跳转至

ISSUE-0225 AI 账号弹窗 API Key 标题没骑缝(字段形态不一致)

来源与定案

2026-10-02 Tony 截图报障(docs/raw/screenshots/2026-10-02-apikey-mask-overflow-tony.png): 「这个 apikey 骑缝的呢?」主控初判「掩码圆点越界」为图像分析误判;Tony 指认 定案:所指 = 「② API Key」标题没骑缝。

真根因(Tony 定案后)

Field(骑缝字段框,src/components/ui/field.tsx)的浮动 label 设计(v0.16.44): raised={!!apiKey} 由值驱动——空 key 时 label 掉在框内当提示、有值才骑缝。AI 账号 弹窗里 API Key 常处于空态(新增流程),label 在框内;上方有值字段(接口地址/模型) label 骑在框上边——同一弹窗内字段形态不一致,看起来不像一套。弹窗表单是必填 配置项场景,与搜索框(大框、收起态 label 当 placeholder 是 Tony 认可的设计)场景不同。

修法

AI 账号弹窗内 Field 的 label 常驻骑缝(调用点级,不动公共 Field 组件默认行为 ——搜索框等其他消费方的收起态设计保持)。空态引导由 placeholder 承担(API Key 的 placeholder 已在位;其余字段核一遍)。

排障存档:初判「掩码越界」的证伪(防复发)

  • harness(tests/layout/apikey-overflow-harness.html + scan-apikey-overflow.mjs, zoom 真挂容器、3 组别 × 4 zoom × 4 宽度 × 2 场景 = 96 点/组): prod 组 0 失败(原生 password input 自裁 + 框内滚动,含 zoom 110/125/150%); mutation 组 4 失败自证 harness 有效。留档作防回归资产。 (v0.16.77 回炉订正:harness 断言②「绘制级 Range 对比」作用于无子节点的 void input,退化为元素盒、结构性恒绿——有效断言是元素级/框级/滚动能力, 详见 harness 内注释。)
  • 截图判读歧义:原图 API Key 字段是收起态(无掩码圆点,右侧「复制回…」是 placeholder);≈85% 竖线与 Field 右边框、dialog 右边框都对不上。
  • 教训:图像分析对像素级边界判读有误判前科(本日第二例),报障定案优先问 Tony 指认,再开 harness。

状态

  • 2026-10-02 开账(初判误向:掩码越界)→ 同日 harness 证伪 → Tony 指认改向 (label 骑缝)→ v0.16.77 修复完成(fixed):
  • src/sections/settings/view/ai-account-dialog.tsx 弹窗内所有 Field raised 恒 true(名称/② API Key/接口地址/模型 ID),field.tsx 零改动;
  • 名称字段补 placeholder「例:Gemini 主用、DeepSeek 备用」;
  • tests/ai-account-dialog-notch.test.tsx 四钉(源码传参 + jsdom 渲染 + field.tsx 边界 + placeholder 在位),mutation 实测红(改回 raised={!!apiKey} 两条断言当场失败,已恢复);
  • L3 截图 docs/raw/screenshots/2026-10-02-ai-account-dialog-notch-fixed.png (空态/有值态全骑缝 + 旧病对照)。