代谢维护 metabolism-tools/dsh-metabolic-maintenance

DSH 的代谢维护

一个用于 DeepSeek Harness（DSH）的原生 Cordis 技能提供者插件。它教导智能体根据错误后果维护工作流、保留消费者证据，并在变更和恢复后验证下游工作。

该插件按需提供指令。它不注册清理钩子、不运行后台任务，也不授予任何权限。当需要可执行的维护工具时，请使用 WM 的 MCP 集成。

本仓库的定位

这里是该插件的分发与发现主页。开发、规范指令和打包都位于 metabolism-tools/workspace-metabolism：

- 插件源码 — plugins/dsh-metabolic-maintenance
- 规范技能文本 — skills/metabolic-maintenance

打包会生成该技能文本的一份完全相同的可分发副本。请编辑上游源文件，而不是此镜像。发布版本由 .github/workflows/sync-release.yml 复制到这里，该工作流会镜像最新的 dsh-metabolic-maintenance-v* 发布版本及其资产和校验和；如果本仓库与源仓库出现不一致，以源仓库为准。

安装

从最新发布版本下载插件 .tgz，并将其解压到你控制的目录中；npm 归档包含一个 package/ 目录。请保持该目录完整。加载解压后的插件无需 npm 账户、构建步骤或安装插件依赖。

在你想要处理的 workspace 中，使用插件的绝对位置生成补丁，然后启动你现有的 DSH 安装：

node /absolute/path/to/package/configure.mjs > maintenance.patch.json
npx @deepseek-ai/dsh web --patch ./maintenance.patch.json

或者，使用解压后的 index.js 的文件 URL，向你现有的 DSH 组合中添加一行插件：

- insert:
- id: metabolic-maintenance
name: 'file:///absolute/path/to/package/index.js'

在 Windows 上使用文件 URL，例如 file:///D:/tools/metabolic-maintenance/package/index.js。生成器会自动处理空格和非 ASCII 路径。标准 DSH 组合必须提供其技能注册表和技能工具。移除 overlay 或该行即可禁用插件。

向智能体提问：使用 metabolic-maintenance 技能评估此 workspace 的维护需求。仅执行已授权的操作，并验证受影响的下游结果。
模型可以通过 skill({name: "metabolic-maintenance"}) 加载它。评估参考可按需获取；其内容不会添加到每个对话步骤中。同名项目技能优先于这个捆绑提供者，因此如果正文不同，请检查是否存在本地覆盖。

我应该使用哪一部分？

| 部分 | 职责 | 何时使用 | 它无法确立什么 |
| 代谢维护技能 | 指导代理的维护判断和证据收集 | 代理必须决定是否需要维护以及如何验证其结果 | 强制权限、模型服从或业务正确性 |
| WM CLI / MCP 工具 | 审计、基于策略的预览、可逆清理、完整性检查和回滚 | 你需要可执行的文件生命周期操作 | 下游研究报告、构建或其他业务结果是否正确 |
| 你的下游消费者和验收检查 | 运行受影响的工作流并检查其实际输出 | 你需要接受维护或确认恢复 | 对无关变更的授权 |

当现有脚本已经定义了维护和验收流程时，可单独使用 WM。当代理需要维护指导时，可单独使用该技能并配合其他足够的工具。当代理既需要指导又需要 WM 操作时，将二者结合使用。该技能是一个咨询层；它不是决策权威或强制执行边界。

实践中的四条规则

| 规则 | 含义 | 示例 |
| 为实际原因而维护 | 识别到期的策略、容量限制、损坏的依赖或明确目标；否则不采取行动 | 一条 30 天保留规则适用于一份未使用且已存在 45 天的临时报告。一份新报告不会仅仅因为代理空闲就成为清理目标。 |
| 让自主性与错误后果相匹配 | 评估受影响范围、依赖关系、隔离性和恢复能力。更严重的后果要求在自主行动前具备更强的条件，而不仅仅是更低的置信度分数 | 可重新生成的缓存可以使用有界检查。共享输入证据需要已知的消费者、保留的来源信息以及经过测试的恢复路径。未解决的高影响选择应交给获得授权的人类。 |
| 保留消费者证据 | 保留复现和判断下游结果所需的信息，而不仅仅是被移除文件的副本 | 将输入身份、相关策略/工具/消费者版本、验收标准、实际输出和恢复材料保留在清理目标之外。 |
| 在维护和恢复后验证下游工作 | 运行相关消费者，并将其输出与约定的验收条件进行比较。回滚后重新检查 | 一份报告在清理后仍必须总计为 18。如果清理破坏了它，恢复文件只是第一步：报告必须再次得出 18。缺少验证会使结果悬而未决。 |
检查应当适度。这些规则不要求对已授权的可逆工作反复审批，也不要求为每次缓存清理都做研究实验。

端到端示例

打包的插件附带一个隔离的维护周期：评估一份到期的临时报告，预览并执行 WM 清理，检查一个真实的文件读取消费者，并恢复一个故意损坏的测试夹具。它还演示了在消费者未知时暂停周期。该示例将脚本化执行与 DSH 智能体提议的角色区分开来；它并非自主模型性能的证据。

版本 0.1.3 新增了维护观察示例——启动失败、证据过期、通知重试、恢复不完整，以及合法的无变更/未到期结果。详细的观察说明和案例记录仅在需要时加载。不安装调度器、通知服务或新的 WM CLI 命令。

与 WM 配对

将 workspace-metabolism 安装到你选定的 Python 环境中，并从目标工作区生成组合补丁：

node /absolute/path/to/package/configure.mjs --with-wm > maintenance.patch.json

这会添加与现有 WM 集成 所使用的相同官方 MCP 桥接，并将其工作目录固定为你生成补丁的位置。WM 的 Python 可执行文件必须位于 DSH 进程的 PATH 中。如果 WM 已配置，请使用仅技能补丁以避免重复的插件条目。生成的补丁包含本地路径；移动目录后请重新生成，且不要将它们包含在公开报告中。

该技能也可以使用现有脚本。它不需要实验性的 wm change 命令。WM 完整性检查本身并不能证明消费者的正确性，策略回执也不能验证人工审批。

从源码构建并验证

在 Node 22+ 和 Python 3.11+ 环境下，从 WM 仓库 中的 plugins/dsh-metabolic-maintenance 目录执行：

npm ci --ignore-scripts
npm run build
npm test
npm pack

打包会生成规范技能的可分发副本；请编辑规范源文件，而非生成产物。

验证边界

兼容性检查使用真实的 Cordis 4.0.2 和 DSH 技能注册表 0.0.1-rc.1，涵盖发现、加载、引用访问、项目覆盖和处置。提供方遵循官方 DSH 技能 API。这些检查并不能确立完整的 DSH UI 兼容性、模型服从性、更低的 token 成本或生产维护安全性。DSH 仍在演进；在诊断兼容性问题时，请保持版本边界可见。

许可证

MIT — 参见 LICENSE。