前言¶
DeepSeek Harness (DSH) 的核心設計理念是插件化。對於習慣使用 Obsidian 進行知識管理(PKM)的開發者而言,將其筆記庫接入 DSH 的智能體工作流是一個常見需求。dsh-obsidian-second-brain 插件移植自 obsidian-second-brain 項目,適配了 DSH 的插件形態,旨在讓 Obsidian vault 變成一個能夠自我維護、自動整理且具備自我校驗能力的第二大腦。
插件概覽¶
該插件由 GongYuanCaiJi 維護,採用 MIT 許可證。它的核心目標是將手動整理筆記的過程自動化:新來源的信息會更新既有頁面而非簡單追加,筆記間的矛盾會被自動調和,過時的事實會被標記,避免知識庫越堆越亂。
核心功能¶
-
自我重寫的知識庫
新輸入的信息會嘗試更新現有的筆記條目,而非僅僅在底部追加。插件會自動調和筆記庫中的矛盾信息。 -
46 個命令覆蓋完整工作流
插件提供了 46 個命令,覆蓋記錄、日記、項目、人物、任務、看板、決策、復盤、檢索、健康檢查等第二大腦的各個環節。 -
混合語義檢索
採用標題加權檢索的方式,並支持檢索質量自評,確保信息的準確性。 -
研究工具箱
提供 7 個研究命令(包括 X/網頁/YouTube/播客/NotebookLM),研究的結果會自動保存到筆記庫中。 -
定時維護
插件支持在會話結束以及後臺 agent 運行時自動整理筆記庫。 -
AI-first 寫入規則
每條生成的筆記都會包含結構化的 frontmatter、wikilink、來源信息與置信度,專門面向未來 AI 的檢索而非僅爲了人類閱讀。 -
類型化圖譜
筆記之間定義了supersedes(覆蓋)、depends_on(依賴)、contradicts(矛盾)等關係,這些關係可以通過腳本進行驗證。
安裝¶
在 DSH 環境中安裝該插件,請使用以下命令:
dsh plugin --profile <你的 profile> add github:GongYuanCaiJi/dsh-obsidian-second-brain
若 pnpm 攔截了構建步驟,需在 profile 的 pnpm-workspace.yaml 文件中將本包加入 allowBuilds。
使用方法¶
安裝完成後,在 DSH 的會話中即可使用 obsidian-second-brain 技能。該技能會根據你的筆記庫情況引導操作:
- 技能引導:會話開始時,
obsidian-second-brain技能會出現在可用技能列表中。 - 讀取規則:插件會優先讀取 vault 根目錄下的
_CLAUDE.md文件(若存在),作爲本次操作的操作規則。 - 保存對話:使用
/obsidian-save命令,可以將當前的對話內容整理成互相鏈接的 AI-first 筆記(包含人物、項目、決策、任務等條目)。 - 檢索筆記:使用
/obsidian-find命令在庫中檢索筆記。
注意:研究命令(如 /research、/x-read 等)依賴於上游的 Python 研究工具(pyproject.toml),首次使用時會提示安裝 uv。
注意事項與依賴¶
- 語言環境:上游內容爲英文,命令觸發詞包含多語言(含中文),按移植規則未做翻譯,保留原樣。
- Python 依賴:研究功能依賴 Python 及
uv包管理器。 - MCP 橋接:MCP 橋接文件(
integrations/obsidian-mcp-server/)保留在上游原處,按需啓用。 - 文件保真:插件逐字保留了上游 321 個文件,並釘住了 commit
4d5b673。所有命令定義與腳本均與上游保持一致。
總結¶
dsh-obsidian-second-brain 是一個面向 AI-first 知識管理的 Obsidian 插件適配。它通過結構化的寫入規則和自動化的維護機制,幫助 DSH 用戶在智能體會話中高效地與 Obsidian 交互,實現知識的持續沉澱與更新。
- 目錄頁: https://www.skillhub.cn/plugins/GongYuanCaiJi/dsh-obsidian-second-brain
- GitHub: https://github.com/GongYuanCaiJi/dsh-obsidian-second-brain