dsh-plugin-wiki-tools

DeepSeek Harness (DSH) 的核心思想是「一切皆插件」。在構建基於 Obsidian 的知識庫時，路徑路由、文件去重、索引維護等機械性操作會消耗模型寶貴的輪次。dsh-plugin-wiki-tools 提供了原生工具集，實現了 Wiki 技能套件的機械核心，包括路徑路由、來源增量追蹤、索引簿記和健康檢查，將文件系統操作從提示詞邏輯中剝離，讓模型專注於內容綜合。

插件定位¶

本插件由 Lion-1209 維護，是 Obsidian vault 的原生 DeepSeek Harness 工具。它實現了知識庫技能套件的基礎設施，包括類型到文件夾的路由、Frontmatter 補全、唯一性校驗、主索引更新以及來源差異追蹤。

核心功能¶

wiki_query¶

提供兩種查詢模式：
* 快速模式：直接返回 hot.md 和 index.md 的原文內容，即技能讀取的標準順序。
* 標準模式：對內容頁進行全文搜索，返回搜索片段、入鏈和出鏈圖譜。

wiki_write¶

負責頁面寫入及完整的簿記工作：
1. 根據 type 自動路由到對應文件夾。
2. 自動補全 Frontmatter（更新時保留 created 和未知字段）。
3. 確保文件名在 vault 範圍內唯一。
4. 自動更新主索引條目和日誌條目。
5. 支持 source_path 參數記錄來源哈希，僅在內容變更時寫入（除非使用 force 強制覆蓋）。

wiki_lint¶

對 Wiki 健康狀況進行檢查，結果僅報告並給出建議，輸出到 wiki/meta/Lint Report <日期>.md：
* 重複文件名
* 死鏈
* 孤立頁面
* Frontmatter 缺失
* 空章節
* 過期的索引條目
* 過期的熱緩存

安裝與配置¶

安裝¶

使用官方命令安裝插件：

dsh plugin --profile web add dsh-plugin-wiki-tools

配置¶

vaultPath 是必填項。在 profile 的 cordis.patch.yml 中覆蓋 wiki-tools 配置項，指向 vault 根目錄（需包含 wiki/ 和 .raw/ 目錄），否則插件啓動時會失敗：

- id: wiki-tools
  config:
    vaultPath: /absolute/path/to/vault
    # 可選：重定向頁面類型到特定文件夾
    typeFolders:
      domain: wiki/areas

技術細節與依賴¶

• 環境要求：Node 版本需 >= 22.19.0。
• 文件系統訪問：Vault 是宿主機本地用戶數據，獨立於 DSH 會話工作區，旨在支持跨項目引用。
• 併發控制：針對每個目標文件的寫入在進程內串行化執行，文件名通過 vault 級別去重保護。
• 架構參考：Vault 佈局和操作契約遵循 LLM Wiki 模式（Andrej Karpathy），形態源於 claude-obsidian。

典型用法¶

1. 與技能套件配合：與 dsh-plugin-wiki-skills 配合使用，後者提供提示詞級別的技能（如 wiki、wiki-ingest、wiki-query、wiki-lint、save），本插件處理機械層。
2. 與 Web UI 配合：與 dsh-wiki-web 配合，可在瀏覽器中瀏覽、BM25 搜索、查看鏈接圖譜和 Lint 儀表盤，無需 Obsidian 客戶端。
3. 前置準備：在配置 vaultPath 前，需先用 wiki 技能的 SCAFFOLD 操作搭建 vault 結構。

總結¶

本插件通過將機械性文件操作標準化，降低了維護 Obsidian Wiki 的心智負擔，適合需要高度自動化知識庫管理的 DSH 用戶。

• 目錄頁
• GitHub 倉庫