dsh-diffstream

dsh-diffstream

在 DSH web GUI 的对话流中直接展示代码改动，让你随时清楚 agent 改动了哪些文件、改了什么、执行到了什么位置。

✨ 功能

1. 工具卡片内嵌行级 diff（流式动画）

每次 edit / write 工具执行完成后，改动内容直接渲染在对应的工具卡片内部——绿色 + 新增行、红色 − 删除行，带行号与上下文；diff 以流式逐行动画展开（支持 1x / 2x / 立即 速度控制），视觉效果与 assistant 消息的流式输出同步，改动展开到哪一行 = 执行到了什么位置。

2. 回合尾部改动汇总

每个已完成的回合尾部追加「📋 本回合改动汇总」卡片：文件级列表（路径、新增/修改/删除状态标签、+N −M 增删统计、头部徽标），点击文件行展开该文件的完整行级 diff；同一文件多次编辑自动合并统计。

3. git 优先、参数回退

• 汇总卡片优先使用真实 git diff（含上下文 hunk，经 Host RPC 获取），非 git 项目或 git 命令失败时静默回退为工具参数 diff（视觉一致，功能不中断）；
• 大文件（>200 行）自动截断，可点击展开全部；
• diff 卡片自动滚动：动画播放期间自动跟随最新行滚动到底部（手动上滚时暂停跟随）；
• 无文件产出的回合自动让位官方 ProducedFiles 展示（chain 回退），互不干扰；
• 动画按工具调用 callId 去重，历史回合（刷新后）直接完整显示，不重播。

📦 安装

本插件以独立 npm 包提供，通过 profile 的 cordis.patch.yml 注入，无需修改 dsh 源码。

# 1. 将包放入 web profile 的 node_modules（或 pnpm link 本地路径）
cd ~/.dsh/profiles/web
pnpm add @f-light/dsh-diffstream

# 2. 在 ~/.dsh/profiles/web/cordis.patch.yml 追加插件行
- insert:
    - id: diffstream
      name: '@f-light/dsh-diffstream'

# 3. 重启 dsh web 生效
dsh --profile web

🔧 工作原理

浏览器端 (lib/client.js)
├─ tool.call.toolview (key: edit / write)   ← 接管工具卡片，内嵌行级 diff + 流式动画
└─ conversation.chat.turnTail (chain, priority -1)
   └─ 汇总卡片：参数 diff（会话快照提取）→ git hunk（Host RPC 成功时优先）
Host 端 (lib/index.js)
└─ harness.handle('diffstream/git-status')  ← shell 执行 git status/diff，解析结构化 hunks

• diff 引擎：纯客户端 LCS 行级对比（零依赖、零延迟、不读磁盘），仅使用工具调用参数（old_string / new_string / content）与 git 输出；
• 数据回退矩阵：

场景	工具卡片（内嵌）	回合汇总
git 项目	参数 diff（实时逐条）	git hunk（含上下文）
非 git 项目	参数 diff	参数累计 diff
git 命令失败/超时	不受影响	回退参数累计 diff
大文件（>200 行）	截断 + 展开	同左
工具执行失败	错误态，无 diff	不计入汇总

🛠 开发

# 动态原型（当前会话）：通过 DSH 的 Cordis 动态插件工具定义并运行
# 固化 bundle 结构：
#   lib/index.js   Host 半（git RPC）
#   lib/client.js  浏览器半（window.__ModuleLoader__.load 格式）
#   docs/screenshots/  功能截图（headless Edge 渲染）

License

MIT