工作区清道夫 zhengqiuyang/dsh-janitor

dsh-janitor

如果这个项目对你有帮助，请点个 star —— 它能帮更多人找到这个项目。谢谢！

为 DeepSeek Harness（dsh）提供确定性的产物生命周期管理。

智能体会话会留下垃圾：已完成任务的计划文档、临时脚本、一次性测试夹具。人们害怕智能体驱动的清理，恰恰是因为智能体驱动的清理无法问责。这个插件注册了 janitor_scan 工具，在工作区上运行 agent-janitor 引擎，返回一份可审查的清理计划 —— 每个候选文件都带有确定性判定（protected / keep / recent / needs-review / safe-to-remove）以及判定依据。

janitor 永远不是智能体。 扫描和判定都是纯确定性规则（引用分析、git 元数据、时间阈值）；v0.1 从不删除任何东西 —— 应用审查过的计划交给上游命令行或你自己，这是有意为之。

家族成员：read-guard（智能体读什么）· pr-gate（它们写什么）· attest（它们做了什么）· mcp-test（它们能调用什么）· janitor（它们留下了什么）。

为什么是现在（核查于 2026-10-12）

dsh 生态里没有任何东西做确定性的工作区清理。@goodandready/dsh-time-machine 插件做检查点和回滚（快照安全），两者互补：它回答「我能撤销吗？」，本插件回答「什么可以安全删除？」。确定性扫描 → 可审查计划 → 应用，这条三步、非智能体的流水线目前无人认领。

判定（固定顺序，先匹配者胜）

| 判定 | 含义 |
| protected | 精确匹配保护列表中的文件或目录前缀 |
| keep | 被任何代码文件引用 |
| recent | 比 minAgeDays 更年轻（优先用 git 提交时间） |
| needs-review | 被文档/其他文件引用，或存在其他歧义 |
| safe-to-remove | 任务已合并且零引用的计划文档，或零引用且足够旧 |

安装

dsh plugin --profile default add dsh-janitor

从 npm 安装 —— 无需构建步骤，无需 allowBuilds 授权；git 安装同样是预构建的（lib/ 随仓库一起发布）。

配置

- id: dsh-janitor
name: dsh-janitor
config:
minAgeDays: 14
protectedPaths: ["plans", "docs/decisions"] # exact file or directory prefix

兼容性

- DSH：已在 0.2.x 系列上验证（源码快照 0.2.1-alpha.2）；通过 dsh plugin add 可安装到任意配置档（预构建 lib/，无需构建审批）。
- Node：>= 20（CI 矩阵：Ubuntu 和 Windows 上的 Node 20/22/24）。
- 一次性配置档证据（2026-10-19）：dsh plugin --profile <fresh> add github:zhengqiuyang/dsh-janitor → 30 秒内安装完成；启动时显示 [dsh-janitor] active: …；dsh plugin --profile <fresh> remove dsh-janitor → 依赖清理完毕，bundle 恢复。

开发

npm install
npm test # syncs the vendored agent-janitor engine, builds, runs fixture tests

扫描/判定引擎从同族的 agent-janitor 内联而来 checkout（npm run sync；CI 运行 sync --check）。

路线图

- janitor_apply，带显式的逐路径确认协议（仍然是确定性的——循环里没有智能体判断）
- 会话残留预设（.dsh-* 账本、临时插件目录）
- 计划归档与上游 CLI 的 apply 集成

终止条件

如果 dsh 推出第一方工作区清理功能，或者 time-machine 风格的插件加入确定性删除计划，本项目就冻结在最后一个可用版本，并在此处附上复盘。无论哪种情况，引擎都归 agent-janitor 所有。