19v6-90 · 演进记录
doc/19-v6 的修订历史:只追加、不篡改。2026-10-07 文档集拆分时从 index 搬入本篇; 文内旧「§N」引用已随拆分改指新篇目(
19v6-NN)。 读法:想知道「当前形态为什么长这样」再读本篇;契约本身在19v6-01。
初版定位(v6 立版):本文取代 v5。v6 = v5 的裁定结论 + 重写,不 copy v5 的篇幅。 只写第一步:跑通最小闭环所需的四个 API 的最简契约。骨架、组件、用例全集——不在内,后续 loop 各自成文。 没有「明确不做」清单:范围只在 §0 正面声明,其余一律「需要时照通道扩、不预留字段」。
2026-10-02 二次修订(改纯拉模型):推翻「一条 message 所有 delta 同号」→ 每个 delta 独占 eventOffset;据此删掉 SSE stream 端点,改为纯轮询拉取(runlive 拉生成中的帧 + runlog 拉定稿历史)。理由:每 delta 独占号后 eventOffset 的唯一归宿就是续传游标,与其让流认游标或维护「挂流+拉取双路合并」,不如让 runlive 直接成为拉取端点、删掉流。无长连接、无推送、无 heartbeat。
【2026-10-18 翻案,doc/31】SSE 回来了,但只翻半边:b2 的核心论证(
eventOffset只有一个归宿、不新增游标抽象、不搞两路状态合并)全部继续成立——流端点的id就是同一eventOffset,消费逻辑(reconcile)只有一份。翻掉的只是「删掉流」这个结论:流被重新定位为同一帧面的第二种运输方式(动机:API 面通用流式,外部消费方不该各自抄轮询样板),拉是正确性、流是优化,四 API 零改动。心跳随流回来(纯拉无连接可掐,流有)。
2026-10-02 三次修订(单批上限 + 初始游标窗口化):runlog 永久增长(compact 压的是 model_history,不动 runlog),所以「新 tab 游标 = 0 = 全量重拉」在长会话下是无界请求。改法不加端点、不加索引、不加请求参数:两个拉取端点统一加单批上限 W(LRANGE key N N+W-1),客户端初始游标改取 max(0, 高水位 - 窗口)——高水位本来就由 session 状态端点返回。又因 runlogOffset 永久有效,往回拨游标翻更早的历史同样合法。
2026-10-03 四次修订(REST 化端点形状):四个 API 的路径重排为资源式—— POST /api/runs(原 /api/message)、GET /api/runs/{runId}/frames(原 /api/runlive)、 GET /api/sessions/{sessionId}(原 /api/session?id=)、GET /api/sessions/{sessionId}/log(原 /api/runlog?id=); 202 响应新增 runId。语义一字未动:懒建/准入、双游标、W、响应三态、gone 语义、 存储键名(runlive:{runId} / runlog:{sessionId} 等)全部原样。改名理由:runlive/runlog 只差三个字母, 正是「两种游标别混」的认知负担来源;新形状让双游标归属在 URL 上显式(run 内游标挂 frames, session 全局游标挂 log),session 归属从 body/query 挪进 path。 裁掉三个提出过但语义未设计的端点,不预留:GET /api/runs/{runId}(frames 每批已带 status,冗余)、 POST /api/runs/{runId}/cancel(cancel 与 worker 收尾竞态、残缺 draft 去留均未设计,stopped 留它自己的 loop——届时加端点不改旧形状)、GET /api/sessions(列表的排序/分页/预览均未设计)。 原则:没有用例逼出的端点不进契约。
2026-10-07 五次修订(闸租约化 + tk: 键名回填):19v6-03 的 live:{sessionId} 闸从「SET NX 不带 TTL、 租约/reaper 留后续 loop」改为「短 TTL 租约 + worker watchdog 续约」——抢闸即 SET NX PX <lease>, 生成期间 watchdog 定期把 live/draft/runlive 三键的 TTL 同刷回 lease(三键同生同灭);进程 kill -9 后没人续约,三键到点一起蒸发、会话自动解锁,无需 reaper 代跑收尾(客户端靠 19v6-02 的冗余收口信号 gone / liveRunId:"" 自愈)。续约 Lua 带 CAS(闸仍等于本 run 才续),防网络分区复活的老 worker 给新 run 续命。 同时把 19v6-03 的键名回填为落地形态:全部带 tk: 前缀(reset 用 SCAN tk:* 对未来新键免疫,也是连错 Redis 实例时的误伤防线), 并补出 model_history 的 Redis 形态 tk:mh:{sessionId}(LIST,每项 role+text)。四个 API 的线上字节零变化。
2026-10-07 六次修订(落库:三搬两留一消失):存储从「Redis 六键」搬到「PG 四表 + Redis 两键」—— session/model_history/runlog 落表(sessions / runs / run_model_messages / runlog_entries,四表同库), runlive/draft 留 Redis(临时态,TTL 到即清、过期不影响历史正确性);闸从 live 键的 SET NX PX 改为 runs 表 one_live_run_per_session 部分唯一索引(WHERE status='running')——插入失败本身就是 409; 租约的真源从「三键 TTL 同生同灭」移到 runs.lease_until 列(watchdog 续约的 CAS = UPDATE 影响行数, 进程死亡 = 读侧即回收 + 新 POST 清扫死行翻 error)。model_history 与闸「同一笔原子写」从措辞变成事务边界: 放闸 UPDATE 与 assistant 行 INSERT 同一笔 PG 事务;terminal 帧仍由 commit 后的 Redis 半压入。 四个 API 的线上字节零变化(A4-1 baseline 原样重跑)。
2026-10-08 七次修订(tool loop:帧扩两 kind + 每帧 agent + runlog 扩展行):T2 落地首个工具 (get_time),契约面随之扩展——frames 新增 tool_call{name,args} / tool_result{name,output} 两种 kind (args = 模型原始 JSON 字符串,原样透传不重编码);每帧新增 agent 字段(任何帧都带,含 start/terminal; 空 = root,子代理帧带子代理名);runlog rows 每行同步带 agent,并新增 role=tool_call/tool_result 扩展行(消息粒度,不是帧——生成中的 delta 仍只进 runlive):text 是可直接展示的一行 (name(args) / 输出原文)、payload 是结构化 JSON({"name","args"} / {"name","output"},字段与同名帧对应)。 存储侧随动:run_model_messages 加 tool_calls/tool_call_id 两列(重建 OpenAI 工具消息)、 runlog_entries 加 agent/payload 两列。这是 v6 首次契约字节变化(帧与 rows 都多了 agent 等字段); 四个端点的路径、游标语义、错误字节不变。机制裁定见 19v6-05(§3 帧扩展、§6 表新增)。
2026-10-09 八次修订(sub agent 预算面:并发 / 超时 / 回传三裁):T3 动工前必拍②定案(用户三裁,机制落 19v6-05 §4)——取消是控制面的事(abort 级联),不是时间面的事:子代理不设总时限、不另立计时器 (pi 实读:两套子代理实现均无计时器;用户指 Google ADK 同立场);并发上限 = 配置项(默认 8); 回传裁剪照 pi——终稿超 50 KB 字节即截(UTF-8 安全 + omitted 提示),全量在子代理 runlog。 四个 API 的线上字节零变化。
2026-10-09 九次修订(T3 子代理规格:文件式 + 字段表;T4/T5 转触发式):T3 动工前必拍①③定案—— 子代理规格从「Go struct 内置」翻为文件式规格:yk-tako-eino/agents/ 单目录、md + YAML frontmatter、 正文 = system prompt,装载 = run 起手扫盘(改文件 → 下一条消息生效、run 中途不变;每规格一包 AgentTool ⇒ 工具清单 = 规格名单 ⇒ Eino 工具 schema 定稿于装配点,要新鲜只能重装配 ⇒ 装载点 = 重装配点 = run 起手); 字段表:name(单字段身份 = AgentTool 工具名 = runlog agent 值;文件名不参与语义;撞名拒载)/ description(必填,缺拒载)/ tools(三态:不写 → 继承父池 / 白名单 / [] 空集;tool_search 为保留名。 2026-10-16 起四态:新增第五个字段 exclude_tools = 继承父池减去列出的名字,与 tools 互斥、同写拒载,doc/26)/ model(不写 → 继承主 worker 实例、写值装载即拒「未实现」),不加展示字段;不设信任门(文件 = 部署产物), 管理面(dashboard = 文件操作壳)后置独立小拍。同时工具目录分级(direct/deferred/hidden)与 tool_search / BM25 (T4/T5)裁为触发式——施工等「MCP 工具 loop 进来或子代理库长到几十条」再连做;纸面保留 「可执行集合 ⊇ 声明集合 ⊇ 可检索集合」分离原则;T3 期 = 一个源(文件)、一个装载点(run 起手)、 一个声明状态(全声明)。均为台账/方案裁定,代码未动、四个 API 的线上字节零变化。 机制裁定见 19v6-05(§4 规格与字段表、§5 施工触发附注)。
2026-10-10 十次修订(model 写值改为 ref 解析生效——撤「装载即拒」):用户澄清原始需求——「用户可以在 md 文件里面改 Model」,model 写值必须真实生效;九修中「model 写值装载即拒报「未实现」」是与之对抗的 裁定,删除(九修原文按本篇只追加、不篡改的惯例保留,以本条为准)。新语义:写值 → 按 ref 解析生效—— ref = 厂商ID/模型ID 格式的模型身份字符串(例:deepseek/deepseek-v4-flash),与 TAKO_MODEL 同源同链 (解析走同一条 ResolveModel 抽出的公用函数);写了具体 ref 的规格:在 run 起手扫盘装配时,去一张 **进程内的懒加载缓存表(学名 ModelRegistry,提供 Get(ctx, ref))**里取该 ref 对应的模型 HTTP 客户端: 缓存已有就复用、缓存空就现场解析环境变量 + 建客户端再塞进表;多副本部署下,每张表只在本进程内生效, 各副本各持一份,不互通不共享(因为缓存的是 HTTP 连接句柄,不是数据——跨进程传不了,重建成本也可忽略)。 不写 model: / 写了 default / inherit / 继承(大小写不敏感):继承主 worker 启动时就建好的那个 模型实例,不查注册表、不新建。ref 解析不了(未配密钥 / 厂商不在目录 / 格式缺模型名等)→ 该条规格不装载、 log 明确报错一行,其余规格照载(和坏 YAML 不载同款,属配置错误报告)。落地拍 = T3-1b (撤 agents.go 原有拒载分支 + 解析落点抽公用函数 + main 装配 ModelRegistry 实例);机制细节回填 19v6-05 §4 (含正向定义术语表、三种写法穷举表、具体规格跑链路、伪代码与进程内设计依据对比表)。 模型身份进帧与行(同日订正:原拟「不进任何帧/行」作废):model 字段随 agent 恒在、值 = 生效 ref—— 帧侧随 T3-1b、行侧随 T3-2 落地,四个 API 的线上字节随这两拍变更(19v6-01 §2/§3 已补)。
2026-10-10 十一次修订(compact 形态成文:C1 补记 + WeKnora 借鉴登记):compact 的 v6 形态 整篇成文为 19v6-07(触发形态 / 折叠算法 / 摘要调用规格 / 落库事务边界 / 前方登记),机制 细节以该篇为准、本篇不展开。本条记两件——
(a)C1 落地补记(落地当日未补记演进,今随本条一并补;commit f09deb6 与 D1 同笔): 上下文压缩核心链落地——触发者 = worker 发送前自测(countInput > window×4/5 进折叠,快速路 零行为变化);算法 = n 降序保最近 n 个已完成 run、errStillOver 哨兵(n=0 仍超 = 不调主模型、 status=error、零写入);旧摘要 seq=0 行原地更新(并入新摘要、不回喂);落库 = EndRun complete 分支同一笔 PG 事务(compacted 标记 + seq=0 摘要行挂「最后折入 run」——UNIQUE(run_id,seq) 下 唯一合法挂点)。四个 API 的线上字节零变化。
(b)借鉴登记(同日实读 WeKnora internal/agent/compaction 全包对比,用户裁量;细节台账 planning §10.6):①摘要原地更新与 C1 机制互证等价、确认保留;差距 = 摘要输入转录分级截断、 三层验货(空/截断拒收;截断以算术主检 completion≥cap 为主、finish_reason 字符串为辅)、 摘要旋钮三件套(低温 / 流式 stall 超时 / 按失败原因分流的 ≤2 次重试)、fileOps 式机械路径 保留——前三者入 C2 范围,初值标注来源、dev 校准。②切点选择规则登记为需求(路线 A run 粒度 / 路线 B run 内下刀,开放,随 mid-run 立项细化)。③响应预留维持 window×1/5,溢出修复层落地后 重裁固定值。④溢出修复层(23 家 provider「太长」正则 + 截断响应检测 + 压后重试一次)建议独立 立项。失败哲学(error / 折半重试 / Degraded 三层标记)待裁。C2–C4 未施工(C2 已按上扩围), 代码除已入库的 C1 外未动、四个 API 的线上字节零变化。
2026-10-11 十二次修订(改名:Registry → ModelRegistry,消歧「注册表」):internal/config 进程内模型客户端缓存的类型 Registry → ModelRegistry(文件 registry.go → modelregistry.go、 构造 NewRegistry → NewModelRegistry、main 侧适配器 registryResolver → modelRegistryResolver、 日志前缀 registry: → modelregistry:),与 19v6-05 §4 学名对齐——它缓存的是按 ref 建好的 HTTP 客户端句柄,不是规格登记表;本仓「注册表」一词已专指 file_effect 声明表(19v6-07)与 deferred tools 库存表(19v6-06)。19v6-05 §4 同步去掉「(简称 Registry)」表述。行为零变化。
2026-10-12 十三次修订(T3 委派落地:子代理帧/行 + 回传裁剪 + 用例 7):T3-2/T3-3/T3-4 施工补记—— 子代理身份首次带非空值出现:子代理帧流(delta/tool_call/tool_result 逐条带 agent=子代理名、 model=该规格生效 ref)与 runlog 子代理行(其工具活动扩展行 + 终稿 assistant 行;agent=名、model=其生效 ref)真实落进观测与历史面;mh 仍 root-only(子代理条目不进模型输入,seq 跳过不占号)。回传裁剪落地 (delegationTool 包壳):超上限回传 UTF-8 安全截 + 尾缀 [Output truncated: %d bytes omitted. Full output preserved in subagent runlog.](N = 总字节 − 保留字节; cap ≤ 0 = 不裁剪)——先裁后落:mh tool 行 / runlog 委派回传行 / 帧 output 三处同一份已裁剪文本, 全量只在子代理终稿行。两个旋钮:-subagent-concurrency(默认 8;<1 启动即拒)/ -subagent-return-cap(默认 51200 B)。字段面字节零变化(agent/model 两恒在字段随七修/十修已扩, 本条是它们首次带非空值出现);19v6-04 增用例 7(委派:帧/行期望 + 裁剪断言 + 交错序客户端预期), 19v6-01 示例区补委派样例(并按实装校准 model 样例值),19v6-05 §4 补实施口径(终稿语义 / 先裁后落 / 尾缀原文 / 两旋钮 / seed 规格说明)。
2026-10-12 十四次修订(笔记层落地:memory 工具 + notes 表 + 双边快照 + 折叠规矩句): doc/17 §7(笔记)点头后施工,M1–M6 六拍验收全过(真源 = doc/17,台账 tmp/17-笔记)。 PG 表 4→5:新增 notes(workspace 分区;kind/content/quote/source_run_id/source_seq/ superseded_by 六列;改口 = 新插一行 + 旧行只填指针、content/quote 一字不改——对质证据链)。 memory 工具进父池(add/replace/remove;唯一写入函数 writeNote,四件在同一事务内—— 字数上限 agent 2200 / user 1375 字、quote 非空且 ≤200 字、注入检查(Hermes strict 移植 11 条正则 + 隐形字符)、workspace 级 pg_advisory_xact_lock);工具结果恒带未替代条目清单 + 已用行 (同场定位 old_content 的唯一凭据——快照起手冻结、本场不回写)。系统提示缝:每场 run 起手 读一次未替代行渲染快照段,主代理经 noteSnapshotHandler 把 state.Messages[0] 重写为 Instruction + 快照段(幂等,midfold 前挂载),子代理在装载处把同一份快照接在规格正文后 (agent system <name>: dev 日志行为观测面);本场中途写入下一场才可见。存量毒行渲染占位 [BLOCKED: …](库中原文保留;工具结果清单留原文供 remove 定位删除)。折叠提示词加规则⑥: 用户明确说过的规矩按原句保留、带引号照抄。四个 API 路径与字段面零变化(memory 走既有 tool_call/tool_result 帧;system 提示字节含快照段属预期变化,不在四端点契约内)。 19v6-01/04 无需改动。
2026-10-12 十五次修订(三期预留重裁:limit = window − min(window/5, 16384)):19v6-09 §9 三期施工补记——触发线 / POST 准入线 / 摘要预算上限三处共用的公共底数,从 window × 4/5(十一修 ③「响应预留维持 window×1/5,溢出修复层落地后重裁固定值」的兑现)重裁为 window − min(window/5, 16384)。改动面:一处纯函数 CompactLimitFor(window)(compact.go;导出供启动日志)+ 两处计算 接线(worker 装配 compactLimit、summarizeCeiling 小窗支)+ 展示位同步(main 启动行 compact window %d tok (limit %d) / flag help / 探针注释)。16384 = WeKnora settings.go 固定 16k(回复大小不随窗口缩放);min 的连续档在 window = 81920 处两式相交(81920/5 = 16384),之下退化为 ×4/5——dev 小窗 600 → limit 480 逐值不变、不留新魔法边界;256k 窗 limit 204800 → 239616(吃回 34816 ≈ 35k)。相对式自动跟随:POST 准入 limit/3、恒有解 推导不动;rescueLimit(真值 / C_rej 相对)、budgetRunes(字符预算)、claude 顶到上限时的系数均 未触碰。闸门 = 一期溢出修复层在真 provider 上真兜住过(A2 活体,已满足)。实测(tmp 台账 溢出节 a5-limit):W=100000 双二进制差分——同一份 cl100k 27270 tok 的请求,旧二进制启动行 limit 80000 / 413 拒收,新二进制 limit 83616 / 202 放行,body-hi 28250 tok 在新二进制得 413 limit:83616;W=21000 话本重跑 fold 行 输入 17722 tok > limit 16800(A4p2 基线 17734 / 16800,逐值同);启动行两档断言 256k → 239616、600 → 480;单测 TestCompactLimitFor 八锚(含 81920 交点两式同值 65536)。四个 API 字节、runlog、计数口径(D11)、帧 kind 零变化;19v6-07 同拍翻案(§1 该条 + 头注 + 链路图 + §5 两处引用)。
2026-10-12 十六次修订(同会话历史查找落地:search_history 工具 + 截断落盘 + 子代理继承): doc/21 点头后施工,H1–H5 五拍验收全过(真源 = doc/21,台账 tmp/21-历史查找)。search_history 工具进父池(排 memory 后;file_effect 登记 = write)。两模式:按词查(多词 ILIKE 全 AND + \ % _ 转义、ORDER BY seq DESC LIMIT ?、片段以首个词命中点为中心前后各 200 字)与 around_seq 窗口(取 [seq−window, seq+window] 含自己、行首 800 字、不排除本场 run——相邻的 本场 user 行 / tool_call 行正是上下文)。身份从 ctx 的 noteBox 取((session, run);会话号不作 参数,模型翻不到别会话的历史);只读 runlog_entries(词模式排除本场 run——抢闸已入库的本场 user 行不占名额),不写它、也不读 run_model_messages。有界 = 片段 + 4000 字总上限(词模式从后 丢、窗口从最远丢)+ limit ≤ 10 / window ≤ 5 钳制;计数口径 = 截断后内联首行「命中 N 条」 报全量数(与落盘文件首行一致,「其余命中已截断。」的「其余」才有先行词——H4 观察点用户裁定, doc/21 §3.2 随文)。截断落盘:真丢行时不设上限的全文写 <workspace>/.tako/search/<runId>_<n>.md (每 run 计数器顺编、主/子代理共用同一份 noteBox、O_EXCL 一次一写;写失败静默退化为纯截断、 无截断不落盘)。子代理继承真工具:无 tools 行的 researcher 拿父池拷贝——同一对象、同一 实现,不设拒绝壳(10-12 二次讨论推翻原「拒绝壳」裁定,doc/21 §3.4 随文;10-16 起 researcher 改走 exclude_tools 排除路而非整份拷贝,「同一对象、不换壳」的结论不变,doc/26)。四个 API 路径与 字节零变化(调用走既有 tool_call/tool_result 帧);不加表、不加索引。19v6-01/03/04 无需 改动。实测 = H1–H4 话本 + H5 全话本重跑五轮(词 / 窗口 / 委派 / 截断各面),内联与落盘文件 逐字节复刻对质全等(证据 tmp/21-历史查找/evidence-h5/)。
2026-10-15 十七次修订(笔记写入检查裁到隐形字符一档):用户质询(纯中文写法拦不拦得住)后以真码 探针逐条实测、据此裁定——notes.go 的句式词表 noteThreatRules(11 条正则 + noteThreatFiller filler 槽,照抄 Hermes tools/threat_patterns.py strict 一档)裁除;隐形字符档 noteInvisibleRunes(17 码点,同 Hermes INVISIBLE_CHARS 全集)保留,扫描只留隐形字符循环;扫描函数 与拒写分类随之改名(Threat / Inject → Invisible),拒写文案、占位文案随动。判据 = 类别的清单能不能 枚举尽:句式拦不住语义——真码探针逐条实测(临时探针,验毕已删),纯中文写法(「禁用 system prompt」 「忽略之前的所有指令」)11 条一条不命中,把锚词换成中文(ignore 之前的 instructions)、写全角 (ignore)都能绕,命中面只剩「句子里恰好用了英文锚词」的窄缝,词表列不尽;隐形档清单有限、 能枚举尽、与语言无关,拦的是「能不能藏」不是「说了什么」——正经用途少(组合 emoji 的 ZWJ、波斯语 ZWNJ),误伤面小、拒写时当场可见(报码点)可改。四个 API 的线上字节零变化(拒写走既有 tool_result 帧文本,不涉契约);doc/17 §7 同拍回填(头注、四件之 3、§7.1 两处措辞), doc/19-v6 index(最近修订行、目录行)同步。
2026-10-20 十八次修订(hidden 语义校正:pi = 注册但不可达,tako = 只撤声明):用户对 19v6-06 §1「hidden:代码内部/子代理用」提出质疑——既然永不声明,模型根本不知道它,何来「子代理用」? 复核 pi 源码与文档后校正:pi 的 hidden 是 registered but unreachable(模型与 ctx.executeTool() 两条路都够不着,激活无效;packages/coding-agent/docs/extensions.md「Tool exposure」),存在理由是 注册表没有 unregister——hidden 是已注册工具唯一的撤回写法,并兼作 MCP 的 server 级默认值与 工具级覆盖取值("delete_*": "hidden" 黑名单;server 默认 hidden + 逐工具覆盖白名单)。tako 的池 每 run 重建,不存在「撤不掉」,因此不能照抄:19v6-05 §5 的「永不声明」只撤声明、不撤执行 (node 全注册),而 Eino tools node 按全量工具表按名分发(v0.9.21 compose/tool_node.go:名字不在 节点才报 tool X not found),模型猜中名字仍可能调起 hidden 工具。T4 若保留 hidden,必须先点名消费者 (代码直调 / 按 agent 区分声明面)并在执行面按声明集设闸;答不出消费者就删掉这一档。 代码未动、四个 API 字节零变化;19v6-06 §1 与 19v6-05 §5 同拍回填。
2026-10-20 十九次修订(hidden 档删除:只留 direct / deferred):十八修校正语义后,用户裁定 不保留 hidden。依据:tako 的池每 run 重建,禁用工具 = 装配时不 append(不进 tools node,既不可 执行也不可检索),不存在 pi「注册表撤不掉」的场景;而只撤声明、不撤执行的 hidden 在 Eino 下关不住 执行面(tools node 按全量工具表按名分发,v0.9.21 compose/tool_node.go 实读:名字不在节点才报 tool X not found)。19v6-05 §5 改为两档并删 hidden 边界段;19v6-06 §1 保留 pi 的 hidden 仅作 对照、明确不采纳。代码未动、四个 API 字节零变化。将来若出现「代码可调、模型不可见」的真实 消费者,按新需求重新立档并同时设执行闸。
2026-10-20 二十次修订(T4/T5 合批:BM25 即首版;mh 与激活集分家):用户裁「一步到位把 T5 也做了」—— T4(工具目录分级 + tool_search)与 T5(BM25 排序器)同批施工,不先做名称/描述直出再替换;BM25 移植 pi(camelCase 分词 + 朴素词干 + 停用词;Okapi k1=1.2/b=0.75;文档 = 名字 + 下划线拆词 + 描述 + schema 描述/属性名;limit 默认 8)即首版。同拍澄清用户问题「这个 issue 工具在后面的 Turn 都会在 mh 里吗」: mh 只记 tool_search 的调用行与结果文本,不记工具 schema、不记激活状态;每轮模型看见哪些工具由 BeforeModelRewriteState 用本 run 的完整目录重建 state.ToolInfos 决定(不能对当前列表做减法: 首轮过滤后 deferred 项已不在其中),激活集是 run 状态。同一 run 的下一次模型调用由 run-local 状态延续; 新 run / 崩溃续跑从零激活。同批已拍(2026-10-20):分级来源 = mcp__ 前缀即 deferred、其余 direct; 激活集只活一场 run,回执写 Loaded N tools for this run...;默认 limit 8(照 pi);子代理只有显式写进 tools 才拿 tool_search(继承档含 exclude_tools 不自动加)。跨 run 若要保留必须结构化持久化, 从 mh 文本重放会被折叠折走。代码未动、四个 API 字节零变化;19v6-05 §5 同拍回填,施工台账见 tmp/19-v6/。
2026-10-20 二十一次修订(T4/T5 落地:A1–A4 收口):T4(分级 + tool_search)与 T5(BM25 排序器) 按二十修同批施工完成。A1 ad1ab6b:toolsearch.go 落地 pi 移植(camelCase 分词 + 朴素词干 + 停用词; Okapi k1=1.2、b=0.75;文档 = 名字拆词 + 描述 + 参数 schema 描述/属性名 + MCP server 短名;limit 默认 8; 空 query/非正整数 limit 报错;无命中 No matching tools found.),handler 在 BeforeAgent 建 run-local 目录与激活集、BeforeModelRewriteState 按「direct + 激活集」重建声明面。A2 a190f4d:tool_search 是保留名——不进池、不按普通未知名拒载;子代理只有显式 tools: 才挂自己的 handler,继承档与 exclude_tools 档不自动给。A3 纯验收:同会话第二场 run 与崩溃续跑都从零激活(第二场 declared=21 active=[];账本重放无 tool_search、无 schema),回执「for this run」与真实寿命一致。 A4 回归+收口:单测补 schema 文本、同分稳定序与 limit 截断、缺省 8/越界报错、已激活去重; 活体重跑 A1(catalog=35 deferred=14,declared 21→29)与 A2 正/负路径(子代理 catalog=2、 继承档名单无 tool_search),无 mcp.json 时 catalog=19 deferred=0 且 tool_search 无命中; server.go/types.go/redisstore.go 自 ad60e49 到 a190f4d 零 diff——四个 API 字节零变化。 19v6-05 §5 改「已落地」并补验收结论,19v6-06 §1/§3/§6 同批校正(hidden 已删、两档)。
2026-10-20 二十二次修订(移除 tk:draft):tk:draft 的两个职责已有承载者。定稿正文是 turn 里 root assistant 文本的累计(pending[""]),写口是否仍属本执行者看 tk:runepoch。Redis 临时键只留 tk:runlive 与 tk:runepoch。EndRun 在打开 PG 事务之前不再读 Redis 正文。四个写口拒收出口仍直接返回,不把 status 改成 error。真源见 doc/38。同批改词:19v6-03 的留 Redis 理由、生命周期与真源划分;架构 index 的结束行与定稿行;19v6-05 的 root 终稿;19v6-10 的 commit 后 Redis 半与终轮正文来源。历史条目里的 draft 字样保留,不回改。
2026-10-21 二十三次修订(hosted mode 不接:client mode 定为终态底座):用户裁「现在实现了 client mode 就足够了」。hosted mode(provider 原生 deferred)确定不接——不是「暂缓」,是终态裁定;理由三条: (1) 覆盖面对不上:本仓 provider 目录 39 条里 36 条 openai 协议、3 条 anthropic 协议,而 eino-ext 只有 claude 组件翻 defer_loading(openai 组件 v0.1.13 无翻译层,eino 核心只定义 option、翻译靠组件), 接了 hosted 只覆盖那 3 条;(2) 代价与收益不对账:hosted 唯一增量是「发现期不毁缓存」,而 client 模式的 缓存损失有界——激活集同 run 内常驻、之后单调收敛,只有最初几轮发现期 miss,跨 run 本就每场重新发现; (3) client 模式对 provider 零要求:不挑厂商、不吃私有协议、不等 eino-ext 上游。代码未动、四个 API 字节零变化。 19v6-06 头注改「降为纯背景篇」、§6 改写为终态裁定(§4–5 链路与厂商矩阵保留作背景,不作施工面、不进待办); 19v6-05 §5 升级路措辞同拍回填。doc/README.md 19v6-06 行状态由 🔶 改 ✅、说明改为「非契约篇;机制背景, hosted 已裁定不接(2026-10-21)」。那条「进度误会」记录第 1 条同时收口(T4/T5 已于 2026-10-20 落地,该条的 「无 deferred 机制在跑」前提已失效,原「复核」命令已不成立)。
2026-10-21 二十四次修订(帧写口合并:AppendDelta → AppendFrame):帧写口从两个并成一个。核查发现 appendDeltaScript 与 appendFrameScript 的可执行部分逐字节相同(同一段「比对 tk:runepoch → RPUSH → 返 LLEN」),而所谓「delta 只能由 root 写」的语义护栏实际落在调用方的 agent == "" 分支上 (worker.go 的 drain),不在存储层——要走到 AppendDelta 必须先判断 agent == "",判断完 agent 本来就是空串,AppendDelta 内部再设一次 Agent: "" 是零增量重复。合并方向是删 AppendDelta、 统一到 AppendFrame(不是加参数):root 与子代理的正文都走同一个写口,靠 Agent 字段区分 (root 空串 = 收口锚「Σ root delta」只认它;子代理带名字)。AppendFrame 签名不变——AppendDelta 多返回的 eventOffset 在生产代码里被丢弃(帧计数走 box.addFrames(1))。四个 API 字节零变化、 帧 JSON 形状零变化、epoch 令牌语义零变化、键名零变化。 活体验收:基线/改后各跑一场真实 run,归一化后 diff 无输出、退出码 0,kind 序列逐项一致 (start,usage,tool_call,tool_result,delta×26,usage,terminal);收口锚复核「Σ root delta 拼接」 与 runlog assistant 行逐字相同;另跑一场委派验子代理 delta 帧仍带 agent:"researcher"。 同批回填:19v6-03 的留 Redis 理由、19v6-09 §8 的帧计数措辞、doc/30 §7.3 与 §11.4 的旧 worker 命运表、 doc/38 §5.4 的故障行为;doc/38 §5.5 的命名表是 doc/38 当时的改动记录(「今天」列指删 draft 之前), 保留原样并加现状注,doc/30 §19 与 doc/38 §1–§4 的历史推导同样不回改。
2026-10-21 二十五次修订(契约追平:帧 kind 五→七、session 字节补三字段):核对契约与代码时发现 19-v6 文档集的帧 kind 断言与 session 响应字节两处漂移,都已过期于现行代码:
19v6-01§2 的「帧有五种kind」——断言「start/delta/tool_call/tool_result/terminal之外没有别的 kind」。但代码里已有七种:usage(doc/27 §4a,2026-10-18 落地)与resume(doc/30 §8.3,2026-10-21 落地)都在。这条断言最坏的后果是前端照它写会漏帧—— usage 帧漏了页面显示不出用量,resume 帧漏了崩溃续跑接不上正文。现改为七种,并逐条写明usage的五个数值列与resume的「text 是整段正文、必须替换不能追加」语义, 外加「未知 kind 必须忽略而非报错」——kind 清单会随机制增长,不是封闭集合。- session 响应字节停在 doc/28 之前:文档写
{"liveRunId":…,"runlogOffset":…}, 实际自 doc/17 §4(lastRunStatus)、doc/30 A1(lastRunId)、doc/35 A4(workspaceId)起 多三个字段。现按server.go的sessionResponse补全,并记下字段序 (liveRunId→runlogOffset→lastRunStatus→lastRunId→workspaceId), 另标lastRunId说的是「最新一场」而非「客户端在看的那一场」,判单场要用GET /api/runs/{id}。
同批同步:19v6-01 §5 的「六种 kind」、index 概念表的「五种」、doc/31 §2 的「五+1 种」—— 三处计数都指向同一份清单,改一处就得改三处。doc/27 §2 那处不动:它是 2026-10-16 的历史快照 (§2 标题就写着「代码事实,2026-10-16 核对」),改它等于伪造历史。 活体验收:起 8901 打真实字节——临时账号 + 已配租户模型,投一场真实 run: session 两条期望(跑中 / 定稿后)逐字对得上,字段序实测一致;frames 实拿到 start → delta → usage → terminal 四帧,usage 帧在真实响应里确实存在(eventOffset=3), 坐实了第 1 条漂移不是笔误。resume 帧不在这次实录里——它只在崩溃接管路径上产生 (字节与验收见 doc/30 §8.3 / §13 A8)。同批回填 19v6-04 头注(校准说明 + 实跑实录)。 回归:go test -count=1 ./internal/runengine 22.956s 绿、go vet ./internal/runengine ./cmd/yktako 干净。 四个 API 字节零变化——这批只改文档,代码一行未动。