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 安装本身，不在插件里复制）。
用起来是什么样
- 鼠标移到自己的某条消息上，气泡下面多一个铅笔图标；
- 点开变成内联编辑器：原文已在里面，光标在末尾，
⌘/Ctrl+Enter 确认、Esc 取消；
- 上方的图片缩略图与文件卡片可以逐个移除，
＋ 或拖拽可以补充新文件；
- 确认后：会话在这条消息所在的轮次之前分叉 → 留下的附件在子会话里重新落盘 →
模型选择继承过来 → 发送改写后的内容 → 视图切到子会话。
原对话不会被动过，那条消息之后的内容也不会保留（这就是「重发」的语义）。
实现要点（改代码前必读）
分叉切点（改这里之前先读完）
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/（回到纯源码状态）
构建做了四件事，顺序不能变：
- tsc 预编译宿主：
src/index.ts 用了标准装饰器（@Remote(…)）和 using，rolldown
只认 legacy 装饰器，直接喂 TS 会把 @Remote 原样留在产物里——Node 解析不了。
lib/index.js：从 tsc 产物打包，清单里声明过的 peer 留成 import，其余内联。lib/typert.host.js / lib/typert.remote-client.js：把预生成的清单打成自足
文件（连 zod 一起内联）。typert loader 在宿主启动时直接 import() 它，那里没有
node_modules 可依赖。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。
