dsh-obsidian-second-brain

前言

DeepSeek Harness (DSH) 的核心設計理念是插件化。對於習慣使用 Obsidian 進行知識管理(PKM)的開發者而言,將其筆記庫接入 DSH 的智能體工作流是一個常見需求。dsh-obsidian-second-brain 插件移植自 obsidian-second-brain 項目,適配了 DSH 的插件形態,旨在讓 Obsidian vault 變成一個能夠自我維護、自動整理且具備自我校驗能力的第二大腦。

插件概覽

該插件由 GongYuanCaiJi 維護,採用 MIT 許可證。它的核心目標是將手動整理筆記的過程自動化:新來源的信息會更新既有頁面而非簡單追加,筆記間的矛盾會被自動調和,過時的事實會被標記,避免知識庫越堆越亂。

核心功能

  1. 自我重寫的知識庫
    新輸入的信息會嘗試更新現有的筆記條目,而非僅僅在底部追加。插件會自動調和筆記庫中的矛盾信息。

  2. 46 個命令覆蓋完整工作流
    插件提供了 46 個命令,覆蓋記錄、日記、項目、人物、任務、看板、決策、復盤、檢索、健康檢查等第二大腦的各個環節。

  3. 混合語義檢索
    採用標題加權檢索的方式,並支持檢索質量自評,確保信息的準確性。

  4. 研究工具箱
    提供 7 個研究命令(包括 X/網頁/YouTube/播客/NotebookLM),研究的結果會自動保存到筆記庫中。

  5. 定時維護
    插件支持在會話結束以及後臺 agent 運行時自動整理筆記庫。

  6. AI-first 寫入規則
    每條生成的筆記都會包含結構化的 frontmatter、wikilink、來源信息與置信度,專門面向未來 AI 的檢索而非僅爲了人類閱讀。

  7. 類型化圖譜
    筆記之間定義了 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 技能。該技能會根據你的筆記庫情況引導操作:

  1. 技能引導:會話開始時,obsidian-second-brain 技能會出現在可用技能列表中。
  2. 讀取規則:插件會優先讀取 vault 根目錄下的 _CLAUDE.md 文件(若存在),作爲本次操作的操作規則。
  3. 保存對話:使用 /obsidian-save 命令,可以將當前的對話內容整理成互相鏈接的 AI-first 筆記(包含人物、項目、決策、任務等條目)。
  4. 檢索筆記:使用 /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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜