sunshaobei/dsh-session-review

dsh-session-review

DSH Web 插件：在输入框正上方显示"本轮会话修改的文件"一行（默认收起，点击展开），右侧 Review 按钮在侧边栏打开针对本次会话修改的 review 面板。

三个能力全部挂在官方扩展点上，不改动 DSH 任何内置包：

Review 的数据是"本次会话"精确的修改：宿主订阅会话事件流，收集每个成功 edit/write 工具结果携带的 meta.diffs（{path, oldText, newText}）——即该工具调用实际替换的文本，不依赖 git（git worktree diff 会混入本会话之前未提交的改动，这里不会）。新建文件显示为"新建 + 全量新增行"。

安装

dsh plugin --profile web add /path/to/dsh-session-review

dsh.bundle.patch 声明会让 CLI 自动把本包追加进 profile 的 bundles（宿主半随之挂载），并以 link 方式安装（开发迭代无需重复 install）。然后重启 DSH 桌面应用并刷新页面。零运行时依赖，无 peer / 构建要求。

卸载：dsh plugin --profile web remove dsh-session-review。

开发迭代：改完代码运行 scripts/deploy.sh（同步 lib 到 profile 安装目录）后重启。

架构

┌ composer (ui-conversation, 不改) ──────────────────────────────┐
│ conversation.input.dock (order 15)                             │
│   [▸] 本轮修改 N 个文件 · M 处            [Review 全部]        │  ← 收起态
│   展开：文件列表（点击 → 单文件 review）                        │
└───────────────────────────────────────────────────────────────┘
                       │ POST /session-review/api/files.list     (轮询 4s / 会话切换 / 展开瞬间)
                       │ POST /session-review/api/files.diff
                       │ POST /session-review/api/files.read     (新建文件内容)
┌ 宿主半 lib/index.js ──────────────────────────────────────────┐
│ ctx.on("session/event") → tool/result 带 meta.diffs 且非错误    │
│   → 按会话累积 {absPath → [{tool, seq, time, oldText, newText}]}│
│ 首次读取某会话时，回放 ctx.sessions.get(id).events 重建状态      │
│   （页面刷新后列表自动恢复；seq 水位线去重，幂等）               │
│ 围栏 API：isTrustedApiRequest（loopback/trustedHosts + 同源）   │
└───────────────────────────────────────────────────────────────┘
┌ Sidebar Review 标签 (betterSidebar.registerTab, 惰性注册) ─────┐
│ 左：本轮修改文件列表（badge=新建/处数，↗ 在编辑器打开）          │
│ 右：选中文件逐处 diff（行级 LCS，绿=新增 红=删除 灰=上下文）     │
│ 打开逻辑：betterSidebar.openTab（meta 或选择store 聚焦单文件）  │
│ 降级：无 better-sidebar → workspaces.openPath 系统打开          │
└───────────────────────────────────────────────────────────────┘