架构决策记录
ADR 0061: 推理档位的显示名由人写在目录里,不再由前端拼出
本文目录
日期:2026-11-02 · 状态:已接受(修改 0009 的「UI 从谓词现算标签」)
背景
推理模板详情页的档位名曾由前端拼成「{芯片对象} {通用|兼容|优化}档位」:芯片对象来自 spec 的 gpus.display_target(缺失时前端用正则从型号里猜),档位类型来自 display_profile。两个字段都在 YAML 里手写,和 gpus 的真实匹配条件没有约束关系。内置目录里有 194 组同一模型、同一引擎下显示名相同的档位(122 个模型),其中 149 组连量化、场景标签也相同,用户必须点开才知道区别;还有标成「NVIDIA」实际只匹配 Hopper 或 Blackwell 的档位。「通用 / 兼容 / 优化」从未定义,用法自相矛盾。
真正区分兄弟档位的是芯片代际、量化与权重发布方、显存门槛、固定卡数、投机解码 / Engram 卸载 / 多机等形态、镜像版本。哪几项值得写进名字因档位而异。
决策
- 删除 spec 级
display_profile与gpus.display_target;导入时仍读这两个键以兼容旧模板,但忽略并给出CATALOG_DISPLAY_PROFILE_RETIRED警告,不存储、不再导出。 - spec 新增人写的
display_name_zh_cn、display_name_en,各存一列,server 原样下发,前端按语言选一个、缺一种时用另一种、都没有时显示 spec 的name,不再推导任何名字。 - 名字格式为「适用卡 · 量化 [· 关键门槛或形态]」,写法见推理目录规范 · 显示名。目录校验同一模型、同一引擎内中英文名各自唯一、单行、限长;内置档位两个名字都必须写(seed 测试守护)。
- 详情抽屉的「适用 GPU」显示
gpus的真实匹配条件,名字只是摘要。
取舍
- 人写 vs 按字段自动生成:自动生成只能拼固定几个维度,要么名字太长,要么漏掉真正的区别(例如两个档位只差上下文长度)。人写的代价是新增档位时要多写两行,并可能写得与匹配条件不一致;唯一性校验能拦住重名,不一致靠评审与名字里的芯片名对照。
- 两列 vs 一个按语言的映射:只有中英两种界面语言,与模型级
readme_zh_cn/readme_en同形,带类型的列比 JSON 映射简单,也符合 ADR 0032。
后果
- 存量用户档位没有名字,显示 spec
name,编辑时补上即可。内置档位随目录升级写入名字。 - ADR 0009 中「具名类的中文展示名消失,UI 需从谓词现算标签」不再成立:展示名回到目录数据里,但写在每个 spec 上,而不是一个具名芯片类上。
这篇文档有帮助吗?