语义字典:组织级语义注册表,契约的唯一信源
2026/8/5 23:59:04 网站建设 项目流程

定位: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交易与操作用户动作会改变系统状态或数据支付、删除、提交、确认、撤销纯信息展示、状态更新、新手引导L1
observational观察与信息用户仅接收信息,无需立即行动通知、状态更新、提示、反馈需要用户决策、需要二次确认、不可逆操作L1
navigational导航与引导用户需要方向指引,无数据变更面包屑、步骤指示、返回、跳转表单提交、数据操作、支付流程L1
conversational对话与交互用户与系统双向交流,上下文持续聊天、问答、建议、澄清一次性操作、无上下文的状态提示L1
financial资金操作transactional 的子层:涉及资金流动支付、转账、退款L2
data-destructive数据销毁transactional 的子层:涉及数据删除删除账户、清空数据L2

强制规则:每个界面点必须且只能被一个 L1 覆盖层覆盖(互斥);L2 是对 L1 的细化而非替代;未注册的覆盖层编译管线拒绝识别。

3.2 第二层:语义重绑定(v1.0.0 全量)

绑定是强制的,不是建议:

术语 ID所属覆盖层状态级别语义绑定约束注入跨层禁止
status.criticaltransactional系统级故障阻断器:用户必须立即处理,否则系统状态恶化视觉:红色脉冲、八边形图标;行为:必须二次确认;文案:必须说明后果;适用:仅用于阻断性错误observational / navigational / conversational
status.warningtransactional用户可恢复限制限制器:用户需要注意,但可以自助恢复视觉:黄色静态、三角图标;行为:必须显示恢复时间;文案:必须提供操作步骤;适用:仅用于可恢复错误observational / navigational / conversational
status.infoobservational一般信息提示信息条:用户可选择性关注,不影响系统状态视觉:蓝色静态、信息图标;行为:可自动消失;文案:禁止附加操作说明;适用:仅用于纯信息展示transactional
status.successobservational操作成功反馈成功条:用户操作已完成,系统状态已更新视觉:绿色静态、对勾图标;行为:可自动消失;文案:禁止附加操作说明;适用:仅用于成功状态transactional
action.destructivetransactional不可逆操作危险动作:用户动作将导致数据永久丢失视觉:红色空心描边、危险图标;行为:必须二次确认;文案:必须说明不可恢复;适用:仅用于删除/清空等操作observational / navigational / conversational
action.primarynavigational主要引导动作引导动作:帮助用户进入下一步或完成流程视觉:品牌色实心、箭头图标;行为:点击后跳转;文案:显示下一步预览;适用:仅用于流程推进transactional / observational

通用术语的重绑定示例(同一个词,不同覆盖层下绑定为不同语义):

通用术语transactional 下绑定为observational 下绑定为navigational 下绑定为
Alert阻断器:用户必须立即处理,否则系统状态恶化信息条:用户可选择性关注,不影响系统状态路径提示:用户需要方向确认,无状态风险
确认不可逆操作确认:用户理解后果并承担风险已知晓确认:用户收到信息,无需承担风险路径确认:用户确认前往下一节点
取消操作撤销:系统回滚到操作前状态关闭提示:信息消失,系统无变化返回上一步:导航状态回退
红色危险信号:阻断、不可逆、需立即响应非法绑定(observational 下红色非法)非法绑定(navigational 下红色非法)

前端实现时不传type="error"参数,而是声明overlay="transactional",由覆盖层强制注入语义。非法绑定在编译时直接阻断。

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 注册纪律

字典是组织内唯一定义覆盖层、语义绑定与场景映射的资产。三条纪律:

  1. 唯一性:全组织同一术语坐标系,任何团队不得维护平行的"私有字典"。
  2. 强制性:所有 YAML 契约必须引用字典中的已定义项,不可自创覆盖层或绑定;semantic_domain的值必须在字典预定义列表中,非法引用在编译前置校验时直接阻断。
  3. 先注册、后引用:字典没有的,先走字典变更流程注册(快照证据 → 诊断归档 → 候选模式 → 评审入典),再引用。不为想象中的需求提前定义语义。

四、架构层概念:设计背景

覆盖层(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

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询