前言¶

DSH 的理念是“一切皆插件”。dsh-change-center 处理的是 agent 工具产生文件变更后的统一处理问题：捕获 write、edit、bash 结果，形成变更会话，并提供审查、回滚、恢复和块级操作入口。下面按已核实资料介绍它的功能、接入方式和可用命令。

这是什么¶

dsh-change-center 是 DeepSeek Harness 插件，维护者为 Chance-Wu，许可证为 MIT。

一句话定位：文件变更的捕获 → 审查 → 回滚 / 恢复 / 块级操作中心。

资料说明，5.x 已移除审批(approve)与拒绝(reject)，并移除了应用/全部应用按钮与端点。其主路径是 capture 即登记：文件变更直接 applied，并建立 before 快照。

核心功能¶

捕获与登记¶

插件捕获 tools/result 中的 write、edit、bash 结果，并记录为文件变更或命令记录。

它按 agent turn 自动分组为变更会话。同一会话内对同一路径的多次写入会合并为一条记录。

capture 即登记表示文件变更被捕获后直接标记为 applied，并建立 before 快照，使回滚能力随之可用。

回滚与恢复¶

状态机中的可用状态如下：

• applied：可回滚。
• rolled_back：可恢复。
• pending / failed：历史状态。

回滚用于恢复捕获前版本；恢复用于撤销回滚，写回 agent 版本。

块级操作¶

插件支持块级操作：应用或撤销单个 hunk，以及在块内编辑并保存该块。

Diff 视图与变更树¶

Diff 视图支持统一、并排、编辑三种模式，所有模式显示行号。

变更树支持目录树或按扩展名分组，并支持大仓模式下的搜索、过滤和窗口化渲染。

审查辅助与后台任务¶

插件提供 AI 审查、风险、验证、Git、历史、修复等辅助能力。

后台任务可以提交并通过 JobHandle 等待或取消；/events SSE 用于推送事件。

安装与启用¶

资料只给出接入方式：将本包加入 profile 的 dsh.profile.bundles，作为 profile bundle 接入。

dsh.profile.bundles

将 dsh-change-center 加入该配置项。

接入前，建议确认依赖满足 peerDependencies：

{
  "peerDependencies": {
    "@deepseek-ai/cordis": ">=4.0.0",
    "@deepseek-ai/dsh-agent": "^0.1.0-rc.5",
    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
    "@deepseek-ai/dsh-session": "^0.1.0-rc.5",
    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5"
  }
}

典型用法¶

界面快捷键¶

J / K 或 ↑ / ↓：切换文件
U / Z：回滚
Esc：收起为 Focus

HTTP 接口¶

回滚单个变更：

POST /api/change-center/changes/:id/rollback

回滚会话内全部变更：

POST /api/change-center/sessions/:id/rollback-all

获取 SSE 事件流：

GET /api/change-center/events

本地开发¶

在仓库中执行：

pnpm install
pnpm typecheck
pnpm test
pnpm build

已核实资料给出的测试基线为：189 个用例 / 24 个文件。

适用场景与注意¶

dsh-change-center 适合需要在 DSH 中统一查看 agent 文件变更、审查差异、回滚或恢复变更，并对单个 hunk 做应用、撤销或编辑的场景。

使用前注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 许可证为 MIT。
• 沙箱策略：插件状态写入使用 danger-full-access，工作区写回使用 workspace-write。
• 写盘路径带 diskBaseline 外部修改守卫，冲突时会提示查看差异或强制写入。
• 持久化变更、会话、快照、策略、审查/风险结果到 $DSH_HOME/change-center；资料列出的路径包括 $DSH_HOME/change-center/store/*.jsonl、history/、policies.json、snapshots/、review/、risk/。

链接¶

• 目录页：https://www.skillhub.cn/plugins/Chance-Wu/dsh-change-center
• GitHub：https://github.com/Chance-Wu/dsh-change-center