tako 文档 GitHub

Handoff · v6 现状与能力差距(2026-10-07)

性质:纯 handoff / 快照文档,不改动任何代码。 触发对话(2026-10-07):用户问「现在的系统还差什么?可以对比 pi、weknora」。 本文记录:① 当日核实的 v6 现状快照;② 对比 pi / WeKnora 的能力差距(分「重建 / 从未做」两叠); ③ 下一步候选与挂账清单。留给后续会话对照:D1 验收、下个 loop 立项、doc/16 状态重标。 文中「现状」均逐条对过代码或台账;pi / WeKnora 结论来自当日对其仓库的实读盘点(结论级)。

1. 现状快照(2026-10-07)

1.1 构成

v6 新仓 yk-tako-eino/ 的全部 = 运行引擎 + 单会话聊天 UI + 模型配置层。

位置 内容
cmd/yktako/ 单入口;旗标 -engine -batch-window -dev -redis -pg -lease-ttl -lease-renew;启动双 fail fast(Redis / PG / 模型配置任一不可达不起进程)
internal/config/ provider-catalog.json(39 家厂商、openai/anthropic 两协议)+ .env 解析 + Eino ChatModel 装配;只支持 chat 一种模态
internal/runengine/ 四个 API + dev reset + Store(跨 PG/Redis)+ Worker(真 LLM 流 + translator 归一层 + watchdog)
web/ Vue3 + TS 单会话聊天(~950 行);U1–U6 + B1–B3 已验收

不存在:工具、护栏、看板、压缩、子代理、记忆、RAG、评测——旧线(v1–v5)已随 backup 整体出仓。

1.2 引擎已验收能力(A 系列全部销账)

1.3 未 commit / 挂账

未 commit 三笔(commit 粒度归用户):

  1. doc/19 拆篇:index + 19v6-01 契约 / 02 reconcile 与双游标 / 03 存储与生命周期 / 04 验收 / 90 演进记录,及全仓注释引用同步(含 web/src/{api,chat}.ts)。
  2. D1 全套:store.go / pgstore.go / store_test.go 新增、redisstore_test.go 删除、 redisstore.go 收窄、main/server/worker/types.go、go.mod/go.sum(+gorm/postgres、−miniredis)、 scripts/dev.sh(PG 自举半边)。
  3. chat.ts 后加两笔(晚于台账落盘、此前无记录;核准未提交清单时补记): ① B4#1 实修——fetchAssistantRow → drainLog:收口拉 log 时把游标经过的别人的定稿行 补渲染(renderForeign),本 tab 投递过的 user 行按 messageId 跳过;② 两处 D1 后过时注释 (「闸释放与 terminal 压入是同一笔原子写」)回填为「放闸与定稿同笔 PG 事务」的说法。 未 commit、未验收;chat.ts 因此不能按文件粒度折进 1 / 2 任一单批。

挂账(登记在案):

2. 差距分析(对比 pi / WeKnora)

2.0 先点名一个对齐问题

doc/16 §2 能力总表的 ✅ 列是旧线口径:它标的落点(internal/adkrun、internal/tools、internal/guard、 internal/taskboard、internal/compact、internal/mediaoffload、internal/webui)在当前仓均不存在。 下次维护 doc/16 时需重标——建议拆「旧线达成(历史)/ v6 现状」两列,避免把「做过的」继续当「现在有的」。

2.1 两叠清单

A. 需在 v6 重建(旧线达成过、代码已出仓、设计仍在 doc/):

能力 设计文档 v6 接缝(已预留处)
主循环 + 工具集(read/bash/edit/write 等) doc/05、08、09 run_model_messages 的 role 锚 OpenAI 标准(tool 行随 loop 进);runlog 扩展行(tool_call/tool_result)已裁「进 runlog、种类由 role 取值承载」
工具安全三件套 + 审批(放行/硬拒/暂停问人) doc/06 「暂停问人」吃 hitl_prompt/hitl_reply 行;payload 列形状待立项时定(planning §8.6 ⑤)
任务看板(Plan/Tasks/Actions) doc/01、02、07 扩展行进 runlog 的裁定已覆盖;重建时用已裁名 tasktracker(见 doc/XX-taskboard-重命名-handoff.md,改名当时未执行)
上下文压缩 doc/12、13 落点已裁:run_model_messages 打 compacted 标记(原文保留)+ 每被压 run 一行 seq=0 摘要;触发者/摘要 role 未定
media_offload(图片落盘换占位符) doc/18 —(旧线末期遗留五问记录在 doc/log/2026-09-30-uncommitted-review-handoff.md)
Web 端旧能力(审批 / 停止 / 事件回放等) doc/10、11、15 现 web 只有聊天 + 连接自愈(reconcile / 双游标 / 409 排队 / 僵尸 sid 自愈)

B. 从未做过(doc/16 的 ⬜):

2.2 对照要点(每源最值得偷什么)

pi(TS 极简 agent):

WeKnora(Go,Eino 类库参考):

steer 附注:运行中插话——pi 有 steering/follow-up 双队列,WeKnora 有生产版收件箱 (inject/after 双模式、队深上限 10、SteerID 幂等键)。tako 现裁 = 409 + 客户端本地排队(B1 已落), 属「明确不做」,不是遗漏。

2.3 归纳

引擎层(多副本正确性、崩溃自愈、纯拉取收敛)是刚打稳的地基,比两个参考源的同位物更彻底; agent 能力层几乎全空(重建 + 从未做两叠);产品层(多会话管理、多入口、多模态、多用户)按 T3 排队。

3. 下一步候选(不预拍板,供立项对话)

  1. 工具循环 + 基础工具集——T1 三项(子代理 / 记忆 / context_usage)共同的前置,引擎 schema 已预留写入口, 也是第一个「重建」项。立项时第一个要拍的问题:循环走 Eino ADK(旧线路径,middleware/checkpoint 现成) 还是手写 ReAct(WeKnora 路径)还是在 v6 worker 上扩展——它决定 tool 消息写入 run_model_messages、以及 runlog 扩展行 payload 的形态(planning §8.6 ⑤)。
  2. doc/16 状态重标到 v6 口径——小活,可与 1 同拍或先行。
  3. D1 验收(用户点头后才谈 commit 粒度)。
  4. 挂账零星项(§1.3)按用户发话逐个开 action。

4. 环境与纪律(给接手会话)

# 起全栈(前台,Ctrl-C 一起停;Redis/PG 缺啥自举啥,已有监听者复用不杀)
./scripts/dev.sh            # 引擎 8901 + vite 5173 + Redis 6390 + PG 5433
./scripts/dev.sh status     # 同理 stop;多实例按 ENGINE_PORT 区分

# 单跑引擎 / 单测
cd yk-tako-eino             # .env 只查 CWD,必须从本目录起
PATH="$HOME/sdk/go1.27.0/bin:$PATH" go run ./cmd/yktako -engine 127.0.0.1:8901 \
  -redis 127.0.0.1:6390 -pg "host=127.0.0.1 port=5433 dbname=tako sslmode=disable"
PATH="$HOME/sdk/go1.27.0/bin:$PATH" go test ./internal/runengine/ -count=1   # 16 条真实例网

5. 关键文档索引

文档 内容
doc/19-v6/19-运行引擎架构-v6.md + 19v6-01..04/90 引擎真源:契约四 API / reconcile 与双游标 / 存储形态与生命周期 / 验收 / 演进记录
tmp/19-v6/planning.md + todos.md 执行台账(planning §8 = 落库施工规格;D1 实测记录在 todos 节末);不进版本库
doc/16-能力复刻总规划.md 能力总规划与梯队(状态列待按 v6 重标)
doc/01–18 旧线设计文档——重建时的设计来源;注意端点/协议措辞多为旧线口径,与 v6 冲突时以 v6 为准
doc/log/2026-09-30-uncommitted-review-handoff.md 旧线末期未清问题(mediaoffload 五问等)
doc/XX-taskboard-重命名-handoff.md taskboard→tasktracker 改名决策与影响面(改名未执行)
本文件 现状快照 + 差距分析 + 下一步候选