Skip to content

About

dsh (deepseek-harness) session-snapshot/undo plugin: snapshot at turn start, in-place undo without forking the conversation, prompt refill, and an expandable turn-collapse badge.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dsh-session-undo

本轮的"撤销"插件(dsh web profile):每条已闭合轮次的用户消息下方都有 "回滚本轮"按钮——点击后可以还原该轮对工作区的修改,并把你的提问回填 到输入框,改完重发。会话日志本身永不改动——聊天内容、工具记录原样保留; 回滚后的该轮气泡折叠成一个"已回滚"徽标(纯前端展示,历史不删),跨刷新保持。

你发提问 ─▶ turn/start ─▶ [插件快照工作区] ─▶ 模型运行 ─▶ 工具改文件 ─▶ turn/end
                                                          ▲
        (轮次闭合后)你消息下出现"回滚本轮":还原文件 + 提问回填输入框
        确认后:该轮气泡折叠 + 显示"已回滚"徽标;点击徽标可展开看回复(历史原样保留)
  • 备份先于修改:turn/start 时对 cwd 拍照(模型还没跑、副作用还没发生)。
  • 还原:被改文件写回原字节、被删文件重建、本轮新建文件删除(删除前有打勾复核清单)。
  • 只动工作树,不动会话:无 fork、无 truncate、无日志篡改。
  • 折叠 + 徽标(可展开):回滚成功后,该轮模型/工具气泡立即折叠(data-dsu-undone 隐藏),你的消息处显示"已回滚"徽标——纯前端展示,由 user-actions 座位组件用本地状态 驱动(渲染即生效),日志与气泡数据一概不动。点击徽标即可展开查看该轮回复,再点收起; 已回滚状态持久在侧存储(宿主 undoneTurns),刷新后仍折叠。
  • 按钮位置:用户消息操作条里的 ← 左箭头图标,排在复制按钮之前 (conversation.chat.user-actions list 座位,由 tools/patch-user-actions.mjs 打入 ui-conversation 客户端 bundle;仅已闭合轮次显示,点击展开复核浮层)。

包结构

dsh-session-undo/
├── package.json            # dsh.bundle(profile 图层)+ dsh.client(浏览器半身)+ ./client 导出
├── cordis.patch.yml        # 一行宿主行: - id: session-undo(insert 语法)
├── lib/
│   ├── index.js            # 宿主半身:session/event 快照 + /dsh-session-undo 路由(previewUndo/undoTurn/undoneTurns)+ 已回滚标记
│   ├── snapshot.js         # 纯 Node 快照引擎:扫描/差分/计划/还原(可独立单测)
│   └── client.js           # 浏览器半身:user-actions"回滚本轮"按钮 + inputActions.setDraft 回填 + 折叠/已回滚徽标(本地状态驱动)
├── tools/
│   └── patch-user-actions.mjs  # 幂等补丁脚本:给 ui-conversation 植入 user-actions 座位(可 --revert)
└── test/
    ├── snapshot.test.mjs   # 引擎确定性单测(11 项:差分/计划/还原/keep/越限/防穿越/清空目录)
    ├── driver.mjs          # 集成场景驱动器(子进程,只执行不断言)
    └── plugin.test.mjs     # 集成测试(断言子进程的单行 JSON 结果)

API(宿主路由)

POST /dsh-session-undo/previewUndo { sessionId, turn } → { ok, value: { prompt, snapshot, plan: { restore, recreate, delete, skippedOverCap } } } POST /dsh-session-undo/undoTurn { sessionId, turn, keep? } → { ok, value: { restored, recreated, deleted, kept, prompt } } (成功后会把状态标记进记录,供客户端恢复折叠/徽标。) POST /dsh-session-undo/undoneTurns { sessionId } → { ok, value: { sessionId, turns: [<turnNo>...] } }(本会话已回滚的轮次集合)

错误码:session-not-found / turn-not-found / turn-open / busy / snapshot-absent / no-cwd / bad-request / method-not-allowed / bad-json / body-too-large / internal。

工作区根的确定:插件在 turn/start 对会话的工作区根做一次整树快照。工作区根 由 sandbox 策略解析(ctx.sandboxPolicy.resolve({ session }).workspaceRoot: 有 cwd 用会话 cwd,无 cwd 则回退到配置的默认根),并兜底到 session.header.cwd; 只有两者都拿不到绝对路径才跳过。因此无 cwd 的子代理/任务会话也能拍照(落在 sandbox 策略解析出的根上),而不再因为缺 header.cwd 就整体跳过。

为何会"没有快照":若该轮 turn/start 时连 sandbox 策略都解析不出绝对工作区根,或 该轮发生在插件开始监听之前,就没有快照——此时回滚返回 no-cwd(无根可还原)或 snapshot-absent(缺该轮快照)。

快照存储(默认 $DSH_HOME/session-undo,可用 DSH_SESSION_UNDO_ROOT 或行配置 sideRoot 覆盖):

session-undo/
├── records/<session>@<createdAt>/turn-<n>.json   # 索引 + createdAfter 增量
└── blobs/<sha256>                                 # 内容寻址字节(全局去重)

记录条目 turn-<n>.json 的 createdAfter 记录"本轮新建"的文件(turn/end 差分), 供删除复核清单区分"agent 建的(默认勾选删除)"与"非本轮出现的(默认保留)"。 回滚成功后记录追加 undone: true(客户端据此恢复"已回滚"折叠/徽标,undoneTurns 路由据此返回集合)。

配置

# cordis.patch.yml 或 profile 的 cordis.patch.yml
- id: session-undo
  name: 'dsh-session-undo'
  config:
    sideRoot: !!js process.env.DSH_SESSION_UNDO_ROOT   # 可选
    # exclude / maxFileBytes 目前不作为正式 Config 字段(读 config 但绕过 schemastery 校验)

默认排除目录:.git node_modules target dist build out .venv venv .tox __pycache__ .next .nuxt .cache coverage .DS_Store;单文件上限 20 MiB(超限文件在预览中标为 skippedOverCap,不还原)。

开发与部署

部署到当前 GUI 所在 profile(本机已完成,含核心补丁):

cd /root/dev/dsh-session-undo
# 1) 插件两大半身 + 补丁脚本装进 profile(本机已执行)
tar -cf - --exclude='node_modules' -C . lib tools package.json README.md cordis.patch.yml \
  | tar -xf - -C /app/dsh-home/profiles/web/node_modules/dsh-session-undo

# 2) 核心补丁:给 ui-conversation 植入 user-actions 座位(幂等;dsh 升级后重跑)
node tools/patch-user-actions.mjs

# 3) 刷新浏览器页面(Ctrl/Cmd+Shift+R)即生效:
#    页面清单、核心 bundle、插件 bundle 均为 per-request 读取(no-cache)。
#    回滚按钮在"已闭合轮次"的你的消息正下方;早于插件安装的轮次点击会提示无快照。
#    注:已回滚的持久化(宿主端 undoTurn 打标 + undoneTurns 路由)需重启服务端进程才生效;
#    仅即时折叠/徽标(客户端 bundle)无需重启——刷新即出现。
  • 浏览器半身由 dsh-client-modules 扫描 dsh.client 元数据后经 /plugins/dsh-session-undo/client.js 服务;宿主行与浏览器行是同一行 (dsh-client-connection 的同款双面模式)。RPC 走宿主 webServer 路由 (与 /api 网关分开,不依赖 typert 生成器)。
  • 方案 A 补丁说明:user-actions 座位目前是本地补丁(安装目录内的文件, 版本升级/重装会覆盖,重跑 tools/patch-user-actions.mjs 即恢复);干净方案 是给 deepseek-harness 上游提交 conversation.chat.user-actions 插槽 PR。 --revert 可用原备份还原;备份位于 bundle 同目录 *.dsh-session-undo.bak。

测试

node test/snapshot.test.mjs   # 引擎确定性单测(必须先绿)
node test/plugin.test.mjs     # 端到端集成(子进程隔离,断言驱动器的单行 JSON)

已知环境限制:该运行环境对"同进程紧凑文件操作"偶发 ENOENT/stale 视图(rm 追踪与外部目录 旁观已验证项目代码无任何删除路径),集成测试因此采用子进程执行 + 失败整轮重试(新目录), 语义等价于用户重试一次。引擎单测不受影响、完全确定。

语义边界(有意为之)

  • 还原"第 N 轮"= 回到第 N 轮起点的快照,N 之后的轮次对该工作区的改动一并回退(复核清单会列出)。
  • 不覆盖 cwd 之外的文件(绝对路径副作用)、非文件副作用(命令/网络/job/tmux)。
  • 事件词汇表封闭,插件不向会话日志写任何自定义事件——撤消点全部在侧存储。

About

dsh (deepseek-harness) session-snapshot/undo plugin: snapshot at turn start, in-place undo without forking the conversation, prompt refill, and an expandable turn-collapse badge.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages