deepseek-harness/docs/persistence-changes/2026-09-14-workspace-changes-event.zh.md

---

description: "记录持久化类型更改及其兼容性确认。"

kind: persistence-change

2026-09-14-workspace-changes-event

English | 中文

概述

新增仅写日志的 workspace/changes 事件，记录顶层轮次改动的文件。

目录

• 声明
• 兼容性
• 验证
• 开发备注

声明

schemaVersion: 1
id: 2026-09-14-workspace-changes-event
baseline: false
changes:
  - root: "event:workspace/changes"
    previous: null
    after: "e308ccf867a5398e316e0af8cb6ce238a8d33a63b9b384c8250a686786285f72"
    decision: same-version

兼容性

同一 Session 格式版本内的新根类型。已有日志没有该事件，保持有效；早于它的读取方遇到它会拒绝该日志，与所有读取时必需的事件一致。该事件只由 Web bundle 的 workspace-changes 插件追加，模型永远看不到；Web 的改动文件卡片是唯一消费者，读取每轮最新的一条。

验证

pnpm exec vitest run packages/deliverables/workspace-changes packages/client/ui-deliverables：165 个测试通过；snapshots/web/changed-files-turn 通过 Web profile 回放了记录的事件。

开发备注

无。