dsh-session-rewind
Verifieddsh-session-rewind · v1.6.1 · MIT · Web UI
Rewind a finished Turn: branch the conversation at any Turn (session header or per-Turn control) and restore every workspace file that Turn changed. · 回合回退:从任意已完成的回合重新开始,并把该回合改动过的工作区文件恢复原状。
Install
dsh plugin add dsh-session-rewind Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Readme
dsh-session-rewind · 会话回退
A DSH Web plugin that adds an always-visible action beside each user message. Completed Turns can be rewound in place; active or stopped Turns can be paused and edited.
DSH Web 每条用户消息旁常显一个操作按钮:已完成回合显示 ↶,点击可就地回退;未完成或已停止回合显示铅笔,点击会暂停并撤回旧消息,将原文放回输入框供编辑重发。
操作
- 已完成回合 ↶:撤回该消息及之后的上下文,原文回到输入框;可选同时恢复本插件记录到的文件改动。
- 未完成/已停止回合铅笔:停止生成,撤回原消息并将原文放回输入框;编辑后发送,界面与模型上下文只保留新版本。
- 对话日志只追加 marker,不物理删除事件;已撤回的消息仍可在轨迹中检查。
- 文件恢复只覆盖通过 DSH filesystem mutation hooks 捕获的变更;shell/git 和直接绕开这些 hooks 的写入不在保证范围内。
Install · 安装
从插件市场安装(推荐):左侧 插件 → 发现(Discover) → 索引源 → 添加
https://raw.githubusercontent.com/2310770803/dsh-session-rewind/main/index.json
→ 搜索 rewind 或 会话回退 → 安装。索引格式与发布流程见 docs/publishing.md。
本机(profile desktop)已把这个索引源写进 cordis.patch.yml,打开「发现」即可看到条目。
从源码目录安装(本机当前就是这种方式):
// plugin_manager
{ action: 'install_bundle', target: 'E:\\DeepSeek Harness\\dsh-session-rewind' }
How it is put together · 实现
| half | mechanism |
|---|---|
| conversation | Client DOM bridge on the user-message row; completed Turns use the in-place surface replace route, while active/stopped Turns use the edit route and composer facade |
| files (capture) | fs/write-intent / fs/edit-intent waterfalls ({ prepend: true }), with the tool execution mapped back to its Session through a tools/pre-execute WeakMap — the same coupling workspace-changes uses |
| files (restore) | text pre-images through the fs service (path resolution, locks, version guard); binary pre-images and deletions through Node, on the archive's own recorded absolute path |
Where data lives · 数据位置
$DSH_HOME/plugin-data/dsh-session-rewind/
index.json per-session, per-Turn file records
blobs/<sha256>.bin the pre-Turn bytes
Nothing leaves the machine: the four Host routes are loopback-only,
same-origin /api routes with DSH Web's own Host/Origin trust fence.
GET /api/session-rewind.selfcheck reports what the running Host has actually
wired up (archive totals, whether the Web half is in the boot graph, the route
list). It is read-only and never exposes session content.
Limits · 限制
- Only mutations that go through the DSH filesystem service inside a Turn are
captured. Files changed by a shell command, by
git, or outside a Turn are not recorded and therefore not restored. - Files written by tools that bypass the
fswrite-intent waterfall are not captured either: the Office tools (word_create,excel_update, …) call the filesystem service directly, so a.docx/.xlsxthey produce is not in the archive and cannot be rewound. Plain text, Markdown, and source code edited through thewrite/edittools are covered. - A Turn snapshots at most 200 files, and no pre-image larger than 2 MiB; larger files are listed as "not restorable" instead of being silently skipped.
- Files inside
.gitare never captured, so a restore cannot corrupt the repository. - The archive keeps the newest 400 Turns; older records are pruned with their blobs.
- A restore writes the recorded content back. It does not re-run anything, and it does not delete files the Turn merely modified.
- A plugin-originated write has no Agent context, so the
fsservice refuses it by default. Restores rebuild the policy from the Turn's own workspace (workspace-write) and widen todanger-full-accessonly for a path the archive recorded outside it. - Capture starts with the Turn that is open when the plugin mounts: a Turn already running at install time is recovered from the live log tail, but a plugin loaded later than the Turn's first write cannot see earlier mutations.
- The plugin-list metadata and client notices are localized in Chinese and English.
Tests · 测试
The package ships the suites used to verify it; they need no browser and no profile:
node test/selftest.mjs # surface planning, archive and restore
node test/edit-smoke.mjs # active edit cancellation and surface replacement
node test/route-smoke.mjs # routes, trust fences and path allow-listing
node test/client-smoke.mjs # single bridge host and message action wiring
Package layout
| file | role |
|---|---|
cordis.patch.yml |
inserts the session-rewind plugin row |
src/index.js |
Host entry |
src/plugin.js |
Host wiring, capture hooks and API routes |
src/lib/archive.js |
durable pre-Turn archive and blob store |
src/lib/inplace.js |
active edit and in-place rewind execution |
src/lib/restore.js |
restore one captured file |
src/lib/route.js |
HTTP routes and trust fence |
src/lib/surface.js |
surface planning, markers and withdrawn-turn calculation |
lib/client.js |
hidden bridge host and per-message edit/rewind control |
locale/*.json |
plugin-list metadata |
index.json |
format-1 plugin-market index |