dsh-reply-forge v3
把 AI 说过的话改成你想让它说的，改完立即生效，不用重启。
连它脑子里那串思维链一起改。
DSH 桌面端（DeepSeek Harness）插件。会话里每条 AI 回复旁边多一个按钮，
点开就能改正文或思维链；改完写进去，这个会话之后的每一轮，模型都只认你改过的版本。
和 v1 / v2 的区别
| v1 | v2 | v3 |
|---|
| 改的是什么 | 页面显示 | 会话落盘文件 | 活会话对象 |
| 模型看得到吗 | 看不到 | 看得到 | 看得到 |
| 生效时机 | 立即（只对本机） | 要重启 DSH | 立即 |
| 能改思维链吗 | 不能 | 不能 | 能 |
| 实现 | localStorage 覆盖 | 改写 .jsonl.zstd | message projection |
v3 把 v2 的落盘改写包成了兜底分支：会话在内存里就直接写活会话（立即生效），
不在内存里才落盘。
前两代是独立仓库，与 v3 完全独立（独立插件 id / 前缀，可分别启用）：
三代可以分别启用，但不要同时启用——它们共用同一条消息操作条，同时开会挂出多条
（安装脚本默认会把更早的两代从 bundles 摘掉，见下）。
怎么用（快速版）
- 鼠标移到任意一条 AI 回复上，点「伪造」按钮；
- 在编辑器里选目标（可选本会话任意可编辑块——包括页面上看不见、折叠着的思维链）、
选写入方式（默认「自动」）；
- 改文本，点写入伪造。写入前会弹一次确认（复述这次会怎么生效），写完成功立刻可见。
两个出口：仅本机渲染（Ctrl+Enter，只改这一页的样子、模型看不见、可逆）与
写入伪造（改「模型看到的对话」，在线写活会话立即生效 / 落盘重启后生效，不可逆）。
完整的界面说明、写入方式对照表、常见问题见 使用说明.md。
关掉插件会不会把会话弄坏
标记齐全就不会——这个「不会」有前提。
reply-forge/patch 是宿主不认识的事件类型，宿主持久化层的准入闸门
validateStoredEvents 规定：未知类型且信封没带 ignorable: true → 抛错、
整条日志拒读（会话打不开）；投影层（插件在场时）对不认识的事件则直接跳过、
不报错，伪造退回原文。宿主自己的注释写明了这条路（known-event-types.js）：
The persisted SessionEvent.ignorable marker is the compatibility mechanism.
于是分三种情况：标记正确 + 冷启动（插件不在）→ 会话照常打开、伪造静默退回原文；
缺标记（早期写入或写盘损坏）→ 被闸门拒读，用修复工具补标记；插件在 DSH
运行时被热卸载 → 宿主抛 session message projection "reply-forge/patch" was removed（所以正常用法都要求重启 DSH，重启后干净重放，碰不到这条）。
v3 的 P0 工作就是把「标记正确」钉死：在线/落盘两条写路径进入宿主持久化前统一补
ignorable: true；每次真写前核验写句柄（WRITER_NOT_ROUTED 可安全回落盘、
APPEND_UNSAFE 一律拒绝，失败码表见 PLAN.md）；真宿主持久化闭环
测试 create → append → flush → 重读 → 闸门放行全过。
致谢与借鉴
dsh-chat-thinking-editor
是本插件重要的学习对象——它是 DSH 生态里最早做「思维链编辑」的探索者，
「改完立即生效」这个目标与它对用户的坦诚（PR 说明里明确写
「编辑过的会话包含插件自有事件，卸载插件后该会话可能无法读取」）都给了我们
直接的启发。两条路线的差别在技术选择：它早期版本把编辑挂在 assistant/message
上并带 surfaceOp，那类事件在插件缺席时仍会被宿主做 surface 校验，校验不过就抛；
v3 因此走了另一条路——自有事件 + 同类型 projection + ignorable 标记
（见上一节）。没有高下之分，只是约束下的不同取舍；站在它的肩膀上，
我们把「卸得干净」这件事做得更彻底了一点。
万一会话已经被弄坏：退出 DSH，双击 修复会话.bat 先看诊断（只读，不动文件），
确认后再 修复会话.bat apply 补上 ignorable: true——工具先备份、只改有毒行、
写完自读复验、修不好自动还原、修不了的旧伤明确报出而不是硬改。关插件的完整说明与
安全排障见 使用说明.md。
安装
前提：已装 DSH 桌面端；另需 Node.js（安装/启用/关闭/修复四个 bat 靠它改静态
配置——bat 会自动探测 PATH、C:\Program Files\nodejs、%LOCALAPPDATA%\Programs\nodejs
与 DSH 自带的 node（%USERPROFILE%\.dsh\dsh-runtimes\...\node\bin\node.exe，
装了 DSH 就有）共四处，一般装过 Node 或 DSH 就能直接用）。没有 Node 也不挡路：bat 会
印出完整的手动四步（改 package.json / cordis.patch.yml / 建 junction），照做即可。
插件本身跑在 DSH 内部，不要求你额外装运行时。
双击 安装插件.bat，然后完全退出并重启 DSH（静态配置要重启才加载）。
脚本只做三件事：建 junction、写 package.json 的 bundles 与 dependencies、
手工登记 lockfile 条目。它不执行 pnpm install —— 在 DSH 运行时跑 pnpm
会清空 node_modules。
安装时会默认把更早的两代（dsh-reply-forge-v2、dsh-reply-forge）从 bundles
里摘掉：三代共用同一条消息操作条，同时开会挂出多条。它们的依赖和链接都保留，
随时可以用各自的「启用插件.bat」开回；想并存做对比就用
node scripts/install.mjs --keep-v2 --keep-v1。
其他脚本：
| 脚本 | 用途 |
|---|
安装插件.bat | 首次安装（含链接、依赖、lockfile、bundles） |
启用插件.bat | 已装过但被关掉时，把插件加回 bundles |
关闭插件.bat | 从 bundles 摘掉。启动异常时用它一键回滚 |
三个脚本都只改静态配置，都不碰 pnpm，都不会删你的覆盖数据；
改完都要重启 DSH（原因见上一节）。
工作原理
宿主不允许对 assistant/message 做 surface replacement ——
assertSourceEventReferences 要求 replace 事件用 sourceEventSeqs 覆盖全部被遮蔽节点，
同一个函数又硬性禁止 assistant/message 携带 sourceEventSeqs。两条约束互斥，
必然抛错。
宿主为此留的正门是 message projection：按事件类型注册的纯函数，折叠时决定
「某个 seq 的消息模型看到的是什么」。所以 v3 追加一条自有的
reply-forge/patch 事件（纯日志记录，不进 surface），再由同类型的 projection
把目标消息改写掉。
- 事件不带
surfaceOp / sourceEventSeqs，所以不触发任何 surface 校验；
- 插件被禁用时，事件被静默跳过，伪造退回原文；只要标记齐全，会话照常打得开；
- 重启后伪造仍在：会话恢复用的是已注册的 projection 列表，而本插件在
apply() 里同步注册；
- 在线写入的事件最终同样落进
session.v4.jsonl.zstd，所以「在线写的」和
「落盘写的」一样耐久。但宿主持久化层会校验事件类型：未知类型必须带
ignorable: true 否则拒读整条日志，而 Session.append() 不接这个字段——
所以 v3 在写路径上包了 shim，进入宿主持久化前统一补标记
（详见上面「关掉插件会不会把会话弄坏」）。
完整论证、宿主源码证据、失败码表见 PLAN.md。
测试
node tests/projection.test.mjs # 在真宿主 dsh-session 上验证机制（找不到宿主会 SKIP）
node tests/persistence.test.mjs # P0 真宿主持久化闭环：create→append→flush→重读→闸门
node tests/ignorable.test.mjs # P0：ignorable shim + 每会话写句柄核验
node tests/live.test.mjs # 在线层校验与失败码
node tests/patch.test.mjs # patch 纯数据层
node tests/routes.test.mjs # 路由层
node tests/client.test.mjs # 客户端产物
node tests/record.test.mjs # 记录过期判据（新会话卡死的根因）
node tests/session-write.test.mjs
node tests/session-log.test.mjs
node tests/session-repair.test.mjs # 受损会话修复工具
node tests/build.test.mjs
node tests/session-anatomy.test.mjs
共 233 项 / 13 套（含 P0 的 ignorable 28 项、persistence 真宿主闭环 5 项、
session-repair 15 项）。其中 21 项（projection 13 + persistence 5 +
ignorable 3）需要本机装有宿主包 @deepseek-ai/dsh-session——找不到就 SKIP、不计失败，
所以发行包在没装 DSH 的机器上也能跑绿；装了宿主的机器上才是完整 233 项全跑。
跑法：逐个 node tests/<文件>，或 node --test "tests/*.test.mjs" 看总门禁。改过
.dsh-plugin/client/*.mjs 后必须重跑 node scripts/build-client.mjs（自研内联器，
零依赖 / 无 JSX / 无 export default），build.test.mjs 会校验产物与源码一致。
命令行（离线改写）
不想开界面时可以直接改文件（需要先退出 DSH）：
node scripts/forge-session.mjs --session <会话id> --list
node scripts/forge-session.mjs --session <会话id> --list --kind reasoning # 列出思维链
node scripts/forge-session.mjs --session <会话id> --seq 42 --block-index 1 \
--kind text --text "改后的正文" --dry-run
--kind 取 text / reasoning / both（默认 text）；--list 按它过滤，
改思维链前先用 --list --kind reasoning 拿到 seq/blockIndex。完整说明见
使用说明.md。
真机诊断脚本
scripts/diag-focus.mjs —— 无人值守复现「保存后输入框没光标」：在 Node 里
照抄 App 启动配方 boot() 起真宿主（合并 app 运行时树 + profile 插件依赖的
node_modules，配置锚点放合并根——typert-loader 的 createRequire 要靠它
解析贡献者清单，放 profile 目录会 14 个全灭、页面 "Failed to load plugins"），
抓带 token 的 web URL，无头 Edge + CDP 打开页面，点「伪造回复 → 仅本机渲染」
全程采样 activeElement 与 focusin/focusout 轨迹。跑法
CODEBUDDY_SAFE_DELETE_ENABLED=0 node scripts/diag-focus.mjs
（safe-delete 垫片会拦宿主删锁文件，见 memory 铁律）。
版本记录
- 3.1.0 —— 三条线：
- 易用性：修新会话真机 bug（新会话全程提示「没有可定位的助手正文」——在线空快照
被当成终态缓存，永不重读）；写入方式改为可显式选择（自动 / 仅在线 / 仅落盘）。
- P0 安全封口：
ignorable: true 补齐覆盖在线 / 落盘两条写路径（shim 在进入
宿主持久化前打标记），并经真宿主持久化闭环验证（create → append → flush →
重读 → 闸门放行）；新增每会话写句柄核验（WRITER_NOT_ROUTED 安全回落盘 /
APPEND_UNSAFE 一律拒绝）；新增 修复会话.bat（诊断优先、备份、原子写、
自读复验、修不好自动还原）。
- 焦点修复（真机 bug）：写完伪造 / 仅本机渲染保存成功后，下方输入框打不了字、
没有光标，点一下「+ 添加文件」才能继续输入。根因是保存时
applyOverride 连
编辑器带消息块一起抹掉，焦点掉到 <body>。修法：先关编辑器把焦点交还宿主
输入框（data-composer-input），再抹块。第二轮查明宿主输入框在
inert（hero 态 / 被锁 / 机审中）时 contenteditable=false、根本不可聚焦，
focus() 是无操作——所以交还结果如实记录：保存后块上提示行报告
「焦点已交还输入框」或「⚠ 焦点未交还：输入框暂不可编辑」，另有焦点守候
（~700ms 内焦点掉回 <body> 就重交还，用户一操作立即收工）与调试命名空间
__dshReplyForgeV3.focus()。第三轮按用户实测锁定仅发生在「写入伪造」的异步路径：
点击后按钮被禁用，Chromium 会先把焦点丢到 <body>，所以现于禁用前快照焦点、
写入成功后恢复；等待期间若用户主动把焦点移到其它控件则不抢。第四轮查明
Electron 原生 window.confirm 是 OS 级模态框，会把 app 窗口键盘焦点弄丢
（DOM 焦点全绿却打不了字），改为页面内两步确认（写入路径再无 OS 级模态）。
第五轮修「重启后写入伪造被 STALE_TARGET 拒绝」：落盘读未过投影，expectText
拿投影前原文当基准——读路由改过投影、投影优先拒绝落盘改写、客户端保留
陈旧自动重试一次。v3 client 57 项、全量测试 233 项 / 13 套全绿。
- 3.0.0 —— 首发：message projection 在线写入 + 落盘兜底、思维链可改、目标选择器。
友链
License
MIT
