前言¶
DeepSeek Harness (DSH) 的插件生態允許開發者將特定的功能模塊化。對於需要管理項目文檔和長期記憶的場景，目前的做法往往是依賴臨時的上下文或者自定義的數據庫。如果有一個插件能夠將項目的文檔和長期記憶以純 Markdown 格式存儲在一個專用的 Obsidian vault 中，就可以在不運行 DSH 的情況下直接查看和管理這些數據，同時利用 Obsidian 的搜索和視圖能力。
插件介紹¶
dsh-obsidian-mem 是 DeepSeek Harness 的一個 host 插件，由 bonerrush 維護。它屬於記憶類別。
它的核心價值在於：保持項目文檔和長期記憶爲純 Markdown 格式，存儲在一個專用的 Obsidian vault 中。
核心功能¶
- 持久化存儲：將項目文檔和長期記憶作爲純 Markdown 保留在專用的 Obsidian vault 中。
- 項目綁定：爲一個倉庫創建穩定的
projectId。 - 目錄結構：將項目文檔寫入專用的 vault 目錄。
- 工具集：提供 six 個
mem_*工具。 - 搜索索引：使用
node:sqlite構建搜索索引。 - 自動蒸餾：自動對已完成的對話輪次進行總結。
安裝與配置¶
在安裝前，請確保環境滿足以下要求：
* DeepSeek Harness: >=0.1.5-rc.2 或 >=0.1.7-rc.2
* Node.js: >=22.22.2
插件代碼每個進程只加載一次，因此安裝後需要重啓 DSH。
1. 安裝插件¶
使用官方命令安裝：
dsh plugin --profile memcheck add github:bonerush/dsh-obsidian-mem
2. 驗證安裝¶
安裝後，檢查配置中是否包含該插件：
dsh --profile memcheck --dump-config | grep -n obsidian-mem
如果輸出中包含 obsidian-mem 的配置行，說明安裝成功。
3. 配置 Vault¶
選擇一個本地磁盤目錄作爲專屬 vault 目錄（默認爲 ~/Documents/dsh-memory），並在 Obsidian 中打開該目錄。
4. 重啓進程¶
必須重啓 DSH（例如 dsh web），插件代碼纔會重新加載並生效。
使用與示例¶
安裝並重啓後，可以通過以下方式使用：
- 查看項目列表：
mem_admin(action="projects")
- 啓動會話：在任何 Git 倉庫中啓動會話，直接提問或使用工具。
注意事項¶
- Honest limits：在啓用自動寫入前，請閱讀插件文檔中的 Honest limits，瞭解它的拒絕策略。
- 數據非詳盡：插件較新，目前寫入的內容不是詳盡的，所有變更記錄在
CHANGELOG.md中。 - 本地存儲：Vault 必須是本地的。
- 獨立目錄：不要將 vault 指向你已經維護的個人 vault，插件會創建項目目錄。
- 權限與源碼：插件代碼運行在 DSH 進程的權限下，安裝前請檢查源碼和許可證。
結語¶
dsh-obsidian-mem 通過將 DSH 的記憶能力轉化爲標準的 Obsidian vault，解決了項目文檔與長期記憶的持久化問題。它利用純 Markdown 和 SQLite 提供了結構化的存儲方案，適合需要在 DSH 和 Obsidian 之間無縫協作的場景。
