conversation-rollback

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

[English](#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