前言¶
DeepSeek Harness（DSH）的插件生态允许用户扩展功能。dsh-lost-and-found 是一个本地文件记忆索引插件，维护者为 wangzhanchao883。它解决的是本地文件检索的痛点：通过扫描指定目录建立 SQLite 索引，让用户能用自然语言或关键词快速定位文件，而不需要翻遍硬盘或依赖云端存储。
核心功能¶
该插件通过本地 SQLite 数据库记录文件信息，实现高效的本地检索。
- 建立索引：将指定文件夹的扫描信息（名称、类型、大小、出现时间、位置、来源）存入本地 SQLite 数据库。
- 增量扫描：每个目录维护独立的增量锚点。新目录首次扫描时会回填历史数据，之后转为增量更新。
- 多维检索：支持关键词、时间范围、文件类型、目录范围等多维度搜索，命中位置会自动加权排序。
- 实时兜底：当索引中无命中结果时，会实时对扫描目录进行只读扫描，尽力找回文件。
- 图片描述：支持图片内容由模型看后写回描述，以便后续按画面内容检索。
- 只读模式：插件全程只读，绝不修改、移动或删除任何文件。
安装与启用¶
安装此插件需要使用 DSH 的 web profile。
dsh plugin --profile web add dsh-lost-and-found
典型用法¶
在对话中可以直接使用自然语言提问，或者调用插件提供的工具。
自然语言示例：
* “我上个月收到的那份报价单在哪？”
* “我让你写的那份关于 XX 的报告存哪了？”
* “下载的那个安装包放哪了，好像这周下的。”
工具命令：
* file_find：找文件的核心工具，支持关键词 + 时间/类型/目录/来源过滤，索引未命中时自动兜底。
* file_index_scan：立刻扫描一次。支持 wait=true 等待跑完，full=true 强制忽略锚点全量重扫。
* file_index_status：查看扫描概况，包括上次扫描时间、库内数量、扫描目录等。
环境要求与配置¶
插件对运行环境有特定版本要求。
- DeepSeek Harness：版本 0.1.7 ~ 0.2.x，且必须使用
webprofile。 - Node.js：版本 ^22 或 >=24。
配置说明：
* 所有数据仅存储在本地 SQLite 文件中，无需联网。
* 索引只覆盖配置的目录，目录外文件只能靠实时兜底按名字/时间找到。
* 扫描范围外的新文件会提示但不自动收录。
注意事项¶
- 正文与摘要抽取尚未启用：目前暂不支持按文档内容进行全文检索。
- 权限限制：插件以当前 DSH 进程的权限运行。安装前应检查源码与许可证（MIT）。
- 目录级剪枝：扫描时会自动跳过缓存目录、VCS 目录等，以提高效率。
