前言¶
在 DeepSeek Harness（DSH）裏讓智能體「記住」某條信息，常見做法是把內容寫進某個 Markdown 或筆記文件。這類目錄往往缺少審覈：原文、摘要和檢索條目混在一起，事後很難覈對結論是否仍與來源一致，衝突時也容易由模型自行選邊。
dsh-kb-curator 是維護者 Mark-mph 發佈的 DSH 組合包（bundle），向 Harness 配置裏掛載只讀技能 kb-curator，並附帶一套無外部向量/嵌入 API 依賴的 PowerShell 知識庫引擎。它把材料分層存放，並在寫入可檢索記憶與主題頁之前，強制經過你批准提案的流程。下面介紹它解決什麼問題、如何安裝，以及首次落地知識庫目錄的步驟。
這是什麼¶
dsh-kb-curator 在 npm 上的包名爲 dsh-kb-curator（當前資料中版本爲 0.1.2，MIT 許可證）。它不是單獨的可執行應用，而是通過 cordis.patch.yml 向 profile 組合層插入一行 kb-curator 插件，由 lib/index.js 註冊捆綁的只讀技能；技能正文與引擎資源位於安裝包內的 assets/kb-curator/。
技能教智能體維護本地三層知識庫：L1 存原文庫、L2 存帶 [src:kb-YYYYMMDD-NNNN] 溯源標記的可檢索命題、L3 存按分類彙總的主題頁。任何未獲批准的內容不得進入 L2/L3；在審覈完成前，智能體只能寫入 _inbox/、_review/queue/ 和 _system/log.jsonl 等約定位置。
社區目錄 SkillHub 將其歸類爲「記憶」；GitHub 倉庫：https://github.com/Mark-mph/dsh-kb-curator 。
核心功能¶
三層分工¶
| 層級 | 內容 | 位置 | 誰可寫入 |
|---|---|---|---|
| L1 原文庫 | 帶固定 frontmatter 的原始 Markdown，只追加、不在原位改稿 | library/<category>/<subcategory>/<yyyy-mm-dd>-<slug>.md |
經 kb.cmd approve 等審覈流程 |
| L2 檢索層 | 單句命題（事實/偏好/決策/片段/技能等），可搜索 | engram SQLite，經 engram_* 工具 |
你批准提案後由智能體寫入 |
| L3 主題頁 | 每分類一頁：綜合理解、索引、未決衝突 | pages/<category>.md |
你批准提案後由智能體寫入 |
設計約束包括：原文留在 L1；L2 只放提煉後的命題；L3 不放整段搬運——若需大段原文應進 L1 並鏈接。主題頁過長（約 200 行以上）時，細節應回沉到 L1/L2。
審覈閘門¶
提案狀態流轉爲：inbox → 智能體寫提案 → proposed → 你批准 → approved → 入庫 → indexed；也可拒絕爲 rejected，或要求修改爲 needs_edit 後再回到 proposed。狀態非 approved 的內容不能進入 L2/L3，不存在「先寫進索引再等批」的路徑。
溯源與衝突¶
引用結論需帶 [src:kb-YYYYMMDD-NNNN] 指回 L1 文檔。多來源矛盾時，技能定義固定仲裁順序；順序用盡仍無法裁決時，智能體應報告衝突而非自行選邊（詳見技能內 references/arbitration.md 與引擎 _system/ 規範）。
分類與引擎¶
init 會創建八個頂層分類目錄：技術工程、產品業務、學術研究、生活健康、財務投資、人文社科、工具流程、未分類。子分類目錄在首次批准該子分類文檔時出現。引擎不調用付費嵌入或向量搜索 API，檢索與整理依賴你已在 Harness 中使用的雲端模型及本地 engram 存儲。
組合包不聲明可配置項；禁用或從組合中移除 kb-curator 行即可卸掉該技能。
安裝與啓用¶
運行環境需 Node.js ^22.19.0 || >=24.0.0。Peer 依賴由 Harness 解析：@deepseek-ai/cordis（資料中 README 表爲 ~4.0.4，package.json 爲 ^4.0.1）、@deepseek-ai/dsh-skill >=0.1.0-rc.1 <0.2.0-0。
官方安裝命令如下：
dsh plugin add dsh-kb-curator
安裝後會在 profile 中插入類似配置（見倉庫 cordis.patch.yml）：
- insert:
- id: kb-curator
name: 'dsh-kb-curator'
DSH 生態採用「一切皆插件」思路；SkillHub（https://www.skillhub.cn/plugins/Mark-mph/dsh-kb-curator）是社區目錄站點，與 DeepSeek / 幻方無官方從屬關係。安裝前建議自行查看倉庫源碼與 MIT 許可證。插件與技能在當前 dsh 進程權限下運行，知識庫目錄應選在你可控、可備份的路徑。
典型用法：首次創建知識庫¶
插件不會自動替你創建知識庫根目錄，需自選文件夾並按 README 完成引擎拷貝與初始化。
-
定位技能資源目錄
安裝包內assets/kb-curator/含SKILL.md、references/與engine/。 -
整目錄拷貝 engine
將engine/全部複製到你選定的知識庫根；kb.ps1以$PSScriptRoot自定位，引擎落在哪，根就在哪。kb.config.json裏的root字段僅供人讀，程序不讀取。
$KB = "D:\KnowledgeBase" # 你的根目錄
Copy-Item -Recurse "<skill-base>\engine\*" $KB
必須完整複製，因 _system/ 規範與 _templates/ 在首次 init 前就要存在。
- 初始化目錄樹
init冪等：只創建缺失項，不覆蓋已有內容。
& "$KB\kb.cmd" init
- 查看狀態
只讀報告根路徑、磁盤閾值、待審/已批/已拒提案數、各層文件數等；不寫日誌、不改文件。資料建議在每次 ingest 或批量寫入前執行。
& "$KB\kb.cmd" status
後續 ingest、提案審覈、approve 與 engram 工具細節見技能 SKILL.md 及 references/kb-cli.md、review-workflow.md 等七份參考文檔。
適用場景與注意¶
適合：希望在 DSH 對話中讓智能體持續整理個人或團隊材料，又要求原文不可篡改、檢索條目與主題頁必須經你點頭後再入庫；希望避免額外向量 SaaS 賬單，接受本地目錄 + SQLite 檢索方案。
注意：
- 引擎入口爲 Windows 友好的
kb.cmd/ PowerShell（kb.ps1），在 Linux 上部署知識庫根目錄時需自行確認 PowerShell 可用性或按引擎 README 操作。 - 磁盤_guard 與付費服務開關等閾值寫在
kb.config.json，以引擎文檔爲準。 - 勿使用資料未給出的安裝方式（例如自行拼接
dsh plugin add github:...）；以 README 中的dsh plugin add dsh-kb-curator爲準。
結尾¶
dsh-kb-curator 把「記憶」從隨手堆文件，改成 L1/L2/L3 分層、強制人工審覈、帶來源標記與衝突仲裁規則的本地知識庫流程；安裝命令一行，知識庫根目錄與審覈節奏仍由你掌控。
- 目錄頁：https://www.skillhub.cn/plugins/Mark-mph/dsh-kb-curator
- GitHub：https://github.com/Mark-mph/dsh-kb-curator
