DeepSeek Harness 提供了插件化的擴展能力。在 Agent 開發中,普通聊天記錄無法可靠地告知模型哪些步驟在何種條件下有效,也無法記錄誰批准了哪些操作。向量搜索能找到相似文本,但相似度本身不足以授權重用一個流程。
dsh-experience-map 旨在解決上述問題。它將已完成的會話證據轉化爲結構化、版本化的 Experience,在重用前檢查其適用性,並請求用戶批准具體的重用計劃。
核心功能¶
該插件提供以下能力:
- Evidence-governed experience memory:以證據爲基礎的經驗記憶機制,確保每一條經驗都有據可查。
- Reuses successful solutions:複用歷史上成功的解決方案,避免重複探索。
- Checks Experience applicability:在提議重用前,檢查 Experience 是否仍適用於當前環境。
- SQLite-based durable records:使用 SQLite 存儲持久化的 Experience 記錄。
- Markdown projections:通過 Markdown 格式提供可讀的視圖。
- Browser-free Host operation:支持無瀏覽器的主機操作模式。
- Opt-in management CLI:提供可選的管理 CLI 工具,用於批量操作。
- Local dense-retrieval adapter support:支持本地密集檢索適配器。
安裝與啓用¶
本插件通過 npm 發佈,包名爲 dsh-experience-map。
環境要求:
* DeepSeek Harness: 0.1.5-rc.2
* Node.js: ^22.19.0 或 >=24.0.0
依賴說明:
* npm 包不打包 Transformers.js 或模型權重,也不會自動下載模型。
* 僅在需要模型提議 Candidate 時,才需要配置 LLM provider。
* 僅在顯式啓用 dense-retrieval adapter 時,才需要安裝 @huggingface/transformers。
典型用法¶
- 手動保存經驗:完成一個有實際產出的任務後,打開對話的
Experience標籤頁。系統會列出零個或多個建議,此時決定是否將建議保存爲持久化的 Experience。 - 無頭操作:使用管理 CLI 對 Experience 進行批量管理或查詢。
注意事項¶
- 本插件以插件形式集成到 DeepSeek Harness 中,在當前 DSH 進程權限下運行。安裝前應檢查源碼與許可證。
- Dense retrieval 適配器爲顯式啓用功能,非默認開啓。