dsh-lost-and-found：本地文件記憶索引插件

前言¶

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，且必須使用 web profile。
Node.js：版本 ^22 或 >=24。

配置說明：
* 所有數據僅存儲在本地 SQLite 文件中，無需聯網。
* 索引只覆蓋配置的目錄，目錄外文件只能靠實時兜底按名字/時間找到。
* 掃描範圍外的新文件會提示但不自動收錄。

注意事項¶

正文與摘要抽取尚未啓用：目前暫不支持按文檔內容進行全文檢索。
權限限制：插件以當前 DSH 進程的權限運行。安裝前應檢查源碼與許可證（MIT）。
目錄級剪枝：掃描時會自動跳過緩存目錄、VCS 目錄等，以提高效率。