dsh-ptc-diff-card
简体中文 · English
DSH Web GUI 插件：让 PTC 模式下的 edit/write 显示和标准模式一样的 diff 卡片。
解决什么问题
PTC（Programmatic Tool Calling）模式下，agent 在 run_code 程序里调用 edit/write。
这些调用被记录成嵌套的 tool/ptc-dispatch 事件，在 run_code 卡片下面渲染成通用行：
展开只有结果文本 The file ... has been updated successfully，没有 diff 卡片。
官方 Tool 层的 diff 推导在 packages/client/ui-tool 的 diffCardModel 里，第一行就把嵌套调用排除了：
if (block.parentCallId !== undefined) return null
而卡片需要的数据其实都在——嵌套块上有调用参数（file_path/old_string/new_string/content）
和落盘的 meta.diffs（已应用 hunks）。
效果
- 嵌套的
edit/write 行变成标准文件卡片：标题、工作区相对路径、输入大小、+新增 -删除；
- 展开就是官方
DiffBlock：语言标签、换行/复制、路径行、增删着色、⋯ 其余 N 行 折叠；
- 失败的调用不画 diff，标题显示错误首行、展开是原始输出（与官方一致）；
- 根调用（标准模式）外观与官方逐字一致，因为整行是照官方实现的复刻。
原理
在 tool.call.toolview 这个 keyed slot 上注册自己的 edit/write 视图，priority: -1
覆盖官方行（低优先级渲染），插件卸载自动还原。行本身复刻官方文件行（同一套
DisclosureRow/DiffBlock 原语 + 一份 vendor 的官方样式表），diff 推导沿用官方逻辑，
只去掉「根调用限定」：
| 调用状态 | diff 来源 |
|---|
成功 settle 且 meta.diffs 非空 | 记录的实际 hunks（路径回写成入参拼写） |
write 新建 / 调用进行中 | 由入参推导的整文件 diff |
| 失败 / 中断 | 不画 diff |
安装
作为普通 DSH bundle 挂到某个 profile：
# 本地目录（开发）
dsh plugin --profile <name> add link:D:/dsh-plugins/dsh-ptc-diff-card
# 从 GitHub
dsh plugin --profile <name> add "github:GrounzerLiu/dsh-ptc-diff-card"
# 从 npm（已发布后）
dsh plugin --profile <name> add dsh-ptc-diff-card
然后把 dsh-ptc-diff-card 加进该 profile package.json 的 dsh.profile.bundles，
重启应用生效。
兼容性与边界
- 目标：DSH
>= 0.2.1-rc.2（engines.dsh），Web GUI（platform: web）。
- 只接管
edit 和 write；str_replace_editor/apply_patch 等未覆盖。
- 行样式是从 ui-tool 0.2.1-rc.3 vendor 的一份拷贝，应用大改版后如需同步外观要重新 vendor。
- 与同样以
priority: -1 抢占 edit/write 的插件（如 dsh-diff-viewer）不能共存：
同 key 同优先级会被 DSH 拒。本插件会捕获并打日志，让官方行继续接管，不会让整个插件加载失败。
- 不自动展开 diff，行为与标准模式一致。
开发
pnpm install
pnpm run check # typecheck + 纯逻辑断言 + 构建
pnpm run build # 只构建 lib/index.js 与 lib/client.js
source 结构：
src/index.ts 宿主半身：inert 的 Loader 入口（浏览器半身的挂载点）
src/client/index.tsx slot 注册（edit/write，priority -1）
src/client/row.tsx 行组件（preparing / dispatched-settled 两态）
src/client/model.ts 行状态、路径、diff 推导
src/client/tool-row.module.css vendor 的官方行样式
scripts/model-check.ts 纯逻辑断言（Node 原生 type stripping，无额外依赖）
浏览器半身按 DSH 客户端插件格式打包：platform 模块表（react、@deepseek-ai/cordis、
ui-slots、ui-primitives…）保持 external，其余内联；CSS Modules 编译成哈希类名 +
一个 <style data-plugin>。
验收
见 VERIFY.md：怎么起测试 profile、在 PTC 会话里看哪一行、怎么对照标准模式与失败调用。
许可
MIT
