资料库

左侧栏的资料库把经手过智能体的文件收在一处：你附加给智能体的，以及智能体自己产出的。

它是一份索引，不是一个存储库——Croli 记下的是文件路径，不搬动、不复制、也不改动任何文件。页面本身完全只读。

入口有两个：左侧栏的「资料库」，以及状态栏的快捷操作菜单。侧栏那一行可以在「显示选项 → 菜单导航项」里关掉，关掉只是少一个快捷入口，从状态栏照样进得去。它的位置不进地址栏，刷新页面会回到会话工作区。

里面收什么

一行一个文件，按「会话 + 路径」去重：同一个文件在两个会话里出现，就是两行。默认按最近出现倒序排，没有排序开关。

只收七类文件：

代码、Markdown、txt、csv、json、压缩包都不收——资料库收的是「资料」，不是你仓库里的源文件。

来源分两种：用户上传（你附加给智能体的）和智能体生成。「智能体生成」除了写文件工具产出的，也包括从命令行和命令输出里扒到的路径——但后者要求文件此刻确实存在、且修改时间落在那次对话提到它的前后半小时内，所以 cat 一个仓库里早就有的 PDF 不会入库。图片永远不会从命令输出里被发现（源码树里到处都是图片，扫一遍 ls 就全进来了），所以用脚本生成的 chart.png 不会自动出现，除非它是写文件工具写的，或者你自己附加过。

怎么找东西

顶部一排筛选，都是叠加生效的：

• 来源 — 全部 / 用户上传 / 智能体生成，单选
• 类型 — 上面那七类，可多选，每项下面标着「N 个文件」；这个数字是全量统计，不随其它筛选变
• 智能体 — 按哪个 CLI 经手筛，同样可多选、带数量
• 搜索 — 输入框里写的是「搜索文件名」，实际上文件名和会话标题都搜，但不搜文件内容
• 时间范围 — 「近 7 天 / 近 30 天 / 近 90 天」三个按钮加一个「更多」（本月 / 今年 / 全部 / 自定义），默认全部；按最近出现的时间筛
• 网格 / 列表两种视图，选了之后会记住

一次取 60 条，还有更多时下面才出现「加载更多」和「已显示 {shown} / {total}」。索引本身还空着时是「这里还是空的……」，筛不到东西时是「没有符合筛选条件的文件。」

能对一个文件做什么

单击打开详情面板，双击（或按回车）打开文件，空格键也是打开详情。右键和详情面板里是同一组操作，一共四个：

「打开」不是用系统默认应用打开。 PDF、音频、视频这些 Croli 没有内置预览器的格式，按文本读出来只会是一堆乱码——想用系统的应用打开，走「在访达中显示」。

没有重命名、删除、下载、移动。 资料库不动你的文件，要改要删请在文件系统里操作。

详情面板里是：类型、来源、大小、引用次数、首次出现、最近出现、路径、会话，以及文件夹（会话不属于任何文件夹时这一行不出现）。只有图片有缩略图（2 MB 以内才渲染，而且滚到眼前才读盘），其他类型显示图标。

文件被你挪走或删掉之后，那一行会变灰并标上「已失效」，点开详情面板才会看到「该文件已不在磁盘上」；打开和定位两个操作同时失效，双击也不再有反应。

索引什么时候更新

打开这一页时会自动跑一次增量同步，有陈旧的会话要读才跑，而且是静默的。右上角「索引」菜单里是两个手动动作：

• 增量同步 — 只读有变化的会话。这一项下面还标着「上次同步 {time}」，没跑过时是「尚未同步」。
• 重建全部 — 重新解析所有会话。某个你确信存在的文件没出现在资料库里时用这个。

跑的时候上方是一条进度条，左边是当前正在读的那条会话的标题，右边是「已完成 / 总数」。手动跑完会提示「已索引 N 个文件」，打开页面时那次自动同步不提示。有会话读不出来会提示「部分会话读取失败」，但这不影响其余结果照常入库。同一时间只能跑一个同步，进度是广播的——另一个窗口触发的同步也会推着你这边的进度条走。

值得了解

• 不打开就不花代价——同步只在你打开资料库、或者展开某条会话详情里的「资料」小块时跑，不在后台常驻。Croli 升级后第一次打开可能会整体重建一次索引，那一次会比平时慢。
• 索引是派生出来的：它从会话记录里重新解析出文件。删掉磁盘上的文件，上传和写文件工具这类来源确凿的行会标成已失效；靠命令输出扒来的行则在下次解析时直接消失。删掉一条会话，它的文件立刻从资料库里消失，会话恢复之后又会原样回来。
• 智能体用不到资料库。 它是智能体干完活之后的产物，不是喂给智能体的输入：没有检索工具，也不会被注入提示词。要把文件给智能体，还是用输入框的「+ → 附加文件」。
• 会话详情页里也有一小块「资料」，只列这一条会话相关的文件（最多 24 个，单击即打开），上传和生成分两列。
• 附件并不总会被复制一份。 本机桌面端附加的文件是原地引用；只有浏览器访问或连着远程工作区时，附件才会上传到服务器的 ~/.croli/uploads/ 下按会话分的目录里（CROLI_HOME / CROLI_DATA_DIR 可以改这个位置）。备份会把它和数据库一起打包。
• 连着远程工作区时，这里的路径是那台服务器上的路径——纯浏览器访问和远程工作区都没有「在访达中显示」。