定位Schema-As-Code 证据链的认知 合法性站B 列全景 背书覆盖主题行①的第二个关键设计——语义字典Semantic Dictionary覆盖层注册表。回答凭什么成立语义字典是组织内唯一定义覆盖层、语义绑定、场景映射的资产是全组织同一术语坐标系。快速阅读方法论总纲与开源把设计规范写成代码格式是所有 AI 工具的上游约束方法论阶段一结构化诊断组件语义快照与模式诊断AI 生成界面的第一道检查阶段二语义契约化设计师作为语义翻译者 当AI生成界面时我怎么用规则锁住设计意图角色专题1:设计师与产品经理AI 界面语义走查指南一、调整前三条真实反馈里的语义三无在没有语义字典之前组织内的语义处于三无状态每条都有团队里的原话为证。真实反馈 1“评审会上说’这里用一个 alert’散会后发现三个人理解成三个东西。”前端理解为模态弹窗设计师指的是顶部通知条产品经理以为是可以自动消失的 Toast。三个人用同一个词指三个东西每个人都对——因为没有任何注册表裁定alert 在这个场景下是什么。同名异义无人仲裁。真实反馈 2“删除账户按钮该红色实心还是橙色描边最后谁的职级高听谁的。”新产品线设计删除账户流程一位设计师主张红色实心按钮、一位主张橙色描边双方都有道理最终靠职级裁定。决策依据是个人经验不可复用、不可跨产品线继承。决策无据全靠经验。真实反馈 3“PRD 写’需明显提示风险’交付后才开始吵什么叫’明显’。”开发按自己的理解实现验收按自己的理解走查争议在交付后才爆发。需求模糊无法验收。汇总成一张表环节界面层呈现状态缺失什么评审沟通同一术语多种理解可引用的唯一定义注册表设计决策个人经验裁定组织级场景语义方案需求描述自然语言形容词可校验的语义引用规范执行文档供人阅读AI 不可见机器可查询、可校验的注册表三条反馈一个根因组织里没有一份唯一定义术语的资产。字典在的时候它是文档平台里供人阅读的文字机器要查的时候它不存在。二、“用语义注册表统一定义”用语义注册表统一定义在工业界已有成熟实践。2024年起企业数据领域已大规模实践语义层概念。Databricks在其Semantic Layer Architecture中将其定义为business-friendly abstraction layer统一跨部门对客户订单等业务术语的理解。这与我们的语义字典同构Databricks解决数据领域的语义一致性我们解决界面领域的语义一致性。架构相同元数据仓库 → 业务逻辑层 → 治理框架。2026年Kyvos进一步提出AI-Ready语义层没有语义层AI无法正确解释数据含义。这个逻辑在界面领域同构没有语义字典AI无法正确解释红色按钮是致命错误还是普通警告。软件工程领域更早。DDD的限界上下文Bounded Context定义术语在特定边界内的唯一含义防腐层Anti-Corruption Layer防止外部模型污染内部语义。我们的语义域覆盖层即Bounded Context同一个Alert在transactional域与observational域含义不同各自域内唯一定义跨层禁止规则即防腐层status.critical不可用于observational域非法绑定在编译时阻断。但行业也有反面的声音。Design Systems Collective今年指出很多所谓语义令牌只是换名color-red-500改叫color-danger没有场景定义。这恰恰反证了我们为什么需要真正的语义字典不是换名而是锁义。参考链接Databricks Semantic Layer · Kyvos AI-Ready Semantic Layer · DDD Bounded Context · Design Systems Collective三、关键设计语义字典三层注册表语义字典是覆盖层注册表三层结构覆盖层目录Overlay Catalog→ 语义重绑定Semantic Rebinding→ 场景映射Scenario Mapping。层级内容查询时获得什么第一层覆盖层目录4 个 L1 语义域transactional交易与操作/ observational观察与信息/ navigational导航与引导/ conversational对话与交互加 L0/L2 层级该界面点属于哪种交互关系、约束特征是什么第二层语义重绑定术语在具体覆盖层下的强制语义6 个语义绑定某令牌在此场景的准确定义与跨层禁止第三层场景映射业务场景的绑定组合与组件组合SCN-001 ~ SCN-006整个场景的完整语义方案可直接引用3.1 第一层覆盖层目录v1.0.0 全量覆盖层 ID中文名称定义适用场景示例禁止场景层级universal通用层所有界面点的基础属性可访问性、响应式—L0被所有层覆盖transactional交易与操作用户动作会改变系统状态或数据支付、删除、提交、确认、撤销纯信息展示、状态更新、新手引导L1observational观察与信息用户仅接收信息无需立即行动通知、状态更新、提示、反馈需要用户决策、需要二次确认、不可逆操作L1navigational导航与引导用户需要方向指引无数据变更面包屑、步骤指示、返回、跳转表单提交、数据操作、支付流程L1conversational对话与交互用户与系统双向交流上下文持续聊天、问答、建议、澄清一次性操作、无上下文的状态提示L1financial资金操作transactional 的子层涉及资金流动支付、转账、退款—L2data-destructive数据销毁transactional 的子层涉及数据删除删除账户、清空数据—L2强制规则每个界面点必须且只能被一个 L1 覆盖层覆盖互斥L2 是对 L1 的细化而非替代未注册的覆盖层编译管线拒绝识别。3.2 第二层语义重绑定v1.0.0 全量绑定是强制的不是建议术语 ID所属覆盖层状态级别语义绑定约束注入跨层禁止status.criticaltransactional系统级故障阻断器用户必须立即处理否则系统状态恶化视觉红色脉冲、八边形图标行为必须二次确认文案必须说明后果适用仅用于阻断性错误observational / navigational / conversationalstatus.warningtransactional用户可恢复限制限制器用户需要注意但可以自助恢复视觉黄色静态、三角图标行为必须显示恢复时间文案必须提供操作步骤适用仅用于可恢复错误observational / navigational / conversationalstatus.infoobservational一般信息提示信息条用户可选择性关注不影响系统状态视觉蓝色静态、信息图标行为可自动消失文案禁止附加操作说明适用仅用于纯信息展示transactionalstatus.successobservational操作成功反馈成功条用户操作已完成系统状态已更新视觉绿色静态、对勾图标行为可自动消失文案禁止附加操作说明适用仅用于成功状态transactionalaction.destructivetransactional不可逆操作危险动作用户动作将导致数据永久丢失视觉红色空心描边、危险图标行为必须二次确认文案必须说明不可恢复适用仅用于删除/清空等操作observational / navigational / conversationalaction.primarynavigational主要引导动作引导动作帮助用户进入下一步或完成流程视觉品牌色实心、箭头图标行为点击后跳转文案显示下一步预览适用仅用于流程推进transactional / observational通用术语的重绑定示例同一个词不同覆盖层下绑定为不同语义通用术语transactional 下绑定为observational 下绑定为navigational 下绑定为Alert阻断器用户必须立即处理否则系统状态恶化信息条用户可选择性关注不影响系统状态路径提示用户需要方向确认无状态风险确认不可逆操作确认用户理解后果并承担风险已知晓确认用户收到信息无需承担风险路径确认用户确认前往下一节点取消操作撤销系统回滚到操作前状态关闭提示信息消失系统无变化返回上一步导航状态回退红色危险信号阻断、不可逆、需立即响应非法绑定observational 下红色非法非法绑定navigational 下红色非法前端实现时不传typeerror参数而是声明overlaytransactional由覆盖层强制注入语义。非法绑定在编译时直接阻断。3.3 第三层场景映射v1.0.0 全量场景 ID场景名称覆盖层语义绑定组合组件组合文案约束约束注入SCN-001删除账户transactionalstatus.critical action.destructiveAlert Button Modal必须包含此操作不可恢复必须说明数据删除范围必须输入账户名二次确认必须提供取消按钮操作后跳转至登录页SCN-002网络中断transactionalstatus.warningAlert Button必须显示网络不稳定必须显示自动重试倒计时提供手动重试按钮倒计时结束后自动刷新SCN-003保存成功observationalstatus.successToast仅显示保存成功禁止附加操作说明3 秒后自动消失不可手动关闭SCN-004新功能上线observationalstatus.infoBanner显示功能名称和一句话说明提供了解详情链接点击链接跳转帮助中心不可阻断当前操作SCN-005支付确认transactionalstatus.criticalAlert Form Button必须显示金额、收款方、支付方式必须说明支付后不可撤销必须输入支付密码或指纹必须提供取消按钮SCN-006步骤引导navigationalaction.primaryStepper Button显示当前步骤和总步骤提供上一步/下一步第一步禁用上一步最后一步变为完成场景映射查询实例设计师查询 SCN-001删除账户字典直接给出完整方案——覆盖层 transactional语义绑定 status.critical action.destructive组件组合 Alert Button Modal文案必须包含此操作不可恢复交互必须输入账户名二次确认。视觉探索在边界内展开语义方案无需重新发明。3.4 注册纪律字典是组织内唯一定义覆盖层、语义绑定与场景映射的资产。三条纪律唯一性全组织同一术语坐标系任何团队不得维护平行的私有字典。强制性所有 YAML 契约必须引用字典中的已定义项不可自创覆盖层或绑定semantic_domain的值必须在字典预定义列表中非法引用在编译前置校验时直接阻断。先注册、后引用字典没有的先走字典变更流程注册快照证据 → 诊断归档 → 候选模式 → 评审入典再引用。不为想象中的需求提前定义语义。四、架构层概念设计背景覆盖层Overlay不是分类Taxonomy。分类模型语义内生于组件ErrorAlert自带错误语义组件库升级时语义跟随重写覆盖层模型语义外赋于组件——组件是空容器Alert只负责渲染语义由覆盖层强制注入。组件库是底层Underlay语义覆盖层在组件之上加盖业务语义把空容器翻译为业务语义组件。分类回答这是什么组件覆盖层回答这个组件在此场景下承担什么语义。码本而非术语表。术语表供人查阅码本供机器解码每个绑定是离散索引编译管线查表后展开为连续约束。这决定了字典的读者不只是设计师更是编译管线与 AI 工具。在全景中的位置。语义字典位于建设层的最上游元规则层语义字典上游·元规则→ YAML 契约中游·实例→ 编译管线下游·执行契约库提供组织级管理。术语双轨。面向不同读者群时三层结构有两套叫法语义域 ≈ 覆盖层目录语义令牌 ≈ 语义重绑定场景映射 ≈ 约束注入。两套术语指向同一份注册表。五、这些坑怎么被解掉三条反馈的闭环回到开头的三条真实反馈字典就位后它们各自的解法路径。反馈 1 的解法“alert 到底是什么”——歧义在引用条目的瞬间消失症状复盘评审会上这里用一个 alert三个人理解成三个东西。根因没有可引用的唯一定义注册表术语含义靠各自脑补。解法路径查字典——transactional 域的 alert 是阻断确认observational 域的 alert 是顶部通知条。设计师与产品经理沟通时用字典条目编号替代形容词争议以字典为仲裁依据不再靠职级裁定。验证方式同样的评审场景引用条目编号后三方理解在当次会议对齐不再散会后才发现。反馈 2 的解法“删除账户按钮之争”——决策依据从职级变成注册表症状复盘红色实心 vs 橙色描边双方都有道理靠职级裁定。根因没有组织级场景语义方案决策依据是个人经验不可复用、不可跨产品线继承。解法路径查询 SCN-001完整语义方案既定覆盖层 transactional status.critical action.destructive 二次确认视觉探索在边界内展开。验证方式跨产品线语义天然一致——下一个产品线遇到删除账户直接引用同一场景映射不重新争论。反馈 3 的解法“什么叫明显提示风险”——需求从形容词升级为可校验引用症状复盘PRD 写需明显提示风险交付后才吵什么叫明显。根因需求用自然语言形容词描述没有可校验的语义引用。解法路径PRD 改写为引用场景映射 SCN-001语义绑定 action.destructive必须二次确认。验证方式验收标准在需求阶段即已确定——交付后的争议消失因为明显已经被翻译成字典里的具体约束。六、扩展路线v1.0.0当前4 个 L1 覆盖层 6 个语义绑定 6 个场景映射只覆盖证据最充分的 6 个漂移模式。v1.1.0规划按业务需求新增覆盖层如 onboarding 新手引导、新增绑定如 status.neutral 中性状态、新增场景映射如批量删除“跨设备同步”。v2.0.0远期重构覆盖层分类如 transactional 拆分为 financial 和>七、调整后工具界面层的呈现状态工具 / 环节调整前调整后组件调用Alert 是无语义的视觉容器契约编辑器中覆盖层下拉自字典选 observational 即继承不可阻断流程约束选 transactional 即继承确认交互要求验收环节走查结论停留在感觉不对Checklist 第一组直接引用字典覆盖层检查 / 语义绑定检查 / 约束注入检查结论注明字典版本号规范变更文档平台发通知人看漏、AI 不可见字典单点变更 → 契约重编译 → 四种消费格式同步更新Git Diff 可追溯边界声明语义字典不解决视觉值的一致性那是 Design Token 层的职责不定义具体场景的约束实例那是 YAML 契约的职责也约束不了有没有人查它消费纪律在角色侧见角色 1 长篇。当前量化收益均为数据模型推演待生产数据验证。1920
)
