崩溃前那半句要不要存
模块:运行生命周期 / Redis 临时态(
internal/runengine/)| 状态:已落地(6e4de68,2026-10-20)| 证据:doc/38-删除draft键.md、tmp/38-删除draft键/planning.md、commit6e4de68
1. 场景与病灶
一场 3000 字的回答,最后一个 delta 已经推到了浏览器上。EndRun 开始收尾,此时 Redis 正在做主从切换。
旧实现里 EndRun 的第一件事是 GET tk:draft——把流式过程中缓存的正文读出来,再写进 runlog_entries。连接错误时它直接在开 PG 事务之前返回。结果:PG 里 run 仍是 running,租约过期后读侧判「已中断」,下一次 POST 把它清扫成 error。用户屏幕上明明看到了完整回答,刷新后却变成一个失败气泡——模型已经写完、PG 也健康,但这场回答永远不会进 runlog。
tk:draft 同时干着两件事,这是问题的根:
- 定稿正文的缓存(EndRun 从这里拿文本);
- run 是否还活着的哨兵(append 前
EXISTS draft,不在了就停止推流)。
两个职责都绑在一个易失键上,于是「缓存被 maxmemory 逐出」被误读成「执行者死了」,「最后一枪后 draft 消失」被写成「complete 但空回复」。
2. 候选与代价
要换的是「正文从哪拿」和「活判看什么」两件事。
| 问题 | 候选 | 好处 | 代价 |
|---|---|---|---|
| EndRun 正文源 | A GET tk:draft |
零改动 | 定稿依赖 Redis 可用性;Redis 故障即丢整场回答 |
B 参数里现成的 pending[""](内存 turn 累计) |
与 draft 逐字节同源;PG 事务照常提交 | 依赖「turn 累计」这一约定 | |
C 读 run_journal 拼正文 |
PG 真源 | 多一次读、多一个失败面,而 turn 已经在参数里 | |
| 活判哨兵 | A EXISTS draft |
简单 | 缓存被逐出 = 判死;最后一枪后写空回复 |
B EXISTS runlive |
键一定在 | terminal 后还有 300s TTL,旧执行者能在收尾后继续追加;把帧流契约与判活绑死 | |
C runepoch == epoch |
回答「我还是不是这一代的执行者」 | 要改名、改测试 | |
| 删法 | A 先换正文源、再换哨兵 | 可逐字节对照 | 两个不可发布的中间态:A1 后 draft 只写不读,A2 后 APPEND 可能重建无 TTL 的孤儿键 |
| B 一次性删干净 | 无中间态 | A1 diff 约 195 行,超过 80 行目标 |
裁定:正文取 pending[""](B),哨兵换 runepoch == epoch(C),draft 一次性删干净。 pending[""] 正是 Σ root assistant turn Text,写进 runlog 的字节与旧路完全相同;runepoch 回答的是执行者身份,不是「某个缓存键在不在」。
3. 同族小裁定
| 小问题 | 裁定 | 代价 / 备注 |
|---|---|---|
| 拒写出口顺手把 status 改成 error 吗? | 只改名 live→accepted,不改行为 |
四个 !accepted 出口仍直接 return;「被逐出算失败还是可接受的部分定稿」是产品判断,另案 |
| 崩溃前那半截 delta 持久化吗? | 不存,随 resume 丢弃 | 每个 delta 写 PG 会把 at-most-once 改成 at-least-once,需要新持久化层与幂等语义;doc/30 已裁 at-most-once |
保留 draft 只当缓存 / 加 TAKO_DRAFT 开关? |
不做 | 「要不要一个缓存」不是运维选择,是结构决定 |
| 正文写入的字节怎么保证不变? | 用单测与活体对账替代过渡态 | 一次性删除的风险由「逐字节等价证明 + 六件单测 + 五场活体」吸收 |
4. 证据
- 方案:
doc/38-删除draft键.md§4(逐字节等价)、§4.5(哨兵等价)、§5.5(命名)、§6(移除方式)、§8.3(不做)、§9(被否决的替代方案)。 - 台账:
tmp/38-删除draft键/planning.md§5.1(EndRun 正文源)、§5.2(append 守卫)、§5.6(命名)、§6(过渡态与转正)。 - 代码:
store.go的 pending 累计与 root assistant 行写入;redisstore.go的 Lua 脚本比 epoch、AppendFrame返回accepted;全仓已无keyDraft/tk:draft。 - 复核命令:
grep -rn "tk:draft\|keyDraft" yk-tako-eino/internal/runengine(应无命中);grep -n "accepted" yk-tako-eino/internal/runengine/redisstore.go。
5. 现状
已落地。AppendDelta 后来与 AppendFrame 合并为唯一写口(4d64265),但「正文来自 turn、活判来自 epoch」两条不变。