dsh-cbm-keeper
DSH × Codebase Memory 圖譜保鮮插件：讓 CBM 知識圖譜自動跟上各專案的 git HEAD（落後偵測、條件式 CLI 重建、每專案監看、設定頁觀測卡片與 REST 控制面）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:WwW7olFWwW/dsh-cbm-keeper#df19a4ac5c92b67426c169554f42fc4024a9b4beCbm Keeper 以 dsh-cbm-keeper 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →讓 CBM 的知識圖譜自動跟上每個已索引專案的 git HEAD，並把「哪些專案過期、差多少、為什麼失敗」變成看得見的東西。
English: README.en.md
DSH 只用一行 MCP row 接 CBM 時，查詢能用，但「圖譜保持新鮮」整件事會失效——實測曾經落後 33 小時／37 個提交／988 個新增檔，而所有當事人都以為它是新的。三個缺陷疊加：MCP 的 cwd 是 profile 級常數、CBM 內建 watcher 不產生可觀測的重建、MCP 工具 index_repository 有 60 秒上限（本專案索引要 60,980 ms）。本插件把這三件事繞過去。
dsh plugin --profile web add github:WwW7olFWwW/dsh-cbm-keeper
裝完不用重啟：卡片會出現在 設定 →「CBM 圖譜」（沒有就重整一次頁面）。 順手關掉上游那個無條件的全量重建——每開一個 session 白燒約 61 秒／658 MB，而且追不上 HEAD：
codebase-memory-mcp config set auto_index false
realpath(root_path) 為唯一鍵，同一棵樹的別名合併成一列。Branch.head_sha 對 git rev-parse HEAD，給精確的 behindBy；沒有 Branch 節點時退用 indexed_at／DB mtime。證據不足就回「無法判定」，不假裝新鮮。POST /rebuild 回 queued: 0，不產生任何索引工作。codebase-memory-mcp cli index_repository），不受 MCP 工具 60 秒上限約束。node:fs.watch。不改 CBM 本體、不改 DSH 本體、不用 systemd timer。
15 個欄位（enabled、cliPath、mode、scanMinutes、autoRebuild、extensions …）全是 volatile，設定頁與 cordis.patch.yml 都能改；REST 控制面與 UI 同源，卡片上的每個動作都能用 curl 打。
完整欄位與路由見 docs/CONFIGURATION.md。
node:fs.watch，語意相同。routes／layers／languages）不可作為證據，卡片上固定標示。其餘（孤兒專案、unborn HEAD、stop() 的 join、@deepseek-ai/schemastery 解析路徑）見 docs/LIMITATIONS.md。
dsh plugin --profile web remove dsh-cbm-keeper
rm -rf ~/.dsh/cbm-keeper
node --test test/*.test.js # 106 項單元測試，不需要真的索引
node tools/verify-keeper.mjs # 對真實 CBM CLI 唯讀掃描
改完 lib/ 要 systemctl --user restart dsh-web 才生效（link: 安裝的 ESM 模組快取不會熱載入）。
架構與檔案職責 ｜ 驗證現況 ｜ 需求規格 ｜ 貢獻指南 ｜ 變更記錄
MIT © 2026 WwW7olFWwW。本專案是獨立的社群插件，與 DeepSeek 官方無隸屬關係。