dsh-codebase-watcher
在终端中运行以下命令:
dsh plugin install WwW7olFWwW/dsh-codebase-watcher
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install WwW7olFWwW/dsh-codebase-watcher 安装本插件,详情见 https://github.com/WwW7olFWwW/dsh-codebase-watcher。
插件介绍
在 DeepSeek Harness 里通过 MCP 使用 Codebase Memory 时,查询往往正常,真正棘手的是图谱会静默过期。MCP 的工作目录与真实项目树不一致,内置监看难以观测且可能落在错误的树上,而通过 MCP 的 index_repository 还有 60 秒上限,团队容易误以为记忆仍是最新的。
dsh-codebase-watcher 对比 git HEAD 与图谱中的 Branch.head_sha,给出精确的落后程度,只在需要时以子进程调用 CBM CLI 做条件式重建,从而绕过 MCP 工具的时间限制。设定页的 CBM 图谱卡片展示本次启动以来的重建成效;侧栏在有落后或失败时显示指示点,全部同步时不渲染,保持安静。
除安装本插件外,不必修改 CBM 或 DSH 配置,也无需在宿主上挂 systemd timer。首次启动会纳管 CBM 已索引的全部项目,落后者按全局并发 1 排队重建,可先通过 includeProjects 缩小范围或将 autoRebuild 设为 false 仅做观察。若 CBM 的无条件 auto_index 仍开启,插件会在卡片上发出具名警告,避免每个 session 重复全量重建。
适合依赖 Codebase Memory 做代码库记忆、希望图谱跟上 git 工作树、并需要在 DSH 内可观测同步状态的开发者;项目须为 git 工作树,并需本机可用的 codebase-memory-mcp CLI,以及 Node.js 20.13 及以上与 DSH 0.2.0-rc.2 及以上。
截图预览
使用场景
- DSH 通过 MCP 使用 CBM,但图谱经常落后于当前 git HEAD
- 不想每个 session 被 CBM auto_index 拖进一分钟级全量重建
- 需要在设定页或侧栏一眼看出哪些项目记忆已过期
适合人员
- 长期用 Codebase Memory 做仓库索引的 DSH 用户
- 管理多个 git 项目且担心记忆静默过期的团队
- 希望少改宿主配置、不用 systemd timer 的运维者
