tako 文档 GitHub

49 · 走查缺陷修复(12 项)

性质:已落地(2026-10-23)。 状态:✅ 12 项全部施工并验收(§15)。四问按推荐值落地(§14),用户仍可翻转任一项。台账 tmp/49-走查缺陷修复/(不入库)。 验收面:go test ./internal/runengine / go vet ./internal/runengine / npm run typecheck / npm test 全绿;端到端在隔离引擎(8944,tako_acc + Redis db8)与浏览器(5173 + 8901)逐条手验。 来源:2026-10-23 晚的第二次全站走查(Playwright 逐页点击 + 真发消息 + 真停止 + 跨标签页 + 窄屏 + 引擎日志对读)。与 doc/48 的 17 条不重叠——doc/48 已全部落地,本篇是落地后发现的新问题。 真源关系:助手规格与工具名是 doc/26/doc/39;等人机器是 doc/47;事件通道是 doc/46;信封与业务码是 doc/40、doc/28。 不改任何既有契约字节;新增的错误响应复用 111002(入参不合法),不新增业务码。


0. 背景:这轮怎么发现它们的

2026-10-23 晚,在真实浏览器里按人的路径走:登录/输错密码/刷新/退出 → 发消息、停止、刷新 → 项目增删改 → 助手新建/导入/改工具 → 团队页 → 700px 与 380px 两档 → 另开一个同源页面验证跨客户端同步。每一条都有当场证据(截图、引擎日志原文、接口响应字节),不是读代码推测。

12 项里:

1. P0:子代理名字不合法会拖垮整个租户的 run

病灶故事:运营在「助手 → 子代理 → 新建」里建了一个叫 qa 空格 的助手,保存成功、列表正常。此后再发任何消息——哪怕是「只回复 ok」——页面都只显示「失败,没有写进历史」。引擎日志里是:

agents: 3 spec(s): coder, qa 空格, researcher
[NodeRunError] status code: 400 ... Invalid 'tools[25].function.name': string does not
match pattern. Expected a string that matches the pattern '^[a-zA-Z0-9_-]+$'

为什么会这样:助手名字同时是三样东西——AgentTool 的工具名、runlog 里的 agent 值、厂商请求里 tools[i].function.name。最后一项有硬约束(^[a-zA-Z0-9_-]+$),而我们在保存、导入、落盘解析三个入口都没校验。

不修的后果:用户不知道是自己建的东西坏了,只会认为「这个产品今天不好用」;而且坏配置会一直留在租户里,重启引擎也不会好。

怎么修:一个规则 ^[A-Za-z0-9_-]{1,64}$,三处都拦:

入口 今天 改后
POST/PUT /api/tenants/:id/agents 只 trim + 非空 400 111002「助手名字只能用字母、数字、下划线、连字符(1–64 个字符)」
POST /api/tenants/:id/agents/import 只查重名 同一句话 400,整批不落库
工作区 .md 规格(parseAgentSpec) 只查 frontmatter 形状 这条拒载并打日志;其余规格照载,run 不受影响

验收:三个入口各打一次(curl 见台账),外加 agents_test.go 两条单测。

2. P1:刷新会把「停止/失败」这一轮抹掉

病灶故事:用户让模型数 1 到 5000,发现不对,点停止。屏幕上立刻出现「已停止,没有写进历史」——然后他刷新了一下页面,这句话和气泡一起消失,只剩自己那条消息。他会以为消息没发出去。

为什么:停止与失败在 runlog 里都没有 assistant 定稿行。实时路径靠 closeOut() 查状态补上这句提示;刷新走 reconcile(),那里只认「有活 run」和「崩溃可续(interrupted)」两种,stopped / error 没有分支。

怎么修:reconcile() 补一条分支,用 lastRunStatus + lastRunId 重建一条空的 assistant 气泡,state 分别置 stopped / error——渲染复用现有 note 文案,不加新组件。

验收:发长任务 → 停止 → 刷新 → 提示还在;再发一条历史顺序不乱。

3. P1:等人面板把输入框永久顶掉

两副面孔:

  1. 幽灵面板:run 停在 ask_user 时,从另一个客户端把它停掉。引擎已是 stopped,本页面板 6 秒后还挂着「需要你确认 / 待回答」,composer 回不来。原因是 pendingAsks 只看 q.status === 'pending',不看所属气泡是否已经收口。
  2. 没有出口:等待期间整个 composer 被面板替换,而「停止」按钮长在 composer 里——用户除了回答问题,没有任何叫停手段;服务端也没有提问超时。

怎么修:pendingAsks 只认「这一轮还没收口」的气泡(streaming / offline);面板头加「停止」,调已有的 stopCurrent()(端点早就幂等)。

验收:面板里点停止 → 面板消失、输入框回来、气泡显示已停止;另开客户端停 → 本窗口 ≤3 秒弹回输入框。

4. P1:删掉的会话会留在侧栏

病灶故事:桌面端删掉一场会话,手机端(或另一个标签页)的侧栏还留着它;点进去是空白的「从一句话开始」,没有任何解释,条目也还在。

为什么:session_deleted 事件只做了「如果当前正打开它,就退回新对话」,没有把这条从 recentSessions 里摘掉;侧栏只在切会话/收尾时重拉。

怎么修:收到事件时顺手 filter 掉;不做全量重拉(重拉会把滚动位置和顺序打乱)。

验收:curl 删一条 → ≤3 秒侧栏消失;删当前会话 → 内容区和侧栏同时回到空态。

5. P1:新建同名内置助手会把内置配置清空

病灶故事:用户在「新建」里填了 coder(可能想改它的说明),保存成功——然后发现「coder」的说明、规格、工具策略全没了。实际上系统建了一条 override,并且用请求里的空串覆盖了从内置复制过来的值。

为什么:服务端「同名默认助手 → 建 override」是给编辑内置这条路用的(前端选中默认条目后走同一个 POST);「新建」也走这条,于是空表单成了「清空」。

怎么修:前端在 creating 状态下先查两侧(root + subagent)的现有名字(含默认),撞名就不发请求,提示「要改它请在左侧选中后编辑」。服务端的 override 能力保留——编辑内置照旧。

验收:新建 coder → 横幅提示、override 条数不变;选中内置改说明 → 保存后是新写的那句。

6. P1:导入与新建的默认可见性相反

病灶故事:同一页面,手工新建的助手默认「仅自己」,导入的默认「团队可见」。导入的人通常以为只是自己多了一份,结果团队成员的助手列表里都出现了。

为什么:importAgents 里自定义行写死 Visibility: "tenant",而前端新建写死 private。

怎么修:按拍板 Q2 统一(推荐「仅自己」),导入完成的提示里写明当前可见性。

验收:导入后 GET 的 visibility 是 private;改成团队可见后变 tenant。

7. P2:报错把网关语义塞给用户;被登出没有说明

现象:助手页导入重名显示 409:这个名字已经有一份配置;输错密码显示 401:邮箱或密码不正确;refresh token 失效时人直接被踢回登录页,屏幕上没有任何一句话。

怎么修:show() / login() 只显示 message;clearAuth(reason) 带上 expired 原因,登录表单据此显示「登录已过期,请重新登录」(主动退出不显示,登录成功即清除)。

验收:四处点一遍,文案里不含三位状态码;伪造 refresh token 后刷新 → 出现过期提示。

8. P2:四个小口径

现象 改法
邀请落地页账号不匹配时,括号里印的是邀请目标邮箱 改印当前登录账号(myEmail)
剪贴板被拒时「复制」完全无反馈 按钮显示「复制失败」1.4 秒 + aria-live
密钥行名字留空会被静默丢弃,但横幅说「已保存」 保存前校验,横幅「密钥名不能为空」,不发请求
灯箱只能点背景关、小图不放大 加「关闭」按钮;点图片在适应窗口/原始大小间切换

9. P2:名字没有边

项目名、助手名都没有长度上限:接口接受 100 字(前端也没有 maxlength),200 字也不拒。今天靠 CSS 兜住了布局,但会话标题、邀请页、审计导出都会用到这个名字。

怎么修:项目名 ≤100、助手名 ≤64(与 A1 同一条规则),服务端 400 111002,两处输入框 maxlength。

10. P3:自动链接吞掉中文标点

现象:模型输出 https://example.com/a,后面,链接把 , 编码进 href,点开是坏地址。

怎么修:markdown.ts 用 marked 的 walkTokens,自动链接末尾的全角标点(,。、;:!?)》」』】)从 href 与显示文本里剥掉;补一条 npm test 断言。

11. P3:项目页两句话与行为对不上

12. P3:访问日志里有完整 access_token

现象:SSE 只能用查询串传 token(EventSource 没有自定义头),而 gin.Default() 的访问日志原样打印整条 URL——日志里躺着可用的凭证(有效期 15 分钟)。日志一旦进采集系统就等于外送。

怎么修:换成自定义 LoggerWithFormatter,把 access_token=… 打成 ***,其余格式不变。不改传参形态(这是 EventSource 的唯一解)。

13. 明确不做

14. 四问的落地取值

本轮按推荐值直接落地;四问都还没有用户点头,任何一项都可以翻(翻的成本写在括号里)。

  1. Q1 助手名字规则:落地 ^[A-Za-z0-9_-]{1,64}$。中文名在保存/导入时 400 111002,提示「助手名字只能用字母、数字、下划线、连字符(1–64 个字符)」。装配期对历史上已经落库的坏行跳过并打日志(agents: %q: 拒载),不再拖垮整个租户。(翻成「允许中文 + 派生安全工具名」要加字段、改三处装配,工作量翻倍。)
  2. Q2 导入默认可见性:落地仅自己,与手工新建一致。(翻回团队可见只改一行。)
  3. Q3「新对话默认进入」:落地改文案为「新对话进入」,并在已在默认项目时隐藏「回到默认项目」按钮。(做成真默认项目偏好要新增存储与端点。)
  4. Q4 灯箱:落地关闭按钮 + 点击放大/还原,背景可点关闭,safe center 处理超高图。

15. 落地与验收记录(2026-10-23)

代码落点:

项 改动
1 agents.go 名字规则 + parseAgentSpec 拒载 + BeforeAgent 跳过坏行;product_api.go 的建/改/导入三入口共用同一句提示;agents_test.go 覆盖空格名、合法名、64/65 字符边界
2 chat.ts reconcile():lastRunStatus ∈ {stopped,error} 且日志里没有对应 assistant 行时补一条占位气泡
3 App.vue:pendingAsks 只认 streaming/offline 气泡;输入区与面板各有一个停止入口
4 App.vue onMutation:session_deleted 时把该会话从最近列表摘掉
5 Configure.vue:新建时撞内置/已有名字先弹提示,不发空 override
6 product_api.go 导入的自定义行 Visibility: private
7 前端不再给 message 加 HTTP 状态码前缀;auth.ts 增加 authExpired,登录页显示「登录已过期,请重新登录」
8 邀请页印当前账号邮箱;复制失败按钮显示「复制失败」;密钥空名行前端拦截;灯箱见第 4 问
9 workspaceNameFrom 按 rune 限 100 字(400 111002);项目页两个输入框 maxlength=100
10 markdown.ts 自定义 url tokenizer:在首个中文标点处截断,再剥尾部 ASCII 标点;markdown.test.ts 三条断言
11 ProjectsView.vue:文案改「新对话进入」;已在默认项目时隐藏「回到默认项目」
12 server.go 换 gin.New() + LoggerWithFormatter,access_token=… 打成 ***;accesslog_test.go 守三种形态

验收摘要:

16. 落地后补记(2026-10-24)

#13 用户气泡里的行内代码白字白底,等于隐形

现象:用户发一条带反引号的消息(例:第一行写 `## 标题`(两个井号)),用户气泡(深色底)里那两个代码片段只剩一个米色圆角块,字完全看不见;同一段消息里的围栏代码块、表格、引用和链接是同一类问题,只是这条消息先暴露了行内代码。

实测(5173 页面,2026-10-24):

CODE text="## 标题"
  color: rgb(246, 241, 231)   ← 继承 .bubble.user .bubble-main(App.vue:2531-2533)
  bg:    rgb(243, 240, 232)   ← .bubble-text :deep(code) 写死的 var(--bg)(App.vue:2581)

对比度 ≈1.0。根因是整套 markdown 排版(doc/48 A1)只按浅色助手气泡设计,用户气泡反过来是深底浅字。

修复:新增一组 .bubble.user .bubble-text :deep(...) 覆盖(code / pre / th / td / blockquote / a / hr),只把「浅底深字」的几项在深色气泡里翻过来;助手气泡不动。修复后实测行内代码 fg=rgb(246,241,231) / 合成底 rgb(63,60,56),对比度 9.8:1。

同类风险:新配色(doc/51)会把用户气泡改到中性深墨,这组覆盖仍然成立;以后任何「深底气泡」都要先检查这七类元素。