tako 文档 GitHub

19v6-07 · compact(上下文压缩的 v6 形态)

本文是 compact 的机制裁定真源,自足成文:设计与链路的全部细节都在本文,不依赖任何台账 (tmp/ 下 planning/todos 是施工期工作文档、验收后即清理,不得作为细节去处被引用)。 C1 已落地部分(commit f09deb6)标「现状」,§3 的 C2 施工面已于 2026-10-11 全部落地 (C2 摘要调用规格 / C3 回归网 + 变异检查 / C4 doc 回填,实测记录在 tmp 台账「C 系列」节—— 台账验收后即清理,不并入本文);§5 两条登记的 C5 施工面亦已于 2026-10-11 落地 (结构化摘要 + 预算分档 + POST 准入 + fileOps 块,A1–A7,实测在 tmp 台账「C5」节)。 §1 的 limit 预留已于 2026-10-12 三期重裁:limit = window − min(window/5, 16384)(19v6-09 §9 落地;原 ×4/5 条已翻案,差分与数值实测在 tmp 台账溢出节)。 设计渊源:算法取 doc/12 §9,落点按 v6 前提重推(doc/12 的旧线载体——钩子 / run_archive / event_log / compact_rag——v6 均无对应物);2026-10-10 吸收 WeKnora internal/agent/compaction 全包实读的借鉴(出处为历史注记,内容本体在 §3/§5 自含)。

§0 范围与不变量

端到端链路(现状 = 实线,C2 施工面 = [C2] 标注):

POST → 抢闸 → goroutine Run(ctx)
  │
  ▼
prepareInput:
  读 mh 全序(user 行在 AcquireRun 时已入)→ countInput(system + 所有行文本,cl100k)
  │ ≤ limit(= window − min(window/5, 16384))─► 快速路:原样送 ADK 主循环(零行为差异)
  ▼ 超限
foldInput:run 粒度分组 → 旧摘要 seq=0 行并入 renderFold(「此前摘要,请合并进新的摘要」)
  → n 从 20 降,每档 summarize 一次:
       同一 ChatStream 流式排干 ──[C2] 转录分级截断 ──[C2] 低温 0.3 / stall 超时 / 重试分流
       ──[C2] 三层验货(算术主检 + 字符串辅检 + 缺失处理)
  → 塞得下 → stagedCompaction{DropRunIDs, Summary, AttachRun}
  → n=0 还塞不下 → errStillOver → status=error 零写入
  ▼
ADK 主循环(T1/T2 工具环)→ delta 帧
  ▼
defer EndRun(唯一出口):complete → 同一笔 PG 事务
  放闸 + 定稿 + UPDATE compacted=true + INSERT seq=0 摘要行(挂 AttachRun)
  error/闸失/进程死 → 零写入,下轮从原文重压
旁路(19v6-09 已立项,机制以该篇为准):provider 报「太长」/ 成功但被截断 → 强制压缩 + 只重试一次

§1 触发形态

§2 折叠算法(foldInput,compact.go)

§3 摘要调用规格(C2 施工面;括号注 = 现状)

§4 落库事务边界

§5 前方登记(每一条都含完整背景;各条立项/落地状态见条目内标注)

§6 验收用例(C1 验收结论:2026-10-08 通过,用户裁「直接算通过」)

验收话本:会话攒到超窗(dev 用小窗口旗标逼出),发下一轮时引擎自动把保留集合之外的已完成 run 压成摘要,模型凭摘要仍能回忆早已挤出的内容(锚点:先告诉模型暗号「蓝莓七号」,压完再问)。

判定标准: