跳转至

[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:「测试通过 的文字提醒 是不是可以在测试按钮左侧,而不是下一行?」

两个理由,第二个更重要:

  1. 另起一行会把那一行撑高一截,列表里其余行跟着跳位;而按钮左侧本来就是空白,放进去零成本。
  2. 🔴 回执该紧挨着引发它的那个按钮 —— 我在 v0.15.13 的注释里刚写完「反馈要出现在引发它的地方」, 转头就把它放到了下一行。写下一条原则,和按那条原则做,是两件事。

⚠️ 失败原因仍在行下方展开:那是多行文本,塞进这一行会把按钮挤出去。 同一个「回执」,成功与失败的落点不同,依据是篇幅不是形式对称。

判据也跟着守位置

gate < 测试按钮 且 gate > 状态徽标(它属于操作区,不是状态区)。

🔄 第一次变异验证「没抓住」,查下来是变异脚本自己写错了: </Stack> 在文件里有多个,index() 命中的是更早的那个,回执其实没被挪出行。 换成锚定 <AiModelEditDialog 重做,判据当场红。 ⇒ 变异没抓住时,先怀疑变异本身——这次若直接下结论「判据恒真」就会去改一条本来正确的判据。