doc/ 文档索引
性质:索引,不是方案。本文只回答「这篇文档是什么、能不能照着施工、代码在哪、被谁取代」。 最后核对:2026-11-16。 状态口径:✅ 已落地 · 🔶 部分落地/待收口 · ⬜ 未做 · 存档 = 历史材料,不作施工面。 代码路径均相对
yk-tako-eino/。
0. 先读哪篇
第一次进仓库,按这个顺序:
- 根
README.md:项目是什么、怎么把引擎和前端跑起来。 - 系统说明页:总览 → 单场 run → 长任务与编排 → 数据与存储。先建立结构,再读契约。(上面是线上版;离线看就克隆仓库后打开
doc/assets/下的同名 HTML——GitHub 上点 HTML 文件只会显示源码。) - 本索引:分清哪些文档能施工、哪些只是历史。
19-v6/19-运行引擎架构-v6.md:v6(第六代引擎,非服务版本)文档集总入口。- 契约与存储四篇,按这个顺序读:
19v6-01-契约-四个API.md:四个端点的请求/响应/错误字节。19v6-03-存储形态与生命周期.md:四表 + 两键(runlive / runepoch)、真源划分、多副本。19v6-02-reconcile与双游标.md:客户端轮询与游标。19v6-04-验收-curl.md:用例 → curl → 期望字节。
想在浏览器里读: 在线 https://ykworm.github.io/yk-tako/;本地 doc/html/ 下每个 md 都有一页网页版(站点首页 doc/index.html · 本索引的网页版 doc/html/index.html),由 scripts/build-doc-html.py 从 md 自动生成。内容以 md 为准——网页版是同批生成的读物,改了 md 要重跑脚本,别直接改 html。
按任务查:
- 改运行引擎、API、存储:先读 19-v6 四篇,再查本表第 1 节。
- 加工具、改子代理:
19v6-05、19v6-08、doc/23、doc/25、doc/26、doc/39。 - 改上下文压缩:
19v6-07、19v6-09、19v6-10。 - 改登录、租户、会话归属:
doc/28、doc/34、doc/35。 - 改响应信封/业务码表:
doc/40(规则在根AGENTS.md,码表在 doc/40 §4)。 - 改契约字节、要重跑验收:
doc/19-v6/19v6-04(人读版)、scripts/acceptance/(机器真源与断言器)、yk-tako-eino/internal/runengine/contract_test.go(快闸)。 - 改 Eval/验收口径:
doc/45(场景化 Eval 框架,口径 2026-11-01 已拍板、未施工)、doc/56(公开基准与配对协议,已部分落地)、doc/83(Anthropic 思路稿,待点头;与 doc/45 并存,取代关系待裁定)。 - 改团队前端(切换器/成员管理/邀请落地页):
doc/36。 - 改界面可用性(markdown 渲染/会话历史入口/停止按钮/文件可达/破坏性操作与文案/md 文件按 markdown 渲染显示,doc/48 §10):
doc/48。 - 改侧栏项目树(项目 → 对话二级、10 条上限、展示全部):
doc/50。 - 改视觉(配色/字阶/间距/圆角/侧栏三段/手机抽屉/气泡):
doc/51。 - 加技能、改技能目录/加载/依赖/管理面:
doc/52。 - 改删除与档案清理(连带删会话、单场删除、保留窗口):
doc/37。 - 改记忆、召回:
doc/65(已落地:pipeline= PG 两层 + 抽取代理 + Redpanda;markdown=USER.md/ 项目runtime/memory/MEMORY.md同步直写);doc/29的线一已被 doc/65 取代,线二dialogue_chunks仍现行;想借鉴别家记忆设计(nanoMuse:防重/整理/变更账):doc/62。 - 改崩溃续跑:
doc/30。 - 改 Redis 临时键(移除 draft):
doc/38。 - 改流式端点:
doc/31。 - 改媒体/附件:
doc/32、doc/35。 - 接 MCP:
doc/33。 - 看产品路线与优先级:
doc/16。 - 不知道某块代码在哪、归哪个模块:
doc/53(模块地图)。 - 想知道「agent 怎么测、公开基准选哪个、哪些不该跑」:
doc/56。 - 改网络抓取(
web_fetch):doc/57。 - 改读文件(
read_file怎么分页)或 bash 大输出(留尾/全文落盘):doc/58。 - 改对话页的工具卡(哪些工具进气泡、摘要/失败/截断口径):
doc/59。 - 改多会话并发(切走保留/实例上限/空对话项目落点/侧栏运行中):
doc/60。 - 改持久 Task/多 Agent 编排:
doc/70、doc/72、doc/73;并行任务的工作区隔离、结果交接与发布恢复:doc/74(已落地)。 - 改后台命令(前台等待窗口/job 输出/停止/失联恢复)、
wait_task就地认领与路径账本:doc/82(已落地)。 - 改目标可行性判断、继任编排组与 handoff:
doc/75;改项目内容根、运行资源容器与整容器删除:doc/76(两篇 2026-11-13 已落地)。 - 改对话页右侧任务面板(项目 Task 常驻、处理项就地打开):
doc/77(已落地)。 - 改对话页右侧工作区(项目目录树、任务、Todo、文件标签与「改动的文件」回执):
doc/78(已落地;取代 doc/77 §3「Todo 不进面板」)。 - 改任务列表的会话过滤(任务面板/任务页默认「本会话」、可切「本项目全部」):
doc/80(已落地;取代 doc/77 §3「不按会话过滤」与 doc/78 §3 同名条款)。 - 想知道某个设计当时为什么这么裁、代价是什么:
doc/problems/(问题档案,按模块分组)。
不要先读: doc/archive/(旧线 01–15、18 与引擎 v3/v4/v5)与 doc/log/(历史交接与文章)。这些是历史材料,不是现行施工面。
1. 现行真源(施工按这些)
16 能力复刻总规划 🔶
- 落点:全仓;分篇见本表
- 产品能力总纲。2026-10-23 已按 doc/35–49 重基线:§0.1 现状快照、§2 表补 5b(子代理持久档案与 resume)/ 9b(团队协作前端)/ 12(项目目录)/ 13(删除与档案清理)、§2c 横切契约(响应信封 doc/40、临时键 doc/38)、§5.1 当前待做、§6 索引补齐 doc/23、24、35–49 与 v6 文档集;doc/48 与 doc/49 已落地并从欠账里划掉;2026-10-27 增补 doc/52 技能方案(已点头;A1–A4、B1–B8、C1–C5、D1、E1、E2、F1–F3、G1 已落地 2026-10-28,24 拍收口)。🔶=总纲自身仍列着 ⬜ 未做能力(IM/cron、场景化 Eval;多 Agent 协作已落地)
17 后续计划:代码子代理与记忆 🔶
- 落点:
internal/runengine/notes.go、bash.go、agents/、web/ - 笔记/执行/停止/搜索/子代理折叠已落地;§5 由 doc/22 取代,§6 由 doc/25 取代
- 落点:
19-v6 运行引擎架构 v6(index) ✅
- 落点:
cmd/yktako/、internal/runengine/、web/ - v6 文档集总入口;取代 v5
- 落点:
19v6-01 契约:四个 API ✅
- 落点:
server.go、types.go、product_api.go - 端点字节真源;含 SSE 端点(doc/31)的翻案标注。2026-10-21 校准:帧 kind 断言改七种(补
usage/resume)、session 响应补lastRunStatus/lastRunId/workspaceId
- 落点:
19v6-02 reconcile 与双游标 ✅
- 落点:
server.go、redisstore.go、store.go - 客户端流程与
eventOffset语义
- 落点:
19v6-03 存储形态与生命周期 ✅
- 落点:
pgstore.go、redisstore.go、store.go - 四表 + 两键(runlive / runepoch)、真源划分、多副本
- 落点:
19v6-04 验收(curl 手打) ✅
- 落点:—(被测端点见 19v6-01);机器版在
scripts/acceptance/ - 改契约字节必须同步改本篇并重跑。2026-10-21 校准:session 期望字节追平现行代码,头注附实跑实录。2026-10-22:机器可重跑版已入库——机器真源
scripts/acceptance/expected.json、断言器assert_contract.py、散文↔︎清单一致性check-expected.sh;「重跑」从此是一句命令,快闸在internal/runengine/contract_test.go
- 落点:—(被测端点见 19v6-01);机器版在
19v6-05 tool loop(T 系列) ✅
- 落点:
tools.go、agents.go、agentlog.go、midfold.go、toolsearch.go、profile.go - T1–T3 已落地;T4/T5(分级 + BM25
tool_search)2026-10-20 落地(A1ad1ab6b、A2a190f4d;A3 寿命验收、A4 回归收口)
- 落点:
19v6-06 工具分级与 deferred tools ✅
- 落点:—(纯机制背景篇,无代码落点)
- 非契约篇;client mode 已是终态底座,hosted mode 2026-10-21 裁定不接;厂商矩阵与链路留作背景
19v6-07 compact(v6 形态) ✅
- 落点:
compact.go、compact_test.go - C1–C4 已落地
- 落点:
19v6-08 文件工具族(F 系列) ✅
- 落点:
fileops.go、filetools.go、media.go - 文件工具机制与契约真源
- 落点:
19v6-09 溢出修复层 ✅
- 落点:
overflow.go、overflow_test.go - 一期/二期/三期均已落地
- 落点:
19v6-10 mid-run fold ✅
- 落点:
midfold.go、midfold_test.go - run 中途压缩;A5 已验收
- 落点:
19v6-90 演进记录 ✅
- 落点:—(修订记录)
- 只追加不篡改;契约本身看 19v6-01
21 同会话历史查找 ✅
- 落点:
search.go、search_test.go - H1–H5 落地;
search_history工具
- 落点:
22 网络搜索 ✅
- 落点:
websearch.go、websearch_test.go - 已切 DeepSeek
/v1/tools/search;结果始终落盘再给描述段
- 落点:
23 coder 规格 ✅
- 落点:
agents/coder.md、agents.go - §2 已逐字落盘;
tools:白名单挡search_history/web_search
- 落点:
24 用量账单、滤思考与折叠触发 ✅
- 落点:
compact.go、agentlog.go、worker.go - 计数、滤思考、Usage mid-run 触发
- 落点:
25 子代理进程内折叠 ✅
- 落点:
midfold.go、agentfold_test.go、agents.go(壳化装配) - 取代 doc/17 §6;A1–A3 已验收;2026-10-23 翻案落地壳化装配(per-delegation 重装的壳化变体:装载输入/观测面 run 级不动,实例每次委派新建,#1177 委派路径消除)
- 落点:
26 researcher 的工具护栏 ✅
- 落点:
agents.go、agents/researcher.md、agents/coder.md exclude_tools四态;排除清单只剩bash
- 落点:
27 用量可见化 ✅
- 落点:
product_api.go、server.go、worker.go、web/src/ - usage 帧/页面阈值/runlog 历史行
- 落点:
28 多租户运行时 ✅
- 落点:
auth.go、identity_store.go、members_store.go、tenant_api.go、scope.go、pgstore.go - 2026-10-21 收口。A0–A6 共 30 拍已落地并 curl 验收,随
9c21b66入库。团队前端不在本篇(doc/36 已落地);A7 那一档里「旧成功体换信封」已由 doc/40 于 2026-10-22 落地,计费、API key、SSO、组织共享、审计导出整批已拍不做(2026-10-22 用户裁,与运行时关系不大的商业化、合规项,§15;2026-10-23 复核维持)
- 落点:
29 长期记忆与对话召回 ✅(线一 2026-11-10 起被 doc/65 取代;线二 dialogue_chunks 仍现行)
- 落点:线二现行 =
dialogue.go、worker.go;线一旧实现(recall.go的 Go 侧词法召回、PG 轮询抽取循环)已退役 - A1–B4 全落地;两条加工线共用 runlog。2026-10-22:召回块改进「本轮输入」并写回 mh 的 seq=1(runlog 仍纯原话)→ mid-run 折叠不再抹掉它;块带 created time;计入折叠预算。折叠链本身未改
- 落点:线二现行 =
30 崩溃续跑 🔶
- 落点:
journal.go、worker.go、resume_test.go、web/src/api.ts、web/src/chat.ts、web/src/App.vue - A1–A5 已落地;A6 自动巡检 2026-10-21 裁为客户端触发式恢复(server 巡检不做);A8 前端 reattach 已落地并验收(interrupted 琥珀提示 +「继续这一轮」按钮,2026-10-21);A7 回归收口已跑(
go test -count=125.3s 绿、vet 干净、19v6-04矩阵重放全过)。2026-10-22:§10.1/§10.2/§10.4 的期望字节已随 doc/40 换信封(404112002、409 三态112102/112103/112104)
- 落点:
31 SSE 流式端点 ✅
- 落点:
server.go、redisstore.go、stream_test.go - 同一帧面的第二种运输方式;拉是正确性、流是优化
- 落点:
-
- 落点:
media.go、media_send.go、media_tokens.go、filetools.go、pdftext.go、pdftool.go、midfold.go、worker.go、guard.go、profile.go、compact.go、provider-catalog.json、media_test.go - 2026-10-21 收口,两个半边都落地(存储纪律 A1–A2;模型可见 A3 五拍)。A1–A7 已落地(dcf3e6b);A3-1 至 A3-5 已落地并活体验收(2026-10-20)。A3-5 按 DeepSeek v41 计价:800×800 为 422、100×100 为 184;窗口 940 上 814>752 进入折叠。A8-1 已施工并活体验收(2026-10-20,run
r_01M5CF1DFS9ZAD72GYQ5YXRYH8complete,assistant 含 banana,user 行仍是占位,该 run 两表零 base64)。A8-2 边界已活体验收(2026-10-20):第 3 页 runr_01M5CH3GN1Y9KDKPMJ90R0NPCS含 orange;第 99 页 runr_01M5CH3MM7HTQ2KDXA36YWW35M返回 pages=3 与超出范围;扫描件 runr_01M5CH3RM7JY9GS0CX779Y5S0Y写明无文本层;音视频 runr_01M5CH3WK609YQJBGFVCAQ4BDN上read_pdf_text拒绝非 PDF;TAKO_MEDIA_SEND=off的 runr_01M5CH5KCY1RQA6T7Z1QY0YW7Y仍读到 orange 且无 media send 行。这些 run 的两表零 base64。扫描件 OCR 不做。2026-10-22:media 的 404 按 doc/40 拆成三个码(114001项目看不见/114101文件不存在/114102路径不对),成功体仍是图片字节、不进信封
- 落点:
33 MCP client ✅
- 落点:
mcp.go、mcpconf.go、mcpconf_test.go - stdio 本地 server;工具直接进池
- 落点:
34 租户运行时装配 ✅
- 落点:
tenantmodel.go、agents.go、mcpconf.go、tenant_runtime_test.go、web/ - R1–R5+U1 已落地并浏览器验收;commit 9c21b66
- 落点:
35 项目目录(workspace) ✅
- 落点:
product_store.go、session_access.go、media.go、web/ - 2026-10-21 收口。A1–A8c 共 13 拍已落地并 curl 验收,随 e30d1f9 入库;路径方案取代 doc/32 的
sessions/<sid>/版。第 0 节第 3 条「删除只删空项目」已由 doc/37 改写(2026-10-21 已落地):有会话改为连带软删,114002退役,活 run 用114006,单场删除用114007
- 落点:
36 团队前端(切换器/成员/邀请) ✅
- 落点:
web/(App.vue、MembersView.vue、InviteLanding.vue、PendingInvites.vue、auth.ts);G1/G3 小改在product_api.go、product_store.go - 2026-10-21 已落地,随
0fd15c5入库:切换器/成员页/邀请落地页与待处理邀请;收尾 build/test/vet 全绿
- 落点:
37 删除与档案清理 ✅
- 落点:
pgstore.go、product_api.go、session_access.go、store.go、server.go、worker.go、archive_sweep.go、auth.go、cmd/yktako/main.go - 2026-10-21 已落地。D1、D2 随 0fd15c5 入库;D3、D4 在 8905 curl 验收后入库。改写 doc/35「删除只删空项目」;单场删除仅属主;清扫器持
cleaner_state租约,-archive-ttl默认 168h,探针POST /api/dev/clean-sweep。114002退役 - D-l 已落地(2026-11-10 随 doc/65):按 scope 删除——
pipeline清该项目两层scope='workspace'的memory_items与相关memory_jobs,保留跨项目user行;markdown的项目MEMORY.md随目录删除、用户USER.md不动;两种模式都清dialogue_chunks,租户归档不动记忆行。代码在pgstore.go删除事务与memory_migrate.go;活体scripts/acceptance/memory_project_delete_live.sh(9/9)
- 落点:
38 删除 tk:draft 键 ✅
- 落点:
redisstore.go、store.go、server.go、worker.go、store_test.go - 2026-10-20 已落地;定稿正文来自 turn,写口只认 runepoch
- 落点:
39 子代理持久化与 resume ✅
- 落点:
agents.go、subagent_wire.go、resume_subagent.go、archive_sweep.go、worker.go、server.go - 2026-10-21 已落地。S1 随 e476749 入库;S2、S3 在 8905 curl 验收后入库。每实例追加式 wire(
.tako/subagents/,无 PG 表)+resume_subagent(只认完整档案;不做半截重接,对齐 doc/30)。第三类清扫挂在 doc/37 同一轮,只删过窗文件
- 落点:
40 响应信封统一 ✅
- 落点:
auth.go、server.go、mcp.go、product_api.go、archive_sweep.go、envelope_test.go、web/src/api.ts、web/src/chat.ts - 2026-10-22 落地,随
cd85050入库。A7-1…A7-8 共 8 拍:后端六拍(curl 逐字节)+ 前端一拍(Playwright 活体)+ 收口一拍。runs/sessions/mcp/media/memory 五组旧接口整包换{code,message,data};不动存储、不动帧格式、不动 HTTP 状态码;media 的二进制成功体与 SSE 帧面不进信封。台账tmp/A7-信封迁移/(不入库)
- 落点:
41 任务看板与人工审批 ✅
- 落点:
pii.go、pii_test.go、pii_mount_test.go、tasktools.go、tasktools_test.go、tools.go、midfold.go、memory.go、worker.go、pgstore.go、server.go、contract_test.go、store_test.go、web/src/{api.ts,chat.ts,App.vue}、scripts/acceptance/taskboard_crash.sh - 2026-10-23 落地。B(PII 脱敏)+ C(任务看板)两线全施工;Loop A(人审回路)整条不做(bash 与 MCP 的越界都由沙箱围栏硬挡 → 没有需要挂起问人的场景,§3.1 与 §6 的 A1–A7 留档备查)。PII 三处挂载点:工具统一出口
wrapToolErrors(含 MCP)+ 模型输入唯一转换口toSchemaMessages(覆盖折叠后)+ 记忆入库前(密钥拒收 / 证件打码)。看板:PG 表run_tasks+ 四把工具 +kind=task帧(词表 7→8)+ 前端看板块;活得过崩溃(kill -9 → 重启 → resume,崩前建的行一条没丢且续跑里继续更新)。task 帧字节在 doc/19-v6-04「用例 8」登记为暂不断言(模型行为不稳)。对应 doc/16 §5.1 第 1、2 项与 §2 表 #2/#3
- 落点:
42 产品形态收窄与共享项目退役 ✅
- 落点:
pgstore.go、store.go、product_store.go、product_api.go、server.go、auth.go、filetools.go - 2026-10-22 落地,随
44cf7ca入库。形态定稿:tako = 多租户的 AI 工作台,一个员工 = 一个项目,项目文件由多 session 共享,团队共享账号/额度/审计、不共享文件(不做协同编辑)。退役两样:跨成员共享项目(可见性判定只剩属主;PATCH /api/workspaces/:id/visibility端点留着路由恒回 404114001;114004退役)、项目闸(one_live_run_per_workspace索引 DROP,同项目并发不再被 409 挡)。另:不再有游离会话——每场 run 自动挂默认项目
- 落点:
43 租户并发闸入 DB ✅
- 落点:
store.go、scope.go、server.go、product_api.go、store_test.go、scripts/acceptance/tenant_gate.sh - 2026-10-23 落地。租户并发上限(
tenants.max_concurrent_runs,默认 8)那道闸原来在 API 层「数一遍 → 比上限 → 放行」,数与放行是两次独立的事 → 并发下超发(活体实测:上限 2,并发四打进来 4 场)。现在数与放行收进同一笔 PG 事务,中间持一把所有副本共享的顾问锁(pg_advisory_xact_lock)→ 并发下不可能超发。无 DDL、无存量迁移、计数口径逐字不变(僵尸行不算活,不误拒)、契约字节不变(满租户仍回 429113001)。回归网:存储层TestTenantGateConcurrent(摘掉闸即红)+ 活体tenant_gate.sh。对应 doc/16 §2c「闸在数据库」
- 落点:
44 前端三处欠账 ✅
- 落点:
web/src/{api.ts,chat.ts,App.vue,ProjectsView.vue,ConfirmDialog.vue} - 2026-10-23 落地。三处前端入口:个人项目页(列表/新建/改名/删除/项目下会话/开新对话)、项目与单场会话删除 + 确认弹窗(服务端 409 文案原样显示)、当前会话的子代理列表与「继续」(把带
sa_id的指令追加进输入框,由父 agent 调resume_subagent,不新增 HTTP 端点)。后端零改动。当前项目按租户存localStorage['tako.workspaceId.<tid>'],workspaceId只随新会话的POST /api/runs发送。对应 doc/16 §5.1 第 2 项与 §2 表 #5b/#12/#13
- 落点:
45 场景化 Eval 框架(方案) ⬜(方案待点头)
- 落点:—(未施工)
- 2026-10-23 立项。给「活有没有干完」建一层可机器重跑的回归——前两层(快闸
contract_test.go+ 契约scripts/acceptance/)只断"接口有没有按约定回",断不了"活干完了没有"(2026-10-23 PII 挂载点选错时两层全绿)。场景 = 准备/动作/判定/证据四件套;判定分 K 系统字节 / S 引擎裁决 / B 模型行为 / C 只登记 四组(按「判定锁在被测系统上」分,不按「模型会不会抖」分);判定 = M=M(跑 M 次全过才算过,M=5),不通过也逐次记录;红的成因分归因(engine_regression/model_below_baseline/model_baseline/unasserted/incomplete),只有前两者拦门禁;语料 = 17 条四组目录(K 7 / S 4 / B 4 / C 1 + 示例 2)。不改internal/runengine/生产代码——Eval 站在引擎外面看它。预计落点scripts/eval/(复用scripts/acceptance/harness.py,不另起 HTTP 底座)。对应 doc/16 §2b 第 6 行与 §2c「验收可机器重跑」第三层
46 变更同步与事件通道 ✅
- 落点:
yk-tako-eino/internal/runengine/{events.go,server.go,auth.go,product_api.go,contract_test.go}、web/src/{mutation.ts,api.ts,chat.ts,App.vue,ProjectsView.vue}、scripts/acceptance/events_live.sh - 2026-10-23 落地。多 tab 失效通知的根治:Loop A BroadcastChannel 同机广播 + 统一失效函数(清落点/重拉列表/会话已删横幅)+ 投递 114001 自愈;Loop B 账号级 SSE
GET /api/events(Redis Streamtk:events:<tid>第三临时键,XADD写口=变更端点横切契约;Last-Event-ID续传、新连接从$起;?access_token=兜底鉴权)——doc/16 #8b 前置。前端 EventSource 与广播并存、同喂一个 dispatch。活体:B2 七条 + B3 三条全过;用例 9 进expected.jsondeclared_not_asserted(events_live.sh判红)+TestContractStreamEventBytes快闸。doc/16 §2c 扩两行
- 落点:
47 Plan 审核与追问澄清 ✅
- 落点:
runengine/{questions.go,waittools.go,plangate.go,journal.go,worker.go,server.go,store.go,pgstore.go,types.go,store_test.go,contract_test.go}、web/src/{chat.ts,App.vue,api.ts}、scripts/acceptance/question_crash.sh - 2026-10-23 立项并落地。Q(ask_user):
run_questions表 +kind=question帧(词表 8→9)+ 三拍(落行/发帧/轮询)+ CAS 一答终答 + resume 重放第三分支 + options 快捷选项;P(plan gate,A 形态=kimi 式运行时守卫):模型自主调enter_plan_mode,planGuardHandler黑名单硬 deny 写/执行,submit_plan复用等人机器过人审(可编辑方案卡),批准注回并放行。P/Q 共用一张表(kind 列)一种帧一套 resume 分支;新增15人审与问答段(115002/115101)。question_crash.sh16 条断言验「挂起中 kill -9 → resume → 答 → complete」;seed-question脚手架已转只读question-check。翻 doc/41 §7「不做 Plan 层人审 gate」之案(用户 2026-10-23 拍) - 2026-11-03 补记(§5.5):一场 run 的正文按等人工具分段——仍是一条 Σ assistant 行,payload 加
segments:[{end,toolCallId}](rune 偏移);历史/收口/实时同套切法,问题卡挂切点前那段,已答自由文本问题紧跟右对齐答案气泡。questionView补toolCallId,answer对 question/plan/install 全量返回。无提问 run 的 payload 字节不变
- 落点:
48 前端可用性欠账(方案) ✅(2026-10-23 全部 17 拍落地;2026-11-14 补充 §10:md 文件按 markdown 渲染显示、默认预览态可切「原文」,doc/79)
- 落点:
yk-tako-eino/web/{playwright.config.ts,e2e/,test/,src/{App.vue,ProjectsView.vue,WorkspaceFileView.vue,Configure.vue,MembersView.vue,api.ts,chat.ts,markdown.ts,markdown.css}}、yk-tako-eino/internal/runengine/{product_api.go,server.go,contract_test.go}、scripts/acceptance/{expected.json,harness.py,assert_contract.py}(新增:文件清单端点GET /api/workspaces/:id/files、项目对象的isDefault字段;markdown 渲染走marked+dompurify) - 2026-10-23 立项。2026-10-23 浏览器走查(四个页面 × 两种视口宽度 + 只读 API 交叉核对)逐条验出 17 条界面现象(归并为 14 项修复):markdown 渲染是 v6 契约违背(19v6-03:118 写明「客户端按 markdown 渲染」,代码是纯文本插值);后端早有的能力前端没入口(停止端点
POST /api/runs/:id/stop一次没调 / 跨项目会话列表GET /api/sessions前端从不裸调 / 文件字节出口GET /api/media只有图片在用);agent 产出的文件用户拿不走(项目页不列文件、文件片不可点)。分 4 个 loop 17 个 action,只有 2 条动后端(B1 新增GET /api/workspaces/:id/files、C1 响应体加isDefault字段)。台账tmp/48-前端可用性欠账/(不入库) - 2026-11-14 补充(doc/79):项目里的
.md/.markdown在两个入口(对话页右侧文件标签、项目页文件列表)按 markdown 渲染显示、默认预览态、可切「原文」;排版样式抽成全局.md-body三处共用(Vue 的 scoped 样式不跨组件,抄不进第二个组件);渲染复用markdown.ts既有管线(marked + DOMPurify),md 用breaks: false、气泡仍breaks: true;先截断后渲染、不把 token 拼进 URL。纯前端、契约字节零变化;单测 8 条 + playwright 2 条新断言全绿。详见 §10
- 落点:
49 走查缺陷修复 ✅(已落地,2026-10-23)
- 落点:
internal/runengine/{agents.go,product_api.go,server.go,accesslog_test.go,agents_test.go}、web/src/{chat.ts,App.vue,Configure.vue,ProjectsView.vue,InviteLanding.vue,markdown.ts,auth.ts}、web/test/markdown.test.ts - 2026-10-23 立项并于同日落地。doc/48 落地后的第二次全站走查:Playwright 逐页点击 + 真停止 + 跨标签页 + 窄屏 + 引擎日志对读,逐条验出 12 项。1 项 P0:子代理名字含空格/中文 → 厂商
tools[i].function.name400 → 整个租户所有 run 失败(保存/导入/落盘三个入口都没校验);5 项 P1:停止/失败刷新后整轮消失、等人面板被别端停掉后卡死输入框且等待期间无停止入口、删除会话事件不剪侧栏(死链点进空对话)、新建同名内置助手静默清空说明/规格/工具、导入默认可见性(团队)与手工新建(仅自己)相反;6 项 P2/P3:报错带 HTTP 状态码、refresh 失效静默登出、邀请页印错邮箱、复制失败无反馈、密钥空名行谎报成功、灯箱不能关/不放大、名字无长度上限、自动链接吞中文标点、项目页两句话与行为不符、访问日志含完整access_token。四问按推荐值落地(§14),落地与验收记录见 §15。台账tmp/49-走查缺陷修复/(不入库)
- 落点:
50 侧栏项目树(方案) ✅(A1–A5 已落地 2026-11-15)
- 落点:
web/src/App.vue(只此一处) - 2026-10-24 立项。侧栏从「最近 10 条扁平会话 + 内部滚动条」改为全部项目 → 各自对话的二级树(手风琴、默认全展开、空项目显示「还没有对话」):整栏合计 10 条、超出点「展示更多」就地 +10、全展开后变「收起」;每个项目再限 10 条,项目内超出时该项目下出「展示全部」,点开只放开这一个项目;项目名前是文件夹图标(开口=展开、合口=折叠)。列表内滚动条已删。后端零改动(
GET /api/workspaces+GET /api/sessions现有字段够拼)。A1 数据层/A2 树与空态/A3 展示更多/A4 双层上限与图标均已浏览器验收;A5(workspace_renamed/workspace_deleted事件重载、窄屏、文档回填)已于 2026-11-15 收口(App.vue的onMutation对上两类事件即重拉侧栏树,窄屏一项由 doc/51 U6 覆盖;Playwrightweb/e2e/sidebar-events.spec.ts,commitcba0339)。台账tmp/50-侧栏项目树/(不入库)
- 落点:
51 UI 视觉重做 ✅(已落地,2026-10-24)
- 落点:
web/src/base.css+web/src/App.vue+web/src/{ProjectsView,Configure,MembersView,ConfirmDialog,InviteLanding,PendingInvites,PlanDoc}.vue(样式段;后端零改动) - 2026-10-24 立项并于同日 U1–U7 落地。token 层先行(8 个组件 150 处硬编码颜色 →
base.css变量),中性现代风(浅灰白 + 单一蓝强调、白卡细边、无暖阴影);侧栏三段式修掉 900px 高时底栏压住树;三页骨架/弹层统一 860px 列、22px 标题、12px 卡片、28/32 控件;对话列 720px、气泡 ≤86% 且用量/复制移到气泡下方;≤860px 顶栏 52px + 280px 抽屉(遮罩 /Esc/ 开会话三法关闭,焦点往返、aria-modal);四档 1440/1024/700/390 收口:无横向溢出、正文 16.88:1、次要 4.51:1、控件高 28/32、行高 30/34。不改后端契约、不改交互流程、不改 doc/50 的树逻辑。台账tmp/51-UI重做/(不入库)。2026-11-03 改口径:对话列去掉 45rem 上限、铺满内容区(左右 1.5rem),助手气泡 100%、用户气泡 78%;手机断点仍是 100% − 1.2rem(doc/47 §5.5)
- 落点:
52 技能(Agent Skills) ✅(已落地 2026-10-28;A1–A4、B1–B8、C1–C5、D1、E1、E2、F1、F2、F3、G1 全部施工并验收,24 拍收口)
- 落点:A1 已落:
internal/runengine/skills.go(skill_rows/skill_disables两张表 +GET /api/skills)、internal/runengine/pgstore.go(建表与部分唯一索引(tenant_id, name) WHERE valid)、internal/runengine/server.go(路由);契约字节scripts/acceptance/expected.json用例 14 +doc/19-v6/19v6-04-验收-curl.md同号散文。 - A2 已落:
internal/runengine/skills_scan.go(POST /api/skills/rescan、frontmatter 解析、扫盘)、internal/runengine/skills_test.go(解析与扫盘单测);库级两级锁(pg_advisory_lock会话级,全局共享 + 租户独占);-system-skills-dir旗标(cmd/yktako/main.go);契约字节用例 15。 - A3 已落:系统管理员全量重扫(
-bootstrap-admin-email;全局独占锁;系统根 + 每个租户根;系统行落空串桶);系统根读失败 → 整次中止不删行、读到 0 条 → 只报数不删行;租户级重扫只涉本租户根与本租户的行;跨桶同名按「先占的生效」显式比;平铺形态也进扫描;契约字节用例 16。 - A4 已落:
GET /api/skills/:name详情(租户视界解析、body逐字原文、missing恒空数组);契约字节用例 17。 - B1 已落:
internal/runengine/skilltools.go(<available_skills>目录、read_skill/use_skill/read_skill_file占位、子代理剔除四名)、profile.go(目录只拼 manager Instruction)、agents.go、worker.go、types.go(Frame.toolCallId)、store.go(payloadtoolCallId)、server.go(GET /api/runs/:id/skills空实现);契约字节用例 18 + 用例 1 末步。 - B2 已落:
read_skill真身(租户视界查行 → 禁用闸116107→ 读盘剥 frontmatter →&/<转义成<skill name source bytes>正文</skill>,不带path;超 16,384 token/64KB 回116116不截断;计数器由工具自己懒构造,-compact-window=0照判)、目录转义补齐、auth.go(116107/116116)、skilltools_test.go(切分/转义往返/两条上限/信封逐字);契约进declared_not_asserted用例 19 + 同号散文。 - B3 已落:
use_skill真身(与read_skill同一条读路、成功回执逐字相同;成功时把{name, root}记进 run 内技能盒子skillbox.go)、sandboxProfile(root, extraReadRoots)(盒子里每个技能根只加只读file-read*;sandboxWrap传nil;子代理在runSubagentGuarded换空盒)、(allow network-outbound)+/private/etc/ssl实测补丁(D37;入站不开)、commandInsideRoot/sandboxRealPath两侧Abs()(修-workspace传相对路径时租户 MCP 全被判围栏外)、skillbox_test.go/skillfence_test.go/mcpfence_test.go(相对根)、验收夹具scripts/acceptance/mcp_fetch_server.py;契约进declared_not_asserted用例 20 + 同号散文。 未施工:拟落skills_install.go、skillops.go、tools.go、web/src/SkillsView.vue、web/src/ToolsView.vue;另涉internal/runengine/{compact.go,fileops.go,sandbox.go,bash.go,agents.go,tasktools.go} - 2026-10-27 立项。本地 Markdown 技能包:安装时校验
name/description(≤1024 字符),run 装配时读skill_rows(PG)生成<available_skills>目录(派生视图,同一场 run 只算一次,装配不扫盘);盘上的偏离靠写入口与rescan收;目录不截断,成本靠作用域/禁用两把闸控(不做技能搜索——目录体积是已知天花板);2026-10-28 执行模型翻案:取消内置skill agent,manager(根助手/主代理)自己read_skill/use_skill读正文、自己执行,正文里的步骤展开成看板任务(run_tasks加skill_name列)——正文是说明书、任务是替身,压缩时正文可折、任务不折;普通子代理仍技能盲(池里无技能工具、bash 看不到技能根);正文以<skill name=…>包裹进上下文(trim 整块替换不夹切),折叠时程序侧钉「技能记录块」进摘要末尾;不做技能市场,但认来源串与npx skills add …命令串(严格解析、原生抓取、不执行 npx),对话里也能装(skill_install,只建不覆盖),删除只有管理面;系统技能与团队技能都在共享 PVC 上(系统技能部署时从仓库同步、应用只读)、项目删除不伤真身;staging→rename 原子更新;requires安装时LookPath检查;2026-10-28 第十四轮:新增工具上传写面(GET/POST/DELETE /api/tools,单文件、文件级校验、不执行不探测),工具根<tenant>/tools按租户常开(所有角色含普通子代理可用、bin前置进PATH),技能根仍证据收窄——缺ffmpeg团队自己补,不必等运维;2026-10-28 第十五轮:bash 围栏放开出站网络(D37,租户 MCP 一并生效),use_skill返回时按requires现查并在<skill>标签给missing(D38,不阻断、只提示上传);子进程PATH只留围栏读得到的目录,围栏外解释器报command not found而不是 EPERM(D39);帧与 runlog 补toolCallId。Linux 沙箱单独 loop。待拍项见该篇 §9。 - B4 已落:
read_skill_file换真身——资源根内解析path(拒绝对路径与任何一段..,EvalSymlinks后判包含,软链越界同116114),入口SKILL.md用os.SameFile认出并指向read_skill,目录回不递归条目列表,文件与正文同一条上限(超 64KB/16,384 token 报116115、不带部分内容);GET /api/runs/:id/skills改从 runlog 真派生(toolCallId配对、seq排序、path只在read_skill_file行);落点skilltools.go、skills.go、server.go、auth.go、skillresource_test.go - B5 已落:
run_tasks加skill_name(TaskCreate按本 run 最近一次use_skill盖戳;read_skill不盖);taskBoardView每行带「(技能:名字)」(TaskList/写回执/kind=task帧同源);task 帧加顶层skillName;落点tasktools.go、skillbox.go、types.go;契约字节用例 22。 - B6 已落:
TaskList读侧拼「上一场」(未完成行 + 说明;全完成一行提示),写回执与 task 帧不带;run 装配按看板skill_name把技能根补回 bash 盒子(续跑查本 run、新 run 查上一场,逐项重判);落点tasktools.go、skillrestore.go、worker.go;契约字节用例 23。 - B7 已落:正文用完让位(D33)——
skillslim.go从行序算「更晚的地方建过TaskCreate」的read_skill/use_skill结果,slimSkillBlocks每枪在BeforeModelRewriteState最上面把正文换成<skill name="…" folded="true" reload="read_skill" tasks="见看板"/>(state 与 base 一起改,-compact-window=0也执行);fold 转录写 marker、trim 不进预算与还原队列;runlog 仍是全文。 - B8 已落:
skillops.go技能记录块(<!-- tako:skill-ops v1 -->,用过/看过两组,旧摘要继承 ∪ 本次提取,与 file-ops 块并排钉摘要末尾、同一套三档收口);trim 对<skill>块整块替换;摘要里不写正文、不写看板任务号。契约字节用例 24。 - C1 已落:
skillinstall.go安装/更新/删除——multipart zip/tar.gz(按魔数判格式),staging 内解包校验(zip slip/软链/层级/文件数/总字节/正文上限),锁内只搬目录与写行(旧目录进.trash/<name>-<ts>);同名冲突 install 用skillNameTaken(同桶也算)、update 用nameTakenInView;DELETE同事务删skill_rows与skill_disables;POST /api/skills/install(201)、POST /api/skills/:name/update(200)、DELETE /api/skills/:name({"status":"deleted"}),写面只给 owner/admin。契约字节用例 25。 - C2 已落:
skillsource.go(来源串/npx skills add命令串的严格解析:只认owner/repo、@ref/#ref、tree/<ref>/<subpath>、GitHub/GitLab/归档直链;命令用自写分词器,不执行 npx,拒绝;\|<>$()与换行)+skillfetch.go(原生抓取:拨号前解析并校验 IP、直接拨已验证 IP、禁代理、重定向 ≤5 跳每跳重验、拒回环/私网/100.64.0.0/10/元数据地址;GitHub 走codeload.github.com// /tar.gz/<ref|HEAD> ,GitLab 先查default_branch)+skillresolve.go(POST /api/skills/preview、来源安装POST /api/skills/install的{source}/{command}分支;歧义 116108 带data.skills);仓库归档容忍 PAX 头与非普通文件(上传仍拒)、frontmatter 名优先于目录名(只警告)、多行/折叠式 frontmatter 与requires:` 块序列;契约字节用例 26。 - C3 已落:对话内安装 HITL(D20/D24)——
skillask.go新建,skill_install只提议(解析 →.staging→run_questions(kind=install)行 →kind=question帧 → 挂起),approve 由答案端点 CAS 赢下后由程序装盘(重新校验 staging 路径、重扫候选、同一把锁、删 staging、发skills_changed),cancel/过期/未知三种收尾文本;角色闸在answerQuestion里按「可读 run +roleRank>=admin」判(viewer 403111203,不走只放 owner 的denyRunWrite);续跑不重装;Store.PublishEvent+ 事件词表新增skills_changed(doc/46 §7.6);契约字节用例 27(declared_not_asserted,活体字节在 19v6-04 用例 27)。 - C4 已落:
web/src/SkillsView.vue(列表/描述折叠/详情抽屉/上传/删除确认/invalid 区/重扫;按 doc/51 浅色皮肤);导航新增「技能」(Page+App.vue模板分支);api.ts技能类型与调用、mutation.ts事件类型加skills_changed、列表收到事件自动重拉。同拍补PATCH /api/skills/:name的服务端半(SetSkillDisabled幂等写/删skill_disables、回data.skill、发事件、admin 闸),E2 收剩余口径与契约用例。npm run typecheck/build绿,活体浏览器验收(列/详情/开关/上传/删除/重扫)。 - C5 已落:
web/src/SkillsView.vue安装入口收成一个输入框+「预览」(来源串/整条npx skills add …/本地包 multipart),预览卡列全部候选(名字、描述、字节 · 文件数、依赖、已选✓/未选○)与 warnings;web/src/SkillInstallCard.vue新建,只按kind=install的args渲染来源/ref/候选全表/选中集/「本会话未出现」提示,owner/admin才出「安装」「取消」,其他角色只看到「已提交,等管理员确认」;web/src/App.vue输入区与历史区共用这张卡(历史区无按钮),对话页工具卡use_skill/read_skill/read_skill_file(按toolCallId配对、失败显示结构化 message);web/src/chat.ts的 install 行带answer复述;服务端 preview 补selected(与执行同一套默认)与候选files,questions列表只对 install 行回answer。 - D1 已落:
requires从「存着」变成「三处同源地用」——use_skill成功标签多两个属性requires="…" missing="…"(read_skill逐字节不带;missing调用那一刻现查、不阻断),列表/详情的missing[]同源现算,新端点GET /api/skills/:name/check回{dependencies:[{name,found,path?}],checkedOn:"host"}(安装/更新响应用同一形状);子进程PATH与沙箱 profile 共用sandboxReadRoots(subprocesspath.go逐段EvalSymlinks+保序去重),围栏外解释器报command not found而不是Operation not permitted,检查说找到的路径与 bash 解析到的是同一个;落点sandbox.go、subprocesspath.go、skilldeps.go、bash.go、skilltools.go、skills.go、skillinstall.go、server.go、web/src/{api.ts,SkillsView.vue};契约字节用例 28(+ 用例 25 形状改动),单测subprocesspath_test.go/skilldeps_test.go。 - E1 已落:manager 规格的
skills:/exclude_skills:(parse 层同写拒载;skills: []靠指针非 nil = 一个都不要)落成tenant_agents/agent_defaults的skill_policy列,JSON 面{"mode":"allow\|exclude\|inherit","names":[…]}(agent 读写与导入认skillPolicy);作用域在四处解析时点生效——装配期目录过滤、read_skill/use_skill共用的loadByName、read_skill_file、D35 看板恢复;范围外名字与「表里没有」同回116001同字节;普通子代理写 allow/exclude 在入口 400111002(JSON 与 md 导入同判),出厂规格 seed 时日志拒载,显式inherit放行;落点agents.go、product_store.go、product_api.go、skills.go、profile.go、worker.go、skilltools.go、skillrestore.go、新文件skillscope.go,测试skillscope_test.go/agents_test.go;活体抓到UpdateAgent漏写skill_policy并补列+回归测试;契约字节用例 29。 - E2 已落:禁用收口成可撤销、按租户、不被吞的开关——
PATCH /api/skills/:name只写skill_disables(false = FirstOrCreate、true = Delete,两方向幂等),不碰skill_rows、不碰盘;目录装配与read_skill/use_skill/read_skill_file读同一张禁用表(禁用后目录无它、调用回116107),正在跑的 run 盒子不回缩;写面owner/admin(viewer 403111203、未登录 401111102);禁用/恢复各发一条skills_changed,字节按 doc/46 §7.6{seq,type,id,at}(台账原写的{action,name}作废——action 是状态,事件带状态会诱导客户端就地改副本而不重拉);DELETE同事务清禁用行(重装同名回enabled:true,行为可证);落点skills.go、events.go、skilltools.go、web/src/SkillsView.vue;验收原语新增invite_viewer与tokenVar(「有身份但角色不够」不能用 401 代替);契约字节用例 30(15 步)与19v6-04同号散文,core 活体 93/93。 - F1 已落:工具上传写面
GET/POST/DELETE /api/tools——工具根<tenant>/tools/<name>/bin/<name>不进表(列表即扫盘,跳过.开头);128MB 上限 413116118、名字白名单+预留名+空文件 400116117、ReserveStorage额度 429113001、staging→.trash→rename 与 C1 同一把锁;写入只给 owner/admin、列表全员可读;删除先过白名单(..拼成租户根)、不存在 404116119;成功发tools_changed;落点toolroots.go;契约字节用例 31(19 步),core 活体 138/138 - F2 已落:工具根对所有角色常开(含普通子代理)——
<tenant>/tools整棵进 profile 只读白名单(写仍只在项目根)、每个<name>/bin前置进子进程PATH(跳过.开头、与宿主PATH同一套sandboxReadRoots过滤),依赖检查同走这条;which hello→ 工具根、which python3→ 宿主;子代理跑hello成功而cat <技能根>/SKILL.md被拒;run 中覆盖后下一枪即新版、DELETE后command not found而 run 仍 complete;落点sandbox.go、subprocesspath.go、bash.go、skilldeps.go - F3 已落:工具区前端
web/src/ToolsView.vue(列表带「被技能引用」、上传、同名覆盖确认、删除确认、无检测按钮),导航与路由接进App.vue;技能详情每个缺失依赖旁「上传 <名字>」跳到工具区预填;api.ts加三个端点封装,mutation.ts补tools_changed事件类型,ConfirmDialog加tone/busyText;浏览器全流程验收 +npm run typecheck/build绿 - G1 已落:
.staging/.trash的 24h 清扫(internal/runengine/tempsweep.go,tempDirTTL+sweepTempDirs(root, now))只在已有的锁内跑——技能安装/删除/租户重扫/全量重扫(每个根各清一次)、工具上传/删除;技能根与工具根同一规则,启动时不扫盘、失败只记日志(TestSweepTempDirsByMtime/NoDirs)。活体:两个根各造 25 小时前与刚建的条目 → 一次rescan(技能根)与一次工具删除(工具根)之后旧条目消失、新条目留下;rescan对账:造目录 →added有它、删目录 →removed一次、再扫removed:[]、表里无重复行;并发装+扫三轮技能都不丢
- 落点:A1 已落:
54 运行级 OTel 追踪 ✅(已落地,2026-10-31)
- 落点:
yk-tako-eino/internal/observability/(装配/内容序列化/开关)、internal/runengine/{trace.go,trace_run.go,worker.go,journal.go,recall.go,compact.go,memory.go,server.go}、cmd/yktako/main.go、.env(内容开关) - 2026-10-31 立项并同日 A1–A9 落地。按 OTel GenAI 语义写 span(
gen_ai.*均为 Development),走 OTLP/http protobuf 上报 CozeLoop:run 根invoke_agent yktako(CLIENT;usage 口径=对话账本tako.usage.scope=conversation,与 usage 帧求和逐值对账)、HTTP 入口POST /api/runs(SERVER,tako.run.start_delay_ms)、每次模型调用chat <model>(TTFT/TPOT/usage/内容)、每次根级工具execute_tool,以及tako.step.{quota,workspace,history,recall,compact,finalize,memory_extract}内部步骤 span(召回下挂search_memory/retrieval);内容属性由OTEL_INSTRUMENTATION_GENAI_CAPTURE_CONTENT控制(.env默认SPAN_ONLY,8KiB/文本段、64KiB/属性截断);缺令牌/空间 ID 即 noop,导出失败只记日志、不影响 run。实跑证据(2026-10-31):探针回exported:true;真 run 日志打出traceId=,含get_time调用的一轮 usage 帧求和 13717/112 与根 span 同源;go test ./internal/runengine ./internal/observability全绿。注:COZELOOP_WORKSPACE_ID必须是令牌所属工作区,不匹配时 OTLP 回 400。台账tmp/cozeloop/(不入库)。2026-11-01:新增第二出口 Langfuse(LANGFUSE_PUBLIC_KEY/LANGFUSE_SECRET_KEY/LANGFUSE_BASE_URL;与 CozeLoop 可并存双发、可单发、都不配即 noop),实测gen_ai.*到 Langfuse 原生模型(AGENT/GENERATION/TOOL、sessionId、usage、工具入参回执)的映射与 v2 observations 读回路径,见该篇 §3.1
- 落点:
56 Agent 测试与基准选型(方案·部分落地) 🔶(G1 已跑完出数,两臂配对 11-01,k=5 基线 11-02)
- 落点:
scripts/bench/(row.schema.json/arms/tako.py/arms/dsh.py/judge.py/cases/gaia_l1_25.json/slice.py/run_bench.py/pricing.json/check-schema.sh);回填scripts/eval/(doc/45)仍未施工;不改internal/runengine/ - 2026-10-31 立项。11-01 第一批落地:把「测谁」钉死(公开基准测的是模型 + 它自带的 harness,不是 tako),并落纸可比性协议(doc/56 §4.7:受试者=runtime、钉死的变量、答案抽取规则、官方 scorer 三支、报告必带口径字段、三条禁语)。GAIA 验证集 L1 的 25 题纯文本切片是唯一现在能直接跑 tako 的公开基准——切片只入配方 +
slice_hash(题面/答案/task_id 不入库,依据 GAIA 条款),判定器内置官方 scorer 三支并有--selftest对照官方源码;GAIA 25 题已实跑两轮单臂并出报告(题面本身 2/25;题面 + 尾句 21/25——差的全在「答案长什么样」,口径钉死见 doc/56 §4.8);同日装上 dsh 臂并跑出两臂配对(tako 22/25 vs dsh 20/25,都过 18、只有 tako 过 4、只有 dsh 过 2——但同臂隔一小时重跑的逐题分歧率 28% 比两臂之间的 24% 还大,即换 harness 的影响不如重跑一次,所以这轮不给两臂排名,见 doc/56 §4.9);pi 臂未装;11-02 凌晨 k=5 首轮基线跑完(tako Pass@5 24/25 · pass^5 20/25,dsh 23/25 · 14/25,配对 pass^5 为 都过 13 / 只 tako 7 / 只 dsh 1 / 都没过 4;基线落scripts/bench/baselines/gaia.json,只存 task_id 短哈希,见 doc/56 §4.10),三臂并排留到下一轮;SWE-bench 先在 Linux 服务器用 mini-swe-agent 跑 25 题作模型基线(C2,明确不叫 tako 分数),tako 级要补引擎镜像与 bash 容器后端(G4,容器当围栏,见 §5.5);HumanEval/MBPP/LiveCodeBench/AgentBench 不作 tako 测试;τ-bench/Claw-Eval 不移植环境,只借 pass^k、终态断言、安全一票否决回填 doc/45;另借 pipackages/evals的 A/B 对照协议(case × 两臂 × 重复 → 配对 lift,只借协议不移植 vitest 栈,§6.5/G5),Eino 开源仓无 eval 包可接。CI 门禁仍只认确定性断言(L0 快闸 / L1 契约 / L2 doc/45 K/S 组)
- 落点:
57 网络抓取(
web_fetch) ✅(2026-11-01,A1–A3)- 落点:
internal/runengine/{webfetch.go,webfetch_test.go,worker.go,fileops.go,search.go}、agents/researcher.md - 父池加
web_fetch:按调用方厂商选择器走 DeepSeek/v1/tools/fetch(只用deepseek一行,其他厂商直接报错);整页 Markdown 落盘.tako/fetch/,工具只回描述段;researcher 走继承自动拿到,coder 白名单不动
- 落点:
58 读分页与输出留存 ✅(2026-11-01,A0–A8)
- 落点:
internal/runengine/{readwindow.go,filetools.go,bash.go,bashspill.go,notes.go,product_api.go}、internal/runengine/{filetools_test.go,bashspill_test.go} - 两处「拿不到就永远拿不到」的收口:
read_file改分页读(入参path/offset/limit,head/tail删掉;每页 2000 行 / 50KB / 单行 2000 字符;页脚恒带总行数与下一个offset;「超 200KB 直接报错」撤掉,长文件读得到中间);bash改留尾 + 全文落盘 + 回路径(每流 64,000 字节尾窗;全文落.tako/bash/<runId>/<seq>.out,64MB/流,装不下全文就删文件、不报路径;回执行给路径;30 天清扫,每次 bash 调用前触发)。四个 API 的请求/响应字节不动;POST /api/dev/workspace/read(A0)让 read 的模型侧字节可 curl 逐字断言
- 落点:
59 工具调用可见性 ✅(2026-11-01,A1–A2)
- 落点:
web/src/{chat.ts,App.vue,api.ts}(前端零后端改动);2026-11-03 分段补记同批动internal/runengine/{store.go,pgstore.go,types.go,waittools.go,questions.go}与契约测试 - 对话页把每一次工具调用画成工具卡(帧与 runlog 两条路径、按
toolCallId配对):删掉「只认技能三件」的白名单;摘要行 + 展开看参数/回执原文,失败按「错误:」前缀标「失败」,参数 2,000 / 回执 8,000 字符截断;初始窗口与翻页加了「回执找不到同批调用行就往前扩一页」的取数规则。翻掉 doc/52 C5 的窄口(卡片机制保留、筛选去掉),子代理行带agent前缀。2026-11-03:等人工具边界开始把正文切段(runlog assistant 行 payloadsegments),问题卡与答案气泡可按真实先后排开;普通工具调用仍只分「卡片在上/在下」两块
- 落点:
60 前端多会话并发 ✅(2026-11-01,A1–A6)
- 落点:
web/src/{App.vue,chat.ts,chatpool.ts}、web/test/chatpool.test.ts、web/e2e/multisession.spec.ts(后端零改动、契约字节零变化) - 前端从「全局一个
useChat()」改成「每个打开过的会话一个实例」:切走不打断轮询,草稿/排队消息/游标随会话保留;空对话在输入区可选项目落点、侧栏项目行「+」可直接开新对话;删除/换租户/上限 8(只淘汰已持久化、不在跑、没草稿的实例)收口;侧栏「运行中」先用本 tab 的busy本地信号,刷新/跨端的运行状态留 P1(列表接口加liveRunId)
- 落点:
61 并发控制设计 ✅(2026-11-03,设计说明,无新增代码)
- 落点:
internal/runengine/{pgstore.go,store.go,redisstore.go,filefp.go,filetools.go} - 解释「为什么不需要分布式锁」:互斥下沉到存储层原语(唯一索引 + 租约 + 行锁 + flock),核心路径无共享可变状态;含与应用层分布式锁的对比及适用边界。文件写入的读者完整性、多副本与长任务隔离后续方案见
doc/71,不把待点头方案当现状
- 落点:
65 记忆双模式(
pipeline= PG 两层 + 统一抽取代理 + Redpanda;markdown=USER.md/MEMORY.md同步直写) ✅(2026-11-10 落地)- 落点:
internal/runengine/{memory.go,memory_pipeline.go,memory_queue.go,memory_search.go,memory_store.go,memory_types.go,memory_mode.go,memory_dispatch.go,memory_markdown.go,memory_migrate.go,memory_write.go,memory_text_guard.go,atomicfile.go,notes.go}、cmd/yktako/main.go(TAKO_MEMORY_MODE);scripts/acceptance/memory_*.sh六件活体;演进记录见doc/log/2026-11-09-记忆两层方案演进.md(非方案) - 两种模式是独立运行形态,不是同一管线的两个存储后端。
pipeline:memory_items两层(resident/recall)+ Redpanda 按会话分区派工 + 消费者三段流抽取(抽条目 → 全量筛候选 → 终局动作)+ 每回合 BM25 召回 +search_memory现实时点回放与历史链;markdown:master 用 add/replace/remove/batch 同步维护两份文件,不启动抽取/MQ/BM25 - 同批统一:取消记忆管理面与管理 API;inrun 由 master 登记
targetLayer,postrun 永不写常驻;证据时间取source_run_id + source_seq → runlog_entries.created_at;项目删除按scope='workspace'清记忆、保留user行(doc/37 D-l 同批落地) - 可靠性与并发:Redpanda 按 session 分区 + consumer group,PG
memory_jobs仍是状态真源,DB 前置条件保证 postrun 不越过未完成 inrun,对账器兜住漏投与崩溃;写事务用 workspace advisory lock;候选全量扫描但按 token 分批,不设 150 行上限;写幂等用持久化 job/批次身份,不用正文去重 - Markdown 写入只给 master,锁内重读 + 操作式修改 + 同目录临时文件原子 rename(
atomicfile.go);多副本用 PG advisory lock 协调。Rakazo 的真实内置存储已核为 PG document + revision,Hermes 才是纯文件参照 - 验收:观测口与守卫字节在
expected.json用例 35–38 + 快闸TestContractMemoryObserveBytes;活体六件——pipeline_live 20/20、markdown_live 26/26、migrate_live 42/42、file_race 11/11、project_delete 9/9、redpanda_crash(真 broker kill -9 补投与 A→B→A 不被吞);doc/29 线一被本篇取代、线二仍现行
- 落点:
70 多 Agent 编排与持久 Task:第一版方案 ✅(2026-11-10 施工+活体验收,commit
9b31baa)- 落点:
internal/runengine/agent_task_{api,delivery,graph,runner,scheduler,store,tools,types}.go+auth.go(117xxx 码,doc/40 §4.2c)+events.go(agent_tasks_changed/agent_orchestrations_changed,doc/46 §7.7)+cmd/yktako/main.go(-task-interval);web/src/TasksView.vue(任务页);活体scripts/acceptance/agent_task_{single,busy,dag,crash,two_replicas}_live.sh+agent_task_live_lib.sh;方案集与调研入口见 doc/70 README - 2026-11-09 立项收束 V1,2026-11-10 一次施工完成:一件可持久、执行、通知、停止与显式恢复的 Task(独立执行 session,恢复复用 doc/30 的同 run epoch+1 接管),加「初始 DAG 整组原子创建 → 并行推进 → 依赖满足后 C 汇总 → 失败阻断传播 → 整组单次交付」。四张表(
agent_orchestrations/agent_tasks/agent_task_links/agent_notifications)+ 模型工具delegate_task/create_orchestration/submit_task_result+ 八端点;V1 固定节点内容、执行者与依赖边,Goal 驱动的动态改图留作下一版 - 验收:单测全绿(图校验/事件/产出归一/依赖失败传播钉子);活体五场 single 24/24、busy 14/14、dag 22/22、crash 20/20、two_replicas 13/13;浏览器走查停止链与恢复链、交付一次审计(来源会话 17 组各恰一条
orchestration_finished);施工期契约缺口修复已回填 doc/40 §4.2c 与 doc/46 §7.7 - 与现行文档的边界:doc/25、doc/39 的同步子代理与 wire 档案不因此改变;doc/41 的
run_tasks仍是一场 run 内的看板,与本 Task 不能混名;doc/71 长任务 worktree 是独立方案,V1 不做并行仓库合并
- 落点:
71 文件写入竞争:短写入互斥、版本校验、原子替换与长任务隔离 🔶(短写入三件套 2026-11-10 落地;长任务 worktree 归 doc/70 未开工)
- 落点:
internal/runengine/{filefp.go,filelock.go,atomicfile.go,filetools.go};长任务编排便签归doc/70 - 2026-11-09 立项。把锁、版本校验与原子 rename 分到三类故障:写者同时写、依据旧版覆盖、读者看到半截;整文件
write_file保留 run/agent 级读取基准,局部edit_file与条目 Memory 在锁内按内容操作,不额外背整文件 map - 已落地(2026-11-10):目标短写入链 = 锁内校验/操作(PG advisory lock,
filelock.go)→ 同目录临时文件 → 原子 rename(atomicfile.go)→ 刷新基准;读者不排队,写者仍排队。write_file/edit_file与 Markdown 记忆文件共用一条写盘路。活体memory_file_race.sh(两台隔离引擎:串行、版本拒绝、原子读、kill -9 释放,11/11) - 参考核查:Kimi 的 ToolAccesses 调度器只覆盖当前工具批次,Tower 用 worktree;Hermes 普通文件确有跨 subagent 的读取版本与同路径锁,但主要是进程内;Rakazo 的 expectedRevision + Serializable 只直接适用于 PG 文档。doc/61 仍是当前机制说明,doc/65 链接本篇消费文件写入原则
- 落点:
72 多 Agent 编排下一阶段:有界修订、Task HITL 与事件驱动 ✅(2026-11-11 施工+活体验收,commit
a5a9a5e)- 落点:
internal/runengine/agent_task_{revision,revision_api,attention,scheduler,delivery}.go+questions.go(expires_at/115102)+events.go(tk:agent-task-wake)+cmd/yktako/main.go(-task-input-timeout)+web/src/{App.vue,TasksView.vue,api.ts};活体scripts/acceptance/agent_task_{revision,hitl,attention,wakeup}_live.sh+expected.json用例 51–54(人读版 19v6-04) - 2026-11-11 成文并补可靠性边界。四条范围:有界计划修订(追加/替代未来工作、图版本防过期、累计 32 节点/32 次修订、版本时间线)、Task 内
ask_user(每 Task 自己的 PG 问题队列、question ID 回答与同 run 续接、可配置截止时间 +input_timeout)、左侧任务展开与“需要我处理”(待答/计划决策/中断/交付失败,复用账号级 SSE,不建未读表)、Task 调度事件唤醒 + 默认 30 秒 PG 对账。doc/70 V1 仍是固定 DAG 真源 - 验收:契约 51–54 逐字节;活体 revision 68/68、hitl 48/48、attention 39/39、wakeup 14/14;V1 五场回归 single 24/24、busy 14/14、dag 22/22、crash 20/20、two_replicas 13/13;浏览器走查左侧四类处理项、点入抽屉、答后/继续后消失、刷新重建与修订时间线(doc/72 §11.6)。施工期发现并修掉 V1 交付通知消费的两处真实缺陷(忙通知恒占队首、已终止通知永留 pending),回填 doc/72 §8.2 与新增两条单测
- 落点:
73 协调通知与交付恢复 ✅(2026-11-11 施工+活体验收)
- 落点:
internal/runengine/agent_task_{delivery,recovery,scheduler,store,runner,types,api}.go+agent_task_attention.go、auth.go(117003/117109/117110)、pgstore.go与store.go(expireDeadSessionRunsTx)、worker.go/agent_task_scheduler.go(RunEnd 与调度对账)+web/src/{App.vue,TasksView.vue,NotificationRecovery.vue,api.ts};活体scripts/acceptance/agent_task_delivery_recovery_live.sh+expected.json用例 55–56(人读版 19v6-04) - 2026-11-11 成文并同日落地。区分 DAG 执行失败与来源 session 交付失败:down/interrupted 走原 run、epoch+1 显式续跑;error/stopped 保留历史并由人工创建同一通知的新处理 run;
resultRevision管结果版本、lease_epoch管执行权、当前 claim run 管通知收尾。补通知 failed 状态、每次处理 attempt 审计、RunEnd 与慢速对账同一收尾、结果摘要与文件路径定位、交付只读工具面及双副本防重 - 验收:契约 55–56 逐字节(
assert_contract.py344 条);活体十场 109/109,doc/72 的 attention/revision/hitl/wakeup(39/68/48/14)与 V1 五场回归(single 24、busy 14、dag 22、crash 20、two_replicas 13)全绿;spotcheck.sh37/37。施工期修掉「崩溃留下的中断 run 卡死后续认领」的收敛缺陷(认领/重试先跑与AcquireRun同一条过期行扫尾)
- 落点:
74 并行任务工作区隔离 ✅(已落地 2026-11-12)
- 落点:
internal/runengine/workspace_{provider,engine,git,directory,result,publish,verify,view}.go+agent_task_artifact.go(artifact / retry-publication)+agent_task_{graph,api,tools,scheduler,runner,store,types,attention}.go、worker.go、sandbox.go/bash.go/bashspill.go、store.go/pgstore.go、auth.go(117111–117113)、server.go;前端web/src/{TasksView.vue,App.vue,api.ts};活体scripts/acceptance/workspace_{git,directory,publication,crash}_live.sh - 2026-11-11 按责任边界重写。Task/DAG 永远通用;LLM 决定节点、依赖与隔离需求,WorkspaceProvider 按真实项目选择 Git 或非 Git 目录实现,引擎调用 Provider 创建现场并协调执行与发布,system prompt 只指导模型配合。默认 shared 不变
- Git 只在已有仓库、需要持久修改并合回项目时启用;非 Git 由 DirectoryProvider 完成目录副本、文件变更清单、冲突与发布恢复。PG 不保存 branch/commit/repo path/worktree path/文件哈希;Provider 状态与不可变结果在共享持久卷
- 验收:活体四场 git 51/directory 42/publication 34/crash 57 全绿;契约用例 57–59 逐字节、用例 60 登记 declared_not_asserted(模型与真实现场场景由活体判红);既有 70–73 回归(single 24、busy 14、dag 22、crash 20、two_replicas 13、revision 68、attention 39、hitl 48、wakeup 14、delivery_recovery 109)与
spotcheck.sh37/37 全绿;浏览器走查隔离标识/发布面板/验证失败/受阻后重新发布闭环
- 落点:
75 目标重规划与继任编排组 ✅(2026-11-12 立项/施工,2026-11-13 活体验收与文档收口)
- 落点:
internal/runengine/agent_task_{successor,handoff,tools,api,store,scheduler,types,delivery,runner}.go+project_layout.go(继任组目录)+auth.go(117004/117114/117115/117116)+server.go(POST /api/orchestrations/:id/successors、GET /api/orchestrations/:id/handoff);前端web/src/{TasksView.vue,api.ts};活体scripts/acceptance/goal_replan_live.sh(124 条)、goal_replan_crash_live.sh(46 条)+expected.json用例 61–63(人读版 19v6-04) - 2026-11-12 立项、2026-11-13 与 doc/76 合并一个施工包落地。先判断目标可行性(
goalAssessment.outcome == feasible才建组),再决定 doc/72 同组修订或创建继任编排组;不可行/不确定时告知或问用户,不盲目新建。继任组写successor.json+handoff.md(frontmatter 机器读、正文给人读,记 replanOf/原因/复用引用/深度),按(taskId,resultRevision)复用旧组不可变结果;深度上限 8、原组先收口、预算不重置、外部副作用不自动重放 - 明确不做跨组调度依赖边、无限重规划、多继任组竞争与 Git 字段入 PG;验收含同组修订、继任复用、不可行、不确定、并发(两副本一条继任行,202/409 117114)、预算、副作用与
kill -9崩溃(preparing不调度、重启后继续)
- 落点:
76 项目内容目录与运行资源容器 ✅(2026-11-12 立项/施工,2026-11-13 活体验收与文档收口)
- 落点:
internal/runengine/project_layout.go(容器路径与layout.json)+scope.go/worker.go(工作现场落 runtime)+media*.go/bashspill.go/webfetch.go/websearch.go(运行资源根)+memory_markdown.go/memory_migrate.go(项目记忆在runtime/memory/)+workspace_{provider,engine,git,directory,result,publish,view}.go(最终结果发布进content/)+filetools.go/product_api.go(删除回cleanup=done|pending)+pgstore.go/store.go(project_cleanups)+archive_sweep.go/tempsweep.go+cmd/yktako/main.go(-migrate-project-layout);前端web/src/{ProjectsView.vue,api.ts};活体scripts/acceptance/project_layout_live.sh(36 条)、project_layout_migration_live.sh(51 条)、memory_project_delete_live.sh(10 条)+expected.json用例 58/60 - 2026-11-12 立项、2026-11-13 与 doc/75 合并一个施工包落地。
workspaces/<wid>成为项目资源容器:用户只看content/,异步工作区、不可变结果、临时文件、媒体与项目记忆归runtime/{orchestrations,tmp,media,memory};shared 是同组共享工作现场,isolated 是每 Task 独立现场,两者中间结果都不直接写 content,最终才发布(共享组同样发布,doc/76 §10.5) - 存量迁移走离线命令的复制 → 校验 → 原子切换,旧布局项目在 HTTP 层直接 409
117116;删除清整个项目容器但不误删租户技能/工具、系统技能与用户记忆,容器删除失败回cleanup=pending由project_cleanups补偿;没有临时实现或过渡开关。用户级 skill/plugin 本期不做
- 落点:
77 对话页右侧任务面板 ✅(2026-11-13 落地:
web/src/App.vue、web/src/TasksView.vue,无后端改动)- 落点:
web/src/App.vue(对话页布局与面板壳)、web/src/TasksView.vue(embedded嵌入模式);无后端改动、无契约字节变化 - 病灶:Task 在后台异步执行,而可观察面只在「任务」页;用户看状态、答 Task 提问、做计划决策都要离开对话再回来。面板把当前项目的 Task 列表与「需要我处理」放到对话页右侧,点行复用任务页同一个详情抽屉;范围是当前项目而非当前会话
- 不改 Task 的存储、状态机、调度与 API;移动端(≤860px)不出现面板,仍走左侧「任务」入口。§3 第 4 条(Todo 不进面板)已被 doc/78 取代;§3 第 1 条(不按会话过滤)与 §4.2 已被 doc/80 取代
- 落点:
78 对话页右侧工作区与改动文件 ✅(2026-11-13 落地:
internal/runengine/runviews.go、web/src/ChatDock.vue等,契约用例 65)- 落点:
internal/runengine/{runviews.go,runviews_test.go,server.go,contract_test.go}、web/src/{App.vue,api.ts,ChatDock.vue,WorkspaceTree.vue,WorkspaceFileView.vue,RunTodoPanel.vue,RunChangedFiles.vue}、scripts/acceptance/expected.json(用例 65)、doc/19-v6/19v6-04、doc/40(端点表) - 把 doc/77 的单面板扩成多标签工作区(项目目录 / 任务 / Todo / 文件),并新增两个只读端点:
GET /api/runs/:id/changed-files(从 runlog 工具调用行派生本轮写入/编辑过的文件)与GET /api/runs/:id/tasks(run_tasks的第一个 HTTP 读口);助手回复结尾列出改动文件,点开在右侧打开文件标签 - 不改 run 执行、Task 状态机、文件工具行为与帧格式;不做右侧编辑、不做 diff、不做拖拽调宽;≤860px 工作区不渲染,Todo 留在输入框上方
- 2026-11-14 补充(doc/79):文件标签里的
.md/.markdown按 markdown 渲染显示,默认预览态、可切「原文」(§2 第 6 条已改口径;样式与判定见 doc/48 §10)。取字节的路径、端点与响应字节一个字没变
- 落点:
80 任务列表按会话过滤 ✅(2026-11-14 落地:
internal/runengine/{agent_task_store.go,agent_task_api.go}、web/src/{api.ts,TasksView.vue,ChatDock.vue,App.vue},契约用例 80)- 落点:
internal/runengine/{agent_task_store.go,agent_task_api.go}(ListWorkspaceTasks加sessionID参数 + 子查询)、web/src/{api.ts,TasksView.vue,ChatDock.vue,App.vue}、scripts/acceptance/expected.json(用例 80)、doc/19-v6/19v6-04 - 病灶:Task 由对话派发、结果回到对话,但任务面板与任务页只按项目列出,同一项目里多个会话派发的任务混在一起。
GET /api/workspaces/:id/tasks新增可选参数sessionId(不传=全部、非空=按来源会话过滤、未知会话=200 空列表);面板/任务页默认「本会话」、可一键切「本项目全部」;处理条仍项目级聚合 - 纯过滤,不校验会话存在性;
sessionId=空串等于不传;不动 Task 的存储、状态机、调度与其它 API 字节。取代 doc/77 §3「不按会话过滤」与 doc/78 §3 同名条款
- 落点:
81 刷新失败不误判登出 ✅(2026-11-14 落地:
web/src/auth.ts、web/test/authrefresh.test.ts,无后端改动)- 落点:
web/src/auth.ts(RefreshOutcome/readRefreshOutcome/isEnvelope三态判定,doRefresh按三态分支)、web/test/authrefresh.test.ts(新增回归网 8 条);纯前端、契约字节零变化 - 病灶:
doRefresh把「/api/auth/refresh拿到任何非 2xx」都当登录失效并clearAuth('expired');dev 重启引擎时 Vite 代理回 500(text/plain),开着的标签页被无端登出。改为只有「HTTP 401 且响应是引擎信封且code≠0」才登出,5xx/代理 500/非信封 401 都是暂时性故障、静默保留 token 等下一拍
- 落点:
82 可组合执行原语与后台任务 ✅(2026-11-15 落地:
internal/runengine/{bash_job,bash_job_sweeper,bashspill,agent_task_*}.go等 +scripts/acceptance/用例 82–83,活体四脚本全绿)- 落点:
internal/runengine/{bash_job.go,bash_job_sweeper.go,bashspill.go,agent_task_tools.go,agent_task_delivery.go,agent_task_scheduler.go,agent_task_store.go,agent_task_runner.go,agent_task_recovery.go,agent_task_attention.go,agent_task_api.go,orchestration_journey.go,sandbox.go}、internal/config/model.go、cmd/yktako/main.go(5 旗标)、agents/{coder,researcher}.md、web/src/{api.ts,TasksView.vue,NotificationRecovery.vue}、scripts/acceptance/(expected.json 用例 82–83 + bash_job_live.sh 等)、19v6-04、doc/40 §4.2e(117117/117118/117119) - 2026-11-15 立项并落地。bash 的 30 秒改为前台等待窗口(默认 8s,超时保留进程并返回
bj_…),补输出读取/有限等待/停止(SIGKILL 整进程组)/持久通知与失联处理(owner watcher 续租写终态、sweeper 对账 interrupted);wait_task让当前 run 已读结果时就地认领通知(claimed_in_place=true,不建 run、不写 attempt 行),避免重复交付;编排组内并发按workspace_mode取值(shared=1、isolated=2);创建编排补finalTaskId;新增路径账本GET /api/orchestrations/:id/journey(只读投影,从计划修订、Task 终态、结果复用、通知尝试与继任 handoff 派生,刷新与换副本一致) - 不增加用户可见 DAG 模式或 JS 引擎:同步子代理、持久 Task、等待和依赖保持可组合;新工作继续走 doc/72 同组修订,已交付后走 doc/75 继任组;shared 组改为串行,需并行修改时使用 doc/74 isolated 现场。验收:单测/契约 506/0、活体四脚本(bash job 62/0、编排 49/49、journey 22/0、orchestration 回归)+
spotcheck.sh37/0 + 浏览器走查(桌面/移动端 390 断言);doc/58 的 bash 落盘落点与清扫触发点被本篇改定
- 落点:
83 场景化 Eval 方案(Anthropic 思路) ⬜(方案待点头)
- 落点:—(未施工;文中提到的
scripts/eval/是 doc/45 的计划落点,尚未存在) - 病灶:doc/45 的口径在 2026-11-01 已拍板但一直没开工;本篇是另一条思路——把评测定成「给真实任务、重复跑多次、查任务结束后的真实世界状态、留完整轨迹」,与 Anthropic 的 Agent Eval 工程实践同调
- 2026-11-16 从仓库根
eval/README.md(讨论稿、无编号)迁入 doc 树,补 NN 编号与状态头注。与 doc/45/doc/56 并存,取代关系尚未裁定;裁定前不动 doc/45 的已拍板口径、不开工 - 验收:无(未施工)。裁定口径后按仓库流程出
tmp/83-场景化Eval/施工包.md交审
- 落点:—(未施工;文中提到的
2. 历史存档(doc/archive/,不作施工面)
归档按两代分组,逐篇清单见 doc/archive/README.md。
正文里出现
doc/01–doc/15、doc/18、doc/19-v3/v4/v5、docs/superpowers/这类旧路径,都是当时的位置;按文件名到对应分组里找。
| 分组 | 内容 | 入口 |
|---|---|---|
| old-line | v6 之前的旧线方案与交接(01–15、18、XX、handoff-doc24),以及旧线 Web UI / MAF 的计划与设计(plans/、specs/) |
archive/old-line/ |
| engine | 运行引擎 v3/v4/v5 | archive/engine/ |
3. 非方案内容
| 位置 | 文档 | 状态 | 说明 |
|---|---|---|---|
doc/blog/ |
叶子才是根:被 Eino 中断契约坑掉的一天 | 非方案 | 工程故事;不作施工面 |
doc/ |
53-模块地图 | 非方案 | 代码结构索引:顶层模块与小模块 → 落点文件与职责;讲「代码在哪一块」,不讲「该怎么施工」 |
doc/ |
55-Go 少见玩法辑录 | 非方案 | 代码阅读笔记:flock / SSE / Lua CAS / seatbelt 等 20 处不常见写法的落点、动机与代价;不作施工面 |
doc/ |
62-nanoMuse 记忆设计调研 | 非方案,调研记录 | 2026-11-04 读浙大开源个人 agent nanoMuse(Meta Muse 的开源平替,本地 clone 于 ref-agent/nanoMuse/)的记忆模块源码:写时防重/读时检索/闲时整理/全程留账四条机制与对 tako 记忆(doc/29)的借鉴清单;借鉴条目落地须另立方案篇;不作施工面 |
doc/ |
63-参照实现对照:子代理与折叠回查 | 非方案,对照记录 | 2026-11-05 把根 README 里的对照表搬来正文:子代理(规格/回传/续跑/工具权限/嵌套/模型/运行形态)与折叠回查两张表,kimi 侧带代码指针、tako 侧带落点;只作对照阅读,不作施工真源 |
doc/ |
66-诉求对照:场景应用与生产就绪 | 非方案,对照记录 | 2026-11-07 把两组外部诉求(应用侧:Trace/Replay/灰度/成本、高敏决策与人工审核、证据链、任务编排;平台侧:Compose/模型网关/基础设施/Metrics/版本管理/Feature Flag/灰度回滚/成本/Runbook)合到一篇逐条对现状:有 3、半有 3、无 4,并给依赖顺序;原 doc/66 与 doc/67 同日合并于此,不作施工真源 |
doc/ |
68-记忆检索的故事演示 | 非方案,演示读物 | 2026-11-08:doc/65 §4.4 search_memory 语义的故事版演示——一场搬家 + 六个问题,覆盖 as_of 现实回放、include_history 改口链、removed 删除边界、过期退场;认知回放只作对比说明,现行工具不开放;参考脉络 Zep/Graphiti(借查询语义、不抄图谱存储);不作施工真源 |
doc/ |
69-参照实现对照:rakazo 与 octop | 非方案,对照记录 | 2026-11-08:读 rakazo(ref-agent/rakazo/)与 Octop(ref-agent/Octop/)源码的对照——agent 管理(rakazo 的 Bot+Subagent 双形态、octop 的 Expert→Agent→Team 三层)、plugin(rakazo「静态声明不执行代码」vs octop「plugin.yaml+main.py 可执行包」)、skill(三家同构的 SKILL.md);结论:rakazo 无 expert、octop 有、tako 无 plugin/expert/协作;只作对照阅读,不作施工真源 |
doc/problems/ |
问题与方案库(43 条) | 非方案 | 决策档案:每条一个设计选择题——当时遇到什么、桌上有哪些候选、为什么这么裁、代价是什么、今天还成不成立;按模块分组,并在 doc/53 各小模块后反链 |
doc/assets/ |
系统架构总览 | 非方案,交互图 | 2026-11-16 重基线:约 20 个责任节点讲清前端、接入、run worker、长任务、结果发布、模型、扩展与存储;点节点/连线看输入输出、代码与真源。静态版 tako-architecture.png(3840×2822)由 scripts/export-architecture-poster.sh 派生。四页共享 tako-architecture.css/js,scripts/check-architecture-pages.mjs 检查数据与链接 |
doc/assets/ |
单场 run 生命周期 | 非方案,交互图 | 从 POST /api/runs 到定稿、记忆与显式续跑;含九种帧、runlog/模型输入/journal 分工、问答与 compact |
doc/assets/ |
长任务与多 Agent 编排 | 非方案,交互图 | 持久 Task、依赖调度、wait_task、shared/isolated、结果发布、后台 bash、通知恢复、同组修订与继任组 |
doc/assets/ |
数据、状态与存储 | 非方案,交互图 | PostgreSQL 当前模型、四类 Redis 临时状态、项目 content/runtime、会话 wire、记忆双模式与多副本共享卷边界 |
doc/html/ |
在线站点 · 本地入口 doc/index.html、doc/html/index.html |
非方案,网页版 | 2026-11-16:每个已入库 md 对应一页网页版,由 scripts/build-doc-html.py(pandoc gfm→html5)生成并重写链接——doc 之间的链接转成 html、代码与脚本链接转成 GitHub blob、仓库里没有的(tmp/ 施工包、ref-agent 参考实现)去掉链接保留文字。只转已被 git 跟踪的 md(doc/interview/ 等被 .gitignore 挡住的私有材料不入站);内容以 md 为准,改了 md 要重跑脚本。--check 只比对不写盘、--audit-only 只查断链,都可进机器验收;.github/workflows/pages.yml 负责发布 |
4. doc/log/ 记录
doc/log/ 只放某一时刻的交接、执行台账与文章,按日期命名,不作为施工真源;需要了解「当时为什么这么做」时再读。清单与说明见 log/README.md。
| 日期 | 文档 | 类型 | 说明 |
|---|---|---|---|
| 2026-09-30 | 未提交改动审查交接 | 交接 | 旧线未提交改动审查 |
| 2026-10-07 | v6 现状与能力差距 | 交接 | v6 现状快照与 pi/WeKnora 差距 |
| 2026-10-08 | pre-T3 落地 | 执行交接 | T3 之前的 lease/T1/T2 |
| 2026-10-08 | 子代理设计素材 | 素材盘点 | 子代理设计的已核实素材 |
| 2026-10-09 | Deferred loading:把工具 schema 移出前缀 | 文章 | 前缀缓存与工具 schema |
| 2026-10-12 | 溢出修复层一期落地 | 执行交接 | 检出/救援链/截断检出 |
| 2026-10-16 | 溢出修复层二期 B2/B3 | 执行交接 | guard 救援链+槽位落库 |
| 2026-10-19 | 多租户运行时现状交接 | 现状交接 | 多租户全改后代码停在哪 |
| 2026-11-02 | GAIA k=5:一个模型,两个 harness | 文章 | tako/dsh 两臂 k=5 可靠性对照 |
| 2026-11-03 | 文档归属重构 | 变更记录 | docs/ 并入 doc/、旧线归档、机器闸落地;执行流水见同目录 tasks.md |
| 2026-11-09 | 记忆两层方案演进 | 演进记录 | 2026-11-07~08 的改稿过程;现行双模式方案以 doc/65 为准,本文不作施工真源 |
5. 新增/修改文档的规则
- 编号与位置
- 主系列:
doc/NN-短标题.md,编号递增,不复用已删编号。 - v6 子系列:
doc/19-v6/19v6-NN-短标题.md;index 与演进记录分别是19-运行引擎架构-v6.md、19v6-90-演进记录.md。 - 交接/文章:
doc/log/YYYY-MM-DD-短标题.md;变更记录:doc/log/<YYYY-MM-DD>-<方案名>/。 - 执行期台账:
tmp/<方案名>/(本地,不入库),验收后按第 8 条留档。
- 主系列:
- 头注必须写四件事:性质(方案/实现真源/讨论稿/存档)、状态(✅/🔶/⬜)、日期、代码落点。写了“未定案”的文档不能被当成施工真源引用。
- 替代关系写在头注:新文档取代旧文档时,旧文档头注加“已被 X 取代”,新文档写“取代 Y”;不删除旧文。
- 同一机制只留一份真源:其他文档只写指针,不复制条款;发现两处冲突,先改真源,再改指针。
- 代码落点必须是真实路径:没有代码就写
—(文档/验收/记录),不要写已删除的包。 - 新增或改状态时同步本索引:同一提交里更新对应行;纯错别字修正除外。 动了产品能力的增减或状态翻转,同批还要更新 doc/16(§2 能力表 + §2c 横切契约 + 头注基线日期)——本索引是目录页,doc/16 是结论页,两个都得更,只更一边总纲的「现状」就是假的。收尾跑
scripts/check-master-plan.sh(比对本表 §1 的现行真源编号与 doc/16 的引用,漏引即失败)。 - 四类归属:现行真源(
doc/顶层编号文档)、决策档案(doc/problems/)、记录(doc/log/)、归档(doc/archive/)。四者不互相冒充。 时效变化不搬家,只改状态:一篇方案过时了就在头注改状态或标「已取代」;只有被整代取代(旧线、旧引擎代际)才进doc/archive/。 - 施工包留档:开工前由主 Agent 写
tmp/<方案名>/施工包.md并交用户确认;开发模型随后一次完成大任务,机器验收后由主 Agent 终审。用户验收后,施工包原样搬进doc/log/<YYYY-MM-DD>-<方案名>/build.md并加状态头,此后冻结;结论提炼进同目录README.md,随后删tmp/<方案名>/。build.md只记「当时怎么施工的」,与doc/NN冲突时以doc/NN为准。