[ISSUE-0180] 判断写对了,但没人调用¶
现象¶
Tony:「验证状态在模型名字前边 勾选框后边会不会更好?然后待验证是什么图标?已失效呢?」
这两个问题问出了一个 bug:它们没有图标。
病灶¶
ai-account.ts 的 modelHealth() 是四态,并且专门写了:
🔴
stale压过testOk:测试是过去时,真实调用是现在时。
而 ai-model-row.tsx 判的是 model.testOk 的两态:
| 真实状态 | testOk |
界面显示 |
|---|---|---|
| 待验证 | undefined |
什么都没有 |
| 已验证 | true |
绿勾 ✅ |
| 未通过 | false |
红叹号 |
| 已失效 | 仍是 true |
绿勾 🔴 |
⇒ 用户看到的「已验证」,可能是一个已经失效的 Key。
而这正是 stale 这个状态被设计出来要防的事。
判断写对了但没人调用,和没写是一样的。
另一半:同一语义两套实现¶
账号行(ai-settings-view.tsx)早就有完整的四态图标映射,模型行却是两态。
同一套健康度语义、两处各写各的 —— 分叉是必然的,只是时间问题。
⇒ 抽成 ai-health-badge.tsx,图标 / 文案 / 颜色只有一个真相源。
顺带定死的命名(Tony:「名称记得规范」)¶
| 状态 | 名称 | 含义 |
|---|---|---|
ok |
已验证 | 测试通过,可以用 |
untested |
待验证 | 还没测过 —— 不代表不能用,只是没验过 |
failed |
未通过 | 测的时候就不通 |
stale |
已失效 | 测过通了,但之后真实调用失败了 |
🔴 failed 与 stale 用不同颜色:后者更该让人警觉,
因为界面上它此前一直显示「已验证」。
判据¶
tests/ai-health-badge.test.ts:四态齐全、四个名字互不相同、
failed 与 stale 颜色不同、modelHealth 的 stale 优先级、
模型行必须走 modelHealth 且不许退回 testOk 两态、
账号行与模型行必须共用徽标、状态图标必须排在勾选框之后模型名之前。
v0.15.12:同一批反馈的第 3、5 条¶
最大输出长度下放到模型级¶
Tony:「输出长度不应该是在每个模型里设置吗?」——他对。 同一个账号下的模型上限差很远:推理模型要留 1000+ 给思考过程, 快模型给太大只会拖慢返回。挂在账号上等于逼用户按最小那个模型来设。
⇒ AiModelEntry.maxTokens;账号级字段标 @deprecated 保留(老数据不报错)。
(温度更早一步挪去了「功能」,同一个道理:它回答「这次任务要多稳」。)
手填模型:从常驻输入框改成「同步」旁的按钮 + 弹窗¶
Tony:「『添加』是不是应该在同步后边?不然不是白白浪费一行」。 那一行常驻占位,而「自建服务 / 清单里没有的新模型」是低频动作 —— 高频的是同步和勾选。低频动作不该和高频动作抢同等版面。
模型编辑:内联展开 → 弹窗¶
Tony:「点击编辑弹窗会不会更好点???不然界面怪怪的」。 内联展开把那一行从 32px 撑到 160px,列表里其余行原地跳位 —— 点「编辑」的本意是改一个模型,结果整个列表重排了一遍。 而且展开态里有输入框、四个能力 chip、一段说明和「收起」, 信息量已经是一个对话框的量,却塞在一行的位置上。
「别名」→「显示名」¶
Tony:「那应该不叫别名 应该叫显示名吧?」——他对。
「别名」听起来像「另一个可用的 id」,而它只影响界面怎么称呼这个模型,
真正发给厂商的永远是 id。
⚠️ 只改 UI 文案,字段名仍是 alias —— 改字段名会让已存的值读不出来,
而那个值用户已经设过(截图里是「你爹啊」)。
🔴 新建弹窗时被既有判据当场抓住¶
tests/dialog-focus-guard-coverage.test.ts 报:
「ai-model-edit-dialog.tsx 自己渲染了 <Dialog> 但没装焦点守卫」。
这正是 ISSUE-0169/0179 的 aria-hidden 家族 —— 新写的 Dialog 会原样复发, 而那条判据就是为此立的。这次它在提交前就拦住了。
v0.15.13:我上一刀判断错了一件事¶
Tony:「点击测试 没有测试成功的提示文字」。
v0.15.12 把测试结果从对话框底部移到行内时,我写的理由是:
成功时不额外占一行:状态徽标已经变绿勾了,再写一句是重复。
那只在「待验证 → 已验证」时成立。 本来就是绿勾的再测一次,界面从头到尾没有任何变化 —— 用户不知道点没点上。
🔴 回执确认的是「我收到了你的操作」,不是「状态变了」。 这两件事我当时混成了一件。
⇒ 盯 testedAt 的变化(父组件每次测完都刷新它),行内显示 3 秒。
短暂而不是常驻 —— 常驻会把每一行都撑高一截。
判据第一版又是恒真的¶
只查了 justTested 这个名字存在。变异验证当场抓到:
把渲染条件改成 false && ...,断言照样绿(那个名字仍在 useState 里)。
⇒ 改成「找到 {justTested && 的位置,再在其后 400 字符内找成功文案」。
「某个标识符存在」和「它真的接在渲染上」是两回事。
另外两条¶
helperText 用空格占位 ⇒ 双倍空隙¶
helperText={... : ' '} —— 那个空格会让 helperText 区域撑出一整行高度,
再加下面那行安全说明的间距,看起来像忘了填东西。
原意是「预留位置,出错时不跳动」,但这个字段下面本来就紧跟着一行说明,
跳动感远不如常驻空白显眼。
「模型名」→「模型 ID」¶
Tony 指着参考界面问「那个是模型 id 吧?」—— 是。 手填弹窗与编辑弹窗的文案统一成「模型 ID」: 它必须和厂商那边完全一致,叫「名」会让人以为可以随便起。
v0.15.14:回执的位置¶
Tony:「测试通过 的文字提醒 是不是可以在测试按钮左侧,而不是下一行?」
两个理由,第二个更重要:
- 另起一行会把那一行撑高一截,列表里其余行跟着跳位;而按钮左侧本来就是空白,放进去零成本。
- 🔴 回执该紧挨着引发它的那个按钮 —— 我在 v0.15.13 的注释里刚写完「反馈要出现在引发它的地方」, 转头就把它放到了下一行。写下一条原则,和按那条原则做,是两件事。
⚠️ 失败原因仍在行下方展开:那是多行文本,塞进这一行会把按钮挤出去。 同一个「回执」,成功与失败的落点不同,依据是篇幅不是形式对称。
判据也跟着守位置¶
gate < 测试按钮 且 gate > 状态徽标(它属于操作区,不是状态区)。
🔄 第一次变异验证「没抓住」,查下来是变异脚本自己写错了:
</Stack> 在文件里有多个,index() 命中的是更早的那个,回执其实没被挪出行。
换成锚定 <AiModelEditDialog 重做,判据当场红。
⇒ 变异没抓住时,先怀疑变异本身——这次若直接下结论「判据恒真」就会去改一条本来正确的判据。