前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。爲了讓 Agent 在對話中具備長期記憶，並能利用本地積累的知識資產，需要將本地的 Obsidian 知識庫與 DSH Agent 建立連接。dsh-plugin-vault-memory 正是爲了解決這個問題而生，它把本地的 Obsidian 庫變成了 DSH Agent 的長期記憶存儲與工作臺。
插件定位¶
dsh-plugin-vault-memory 是一個 DSH 插件，由 zhaoxuejie 維護，許可證爲 MIT。
它主要解決四個問題：
1. 檢索問題：Agent 能通過自然語言在庫中檢索筆記，並標註出處。
2. 記憶注入：新會話自動注入庫狀態和活躍項目。
3. 成果保存：將對話產出自動整理爲筆記，包含 frontmatter 和關聯建議。
4. 庫維護：提供巡檢功能，識別孤兒、斷鏈等問題，需手動批准後才寫入磁盤。
核心功能¶
插件通過右下角的浮卡提供交互界面，主要包含以下能力：
1. 檢索能力
* 全文檢索：支持中文分詞，能處理自然語言提問。
* 結構化查詢：支持按目錄、標籤、時間等維度篩選。
* 帶行號讀取：Agent 在引用特定內容時，可以獲取精確的行號。
* 語義檢索：可選功能，使用本地模型（Ollama bge-m3）進行語義向量檢索，需配合語義嵌入使用。
2. 關聯與推薦
* 關聯推薦：支持入鏈、出鏈、同標籤、共引四種推薦方式，並附帶理由。
3. 會話產出保存
* 自動保存：將對話中的成果保存爲筆記。
* 自動 Frontmatter：自動生成元數據。
* 關聯建議：自動推薦與庫內哪些筆記建立關聯。
4. 庫巡檢
* 發現隱患：定期掃描孤兒筆記（無人引用）、斷鏈（指向不存在的文件）、缺總覽（目錄頁缺失）。
* 安全機制：巡檢結果只建議不擅自修改。所有寫入操作（包括修復斷鏈、創建文件）都需要用戶在審查界面手動批准，且寫前會自動備份。
5. 浮卡界面 (GUI)
* 概覽：顯示庫健康度、筆記數、斷鏈數、趨勢等。
* 捕獲：預覽並保存新筆記，支持在 Obsidian 中打開。
* 審查：逐條批准巡檢建議。
* 配置：管理已連接的 Obsidian 庫路徑。
安裝與啓用¶
通過 CLI 安裝到 web profile：
dsh plugin --profile web add dsh-plugin-vault-memory
安裝完成後，需要完全重啓 DSH（不是刷新瀏覽器頁面），右下角纔會出現「📚 知識庫」浮卡。
在浮卡「配置」或 ~/.dsh/settings.yaml 中添加 Obsidian 庫路徑：
dsh-plugin-vault-memory:
vaults:
- path: D:\path\to\your-vault
label: main
典型用法¶
在 DSH 對話中，可以直接通過自然語言調用插件功能：
- 檢索：“庫裏有沒有 Docker 相關筆記？”
- 篩選：“查 tools/ 下近 30 天改過的筆記”
- 讀取：“把《Git 合併》筆記讀給我”
- 語義搜索：“搜跟’Windows 命令行’相關的”
- 關聯分析：“這篇筆記跟哪些有關聯？”
- 保存：“把這段整理成筆記存進庫”
- 巡檢：“庫裏有孤兒/斷鏈嗎？”
適用場景與注意事項¶
此插件適合需要將個人知識庫與 AI 對話深度結合的開發者或知識工作者。
隱私與安全：
索引、檢索、巡檢全部在本地完成，筆記內容默認不會離開本機。
依賴項：
* 語義檢索：若需使用語義檢索功能，需本地運行 Ollama 並拉取 bge-m3 模型。
* 同名文件：插件設計上不覆蓋同名文件，若保存提示“同名已存在”，需更換標題或目錄後重試。
運維建議：
* 安裝後務必完全重啓 DSH 進程。
* 巡檢功能建議定期查看，但修改操作需謹慎，建議先批准備份，確認無誤後再正式寫入。
