DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在構建智能體或本地開發環境時，往往需要將代碼倉庫文檔、知識卡片和會話記憶持久化保存。dsh-cardian 是由 myYangyunfan 維護的一個插件，它將主流智能體 IDE 的“知識中心”能力內化，並將所有數據落地到本地 Obsidian vault 中。每個知識卡片、記憶條目和 RepoWiki 頁面都會生成帶有 YAML frontmatter 的 Markdown 文件，支持在 Obsidian 中直接查看、搜索和圖譜化。
核心功能¶
插件通過三個主要模塊構建知識庫：
- RepoWiki：掃描本地代碼倉庫，生成 Wiki 骨架，並由 Agent 填充語義描述。
- Knowledge Cards：原子知識單元，支持基於 SM-2 算法的閃卡複習計劃，使用 YAML frontmatter 存儲。
- Memory：跨會話的持久化記憶，按 Scope 分組，支持事實、重要性和類型分類。
活動驅動自動刷新¶
插件監聽 DSH 會話的 session/event（即 user/message）。當會話的工作目錄與現有的 RepoWiki 區塊匹配時，系統會自動：
1. 向 Memory 模塊寫入一條帶有 scope=<project> 標籤的“最近對話”記錄；
2. 觸發 refreshAll()，重建 RepoWiki、Knowledge Cards 和 Memory 的索引。
這意味着只要某個項目有對話活動，相關的知識庫就會自動保持最新。
一鍵凝練¶
在 RepoWiki 標籤頁的“沉澱”操作中，點擊凝練不僅會生成骨架卡片，還會啓動 Agent 會話，自動填充內容。生成的卡片包含結構化的章節，如：
* ## 職責
* ## 關鍵實現
* ## 依賴
* ## 注意點
凝練過程支持冪等性，已填寫的內容不會被覆蓋，僅處理新掃描或刷新的骨架。
知識樹層級¶
知識樹面板提供可展開的文件夾層級。第一級按模塊分組（RepoWiki/知識卡片/記憶），RepoWiki 層級進一步按文件路徑細分（如 src ▸ lib ▸ store.js）。點擊項目或文件夾可展開，點擊文件可查看內容。
工具矩陣¶
插件暴露了 36 個工具，並在定義中標註了行爲屬性（readOnly、idempotent、destructive），幫助 Agent 選擇正確的操作方式。主要工具包括：
* 只讀類：search、recall、tagCloud、backlinks、related、status。
* 冪等類：import、importMarkdown、reindex、ingest、upsert、review。
* 破壞性類：delete。
安裝與啓用¶
作爲 DSH 插件安裝：
npm install dsh-cardian
安裝後，需將 cordis.patch.yml 中的 insert 行合併到當前配置中。配置項包括：
* vaultPath：Obsidian 倉庫路徑。
* autoInit：自動初始化。
* semanticSearch：語義搜索開關。
* searchAlpha：混合搜索參數（0=純語義，1=純關鍵詞）。
使用示例¶
插件提供 CLI 和獨立運行模式，核心引擎框架無關，可同時服務於 DSH 插件和獨立 CLI。
# 安裝插件
npm install dsh-cardian
# 查看狀態
node cli.mjs status --vault ./cardian-vault
# 添加知識卡片
node cli.mjs card add "Closure" "closure = function + lexical environment" --tags js
# 運行演示示例
node examples/demo.mjs
# 手動構建客戶端 UI
npm run build:client
生態與地址¶
插件遵循 MIT 許可證，核心引擎無框架依賴，未來計劃支持 MCP 服務器。
- GitHub：https://github.com/myYangyunfan/dsh_cardian
- 社區目錄：https://www.skillhub.cn/plugins/myYangyunfan/dsh_cardian
