知樞 KnowHub：DSH 全局知識中心與項目長期記憶

前言¶

智能體開發中，項目知識散落在代碼註釋、文檔、會議記錄與長期記憶裏，檢索困難、版本不可追溯、難以複用。DSH 插件生態以「一切皆插件」爲理念，本插件提供全局知識中心與項目長期記憶，把項目知識與長期記憶沉澱成可檢索、可審覈、可追溯、可備份的知識庫，並在 DSH 會話中按工作區作用域自動注入或按需檢索。

是什麼¶

知樞 KnowHub（dsh-knowhub）是 DSH 的全局知識中心與項目長期記憶插件。由 Mw-HbCK 維護，分類爲「記憶」，GitHub 1 star。它將項目知識與長期記憶整理成可檢索、可審覈、可追溯、可備份的知識庫，並在 DSH 會話中按工作區作用域自動注入或按需檢索。

核心功能¶

知識庫與作用域¶

用戶級知識庫（跨工作區共享）與工作區級知識庫（僅當前項目可見）；檢索與上下文注入按工作區作用域隔離，審覈隊列與知識庫列表覆蓋本地全部知識庫。
每個知識庫可綁定不同的模型與生成策略（economy / balanced / quality），初始化、提煉、增量都使用庫綁定的模型。
創建後可修改名稱、模型與策略，不影響已有知識與版本歷史；編輯配置裏可先「測試模型」確認該模型當前可調通。
模型輸出被截斷（推理模型把 token 預算消耗在思考過程）時，任務會自動加倍預算重試一次；仍失敗會明確提示換用非推理模型或調高「模型使用策略」。

Repo Wiki 與增量更新¶

一鍵掃描工作區，生成項目概覽、架構、模塊等 Wiki 候選。
內容哈希 + Git 檢出雙重判據驅動增量更新：只對受影響的知識生成更新候選，並記錄每次檢查點與變更清單。
已批准的知識不會被流水線靜默覆蓋，寫入類更新一律先成爲待審覈候選。

長期記憶與知識卡片¶

七類知識：Wiki、記憶、偏好、決策、約定、問題、待辦。
每條知識帶來源清單、驗證態（observed / inferred / assumed / unverified）、版本歷史與審覈日誌。
Agent 可在會話中通過工具提議新知識；也可開啓自動提煉，在回合結束後把有價值的結論沉澱爲候選。

檢索與上下文注入¶

SQLite FTS5 trigram 中文全文檢索，1–2 字短詞自動回退 LIKE；支持標籤過濾（AND、最多 6 個）、類型/狀態/知識庫過濾與分頁加載。
同一內容的結果按哈希合併，並提示重複來源。
會話系統提示按作用域注入已批准知識摘要，可分別關閉全局記憶與項目記憶，並限制摘要字符數與標題數。

審覈與版本¶

待審覈隊列分候選、衝突、草稿、過時四類，覆蓋本地全部知識庫（用戶級 + 各工作區），真實計數、關鍵字/類型/來源篩選與排序。
支持單條與批量審批（單次最多 50 條）、編輯後批准、衝突人工合併。
候選與衝突提供文檔對比頁：綠色新增、紅色刪除，行內詞元高亮，統一視圖與並排視圖，改動處導航。
版本歷史可查看、對比與恢復，恢復同樣以新版本追加，可回退。

備份與維護¶

gzip 備份、恢復前預覽、破壞性操作前自動創建恢復點；恢復是合併語義，不刪除當前已有的知識。
存儲位置遷移：預檢 → 自動備份 → 計數校驗 → 切換指針，回滾只需刪除指針文件。
環境診斷：運行時、存儲、工作區、模型、SQLite FTS5 與工具註冊狀態。

導入導出¶

單篇或整庫導出 Markdown（帶元數據頭），可讀可改，可進 Git。
Markdown 導入支持粘貼或選擇文件，一律先落爲草稿，同名知識跳過不覆蓋。

面板¶

DSH 內嵌的中文知識中心：Repo Wiki / 知識卡片 / 記憶 / 知識庫四個頁籤，加上待審覈 / 檢索 / 設置三個整頁入口。
配色全部讀取 DSH 主題 token，跟隨淺色 / 深色 / 跟隨系統。
知識正文使用內置零依賴 Markdown 渲染，可切換「渲染 / 源碼」。

安裝與啓用¶

環境要求¶

DSH 0.2.x（需含 web 面板 bundle，用於知識中心界面）
Node.js ^22.19 或 >=24
一個已在 profile 中註冊的 provider / model，初始化、提煉與增量會調用它

從 npm 安裝¶

dsh plugin --profile knowhub add dsh-knowhub
dsh --profile knowhub --port 29961 --no-open

安裝會寫入 profile 依賴；請確認 profile 的 package.json 中 dsh.profile.bundles 包含 dsh-knowhub。啓動日誌會打印面板地址（含一次性 token）：http://127.0.0.1:29961/?token=...

從本地 tarball 或源碼目錄安裝¶

# tarball
& dsh plugin --profile knowhub add .\dsh-knowhub-0.8.8.tgz

# 開發期：軟鏈到源碼目錄，構建後重啓即生效
cmd /c mklink /J "$env:USERPROFILE\.dsh\profiles\knowhub\node_modules\dsh-knowhub" "C:\path\to\KnowHub"

配置模型¶

知識庫需要模型才能生成 Wiki。在 profile 的 cordis.patch.yml 中註冊默認模型：

- id: agent-default-model
  name: "@deepseek-ai/dsh-agent-default-model"
  config:
    provider: <provider-id>
    model: <model-id>

創建知識庫時，面板會列出宿主 /models 返回的可用模型，選中後綁定到該庫。

典型用法¶

新建知識庫：左側欄「知樞」→「知識庫」→「+ 新建」，選擇生效範圍（用戶級 / 工作區級）、模型與策略。
初始化 Wiki：在知識庫詳情點「初始化」，掃描工作區並生成候選草稿。
審覈：右上「待審覈」裏逐條或批量審批；內容有改動可用「編輯後批准」，衝突可人工合併。
增量更新：初始化完成後點「增量更新」，只對變更文件影響到的知識生成候選。
記憶與卡片：會話中由 Agent 工具提議，或開啓自動提煉；結果都在待審覈裏確認。
檢索與注入：右上「檢索」按關鍵詞或標籤查找；「設置」裏控制注入開關與摘要預算。

適用場景與注意¶

適合需要將項目知識沉澱爲長期記憶、希望對知識進行審覈與版本控制、需要在 DSH 會話中自動注入知識摘要的開發者。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。插件禁用或卸載不刪除用戶知識。

短結尾¶

知樞 KnowHub 提供從掃描、審覈、檢索到注入的全鏈路知識管理能力，適合需要長期沉澱項目知識並與 DSH 會話深度集成的場景。

目錄頁：https://www.skillhub.cn/plugins/Mw-HbCK/dsh-knowhub
GitHub：https://github.com/Mw-HbCK/dsh-knowhub