@local/dsh-time-weaver（时空编织者）
DSH（DeepSeek Harness）会话流控制插件：在保留不可变追加日志（append-only journal）的前提下，对用户消息回溯、AI 回复原地编辑、语义撤回与重新生成做完整支持。
底层日志一条都不改，全部能力以 hook/invoked 保留事件追加落盘——所以关闭客户端、重启电脑、切换历史会话之后，所有编织状态依然成立，并且对插件安装之前创建的旧会话同样有效。
目录
功能
| 功能 | 入口 | 行为 |
|---|
| 回溯重填 Rewind | 用户消息操作行的「↺ 回退至此」 | 打断正在跑的回合；隐藏该消息及其后的尾部；原文与图片附件回填输入框；可再次编辑发送 |
| 取消回溯 Cancel | 发送按钮左侧「✕」 | 撤销待定回溯，恢复全部行，并清空回溯自动回填的草稿 |
| 原地编辑 Edit | AI 回复操作条「✏️ 编辑此回复」 | 弹窗修改正文；保存后模型上下文与屏幕气泡同时更新，保留分段换行 |
| 撤回 / 删除 Retract | AI 回复操作条「🗑️」 | 该条回复从会话中整行隐去；模型侧读到的是可配置占位符（默认 .） |
| 重新生成 Regenerate | AI 回复操作条「🔄」 | 旧回复隐去并从上下文剔除，主动唤醒新一轮生成；触发消息以 notice 形态折叠为一行提示 |
| 设置 Settings | 输入区右侧「⚙」 | 选择或自定义撤回占位符 |
所有 AI 侧操作都保留前置工具调用链（tool calls / tool results），不会产生孤儿工具结果。
环境要求
- DSH Next（插件依赖宿主侧的
webServer / sessions / agents 服务与客户端 slots 服务）
- DSH 0.2.1-rc.2 起用户气泡正文改由
conversation.chat.user.content Factory 渲染；插件优先使用它，缺失时自动回退纯文本
- Node.js >= 20
- 无运行时第三方依赖
安装
插件以普通 DSH 插件包的形式挂载，需要有 package.json 的 dsh.bundle 与 dsh.client 声明：
// package.json（节选）
"main": "host.v8.js",
"exports": { ".": "./host.v8.js", "./client": "./client.js" },
"dsh": {
"bundle": { "patch": "./cordis.patch.yml" }, // 挂载 host 半边
"client": { "platform": "web", "immediately": true, "inject": ["@deepseek-ai/dsh-client-ui-slots"] }
}
把本包加入你的 DSH profile 依赖并列入 dsh.profile.bundles，然后重启 DSH（host 半边在进程启动时加载）。客户端半边随页面刷新即可生效。
工作机制
插件分两半，职责互不重叠：
| 半边 | 文件 | 职责 |
|---|
| Host | host.v8.js | 追加/回放 hook/invoked 事件、改写 session.deriveMessages() 投影、提供 HTTP 接口、唤醒 agent |
| Client | client.js | 通过 slots 注入按钮与弹窗、按状态隐藏/回写已渲染的行 |
几个关键点：
- 模型上下文由
session.deriveMessages() 决定。Host 在它外面包了一层投影：被编辑的回复换成新正文，被撤回的换成占位符，被回溯的区间与被重新生成的回复直接剔除。返回的 content 始终是标准 block 数组。
- 屏幕显示不由事件驱动，而是插件按状态二次处理已渲染的行：
- 定位采用三级锚：
data-chat-turn 回合号（稳定、与文本无关）→ 本轮盖的 data-tw-seq 章 → 全文唯一匹配。
- 隐藏 = 整行
display:none；编辑 = 就地把文本节点换掉，含换行时加 white-space: pre-wrap。
- 用
MutationObserver（含 characterData）加 1.2s 兜底重放，抵抗 React 重渲染回滚。
- 回溯提交发生在下一回合的
agent/pre-step：把待定区间固化为隐藏区间。区间右端取标记时刻的尾部，因此新发的消息与它的回复不会被误伤；客户端在存在待定状态时轮询 /state，确保宿主提交后立即同步。
- 重新生成调用 agent 实例的
followup() 主动开启新一轮（无需用户输入），触发消息带 source.form = "notice"，渲染成一行折叠提示而非用户气泡。
HTTP API
全部挂在 /api/time-weaver 下：
| 方法 | 路径 | 说明 |
|---|
| POST | /mark | 标记回溯起点（sessionId / seq），返回 markSeq |
| POST | /cancel | 取消待定回溯 |
| POST | /edit | 编辑指定 seq 的回复正文 |
| POST | /retract | 撤回指定 seq，返回 originalText |
| POST | /regenerate | 剔除并重新生成，返回 started / originalText / turn |
| GET | /message | 取某条消息的正文与状态 |
| GET | /state | 完整状态：pending / ranges / edits / retractions / regenerates（含 turn 与 originalText） |
| GET·POST | /config | 读写全局配置（占位符） |
| GET | /image | 取回被回溯消息引用的图片附件 |
| POST | /diag | 客户端诊断上报，写入诊断日志 |
诊断日志
客户端与宿主共同往 ~/.dsh/time-weaver-diag.log 追加 JSON 行（超过 512 KiB 自动截断），无需 DevTools 即可定位问题：
v | 含义 |
|---|
boot | 客户端半边加载完成（含 hasSlots，可判断槽位服务是否可用） |
diag-1 | 一次状态应用：行数、各类行数、编辑/撤回/重生成条数、命中数、盖章数 |
rewind-click / rewind-rejected | 回溯点击与宿主拒绝原因 |
mark-ok / mark-reject | 标记成功（含 tailSeq）或拒绝原因（unknown-session / bad-seq / not-user-message / inside-hidden-range） |
pending-committed | 宿主已提交回溯区间，客户端完成同步 |
regenerate / regenerate-rejected | 重新生成是否成功唤醒新回合、失败原因 |
已知限制
- 屏幕层是二次处理，不是重写渲染器：定位依赖 DSH 当前的 DOM 结构（
data-chat-flow-key / data-chat-turn / data-chat-flow-kind）。DSH 大版本调整聊天 DOM 时，需要跟着更新 TW_ROW_SELECTOR 与定位函数。
- 一个回合可能包含多个 assistant 步骤（思维链、工具卡）。编辑/撤回/重生成作用在该回合的最终回答上。
- 重新生成会额外落一条 notice 形态的上下文消息；这是触发新一轮的必要输入，不会显示成用户气泡。
- 回溯区间一旦提交即持久化，隐藏的是旧尾部；新消息不会被吞。该行为不可通过界面撤销（需要直接改日志）。
开发与测试
无第三方依赖，直接跑：
node test/host.test.mjs # host 投影：编辑/撤回/重生成/回溯提交区间
node test/hiding.test.mjs # client 定位与隐藏：回合锚、歧义、占位、幂等、换行
两套测试都直接加载真实入口文件（host.v8.js / client.js），不复制代码、不 mock 框架。
目录结构
dsh-time-weaver/
├─ host.v8.js # host 半边（真实入口）
├─ client.js # client 半边（真实入口）
├─ cordis.patch.yml # 挂载 host 半边的 bundle 补丁
├─ package.json # main / exports / dsh 声明
├─ test/
│ ├─ host.test.mjs
│ └─ hiding.test.mjs
├─ screenshot.png # 用户气泡操作条
└─ screenshot-input.png # 回溯横幅与输入框
注意：package.json 的 main、exports["./client"] 与 cordis.patch.yml 指向的是根目录这两个文件。包里没有其它源码副本，改代码只改这两个。
致谢与许可
版本历史
1.0.9 (2026-10-21 14:20)
- 适配 DSH 0.2.1-rc.2：
UiPrimitives.projectUserText 已被移除（用户文本改为 conversation.user.text 键位 Slot），原调用让整个 conversation.chat.node 条目抛错、用户消息整行消失。
- 用户气泡改走宿主的
conversation.chat.user.content Factory（renderFactorySlot），正文、引用 chip、图片/文件卡片全部交回宿主渲染；拿不到 Factory 时回退为保留换行的纯文本气泡 + 旧 renderMessageImages。
- 新增
.tw-factory 容器样式；复制/回退按钮与外层行结构不变。
1.0.8 (2026-10-21 11:16)
- 行定位改为回合锚优先（
data-chat-turn），与文本解耦；修复重新生成/删除"时灵时不灵"。
/state 的 regenerates 升级为 {seq, turn, originalText}，刷新后仍可定位。- 移除 effect 清理里的
rwRestoreAll()：它会在每次状态变化时还原隐藏行，造成"闪出来又消失"。
1.0.7 (2026-10-19 17:20)
- 修复回溯提交后客户端状态卡死：宿主提交
pending 无推送渠道，客户端继续旧值隐藏新消息。改为存在待定状态时轮询 /state 并同步。
- 点击回退时立刻给该行盖章并执行一次判定，消除"点下去没反应"。
1.0.6 (2026-10-19 11:52)
- 重新生成真正可用了：
/regenerate 改为调用 agent.followup() 主动开新一轮；触发消息用 notice 形态，不显示为用户气泡。
- 被重新生成的回复整行隐去，新回复出现在原位。
1.0.5 (2026-10-19 00:11)
- 编辑文本回写保留换行（
white-space: pre-wrap）。
- 撤回改为整行隐藏，
. 仅作为喂给模型的占位符。
/mark 成功与拒绝均写诊断日志；诊断增加 userStamps，可判断回退按钮是否由插件渲染。
1.0.4 (2026-10-18 22:39)
- 定位到真实 DOM 载体：已完成的回合把回复折叠进
turn-process 分组行，选择器恢复为 assistant-step + turn-process + [data-turn-process-answer]。
- 新增
characterData 观察与 1.2s 兜底重放；新增 /diag 诊断通道。
1.0.3 (2026-10-18 19:40)
- 修复短回复（如
1 → 2）因"至少 4 字符"护栏被跳过的问题。
- 撤回与编辑共用回写通道；回溯提交区间改用
tailSeq，不再吞掉新消息；取消回溯同步清空草稿。
1.0.2 (2026-10-18 17:56)
- 修正入口错位：此前的修复全部写进了不被加载的
lib/ 副本，现落回根目录真实入口。
deriveMessages 产出的 content 改为标准 block 数组，消除 message.content.some is not a function。- 派生缓存改用单调
rev 失效；/state 与 pre-step 均重装投影。
- 客户端
seq 改取 node.anchorSeq，会话 id 补 liveSessionId 兜底。
1.0.1 (2026-10-16 21:26)
- 修复 host 端
deriveMessages 的 content 字符串缺陷。
- 客户端补齐历史消息 seq 解析、待定回溯的视觉隐去，以及编辑后的视图刷新。
1.0.0 (2026-10-14 19:58)
- 首次发布：回溯重填、AI 回复原地编辑、语义撤回、重新生成、占位符设置面板，状态全部落盘。
