dsh-obsidian: DeepSeek Harness 的 Obsidian 單插件

前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」。dsh-obsidian 是一個把 Obsidian 變成「自組織 AI 第二大腦」的 DeepSeek Harness 單插件。它合併了 dsh-plugin-wiki-skills 和 dsh-plugin-wiki-tools 兩個上游插件，旨在解決上游插件因 DSH 框架快速迭代而頻繁破壞 API，以及拆分插件對個人用戶不友好的問題。該插件提供統一的版本管理和清晰的 v2.x 升級路線。

核心功能¶

插件通過註冊在 ctx.tools 和 ctx.skills 上提供能力。

工具（Tools）¶

工具名	作用
`wiki_query`	BM25 檢索，返回片段與鏈接圖；quick 模式返回 hot + index
`wiki_write`	單頁寫入，包含 type 路由、frontmatter 補全、index/log 記賬與 source-hash 去重
`wiki_lint`	健康檢查：檢測重複、死鏈、孤兒頁、frontmatter 缺失、空章節及失效的 index/hot
`wiki_scaffold`	初始化 LLM Wiki 目錄結構（默認 dry-run）
`wiki_rename`	重命名頁面（含機器頁保護）
`wiki_list`	列出所有頁面標題

技能（Skills）¶

技能名	作用
`wiki`	vault 腳手架與路由
`wiki-ingest`	將來源捕獲進 vault
`wiki-query`	帶引用地從 vault 回答問題
`wiki-lint`	健康檢查工作流
`save`	歸檔對話洞察
`think`	10 原則推理循環
`obsidian-markdown`	Obsidian Flavored Markdown 支持
`obsidian-bases`	Bases 支持
`defuddle`	上下文去重
`obsidian-cli`	CLI 集成

安裝與配置¶

前置條件¶

DSH 0.x 或更新（需包含 dsh plugin CLI）。
Node.js 版本 ≥ 22.19。
磁盤上有一個現有的 Obsidian vault。

安裝步驟¶

在終端執行安裝命令：

    dsh plugin --profile web add @qiqiangvae/dsh-obsidian

編輯你的 DSH profile 配置文件（例如 ~/.dsh/profiles/web/cordis.patch.yml），添加如下內容：

    - id: dsh-obsidian
      config:
        vaultPath: /absolute/path/to/your/obsidian/vault
        # 可選配置：
        # typeFolders: { domain: "wiki/areas" }
        # maxQueryResults: 10

重啓 DSH 服務：

    dsh web

（可選）初始化全新 vault 目錄結構：

    # 在 DSH CLI 中運行
    wiki_scaffold 工具，參數 { template: "default", apply: true }

鎖定版本¶

若需鎖定具體版本：

dsh plugin --profile web add @qiqiangvae/dsh-obsidian@0.1.0

技術細節¶

依賴與許可¶

依賴：@deepseek-ai/cordis、@deepseek-ai/dsh-tools、@deepseek-ai/schemastery。
許可證：MIT。
Scoped 包名：非 scoped 的 dsh-obsidian 已被其他無關 vault 文件系統插件佔用，因此本包使用 @qiqiangvae/dsh-obsidian 作爲唯一標識。

開發¶

插件基於 TypeScript 開發。開發時需執行 pnpm run build 將 src/ 編譯至 lib/，隨後在 DSH 中運行 dsh plugin --profile web add link:$(pwd) 進行本地調試。

注意事項¶

權限：插件以當前 DSH 進程的權限運行，請確保配置的 vaultPath 對進程可訪問。
生態：該插件屬於 DeepSeek Harness 生態，與 DeepSeek / 幻方無官方從屬關係。
源碼審查：在安裝任何插件前，建議閱讀源碼與 ATTRIBUTION.md 以確認許可證兼容性與功能邊界。