caoTbenren0 / dsh-edit-resend

dsh-edit-resend

编辑已发送的用户消息并重新发送 —— 从该消息所在回合 fork 出一个新分支，用编辑后的文本重新生成回复。原会话自动归档，可在设置页一键恢复。

Edit a sent user message and resend it: fork a new branch from that message's turn and regenerate the reply with the edited text. The original session is archived automatically and can be restored from the Settings page.

A DeepSeek Harness (DSH) plugin for 0.1.0-rc.6 that adds edit-and-resend to any completed turn, built on the cordis plugin system and the Typert Remote protocol.

---

✨ 功能特性 / Features

• 回合尾部编辑入口 — 每个已完成回合的尾部出现 ✎ 编辑本轮消息并重发 按钮（不替换官方 UI，纯增量注入）
  Edit entry on every completed turn tail — an additive ghost button, the official bubble stays untouched.
• 读取该轮用户原文 — 从 Host 的全量事件日志定位该轮的用户消息（客户端投影会截断长会话历史，因此不在客户端查节点）
  Reads the turn's original user text from the Host's full event log (the client projection window-truncates long sessions, so nodes are never looked up client-side).
• Fork 重发 — 以目标回合起点为界切割事件日志作为种子，创建子会话并发送编辑后的文本；历史不可改写，只 fork 新分支
  Forks a child session seeded with the event-log prefix before the target turn, then delivers the edited text as the first followup; history is immutable, so the reply is regenerated on a new branch.
• 自动归档原会话 — 重发成功后原会话自动归档（仅视图隐藏，日志与数据绝不删除）
  The source session is archived automatically after a successful resend — view-level hiding only, no data is ever deleted.
• 设置页恢复 — 设置页新增「编辑重发」分区，列出全部归档会话，一键恢复回侧边栏（官方 rc.6 没有 unarchive API，本插件补齐）
  A new "编辑重发" section in Settings lists every archived session with a one-click restore (official rc.6 has no unarchive API — this plugin fills the gap).

🚀 安装 / Installation

以 web profile 为例，其他 profile 同理。要求 DSH ≥ 0.1.0-rc.6。 Example uses the web profile; others work the same. Requires DSH ≥ 0.1.0-rc.6.

# 1. 安装插件（发布包或本地路径均可）
#    Install the plugin (published package or a local path both work)
dsh plugin --profile web add dsh-edit-resend

# 2. 把 cordis.patch.yml 中的 insert 行并入 profile 的 cordis.patch.yml
#    Merge the insert line from cordis.patch.yml into the profile's cordis.patch.yml
#    - id: edit-resend
#      name: 'dsh-edit-resend'

# 3. 重启 dsh web（Host 端改动必须重启；之后客户端改动只需刷新页面）
#    Restart dsh web (host-side changes require a restart; client-only changes
#    are picked up by a page refresh, the bundle is served with no-cache)

手动配置 / Manual configuration

将以下内容加入 profile 的 package.json 与 cordis.patch.yml：

// profiles/<name>/package.json
{
  "dependencies": {
    "dsh-edit-resend": "link:/absolute/path/to/dsh-edit-resend"
  },
  "bundles": {
    "dsh-edit-resend": "dsh-edit-resend"
  }
}

# profiles/<name>/cordis.patch.yml
- insert:
    - id: edit-resend
      name: 'dsh-edit-resend'

📖 使用 / Usage

1. 打开任意有已完成回合的会话 → 回合尾部点击 ✎ 编辑本轮消息并重发
   Open any session with completed turns → click ✎ 编辑本轮消息并重发 on the turn tail.
2. 编辑器会预填该轮的用户原文，修改后点击「保存并重发」
   The editor is pre-filled with the turn's original user text; edit it and click 「保存并重发」.
3. 界面自动切换到新 fork 分支并开始重新生成；原会话从侧边栏消失（已归档）
   The UI jumps to the new fork automatically; the source session disappears from the sidebar (archived).
4. 需要找回原会话：设置 → 编辑重发 → 找到对应会话 → 「恢复」
   To bring a session back: Settings → 编辑重发 → find the session → 「恢复」.

归档绝不删除数据：恢复后原会话回到原位置，日志完整保留。 Archiving never deletes data: a restored session returns to its original place with its full log intact.

🧩 工作原理 / How it works

层	机制
Host 端	EditResendService（cordis 服务，继承 TypertRemoteService）暴露 5 个 Remote 端点：edit / getText / archive / unarchive / listArchived。edit 从完整事件日志定位目标回合的 turn/start，切割出前缀作为 seed 调用 agents.create 创建子会话，attach 到原工作区，再以编辑后的文本触发 followup
Client 端	UMD bundle 注入两个 slot：conversation.chat.turnTail（链式，编辑按钮）与 settings.section（归档恢复列表）；通过 remote.editResend.* 调用 Host（第三方插件需自行 $mount Remote 贡献）
归档竞态	归档广播会清空"当前被归档的会话"，因此 client 先同步打开 fork、再归档原会话——归档到达时当前会话已是 fork，清空规则永不触发（详见 HANDOFF.md §3.5）

Layer	Mechanism
Host	EditResendService (a cordis service extending TypertRemoteService) exposes 5 Remote endpoints: edit / getText / archive / unarchive / listArchived. edit locates the target turn's turn/start in the full event log, seeds a child session with the retained prefix via agents.create, attaches it to the source workspace, and delivers the edited text as a followup
Client	A UMD bundle injects two slots: conversation.chat.turnTail (chain slot, edit button) and settings.section (archived-session restore list), calling the Host through remote.editResend.* (third-party plugins must $mount their own Remote contribution)
Archive race	The archive broadcast clears a current session that became archived, so the client opens the fork first and only then archives the source — by the time the broadcast lands, the current session is already the fork (details in HANDOFF.md §3.5)

📁 文件结构 / File layout

dsh-edit-resend/
├── lib/
│   ├── index.js          # Host 半：EditResendService（5 个 Remote 端点） / Host half
│   ├── client.js         # Client 半：UMD bundle（按钮 + 设置页） / Client half
│   ├── typert.host.js    # Host Typert 清单（schema + invocation + model）
│   └── typert.remote.js  # Client Remote 描述符 / descriptors
├── cordis.patch.yml      # bundle patch 声明
├── package.json
└── HANDOFF.md            # 开发记录与 root-cause 分析 / dev log & root-cause analyses

🔧 兼容性 / Compatibility

• DSH 0.1.0-rc.6（web profile 验证）
• peerDependencies：@deepseek-ai/cordis ^4.0.1、@deepseek-ai/dsh-agent ^0.1.0-rc.6、@deepseek-ai/dsh-typert-protocol ^0.1.0-rc.6
• 官方 rc.6 无 unarchive API/UI：设置页恢复由本插件实现（workspaceRegistry.setState + host/archived-sessions-changed 广播）

📄 License

MIT — 请同时参考 DeepSeek Harness 的许可条款。 See also the DeepSeek Harness license terms.