前言¶
DeepSeek Harness (DSH) 的智能體在會話之間往往面臨上下文丟失的問題，尤其是當工作流涉及大量文件、工具配置或歷史記錄時，重複檢索本地資源效率低下。mega-index-map 作爲一個跨工作區庫，旨在解決這一問題。它允許智能體將遇到的文件、工具、環境配置、知識庫條目和工作記錄統一記錄並索引到本地，從而在任何對話中都能快速複用這些信息。
插件定位¶
mega-index-map 是一個由 Nesarf 維護的跨工作區互操作庫。其核心價值在於提供一個本地的、自擴展的文件格式庫，用於記錄、索引和搜索跨工作區的數據。所有數據存儲在 $DSH_HOME/library 目錄下，插件運行時無網絡 I/O，不執行任何上傳操作，確保了數據的安全性和隔離性。
核心功能¶
插件提供了一系列以 library_ 爲前綴的工具命令，覆蓋了從數據記錄到檢索的全流程。
-
library_record
記錄對象。系統具備變更檢測機制，通過verify/confirm路由決定是否更新。對於不可變類的變更，系統會拒絕並等待用戶確認，隨後記錄reason並標記爲record-confirm。 -
library_index
對索引執行重建、審覈、索引和修剪操作：op=rebuild（默認）：去重、排序並報告衝突。op=audit dir=<path>：只讀 reconciling 目錄與索引，處理磁盤上存在但未記錄的條目，以及索引中路徑不再存在的記錄。op=index dir=<path> confirm=true：註冊缺失條目，受深度和條目上限限制，同時應用敏感內容規則。op=prune confirm=true：刪除不再符合條件（如格式簽名出現次數不足）的派生行。
-
library_query
按關鍵字、類型或標籤搜索，支持光標分頁。多詞查詢會逐詞匹配並基於覆蓋率進行排名，單個詞則作爲子串搜索。 -
library_detect
掃描並註冊本機的工具和環境。內置種子基於PATH解析命令名，並記錄工具位置（如%ProgramFiles%、%GOROOT%等）。支持add（添加到候選包）和propose（從目錄建議條目）。 -
library_sniff
通過頭部字節（支持 108 種簽名）識別文件類型，獨立於文件擴展名。 -
library_format
擴展本機的格式庫，支持list、scan、learn、add、remove、deps、draft、report、deliver和unseal等操作。 -
library_decrypt
在請求時讀取隔離的敏感對象。 -
library_export
將數據導出爲 JSON 或 NDJSON 格式。 -
library_encoding
報告主機編碼及切換到 UTF-8 的方法。 -
library_adb
通過 ADB 執行 Android 設備操作。 -
library_sessions
讀取 DSH 會話及其導出的歷史記錄 ZIP。支持op=list、op=read、op=tail、op=search、op=record、op=bootstrap和op=status。數據以 zstd 幀存儲，支持只讀訪問和損壞尾部的處理。
安裝與啓用¶
安裝插件需要使用官方的包管理命令。
# 安裝插件
dsh plugin --profile web add github:Nesarf/mega-index-map
# 升級已安裝的版本
dsh plugin --profile web update mega-index-map
在首次啓動時，插件會自動執行引導流程，讀取會話歷史並挖掘可索引的事實。
典型用法¶
- 查詢索引
library_query term by term ranking
- 索引操作
# 重建索引
library_index op=rebuild
# 審覈目錄
library_index op=audit dir=/path/to/dir
# 索引目錄並強制確認
library_index op=index dir=/path/to/dir confirm=true
# 修剪索引
library_index op=prune confirm=true
- 會話管理
# 列出會話
library_sessions op=list
# 讀取會話摘要
library_sessions op=read
# 搜索會話歷史中的短語
library_sessions op=search phrase
# 引導配置
# blocking: 默認，完成後註冊工具
# gate: 後臺運行，通過 status 查看狀態
# off: 僅顯式調用 bootstrap
# bootstrapBudgetMs: 默認 300000ms，控制最大運行時間
library_sessions op=bootstrap blocking bootstrapBudgetMs=300000
- 工具檢測
# 添加候選工具
library_detect add tool_name
# 從目錄建議條目
library_detect propose /path/to/dir
適用場景與注意¶
該插件適合需要在多輪對話中保持狀態、檢索本地工具配置或文件信息的場景。
- 性能數據：在當前規模下（約 11,649 個對象，6.0 MB 索引），查詢耗時約 51ms，記錄耗時約 156ms，重建耗時約 124ms。
- 併發與隔離：寫入操作通過鎖文件串行化。插件對跨 Harness 是隻讀的，僅向
$DSH_HOME、臨時目錄或調用者路徑寫入。 - 不變量：輸出強制爲 ASCII，確保跨平臺可移植性，並正確處理 UTF-8 文本。
- 安全提示：該插件以當前 DSH 進程權限運行。安裝前請檢查源碼與許可證。
總結¶
mega-index-map 爲 DSH 提供了一個本地化的知識管理和檢索層。通過將文件、工具和環境記錄進索引，智能體可以更高效地複用上下文，減少對磁盤的直接檢索依賴。對於需要長期維護工作上下文的項目，這是一個實用的工具。更多詳情可查看插件目錄或 GitHub 倉庫。
