编辑重发 iStarryDust/dsh-edit-regen

dsh-edit-regen

DeepSeek Harness 的编辑重发插件：用户消息气泡上多一个「编辑」，改完从那条消息重新生成；保留的图片与文件随行重传，新会话继承原会话的模型选择。

一个包，两半：

| 半端 | 文件 | 作用 |
| 宿主 | lib/index.js | 注册 editRegen 会话动作：授权读回文件字节、定位分叉边界、清理空壳会话 |
| 浏览器 | lib/client.js | 遮蔽官方 user 消息渲染器，加「编辑」入口与内联编辑器；自己把 remote.editRegen 挂到共享 remote 服务上 |

不依赖任何 Agent 管理能力：Remote 命名空间由本插件自己的浏览器半端 $mount，所以单独装它就能用。

安装

项目根目录本身就是可安装的包（lib/ 就在根上），所以两种装法都可以：

直接装目录（开发时最省事，link 过去的改动重启即生效）
dsh plugin --profile <名字> add E:/Plugin/发布版/dsh-edit-regen

或者打成 tarball 装（发布/给别人的形态）
pnpm pack
dsh plugin --profile <名字> add ./istarry-dsh-edit-regen-0.1.0.tgz

装完重启 dsh 宿主进程并刷新页面——客户端 bundle 在启动时组合。

要求 DeepSeek Harness 0.1.7-rc.2 / 0.2.x（宿主半端只依赖 @deepseek-ai/dsh-typert-protocol、 dsh-session、dsh-attachment，全部作为可选 peer，实例一律来自 dsh 安装本身，不在插件里复制）。

用起来是什么样

1. 鼠标移到自己的某条消息上，气泡下面多一个铅笔图标；
2. 点开变成内联编辑器：原文已在里面，光标在末尾，⌘/Ctrl+Enter 确认、Esc 取消；
3. 上方的图片缩略图与文件卡片可以逐个移除，＋ 或拖拽可以补充新文件；
4. 确认后：会话在这条消息所在的轮次之前分叉 → 留下的附件在子会话里重新落盘 → 模型选择继承过来 → 发送改写后的内容 → 视图切到子会话。

原对话不会被动过，那条消息之后的内容也不会保留（这就是「重发」的语义）。

实现要点（改代码前必读）

分叉切点（改这里之前先读完）

rewriteBoundary 只有一个合法切点：前一个轮次自己的 turn/end。

- 不能在「下一个 turn/start 减一」处切；
- 也不能在「seq 减一」处切；
- 这条消息之前没有已完成的轮次时（它本来就是第一条消息）必须返回 null，让客户端走「干净新建」。

原因：那条消息之前的空隙里不只有会话开场事件，还有用 queue 模式发消息时写下的 agent/inbox/spliced——它承载着源会话自己的待发消息。在空隙处分叉会把它们原样搬进子会话的收件箱，子会话的下一轮再把它们当成注入的用户消息发一遍。

症状：编辑第一条消息重新生成，会连着发两次。

这个坑踩过两次：套件里 agent-preset-authoring 的那份 rewriteBoundary 早就改成 lastTurnEnd ?? null 了，而同一份代码在从未被挂载过的独立宿主包里还是老的 openTurnStart - 1 / seq - 1 兜底——独立插件直接复用了后者，于是修复丢了。
两处实现分叉是根因，改语义时两处必须一起改（本插件只有一处，别再分叉）。

附件为什么要重传

文件收据（receiptId）是按会话签发的，不能搬到子会话。所以：

- 留下的图片：走会话授权的 readAttachment 拿到字节，作为新的 image 内容块发出去；
- 留下的文件：宿主 readFileAttachment 读回原始字节（用会话事件日志做授权）→ 官方上传通道 remote.fileUploads 在子会话上换一张新收据；
- 新挑的附件：直接从浏览器上传。

发送被拒就丢壳

分叉出来的子会话只是进了目录、没有被持有。发送失败时会尽力 discardSession 清掉，所以一次失败的编辑不留痕迹。在会话存储不支持删除的运行时上（比如 0.1.7-rc.2 的 SessionPersistence 就没有删除 API），这一步会返回 edit-regen/remove-unavailable，前端降级为「留下一个空会话」——功能不受影响，只是多一条空对话。

宿主半端的服务一律用 ctx.get 软取

this.ctx.sessions 这种属性访问是按 fiber 注入检查过的：本插件只 inject 了 attachments，读别的服务会当场抛

cannot get property "sessions" without inject

而且它会被网关包成 gateway/internal 抛到前端，看起来像「远端挂了」。所以除了 attachments 之外一律 this.ctx.get('sessions') / get('sessionQuery') /
get('sessionPersistence') 软取。

别在宿主半端声明浏览器服务

客户端包（dsh.client）的宿主行不许 inject slots / locale / workspaces / uiWorkspace / remote——那些服务在浏览器平面上，宿主行永远等不到，插件页就会显示「等待依赖」。本插件的宿主行只 inject attachments。

仓库结构

四层分开，别混：

dsh-edit-regen/
├── package.json 发布清单（dsh.bundle.patch + dsh.client 都在这里） ├── cordis.patch.yml 挂载补丁：一行 insert ├── icon.svg / locale/ 插件页的图标与文案 │ ├── src/ ① 手写源码 │ ├── index.ts 宿主半端：editRegen 服务 │ ├── types.ts 线上请求/返回值类型 │ └── client/ 浏览器半端：index / actions / EditRegenView / locales / css │ ├── vendor/typert/ ② 预生成的线上契约（host.js / remote.js，别手改） │ ├── build.mjs ③ 构建 ├── build/ client / host / platform / tsdown 预设 ├── tooling/ 构建工具链（独立安装，见下） │ └── lib/ ④ 产物（git 不跟踪，构建生成；这个包的运行时入口）

lib/ 是产物：.gitignore 里已经排除，仓库里不留；但本地必须有它才能跑（main、exports、dsh.client 都指向它）。随时可用 npm run clean 删掉、 node build.mjs 重建。

不要另建 dist/：main、exports、dsh.client 全部按「包根 = 本目录」写的。
以前产物放在 dist/ 时，dsh plugin add <项目根> 会把一个没有 lib/ 的 package 装进去——插件页显示「已安装」，两半却都加载不到，气泡上自然没有编辑按钮。

构建

cd tooling && pnpm install # 首次
cd .. && node build.mjs # 全量：tsc → 三个 tsdown 目标 → 校验 → 写 lib/
node build.mjs --check # 只构建 + 校验，不写 lib/
node build.mjs --staging # 产物留在 .build/out，不动 lib/
npm run clean # 删掉 lib/ 与 .build/（回到纯源码状态）

构建做了四件事，顺序不能变：

1. tsc 预编译宿主：src/index.ts 用了标准装饰器（@Remote(…)）和 using，rolldown 只认 legacy 装饰器，直接喂 TS 会把 @Remote 原样留在产物里——Node 解析不了。
2. lib/index.js：从 tsc 产物打包，清单里声明过的 peer 留成 import，其余内联。
3. lib/typert.host.js / lib/typert.remote-client.js：把预生成的清单打成自足 文件（连 zod 一起内联）。typert loader 在宿主启动时直接 import() 它，那里没有 node_modules 可依赖。
4. lib/client.js：CJS 工厂壳 + lightningcss 编译的 CSS Modules，只把模块表里的名字留成 require()。

校验闸（build.mjs 的 validate()）：产物语法（node --check）、宿主只 import 已声明的包、浏览器只 require 平台模块表里的名字。这三种故障都只在部署后暴露。

typert 清单是预生成文件

vendor/typert/host.js / remote.js 由 @deepseek-ai/dsh-typert-generator 从宿主源码生成，里面硬编码了包名与三个方法名。改了 editRegen 的方法签名或增减方法，必须重新生成，否则启动时报：

typert-loader: TYPERT manifest names package ... must be owned by the package that exports it

或者网关按旧 schema 校验参数、把新参数判成 gateway/argument-invalid。

工具链单独装在 tooling/

package.json 是要发出去的清单，里面不能出现 workspace: / file: 之外的构建依赖；所以 tsdown / typescript / lightningcss / zod / @types/ 单独装在 tooling/。
build.mjs 每次会把 zod、@types/ junction 到 node_modules/（rolldown 要从导入方所在目录解析 zod，编辑器的 @types 也需要）——junction 指向物理目录，指向 pnpm 的符号链接在 Windows 上解析不到东西。

排错

| 现象 | 看哪里 |
| 插件页显示「已安装」，气泡上却没有铅笔 | 先确认 node_modules/@istarry/dsh-edit-regen/lib/index.js 真的存在——装成了没有 lib/ 的目录就是这样：两半都加载不到，但插件页不报错 |
| 插件页显示「等待依赖」 | 宿主行 inject 了浏览器服务，或者 attachments 服务没起 |
| 页面空白 / 插件不出现 | node build.mjs --check 看产物；浏览器控制台里 web boot: … did not activate 才是真因 |
| 气泡上没有铅笔图标 | 会话在运行中或是子智能体会话（两者都禁用编辑）；或官方改了 conversation.chat.node 的注册契约 |
| 点了「重新生成」报 editRegen remote is unavailable | 浏览器半端没有挂上命名空间：确认 lib/typert.remote-client.js 存在，且 dsh.client 行是「运行中」 |
| 点了「重新生成」报 cannot get property … without inject | 宿主半端直接读了 ctx.<服务>，改成 ctx.get('<服务>') |
| 重发报 attachment-invalid | 那条消息里的文件不再被该会话引用，或超过 128MB 读回上限 |
| 报 edit-regen/remove-unavailable | 运行时存储不支持删除会话（0.1.7 就是），属预期降级 |

许可

MIT，见 LICENSE。