前言¶
給智能體做長線項目時，一個常見問題是知識留不下來：實體、概念、決策散落在一次次會話裏，下次開工要麼靠模型硬記，要麼人工搬運筆記。Claude 生態的 claude-obsidian 用一套以提示詞爲中心的 vault 工作流驗證了「讓智能體自己維護 wiki」的可行性，但 dsh 用戶無法直接複用。下面介紹的 dsh-plugin-wiki-skills 做的就是這個移植：把 claude-obsidian 衍生的知識庫技能套件打包成 DeepSeek Harness 插件，讓 dsh 智能體具備建 wiki、攝入資料、查詢回答、健康檢查、寫回洞見的完整鏈路。
這是什麼¶
dsh-plugin-wiki-skills 由 Lion-1209 維護，當前版本 0.2.2，MIT 許可。核心是五個技能：wiki、wiki-ingest、wiki-query、wiki-lint、save，外加 think、obsidian-markdown、obsidian-bases、defuddle 四個支撐技能。vault 設計遵循 Andrej Karpathy 描述的 LLM Wiki 模式。
工程上，插件以只讀 bundled provider 掛載到 ctx.skills 註冊表，通過 dsh.bundle patch 插入一行 wiki-skills，不做侵入式修改。
核心功能¶
五個核心技能按職責劃分：
wiki：Vault setup、scaffolding、cross-project referencing、hot-cache management；wiki-ingest：將來源攝入 vault，抽取實體/概念、建立交叉引用、記錄日誌；wiki-query：基於 vault 回答，檢索順序爲 hot cache → index → pages，並附引用；wiki-lint：健康檢查，覆蓋 orphans、dead links、frontmatter gaps、stale index entries；save：將對話洞見寫回 vault。
支撐技能方面：think 提供 10 原則推理循環（OBSERVE…GROW），所有 wiki 技能都映射在這套循環之上；obsidian-markdown 是 Obsidian Flavored Markdown 語法參考（wikilinks、callouts、embeds）；obsidian-bases 是 Obsidian Bases 參考，用於對 note 屬性做數據視圖；defuddle 負責在攝入前清洗抓取的網頁，輸出無廣告的可讀文本。
實現細節有三點值得注意：
1、註冊名爲 wiki-skills 的單個 provider，候選 rank 爲 bundled-rank (600)；
2、每個技能聲明 resourceBase: directory，正文可以引用 references/ 下的同級文件；
3、frontmatter 格式錯誤時在發現階段直接報錯，而不是靜默跳過某個技能。
出處與適配範圍¶
五個技能改編自 AgriciDaniel（AI Marketing Hub）的 claude-obsidian（MIT 許可，見倉庫中的 ORIGINAL_LICENSE），基於其 v1 時代以提示詞爲中心的版本，經 ZCode 適配後再度適配到 dsh。
本適配版的改動：移除上游推廣頁腳（Community Footer）與未打包子技能（autoresearch、canvas）的路由行；爲每個技能加上 dsh 適配說明。上游的 autoresearch、canvas、wiki-cli、wiki-fold、wiki-mode、wiki-retrieve 技能未打包，research 與 canvas 工作流仍是上游功能；上游產品腳本（transport detection、wiki-mode.py、wiki-lock.sh、DragonScale address allocation、.vault-meta/）同樣未打包，機械核心由配套包 dsh-plugin-wiki-tools 的原生工具承擔。
安裝與啓用¶
運行環境要求 Node.js >=22.19.0（engines 約束），依賴 yaml ^2.8.0。
安裝只需一條命令：
dsh plugin --profile web add dsh-plugin-wiki-skills
這條命令把插件裝進 web profile。包內聲明瞭 dsh.bundle patch，加載時會向 ctx.skills 註冊表插入一行 wiki-skills，以只讀 bundled provider 的形式提供技能。
典型用法¶
建議與 dsh-plugin-wiki-tools 配對使用，後者提供原生的 wiki_query / wiki_write / wiki_lint 工具，承擔這套技能的機械核心。
按各技能的路由，一套典型鏈路是：先用 wiki 搭建 vault 並做 scaffolding；網頁等來源先經 defuddle 清洗，再用 wiki-ingest 抽取實體與概念、建立交叉引用；需要答案時由 wiki-query 按 hot cache → index → pages 的順序檢索並附引用；定期跑 wiki-lint 檢查 orphans、dead links 等問題；會話中的洞見用 save 寫回。
如果是參與開發，先做依賴安裝，再跑測試：
npm install
node --test
適用場景與注意¶
適合在 dsh 上維護長期項目的智能體開發者，尤其希望知識沉澱爲 Obsidian vault（技能直接引用了 Obsidian Flavored Markdown 與 Bases）的場景。使用前注意三點：
1、bundled-rank (600) 意味着同名的 project、runtime、user 技能優先於本套件，想覆蓋默認行爲可以寫同名技能；
2、research 與 canvas 工作流不包含在本插件內；
3、插件以當前 dsh 進程權限運行，安裝前建議自行檢查源碼與許可證。許可證方面，本打包爲 MIT，打包的技能內容衍生自 claude-obsidian（同樣 MIT），詳見 ORIGINAL_LICENSE。
結尾¶
經過上面的步驟，dsh 智能體就能擁有一套來源清晰、可查詢、可體檢的持久知識庫，且整套移植保留了上游的歸屬說明。項目地址與收錄頁：
- GitHub：https://github.com/Lion-1209/dsh-plugin-wiki-skills
- 社區目錄頁：https://www.skillhub.cn/plugins/Lion-1209/dsh-plugin-wiki-skills
社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
