dsh-change-center

DeepSeek Harness 插件:文件变更的捕获 → 审查 → 拒绝 / 应用 → 回滚中心。

范围(2026-08):专注变更的接收、拒绝、回滚,并提供会话级「全部接收并应用」批量操作。 审批(Approval)与工作流(Workflow)已移除;AI 审查 / 风险 / 验证 / 策略(allow|warn|deny) / git / 历史 保留为审查辅助。

功能

• 捕获:监听 tools/result,把 write/edit 结果记为文件变更、bash 记为命令记录,自动按 agent turn 分组为变更会话;会话以「Turn N · HH:MM」命名(一次 turn = 一次 agent 回复周期内捕获的变更)。
• 审查:
  • 变更树:默认按扩展名分组(*.ext,含聚合行数统计),可切换为可折叠目录树;路径显示为工作区相对路径;行悬停出现 接受/拒绝 快捷操作,支持全部展开/折叠。
  • 统一 diff 视图(纯文本 / 左右对照 / 编辑器)+ 每变更 接受/拒绝/应用/回滚 操作栏,编辑器可直接改后保存。
• 会话级批量操作:全部接收 / 全部拒绝;「全部接收并应用」一次批准全部待审变更并写回工作区,返回 {approved, applied, skipped, failed} 汇总(失败项含原因);面板带待审计数徽标与结果摘要。
• 辅助:Git 仓库信息与工作树状态、AI 审查(结构化 JSON findings)、确定性风险规则(评分+原因)、验证任务、策略门控(allow/warn/deny)、历史时间线。
• 后台任务:验证 / AI 审查 / AI 修复 / 修复循环以 job 形式提交,HTTP 请求立即返回 {job};客户端持有 JobHandle {jobId, done, cancel},智能面板在任务运行中显示「取消」按钮(取消为正常终态);/events SSE 流把变更/会话/job 事件推给浏览器,列表自动刷新、无需轮询。
• 持久化:变更与会话落 $DSH_HOME/change-center/store/*.jsonl,历史落 history/,策略覆盖落 policies.json,快照落 snapshots/ —— 全部经 ctx.fs 接缝(沙箱/审批/原子写),重启后数据保留。

架构

src/
├── capture/   ToolCapture —— tools/result → ChangeService.record
├── services/  ChangeService(状态机+存储,含 acceptAllAndApply) · SessionService · ApplyService(哈希守卫+原子写)
│              SnapshotService(快照/回滚) · DiffService(自研 LCS,大文件回退) · JsonlStore · JobService(后台任务)
├── git/       GitService(经 ctx.shell 只读)
├── verification/ · review/ · risk/ · history/ · policy/ · fix/ · loop/
├── api/       routes.ts —— /api/change-center 同源 REST + /events SSE
└── client/    conversation.view「变更」标签页 + settings.section「变更中心」
               ChangeTree(扩展名/目录双视图) · DiffViewer · ReviewBar · IntelligencePanel(后台任务+取消)

变更状态机:pending → approved → applied → rolled_back,以及 rejected / failed, 非法转移由 TRANSITIONS 表直接拒绝。

开发

pnpm install
pnpm typecheck   # tsc --noEmit
pnpm test        # vitest run(含 e2e:真实 write 工具 + 真实文件系统)
pnpm build       # tsc + tsdown(浏览器半边打包 lib/client.js)

测试将 $DSH_HOME 指向临时目录,持久化写入可写区域(与 DSH 沙箱兼容)。

接入 DSH