tako 文档 GitHub

19v6-03 · 存储形态与生命周期

本篇是 doc/19-v6 文档集的存储篇:四表 + 两键(PG 四表 + Redis 的 runlive / runepoch)、生命周期、真源划分、多副本。 2026-10-20 起 draft 已移除(doc/38)。端点契约见 19v6-01;概念表见 index(19-运行引擎架构-v6.md)。

三搬两留一消失(2026-10-07 D1 落库)

结构 原形态(Redis 六键) 现形态 介质
session tk:session:{id} STRING sessions 表 PG
model_history tk:mh:{session} LIST run_model_messages 表 PG
runlog tk:runlog:{session} LIST runlog_entries 表 PG
runlive tk:runlive:{run} LIST 留 Redis Redis
draft tk:draft:{run} STRING 已移除(doc/38) —
runepoch doc/30 起新增,不在当初六键里 留 Redis tk:runepoch:{run} STRING Redis
live(闸) tk:live:{session} STRING + 租约 消失——闸 = runs 表活行上的部分唯一索引 PG

四表(PG)

零 JSONB、零外键、全表代理主键(2026-10-07 裁):消息、摘要都是行 / 列,无键序问题; 引用完整性归应用层(写入路径只有 engine 一处、且被闸串行化);代理主键供未来行级引用。

闸的落库形态(kill -9 在 DB 形态下的答案)

生命周期

真源划分

runlog 记「产出了什么」(历史展示只读它);run_model_messages 记「模型现在该看到什么」(worker 组装输入的唯一来源,compact 压它、不动 runlog);runlive 是「正在生成的临时态」,TTL 到即清——清掉后那条回复的权威在 runlog,runlive 过期不影响历史正确性。 root 终稿 = turn 里 root assistant 文本的累计(pending[""]),EndRun 写入 runlog,不从 Redis 读正文。

「一条记录 / 一帧」= DB 的一行 row,不是文本的一行 line。text 里的 \n 原样保留,客户端按 markdown 渲染,排版不受影响。

多副本

全部状态在 PG 与 Redis 共享存储:客户端轮询打到任意副本从共享存储读;执行 run 的 worker 往 Redis 的 runlive 与 runepoch 写。 闸 = 部分唯一索引——跨副本天然成立;租约判定共用一个时钟(SQL now()),不依赖进程本地时间。 删掉 SSE 后不再有「持有长连接的副本 = 执行副本」的亲和问题。

reset(dev 端点)两半都清:PG TRUNCATE 四表 + Redis SCAN MATCH tk:* + UNLINK(返回 Redis 删除键数)。 runs 必须同清——它是闸的落点,漏清则幽灵 running 行永久残留(清扫只在新 POST 时按 session_id 触发, 旧 session 已 404,再没人替它扫)。