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:一个空格就能让整个租户的对话全部失败。
- 5 项 P1:刷新丢结果、面板卡输入框、侧栏留死链、内置助手被静默清空、导入默认可见性与手工相反。
- 6 项 P2/P3:文案、反馈、边界与日志卫生。
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:等人面板把输入框永久顶掉
两副面孔:
- 幽灵面板:run 停在 ask_user 时,从另一个客户端把它停掉。引擎已是
stopped,本页面板 6 秒后还挂着「需要你确认 / 待回答」,composer 回不来。原因是pendingAsks只看q.status === 'pending',不看所属气泡是否已经收口。 - 没有出口:等待期间整个 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:项目页两句话与行为对不上
- 已经在默认项目里,仍显示「回到默认项目」,点了没反应 → 用已有
isDefault控制显隐。 - 「新对话默认进入」读起来像一个可配置的默认值,实际是「上次在哪个项目」→ 按 Q3 改文案(推荐)或做成真设置。
12. P3:访问日志里有完整 access_token
现象:SSE 只能用查询串传 token(EventSource 没有自定义头),而 gin.Default() 的访问日志原样打印整条 URL——日志里躺着可用的凭证(有效期 15 分钟)。日志一旦进采集系统就等于外送。
怎么修:换成自定义 LoggerWithFormatter,把 access_token=… 打成 ***,其余格式不变。不改传参形态(这是 EventSource 的唯一解)。
13. 明确不做
- SSE 改用请求头:EventSource 不支持;要用请求头就得换 fetch 流式实现,属于另一个方案。
- 静止标签页的 401 重连:doc/48 已加「重连前先刷新 token」;页面静止时没有调用者仍是机制性限制。
- ask_user 超时:产品拍板项(多久算放弃、超时后 run 怎么收),本篇只补「人能停」。
- 新建同名内置助手在后端直接拒绝:后端无法区分「编辑内置」与「新建撞名」(同一个 POST、同一形状),所以拦在前端。
14. 四问的落地取值
本轮按推荐值直接落地;四问都还没有用户点头,任何一项都可以翻(翻的成本写在括号里)。
- Q1 助手名字规则:落地
^[A-Za-z0-9_-]{1,64}$。中文名在保存/导入时 400111002,提示「助手名字只能用字母、数字、下划线、连字符(1–64 个字符)」。装配期对历史上已经落库的坏行跳过并打日志(agents: %q: 拒载),不再拖垮整个租户。(翻成「允许中文 + 派生安全工具名」要加字段、改三处装配,工作量翻倍。) - Q2 导入默认可见性:落地仅自己,与手工新建一致。(翻回团队可见只改一行。)
- Q3「新对话默认进入」:落地改文案为「新对话进入」,并在已在默认项目时隐藏「回到默认项目」按钮。(做成真默认项目偏好要新增存储与端点。)
- 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 守三种形态 |
验收摘要:
- A1(P0):curl 建
qa 空格→ 400111002+ 那句提示;qa_ok/qa-ok/64 字符通过、65 字符拒绝;导入含坏名整批 400 不落库;库里已有坏行时装配日志出现拒载,其余 run 正常。 - A2:真停一轮 → 「已停止,没有写进历史」;刷新后重开同一会话,占位气泡仍在(
lastRunStatus=stopped)。 - A3:ask_user 挂起时面板有「停止」;点它 → run
stopped、面板收起;外部POST /api/runs/{id}/stop后页面 ≈0.5 s 内收起(观测窗 3 s 内)。 - A4:外部
DELETE /api/sessions/{id}后侧栏该条 9 ms 消失,正开着的对话同时清空。 - A5:新建同名内置助手 → 提示「已经是内置或已有助手」,服务端助手表仍是
coder/default、researcher/default。 - A6:导入后该行
visibility为private。 - A7:过期后登录页出现「登录已过期,请重新登录」,重新登录后消失;各页报错不再带
400:/401:前缀。 - A8:邀请页印当前账号邮箱;
writeText被替成 reject 后按钮变「复制失败」;密钥空名点保存被拦;灯箱可开、点击放大、× 关闭。 - A9:101 个汉字项目名 → 400「项目名最多 100 个字符」;100 个通过并建出项目。
- A12:隔离引擎日志里
access_token=***,全日志 grep 探针串 0 命中。
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)会把用户气泡改到中性深墨,这组覆盖仍然成立;以后任何「深底气泡」都要先检查这七类元素。