# 1. 克隆仓库到 harness 的 workspace 同级目录，或直接放在 harness 仓库目录下
git clone https://github.com/<你的用户名>/dsh-turn-diff.git
cd dsh-turn-diff

# 2. 暂时将插件注册为 harness 的 workspace 成员，以便依赖解析
#    编辑 <harness>/pnpm-workspace.yaml，在 packages: 列表末尾添加一行：
#    注意缩进，与 `- vendor/*` 对齐
#      - dsh-turn-diff

# 3. 在 harness 根目录安装依赖
cd <harness-root>
pnpm install --no-frozen-lockfile

# 4. 构建插件
pnpm --filter dsh-turn-diff run build

# 5. 安装进 web profile
dsh plugin --profile web add link:$(pwd)/dsh-turn-diff

# 6. 重启 dsh web
dsh web

或者直接从 npm 安装（发布后）：

dsh plugin --profile web add dsh-turn-diff

重启后，每轮对话结束时即可看到改动汇总面板。

卸载

dsh plugin --profile web remove dsh-turn-diff

重启 dsh web 即可。

架构

dsh-turn-diff/
├── cordis.patch.yml       # bundle 入口：挂载 node 端和 client 端插件
├── src/
│   ├── index.ts           # Node 端（无操作，仅作为插件入口）
│   ├── invariant.ts       # 运行时不变式
│   └── client/
│       ├── index.ts       # 浏览器端入口：注册节点和槽位
│       ├── turn-diff.ts   # ConversationNodeDefinition：聚合 tool/result diff 数据
│       ├── TurnDiffPanel.tsx   # React 组件：可折叠的差异面板
│       └── TurnDiffPanel.module.css
├── tsconfig.json
├── tsdown.config.ts
└── package.json

数据流

tool/result (card: 'diff', diffs: FileDiff[])
    │
    ▼
turnDiffDefinition.match()  → 匹配 turn/start 和 tool/result
    │
    ▼
turnDiffDefinition.update() → 合并 hunk 到按路径索引的状态
    │
    ▼
turnDiffDefinition.buildLocationData() → 发布 turn-diff 到回合数据 { files: [...] }
    │
    ▼
TurnDiffPanel 从 turn.data.get('turn-diff') 读取 → 渲染展开/折叠面板

依赖

@deepseek-ai/dsh-client-runtime — 会话节点和数据存储
@deepseek-ai/dsh-client-ui-conversation — turnTail 槽位
@deepseek-ai/dsh-client-ui-slots — 槽位注册
@deepseek-ai/dsh-client-ui-primitives — DiffBlock 组件
@deepseek-ai/dsh-tools/presentation — FileDiff 类型
react / clsx — UI 渲染

已知限制

diff 仅覆盖 Write/Edit 工具调用：通过终端命令间接修改的文件不在统计范围内（与 ui-deliverables 一致，因为 presentResult 产生的 diff 视图只在这些工具上定义）
回放/历史页面：通过 viewFor 函数重算视图，应该能正常渲染；但如果某个工具在回放时没有注册，view 会缺失
默认不编译：需要先 pnpm run build 再安装