dsh-rollback-withdraw
面向 DeepSeek Harness Web 的 Trae 式会话撤回插件。 在每条用户提问与助手回答旁提供一键撤回按钮：把工作区代码与会话本身（记忆、轨迹、目标）整体回滚到该消息之前的最后一个完整回合。
它能做什么
DSH Web 会话中每个已完成的回合都会自动成为一个回滚点。点击任意消息旁的撤销图标，工作区文件即恢复到该消息之前最后一个完整回合的状态，同时会话在该处分叉并自动打开回滚后的对话——仿佛那段交流从未发生过。
- 工作区代码：通过最佳可用后端恢复（见下）。
- 会话：在边界处 fork 出子会话并打开；模型记忆、轨迹、目标与子代理血缘都与那一刻完全一致。
- 原生 git 集成：工作区是 git 仓库时，回滚点就是真实提交，撤回 =
git reset --hard+ 安全的git clean。
功能特性
- 每条消息都可撤回——用户气泡下方、每个已完成回合的最后一条助手消息旁。
- 双恢复后端，自动选择：
- git 模式（默认开启，一键切换）：每回合结束提交
rollback checkpoint；撤回用git reset --hard+ 保留依赖/构建目录的git clean。空间高效、与常规 git 工作流一致。 - 文件快照模式：否则在每回合结束生成硬链接快照——未变更文件跨快照共享同一副本，保留几百轮历史几乎零成本。
- 按工作区开关——会话头部 git 分支图标一键切换 git 自动提交；选择持久化在
.dsh-rollback/config.json。 - 随客户端启动自动加载——以 web profile bundle（
dsh.bundle+dsh.client）形式打包，重启无需重新激活。 - 两步确认——第一次点击进入"确认"状态（按钮变红），再次点击才执行，杜绝误撤回。
环境要求
| 项目 | 说明 |
|---|---|
| 操作系统 | Windows（依赖 robocopy 与 PowerShell 5.1+）；其他平台规划中 |
| Git | 可选——仅 git 模式需要 |
| DSH | web profile（dsh web） |
安装
# 从 npm 安装
dsh plugin --profile web add dsh-rollback-withdraw
# 或从本仓库安装
dsh plugin --profile web add github:dyhyfjn/dsh-rollback-withdraw
# 或本地构建
npm pack && dsh plugin --profile web add ./dsh-rollback-withdraw-0.1.0.tgz
安装后重启 Web 应用——插件集变更需重启生效。
使用方法
- 照常与 agent 对话；每个回合完成后自动记录一个回滚点。
- 悬停消息并点击撤销图标——第一次点击进入"确认"（变红），再次点击执行。
- 工作区恢复，界面切换到分叉后的回滚会话，从这里继续。
会话头部的 git 分支图标表示 git 模式状态：
- 点亮（品牌色 + 右下角绿点）= git 自动提交开启；
- 灰暗 = 关闭，或工作区不是 git 仓库（悬停有提示）；
- 工作区无 git 仓库时按钮禁用。
工作原理
- host 半部监听
session/event，在每个turn/end记录检查点——git 提交，或硬链接快照（存放在<工作区>/.dsh-rollback/snap/<会话>/<序号>/）。 - 客户端按钮通过同源 HTTP 路由
/rollback/rpc调用 host（静态插件通道，替代动态插件的harness.handle）。 - 撤回流程：校验边界（该消息之前最近的
turn/end）→ 恢复文件 → 客户端在对应序号 fork 会话并打开子会话。 - 会话第一条消息无法撤回（没有更早的回合）；插件安装前的消息没有快照——按钮会说明原因。
配置
| 配置项 | 位置 | 默认 | 含义 |
|---|---|---|---|
gitAutoCommit |
<工作区>/.dsh-rollback/config.json |
true |
工作区为 git 仓库时，用 git 提交作为回滚点 |
忽略路径（不纳入快照/提交/删除）：node_modules、.git、dist、build、.next、.venv、__pycache__、.idea、.vscode、coverage、*.pyc、*.log 等（详见 lib/index.js 中 IGNORE_DIRS / IGNORE_FILES）。
安全说明
/rollback/rpc 是本机 web 服务器上的同源、无鉴权路由——本插件假定仅个人、仅本机使用。请勿将 harness 端口暴露到不可信网络。
已知限制
- 优先支持 Windows（robocopy + PowerShell）；macOS/Linux 回退方案规划中。
- git 模式执行整仓库
git reset --hard+git clean（保留忽略目录）——回滚会删除未跟踪且未被忽略的文件。 - 撤回助手回答时也会一并回滚其前置提问（回到上一个完整回合结束点）；平台分叉原语只能在回合边界切割。
- 源会话保留在侧栏作为分支；不做自动归档。
开发
npm pack # 生成可发布的 tarball
node --check lib/index.js lib/client.js # 语法检查
许可证
MIT — 见 LICENSE。
