conversation-rollback

Codex-style conversation rollback and "edit input, then re-generate" for the DeepSeek Harness (DSH) Web UI.

English · 中文

---

English

conversation-rollback is a DSH Web plugin that rewinds a conversation log to a completed-turn boundary (Codex-style rewind) and can also edit a previous user message and drive the model again from that point.

Features

• Edit input: the entry point lives in the user message bubble action row, next to the copy button (✎). Clicking it opens an inline editor. On save, the host truncates the session log to just before that turn and pushes the edited text through the Agent inbox as a new message so the model regenerates the answer. The original reply and all later turns are deleted.
• Rollback to here: the entry point lives at the bottom of an assistant answer, next to the "branch in new chat" button (↩, with a second-click confirmation). It deletes every message after that turn and continues the conversation in place.
• The latest completed turn only shows Edit input; rollback is not offered there.
• Editing inputs that contain images is not supported yet.
• Actions are unavailable while the session is running, for subagent sessions, and when an unfinished turn exists.

Both operations are destructive and cannot be undone: the original reply and all subsequent messages are permanently removed.

Endpoint

POST /api/conversation-rollback

• Rollback: { "sessionId": "...", "atSeq": <any seq inside a completed turn> }
• Edit: { "operation": "edit", "sessionId": "...", "turn": <turn number>, "text": "..." }

Requirements

• A working DSH installation with the web profile (dsh web).
• pnpm available on your PATH for dsh plugin management.
• git is required for the GitHub install and the local clone; npm is only required for the npm pack option.

Installation

Install from GitHub (recommended)

dsh plugin --profile web add github:sharedcare/dsh-conversation-rollback

dsh plugin adds the package to the selected profile and automatically registers the bundle patch layer. If you maintain a fork, replace sharedcare with your GitHub username or use the full repository URL:

dsh plugin --profile web add "git+https://github.com/<owner>/dsh-conversation-rollback.git"

To pin an exact commit or tag, append #<commit-or-tag> to the full git URL.

Install from a local clone or tarball

For development, or if you prefer to build the package yourself:

git clone https://github.com/sharedcare/dsh-conversation-rollback.git
cd dsh-conversation-rollback

Option A — link this checkout directly into the profile (useful while developing):

dsh plugin --profile web add "$PWD"

Option B — install a packed tarball:

npm pack
dsh plugin --profile web add ./conversation-rollback-<version>.tgz

Replace <version> with the version printed by npm pack (for example 1.3.0).

Activate and verify

1. Restart the DSH Web process so the host route and browser client are loaded.
2. If the profile's cordis.patch.yml ($DSH_HOME/profiles/web/cordis.patch.yml, default ~/.dsh/profiles/web/cordis.patch.yml) still contains a hand-written - insert: conversation-rollback entry from an older setup, remove it — the installed bundle patch adds that entry automatically.
3. Verify the plugin is installed and loaded:

dsh plugin --profile web list
dsh web --dump-config | grep conversation-rollback

The dump should show the bundle section and an entry with id: conversation-rollback.

Uninstall

dsh plugin --profile web remove conversation-rollback

Restart the DSH Web process afterwards. To upgrade a git-based install, remove it and run the add command again with the desired commit/tag.

Files

• cordis.patch.yml: bundle patch; the installer inserts the plugin entry automatically.
• lib/index.js: host-side HTTP route, log truncation, live-session splicing, and Agent re-driving.
• lib/client.js: browser side; injects conversation.chat.user-actions (edit input) and registers conversation.chat.assistant-actions (rollback) through a low-priority shadow renderer without modifying any upstream package.

Host dependencies are provided by the DSH bundles themselves (@deepseek-ai/dsh-session, @deepseek-ai/dsh-llm); the plugin does not pull in its own copies of those packages.

Troubleshooting

• If "Save and regenerate" fails with Cannot read properties of undefined (reading 'adapterDefaults'), the live Agent still cached state from the truncated log. Restart the Web process so the current lib/index.js is loaded; this version resets the session request/context folds, derived message caches, agent.requestHeaderLogged, and runtime-context projections after splicing.
• If the buttons do not appear after installation, restart DSH Web, run the verification commands above, then hard-refresh the browser page.
• If dsh plugin add fails for a git-hosted fork that adds a prepare/postinstall script, follow the allowBuilds hint printed by pnpm and add the exact key to $DSH_HOME/profiles/web/pnpm-workspace.yaml, then re-run the install. The upstream package has no build scripts, so the standard GitHub install needs no extra approval.

---

中文

conversation-rollback 是一个 DSH Web 插件：既能把会话日志回退到某个已完成 回合的边界（Codex 风格），也能修改之前的用户输入，并从该位置重新驱动模型 生成。

功能

• 修改输入：入口在用户输入气泡的操作行里，紧挨着复制按钮（✎）。 点击后弹出内联编辑框；保存时宿主会把日志截断到该轮之前，再通过 Agent inbox 以新消息驱动模型重新生成。原回复和后续轮次都会被删除。
• 回退到此：入口在助手回答尾部的操作行里，紧挨着「在新对话中 分支」按钮（↩，需二次点击确认）。删除该轮之后的所有消息并原地继续。
• 最新的已完成轮次只显示「修改输入」，不显示回退。
• 包含图片的输入暂不支持修改。
• 会话运行中、子代理会话、存在未结束回合时不可操作。

两种操作都是不可撤销的破坏性操作：原回复及其后的所有消息会被永久删除。

端点

POST /api/conversation-rollback

• 回退：{ "sessionId": "...", "atSeq": <完成轮次内任一 seq> }
• 修改：{ "operation": "edit", "sessionId": "...", "turn": <turn number>, "text": "..." }

环境要求

• 可正常启动 web profile 的 DSH 环境（dsh web）。
• PATH 中有 pnpm，供 dsh plugin 管理插件使用。
• GitHub 安装和本地 clone 需要 git；只有使用 npm pack 方式时才需要 npm。

安装

从 GitHub 直接安装（推荐）

dsh plugin --profile web add github:sharedcare/dsh-conversation-rollback

dsh plugin 会把包加入所选 profile，并自动注册 bundle patch 层。如果你维护 自己的 fork，把 sharedcare 替换成你的 GitHub 用户名，或使用完整仓库地址：

dsh plugin --profile web add "git+https://github.com/<owner>/dsh-conversation-rollback.git"

如需固定到某个 commit 或 tag，在完整 git URL 末尾追加 #<commit-or-tag>。

从本地克隆或 tarball 安装

适合二次开发，或希望自行打包的场景：

git clone https://github.com/sharedcare/dsh-conversation-rollback.git
cd dsh-conversation-rollback

方式 A：直接把当前 checkout 链接进 profile（适合边改边调试）：

dsh plugin --profile web add "$PWD"

方式 B：先打包，再安装生成的 tarball：

npm pack
dsh plugin --profile web add ./conversation-rollback-<version>.tgz

请把 <version> 替换为 npm pack 输出的版本号（例如 1.3.0）。

启用并验证

1. 重启 DSH Web 进程，以加载 host 路由和浏览器端 client。
2. 若 profile 的 cordis.patch.yml（位于 $DSH_HOME/profiles/web/cordis.patch.yml，默认是 ~/.dsh/profiles/web/cordis.patch.yml）里还留有旧方案的手工 - insert: conversation-rollback 行，请删掉；安装后的 bundle patch 会 自动插入该条目，手工行会和它重复。
3. 验证插件已安装并已加载：

dsh plugin --profile web list
dsh web --dump-config | grep conversation-rollback

配置 dump 中应出现 bundle 分节，以及 id: conversation-rollback 条目。

卸载

dsh plugin --profile web remove conversation-rollback

卸载后重启 DSH Web 进程。基于 git 安装时，如需升级，先执行上面的 remove， 再用目标 commit/tag 重新执行 add。

文件

• cordis.patch.yml：bundle patch，安装时自动插入插件行。
• lib/index.js：host 端 HTTP 路由、日志截断、live Session 拼接、Agent 再驱动。
• lib/client.js：浏览器端通过低优先级 shadow renderer 注入 conversation.chat.user-actions（修改输入）并注册 conversation.chat.assistant-actions（回退），不修改任何上游包。

宿主依赖由 DSH 本体的 bundle 提供（@deepseek-ai/dsh-session、 @deepseek-ai/dsh-llm），插件不额外安装这些包。

故障排查

• 若「保存并重新生成」后出现 Cannot read properties of undefined (reading 'adapterDefaults')，说明 live Agent 仍缓存了被截断掉的 request/header 状态。重启 Web 进程加载当前 lib/index.js；该版本会在 拼接日志后重置 session 的 request/context fold、派生消息缓存、 agent.requestHeaderLogged 和 runtime-context 投影。
• 安装后看不到按钮：重启 DSH Web，执行上面的验证命令，然后强制刷新浏览器 页面。
• 如果你的 fork 新增了 prepare/postinstall 脚本，dsh plugin add 安装 git 依赖时被 pnpm 拦截，请按 pnpm 打印的提示把对应 key 加入 $DSH_HOME/profiles/web/pnpm-workspace.yaml 的 allowBuilds，再重新执行 安装。上游包没有构建脚本，因此标准 GitHub 安装不需要额外放行。

Repository

• https://github.com/sharedcare/dsh-conversation-rollback
• License: MIT