義令牌表：把語(yǔ)義概念編碼成離散枚舉)
框架設(shè)計(jì)背景本文是 Schema-As-Code 證據(jù)鏈 的框架設(shè)計(jì)站屬于主題行的第一個(gè)關(guān)鍵設(shè)計(jì)——語(yǔ)義令牌表Semantic Token Table。在前序章節(jié)中階段一 Guard 結(jié)構(gòu)化診斷通過(guò)組件語(yǔ)義快照與三層判定模型發(fā)現(xiàn)了6 個(gè)漂移模式語(yǔ)義域建立了組件是空容器語(yǔ)義由場(chǎng)景定義的覆蓋層模型。但語(yǔ)義要能被機(jī)器識(shí)別、校驗(yàn)與生成必須先解決一個(gè)編碼問(wèn)題如何把語(yǔ)義概念變成機(jī)器可運(yùn)算的離散值本文要建立的正是 Schema-As-Code 的語(yǔ)義編碼層——當(dāng)語(yǔ)義規(guī)范體系需要被寫(xiě)入YAML 契約時(shí)語(yǔ)義必須以離散令牌的形式存在而非自然語(yǔ)言描述。1. 問(wèn)題語(yǔ)義是感覺(jué)還是可運(yùn)算的值行業(yè)現(xiàn)狀中語(yǔ)義以自然語(yǔ)言或視覺(jué)樣式存在設(shè)計(jì)師說(shuō)這個(gè)要用紅色前端看到 #EF4444AI 生成工具看到 color: red。但紅色在不同場(chǎng)景下含義完全不同——在語(yǔ)義域的 transactional 域它是阻斷確認(rèn)在 observational 域它可能是非法綁定跨層禁止。當(dāng)語(yǔ)義以顏色值、文案詞或感覺(jué)的形式流動(dòng)時(shí)機(jī)器無(wú)法區(qū)分同一個(gè)紅色在不同場(chǎng)景下是否合法。6 個(gè)漂移模式中的 ERR-001錯(cuò)誤狀態(tài)后果差異未分級(jí)根因正是如此致命錯(cuò)誤、網(wǎng)絡(luò)抖動(dòng)、限流、降級(jí)四種完全不同的后果共用同一種紅色——因?yàn)闄C(jī)器看到的只是 color: #EF4444而不是 error_severity.fatal 與 error_severity.retryable 的語(yǔ)義區(qū)別。沒(méi)有離散令牌就沒(méi)有機(jī)器可執(zhí)行的判定依據(jù)。2. 為什么自然語(yǔ)言守不住語(yǔ)義不可運(yùn)算設(shè)計(jì)規(guī)范文檔用自然語(yǔ)言描述語(yǔ)義“致命錯(cuò)誤用紅色脈沖限流用黃色時(shí)鐘”。但自然語(yǔ)言對(duì)機(jī)器是不可運(yùn)算的●AI 生成工具讀不懂致命錯(cuò)誤與限流的區(qū)別它的訓(xùn)練語(yǔ)料里只有 red 和 yellow●前端工程師看到的是 Design Token color-danger 和 color-warning但 danger 與 warning 的語(yǔ)義邊界沒(méi)有機(jī)器定義AI 可以把 color-danger 用在成功狀態(tài)●驗(yàn)收走查依賴人的主觀判斷感覺(jué)不對(duì)無(wú)法轉(zhuǎn)化為可復(fù)現(xiàn)的校驗(yàn)規(guī)則。組件語(yǔ)義快照的 6 字段記錄法已經(jīng)證明觀察界面時(shí)需要記錄 component_type、visual、copy、interaction、context 等維度。但這些字段的值如果是自由文本如 color: “red”仍然不可運(yùn)算。語(yǔ)義令牌表的作用就是把紅色編碼為 status.critical把限流編碼為 error_severity.retryable——讓語(yǔ)義成為機(jī)器可查詢、可校驗(yàn)、可攔截的離散值。3. 設(shè)計(jì)思路把語(yǔ)義概念編碼成離散枚舉本文的設(shè)計(jì)思路是三個(gè)遞進(jìn)命題●語(yǔ)義概念 → 離散令牌error_severity 不是文檔里的段落而是包含 fatal、transient、retryable、degraded 四個(gè)枚舉值的令牌表每個(gè)枚舉值綁定唯一的視覺(jué)映射status.critical → 紅色脈沖與行動(dòng)約束必須提供恢復(fù)路徑●令牌 → 字典注冊(cè)所有語(yǔ)義令牌在語(yǔ)義字典中注冊(cè)成為組織級(jí)唯一信源。契約YAML不定義令牌只引用令牌●令牌 → 可執(zhí)行規(guī)則編譯管線將令牌表編譯為 Prompt 前綴注入 AI 上下文、JSON Schema組件 Props 校驗(yàn)、CI 規(guī)則流水線攔截——同一組離散值在不同工具鏈中以不同格式執(zhí)行同一語(yǔ)義。這與語(yǔ)義規(guī)范體系的關(guān)系語(yǔ)義規(guī)范體系定義有哪些語(yǔ)義維度語(yǔ)義令牌表定義每個(gè)維度下有哪些離散值。沒(méi)有令牌表規(guī)范體系只是分類框架沒(méi)有規(guī)范體系令牌表只是孤立枚舉。3.1 把意思變成編號(hào)機(jī)器看不懂紅色代表很危險(xiǎn)機(jī)器看得懂 status.critical。把連續(xù)的自然語(yǔ)言描述變成離散的編號(hào)枚舉值。Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境里的例子不說(shuō)紅色、很緊急、要刷新 → 說(shuō) status.critical不說(shuō)黃色、等一等、能恢復(fù) → 說(shuō) status.warning不說(shuō)灰色、加載中、不用管 → 說(shuō) status.neutral為什么這樣做自然語(yǔ)言有同義詞“嚴(yán)重≈Critical≈危急”機(jī)器會(huì)搞混。編號(hào)沒(méi)有同義詞一個(gè)編號(hào)只對(duì)應(yīng)一個(gè)意思。3.2 一個(gè)編號(hào)只綁定一套視覺(jué)status.critical 只能是紅色脈沖 八邊形圖標(biāo)不能今天是紅色明天變成橙色。編號(hào)和視覺(jué)參數(shù)是鎖死的一對(duì)一映射。Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境里的例子編號(hào)顏色動(dòng)畫(huà)圖標(biāo)按鈕樣式status.critical紅色脈沖八邊形必須二次確認(rèn)status.warning黃色靜態(tài)三角顯示恢復(fù)時(shí)間status.info藍(lán)色靜態(tài)信息可自動(dòng)消失status.neutral灰色旋轉(zhuǎn)加載無(wú)為什么這樣做以前設(shè)計(jì)規(guī)范寫(xiě)錯(cuò)誤用紅色但不同前端可能用不同紅。編號(hào)鎖死后機(jī)器查表就知道唯一答案。3.3 同一個(gè)編號(hào)能翻譯成三種格式設(shè)計(jì)師寫(xiě)了一份 status.critical 的定義機(jī)器自動(dòng)把它變成三種東西給三種不同的人用。Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境里的三種格式給誰(shuí)用格式內(nèi)容給 AI 寫(xiě)界面的工程師Prompt 前綴“生成致命錯(cuò)誤時(shí)必須用紅色脈沖…”給校驗(yàn)代碼的機(jī)器JSON Schema{“color_token”: “status.critical”, “motion_token”: “pulse.red.urgent”}給 CI 流水線阻斷規(guī)則“如果在 observational 域用 critical阻斷合并”為什么這樣做設(shè)計(jì)師只寫(xiě)一次三種消費(fèi)方自動(dòng)拿到自己需要的東西。不用設(shè)計(jì)師給工程師寫(xiě)一遍、給運(yùn)維寫(xiě)一遍、給測(cè)試寫(xiě)一遍。3.4 同一個(gè)顏色不同編號(hào)代表不同意思機(jī)器看到 #EF4444紅色不知道這是系統(tǒng)故障還是刪除按鈕。必須看編號(hào)才知道。Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境里的對(duì)比編號(hào)都是紅色但意思完全不同場(chǎng)景status.critical紅色系統(tǒng)故障對(duì)話可能丟了錯(cuò)誤狀態(tài)action.destructive紅色刪除賬戶數(shù)據(jù)永久沒(méi)了操作按鈕為什么這樣做以前設(shè)計(jì)規(guī)范只規(guī)定紅色用在危險(xiǎn)場(chǎng)景但機(jī)器不知道危險(xiǎn)有 10 種。編號(hào)把哪種危險(xiǎn)說(shuō)清楚了。3.5 編號(hào)不能跨層亂用status.critical紅色脈沖只能在錯(cuò)誤狀態(tài)里用不能拿到提示信息里用。跨層使用會(huì)被機(jī)器自動(dòng)阻斷。Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境里的例子合法status.critical 用在消息流中斷系統(tǒng)故障非法status.critical 用在限流提示只是等一等不是故障機(jī)器攔截如果 AI 把限流提示做成紅色脈沖CI 直接阻斷代碼合不進(jìn)去為什么這樣做防止紅色濫用。以前所有錯(cuò)誤都用紅色用戶分不清多嚴(yán)重?，F(xiàn)在每個(gè)編號(hào)有指定的使用范圍超范圍就報(bào)錯(cuò)。4. 本文的核心命題把語(yǔ)義編碼成離散令牌必須翻譯成可驗(yàn)證的框架設(shè)計(jì)。本文回答三個(gè)命題命題驗(yàn)證標(biāo)準(zhǔn)語(yǔ)義可被離散編碼error_severity 的四級(jí)后果差異能被編碼為四個(gè)互斥枚舉值而非自然語(yǔ)言描述令牌綁定唯一視覺(jué)映射每個(gè)令牌如 retryable綁定且僅綁定一組視覺(jué)參數(shù)status.warning 時(shí)鐘圖標(biāo) 倒計(jì)時(shí)不可被自由替換令牌可被機(jī)器消費(fèi)同一組令牌能被編譯為 Prompt 前綴、JSON Schema、CI 規(guī)則三種格式在不同工具鏈中執(zhí)行同一語(yǔ)義判定一、調(diào)整前四個(gè)角色的真實(shí)反饋在沒(méi)有語(yǔ)義令牌之前各角色在界面層看到的世界用他們自己的話說(shuō)?前端與 AI 工程師的真實(shí)反饋“致命錯(cuò)誤和限流提示被渲染成了同一種紅色背景條?！盇I 生成工具里只有 Design Token——color.danger: { value: “#EF4444” }。紅色是一個(gè)色值不附帶任何場(chǎng)景含義。同一款 AI 對(duì)話產(chǎn)品中對(duì)話可能已丟失的致命錯(cuò)誤與請(qǐng)求太頻繁請(qǐng)等 30 秒的限流提示長(zhǎng)得一模一樣色板合規(guī)、對(duì)比度達(dá)標(biāo)視覺(jué)走查挑不出任何毛病但用戶從界面上讀不到兩者的區(qū)別。?設(shè)計(jì)師與產(chǎn)品經(jīng)理的真實(shí)反饋“同一個(gè) alert三個(gè)人三種理解每個(gè)人都沒(méi)錯(cuò)。”組件庫(kù)里的 Alert 只是視覺(jué)組件——圓角、圖標(biāo)位、關(guān)閉按鈕。它不知道自己在交易確認(rèn)場(chǎng)景里是阻斷性語(yǔ)義在信息展示場(chǎng)景里是旁觀性語(yǔ)義。前端理解為彈窗設(shè)計(jì)師指的是頂部通知條兩個(gè)人都對(duì)因?yàn)闆](méi)有任何注冊(cè)表裁定。?前端與 AI 工程師的另一條真實(shí)反饋“LLM 把 Critical 降級(jí)為’嚴(yán)重’代碼里查不出來(lái)?！痹?LLM 的詞匯表里“Critical和嚴(yán)重是近義詞。AI 生成告警時(shí)把 “Critical” 替換為嚴(yán)重”、把 “Data Loss Risk” 替換為請(qǐng)稍后重試——情緒權(quán)重在概率性輸出中被隨機(jī)降級(jí)而沒(méi)有任何機(jī)制判定這是違規(guī)。?DesignOps 與設(shè)計(jì)系統(tǒng)負(fù)責(zé)人的真實(shí)反饋“規(guī)范寫(xiě)在文檔平臺(tái)里人可能看漏AI 工具完全不可見(jiàn)?！卞e(cuò)誤狀態(tài)分四級(jí)供人閱讀機(jī)器查詢不了更校驗(yàn)不了。匯總成一張表工具 / 環(huán)節(jié)界面層呈現(xiàn)狀態(tài)缺失什么AI 生成工具只有色值與樣式語(yǔ)義靠概率猜這個(gè)紅代表什么的機(jī)器可讀定義組件庫(kù)組件只有視覺(jué)屬性組件在不同場(chǎng)景下的語(yǔ)義身份文案生成同義詞自由替換關(guān)鍵術(shù)語(yǔ)的權(quán)重錨定規(guī)范文檔供人閱讀機(jī)器可查詢、可校驗(yàn)的注冊(cè)表這四條反饋指向同一個(gè)根因語(yǔ)義沒(méi)有被編碼成機(jī)器可讀的東西。紅色只是色值組件只是容器術(shù)語(yǔ)只是字符串——機(jī)器拿不到語(yǔ)義就只能靠概率猜。二、把語(yǔ)義編碼為離散令牌不是自創(chuàng)概念2003年Eric Evans 在《Domain-Driven Design》中提出 Bounded Context限界上下文——同一個(gè)術(shù)語(yǔ)在不同業(yè)務(wù)邊界內(nèi)有不同含義域內(nèi)唯一定義互不污染。這與我的語(yǔ)義域設(shè)計(jì)是同一邏輯同一個(gè) Alert 在 transactional 域是阻斷確認(rèn)在 observational 域是旁觀通知條——域內(nèi)唯一定義域間含義不同。同期Evans 定義了 Anti-Corruption Layer防腐層——邊界之間做翻譯與隔離非法引用被拒絕。這與我的跨層禁止規(guī)則設(shè)計(jì)對(duì)應(yīng)status.critical 不可用于 observational 域非法綁定在編譯前置校驗(yàn)時(shí)直接阻斷。域邊界靠機(jī)器規(guī)則維護(hù)。工業(yè)界也在做。Microsoft Azure 將 ACL 作為官方架構(gòu)模式收錄W3C DTCG 已定義 Semantic Token 層。我的設(shè)計(jì)在其之上擴(kuò)展了行為約束與跨域規(guī)則。但行業(yè)也有反面的聲音。許多設(shè)計(jì)系統(tǒng)的語(yǔ)義令牌只是換名color-red-500 改叫 color-danger沒(méi)有場(chǎng)景定義組件分類模型在 AI 生成時(shí)代系統(tǒng)性失效 自帶語(yǔ)義導(dǎo)致升級(jí)時(shí)語(yǔ)義跟著重寫(xiě)。這恰恰反證了我為什么要設(shè)計(jì)覆蓋層模型——語(yǔ)義必須外賦于組件空容器由域邊界統(tǒng)一定義可被機(jī)器校驗(yàn)。參考鏈接●Eric Evans · DDD Reference 2015https://www.domainlanguage.com/wp-content/uploads/2016/05/DDD_Reference_2015-03.pdf●Microsoft Azure · Anti-Corruption Layer Patternhttps://learn.microsoft.com/en-us/azure/architecture/patterns/anti-corruption-layer●W3C DTCG · Design Tokens Format Module 2025.10https://www.designtokens.org/TR/2025.10/format/●W3C · Design Tokens Community Grouphttps://www.w3.org/community/design-tokens/三、關(guān)鍵設(shè)計(jì)語(yǔ)義令牌表3.1 四大命名空間碼本原子集語(yǔ)義令牌按回答的問(wèn)題分為四個(gè)命名空間每個(gè)令牌是離散索引編譯管線查表后展開(kāi)為連續(xù)約束status._ —— 這件事有多嚴(yán)重令牌含義視覺(jué)映射示例status.critical致命系統(tǒng)故障、數(shù)據(jù)丟失紅色脈沖 八邊形警告status.warning警告限流、降級(jí)、可恢復(fù)錯(cuò)誤黃色提示 時(shí)鐘圖標(biāo)status.info信息提示、說(shuō)明、部分可用藍(lán)色靜態(tài) 信息圖標(biāo)status.success成功保存完成、操作成功綠色靜態(tài) 對(duì)勾圖標(biāo)status.neutral中性加載中、等待中灰色動(dòng)畫(huà) 旋轉(zhuǎn)圖標(biāo)【Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境status._ 命名空間令牌卡片】對(duì)應(yīng) HTML 演示環(huán)境位置頁(yè)面中status._標(biāo)簽頁(yè)下的五個(gè)彩色令牌卡片critical 紅脈沖 / warning 黃時(shí)鐘 / info 藍(lán)信息 / success 綠對(duì)勾 / neutral 灰旋轉(zhuǎn)每張卡片展示令牌名、含義、視覺(jué)映射顏色動(dòng)畫(huà)圖標(biāo)按鈕樣式。phase._ —— AI 處于什么階段用戶在等什么令牌含義視覺(jué)映射示例phase.research檢索搜索信息、查找來(lái)源藍(lán)色 放大鏡圖標(biāo) 來(lái)源計(jì)數(shù)phase.analysis綜合對(duì)比多源、識(shí)別分歧黃色 大腦圖標(biāo) 共識(shí)度phase.check驗(yàn)證核對(duì)鏈接、驗(yàn)證事實(shí)綠色 盾牌圖標(biāo) 驗(yàn)證狀態(tài)phase.output生成生成答案、輸出結(jié)果紫色 文檔圖標(biāo) 引用索引boundary._ —— 系統(tǒng)拒絕用戶時(shí)權(quán)利邊界在哪里令牌含義視覺(jué)映射示例boundary.soft軟性拒絕拒絕請(qǐng)求但保留會(huì)話黃色提示條 保留輸入框boundary.hard強(qiáng)制終止終止會(huì)話清空上下文紅色退出面板 數(shù)據(jù)政策說(shuō)明boundary.review升級(jí)審核提交人工審核藍(lán)色提示 預(yù)計(jì)審核時(shí)間action._ —— 用戶點(diǎn)擊后后果是什么令牌含義視覺(jué)映射示例action.destructive破壞性刪除、清空、不可逆紅色空心 二次確認(rèn) 輸入驗(yàn)證action.constructive建設(shè)性保存、提交、創(chuàng)建藍(lán)色實(shí)心 成功反饋action.neutral中性取消、關(guān)閉、返回灰色描邊 無(wú)后果3.2 字典注冊(cè)的 6 個(gè)語(yǔ)義綁定v1.0.0語(yǔ)義字典v1.0.0 注冊(cè)的 6 個(gè)語(yǔ)義綁定構(gòu)成組織級(jí)語(yǔ)義碼本的最小可行原子集語(yǔ)義綁定含義核心約束注入跨層禁止示例status.critical阻斷性、可能不可恢復(fù)紅色脈沖、八邊形圖標(biāo)必須二次確認(rèn)文案必須說(shuō)明后果不可用于 observational 域限流提示禁用致命紅status.warning需注意、可恢復(fù)黃色靜態(tài)、三角圖標(biāo)必須顯示恢復(fù)時(shí)間必須提供操作步驟—status.info中性信息告知藍(lán)色靜態(tài)、信息圖標(biāo)可自動(dòng)消失禁止附加操作說(shuō)明—status.success操作成功確認(rèn)綠色靜態(tài)、對(duì)勾圖標(biāo)可自動(dòng)消失禁止附加操作說(shuō)明—action.destructive不可逆操作紅色空心描邊、危險(xiǎn)圖標(biāo)必須二次確認(rèn)必須說(shuō)明不可恢復(fù)禁止使用普通主按鈕樣式action.primary場(chǎng)景主行動(dòng)品牌色實(shí)心、箭頭圖標(biāo)點(diǎn)擊后跳轉(zhuǎn)顯示下一步預(yù)覽—3.3 令牌如何展開(kāi)為連續(xù)約束每個(gè)令牌在契約中展開(kāi)為一組連續(xù)約束。以 status.critical 應(yīng)用于致命錯(cuò)誤ERR-001 · fatal 級(jí)別為例一個(gè)離散索引status.critical→ 展開(kāi)為視覺(jué)方向紅色脈沖 八邊形圖標(biāo) 行為約束恢復(fù)路徑、二次確認(rèn) 文案約束必須說(shuō)明后果 機(jī)器防線跨層禁止block。這就是碼本解碼的完整形態(tài)。碼本解碼演示status.critical → 展開(kāi)為連續(xù)約束【演示環(huán)境碼本解碼演示區(qū)塊】頁(yè)面中碼本解碼演示區(qū)塊包含離散索引status.critical、視覺(jué)方向紅色脈沖 八邊形圖標(biāo)、行為約束必須二次確認(rèn) 恢復(fù)路徑、文案約束必須說(shuō)明后果、機(jī)器防線·跨層禁止observational/navigational/conversational 域下非法五欄展開(kāi)。同一令牌編譯為三種消費(fèi)格式【演示環(huán)境三種消費(fèi)格式并排】頁(yè)面中同一令牌編譯為三種消費(fèi)格式區(qū)塊三欄并排展示 Prompt 前綴 / JSON Schema / CI 規(guī)則。Prompt 前綴在生成致命錯(cuò)誤界面時(shí) - 必須使用紅色脈沖視覺(jué) - 必須包含八邊形警告圖標(biāo) - 必須提供恢復(fù)路徑按鈕 - 文案必須說(shuō)明后果嚴(yán)重性 - 禁止在 observational 域使用JSON Schema{color_token:status.critical,motion_token:pulse.red.urgent,icon_token:alert.octagon,required_actions:[refresh,export],forbidden_domains:[observational]}CI 規(guī)則rules:critical-token-usage:token:status.criticalforbidden_in:[observational]required_visual:pulse.red.urgentviolation:block3.4 對(duì)比演示同一個(gè)紅色在不同令牌下的不同含義【演示環(huán)境同一個(gè)紅色對(duì)比卡片】頁(yè)面中對(duì)比演示同一個(gè)紅色在不同令牌下的不同含義區(qū)塊左右兩張卡片對(duì)比展示 status.critical系統(tǒng)故障與 action.destructive刪除賬戶。status.criticalaction.destructive都是紅色系統(tǒng)故障對(duì)話上下文可能丟失不可逆操作數(shù)據(jù)將永久刪除覆蓋層transactionaltransactional行為必須二次確認(rèn) 恢復(fù)路徑必須二次確認(rèn) 輸入驗(yàn)證樣式紅色脈沖 八邊形紅色空心描邊非實(shí)心跨層observational 域非法—沒(méi)有令牌時(shí)機(jī)器只看到 #EF4444有令牌時(shí)機(jī)器知道這是 status.critical 還是 action.destructive?！狙菔经h(huán)境跨層禁止演示CI 阻斷日志】頁(yè)面中跨層禁止區(qū)塊展示 CI 阻斷日志“[CI 阻斷] error-severity-cross-layer / Token: status.critical / Used in: observational domain / Expected: status.warning / Action: BLOCK”。3.5 五條思路的依賴關(guān)系第1條把意思變成編號(hào)離散編碼 ↓ 第2條編號(hào)鎖死一套視覺(jué)一對(duì)一映射 ↓ 第4條不同編號(hào)可以同顏色但不同意思區(qū)分場(chǎng)景 ↓ 第5條編號(hào)不能跨層亂用使用范圍限制 ↓ 第3條編號(hào)自動(dòng)翻譯成三種格式一次定義多方消費(fèi)四、架構(gòu)層概念設(shè)計(jì)背景碼本而非術(shù)語(yǔ)表。術(shù)語(yǔ)表供人查閱碼本供機(jī)器解碼每個(gè)令牌是離散索引編譯管線查表后展開(kāi)為連續(xù)約束視覺(jué)方向 行為約束 文案語(yǔ)氣。這決定了令牌的讀者不只是設(shè)計(jì)師更是編譯管線與 AI 工具。令牌層與呈現(xiàn)層分離。color_token 是語(yǔ)義標(biāo)識(shí)color 是實(shí)際色值同一個(gè) status.critical 在不同設(shè)計(jì)系統(tǒng)里可映射到不同色值Tailwind #EF4444 / Ant Design #F5222D / DevUI #FF4D4F。語(yǔ)義令牌不關(guān)心具體色值只關(guān)心語(yǔ)義映射關(guān)系——設(shè)計(jì)系統(tǒng)更新時(shí)改映射表契約不變。語(yǔ)義覆蓋層Semantic Overlay。組件庫(kù)是底層Underlay只負(fù)責(zé)渲染——它提供圓角、色值、圖標(biāo)位這些空容器語(yǔ)義覆蓋層在組件之上加蓋業(yè)務(wù)語(yǔ)義把空容器翻譯為業(yè)務(wù)語(yǔ)義組件。令牌是覆蓋層加蓋語(yǔ)義時(shí)使用的印泥。術(shù)語(yǔ)雙軌。面向不同讀者群時(shí)三層結(jié)構(gòu)有兩套叫法語(yǔ)義域 ≈ 覆蓋層目錄語(yǔ)義令牌 ≈ 語(yǔ)義重綁定場(chǎng)景映射 ≈ 約束注入。兩套術(shù)語(yǔ)指向同一份注冊(cè)表。五、這些坑怎么被解掉場(chǎng)景與角色對(duì)照回到開(kāi)頭那些真實(shí)反饋看令牌就位后它們各自怎么閉環(huán)。踩過(guò)的坑 1“這個(gè)紅到底代表什么走查時(shí)誰(shuí)也說(shuō)不清”● 癥狀A(yù)I 生成限流提示時(shí)Before 形態(tài)下選 color-danger 無(wú)可指責(zé)——紅色本身沒(méi)錯(cuò)視覺(jué)走查也合規(guī)但用戶看到紅色以為賬戶出了問(wèn)題實(shí)際只是需要等 30 秒。合規(guī)但錯(cuò)誤。● 根因Token 只定義顏色沒(méi)定義場(chǎng)景語(yǔ)義機(jī)器拿不到限流 ≠ 致命這條信息?！?關(guān)聯(lián)機(jī)制①語(yǔ)義令牌與字典《Token 層差異》● 解法路徑有了令牌后限流語(yǔ)義級(jí)別是 retryable黃色時(shí)鐘 倒計(jì)時(shí)AI 若選 status.critical直接違反跨層規(guī)則CI 阻斷PR 無(wú)法合入。錯(cuò)誤在生成階段就無(wú)法成立?！?驗(yàn)證方式前端與 AI 工程師的驗(yàn)收爭(zhēng)議從感覺(jué)不對(duì)變成違反了哪條綁定——爭(zhēng)議可引用、可定位、可裁決。踩過(guò)的坑 2“LLM 把 Critical 降級(jí)為’嚴(yán)重’代碼里查不出來(lái)”● 癥狀A(yù)I 生成告警時(shí)把 “Critical” 替換為嚴(yán)重、把 “Data Loss Risk” 替換為請(qǐng)稍后重試——情緒權(quán)重被概率性輸出隨機(jī)降級(jí)Schema 校驗(yàn)通過(guò)語(yǔ)義卻是錯(cuò)的?！?根因文案層沒(méi)有術(shù)語(yǔ)錨定同義詞自由替換沒(méi)有任何機(jī)制判定違規(guī)?！?關(guān)聯(lián)機(jī)制①語(yǔ)義令牌與字典B3 字典 synonym_firewall 同義詞防火墻 6 個(gè)漂移模式證據(jù)庫(kù)ALR-001● 解法路徑Y(jié)AML 定義禁止詞并編譯進(jìn) Prompt 前綴synonym_firewall 約束下關(guān)鍵術(shù)語(yǔ)替換即違規(guī)生成階段被校驗(yàn)規(guī)則命中?！?驗(yàn)證方式設(shè)計(jì)師與產(chǎn)品經(jīng)理精心設(shè)計(jì)的語(yǔ)義權(quán)重不再被概率性輸出隨機(jī)抹平——“Critical” 在所有產(chǎn)出中保持錨定替換即被校驗(yàn)規(guī)則命中。六、調(diào)整后工具界面層的呈現(xiàn)狀態(tài)同一批工具在語(yǔ)義令牌就位之后工具 / 環(huán)節(jié)調(diào)整前調(diào)整后AI 生成工具只有色值限流與致命錯(cuò)誤同紅Prompt 前綴注入令牌約束后致命錯(cuò)誤 紅色脈沖 八邊形圖標(biāo) 恢復(fù)路徑限流提示 黃色時(shí)鐘 倒計(jì)時(shí).同模型同任務(wù)產(chǎn)出語(yǔ)義分級(jí)文案生成“Critical” 被隨機(jī)替換為嚴(yán)重synonym_firewall 錨定關(guān)鍵術(shù)語(yǔ)替換即被校驗(yàn)規(guī)則命中驗(yàn)收環(huán)節(jié)走查結(jié)論停留在感覺(jué)不對(duì)Checklist 逐項(xiàng)核對(duì)語(yǔ)義分級(jí) / 文案 / 紅線違反紅線即阻斷結(jié)論注明契約版本號(hào)【推演條件】從演示環(huán)境進(jìn)入生產(chǎn)環(huán)境語(yǔ)義令牌表需要以下組織條件誰(shuí)來(lái)維護(hù)令牌建議由語(yǔ)義翻譯設(shè)計(jì)師角色 4擔(dān)任令牌管理員負(fù)責(zé)定義和更新語(yǔ)義令牌DesignOps角色 3負(fù)責(zé)版本發(fā)布與廣播。令牌不是公共文檔而是組織的語(yǔ)義憲法修改權(quán)限必須集中。變更如何不擊穿下游令牌升級(jí)如新增 status.degraded 級(jí)別必須自動(dòng)同步到所有消費(fèi)面設(shè)計(jì)師的 Checklist、前端的 Prompt 前綴、CI 的攔截規(guī)則。組織需要建立字典變更 → 契約重編譯 → 消費(fèi)格式換版 → 角色通知的閉環(huán)避免上游改了下游還在用舊定義。誰(shuí)來(lái)證明有效每次令牌升級(jí)后需通過(guò)語(yǔ)義分級(jí)器抽檢一定數(shù)量的 AI 生成文案驗(yàn)證新規(guī)則確實(shí)攔截了目標(biāo)錯(cuò)誤。驗(yàn)證結(jié)果應(yīng)沉淀到模式卡片中作為該模式置信度持續(xù)遞增的證據(jù)。邊界聲明語(yǔ)義令牌表不解決視覺(jué)值的一致性那是 Design Token 層的職責(zé)不定義具體場(chǎng)景的約束實(shí)例那是YAML 契約的職責(zé)也約束不了有沒(méi)有人查它消費(fèi)紀(jì)律在角色側(cè)見(jiàn)角色專題 ①設(shè)計(jì)師與產(chǎn)品經(jīng)理。當(dāng)前量化收益均為數(shù)據(jù)模型推演待生產(chǎn)數(shù)據(jù)驗(yàn)證。一句話總結(jié)給不同角色給設(shè)計(jì)師“你以前寫(xiě)’錯(cuò)誤用紅色’前端可能理解錯(cuò)?，F(xiàn)在你寫(xiě) status.critical機(jī)器查表就知道必須是紅色脈沖 八邊形 二次確認(rèn)不會(huì)跑偏?！苯o前端“你不需要猜設(shè)計(jì)師的意思查 status.critical 的表就知道顏色、動(dòng)畫(huà)、圖標(biāo)、按鈕樣式全部鎖死。”給 AI 工具開(kāi)發(fā)者“你不需要自己判斷用什么顏色輸入場(chǎng)景編號(hào)查表輸出 Prompt 前綴AI 按規(guī)矩生成。”給 DesignOps“你改一次編號(hào)定義Prompt 前綴、JSON Schema、CI 規(guī)則三處自動(dòng)更新不用發(fā)三遍文檔?！? ① 語(yǔ)義令牌表：把語(yǔ)義概念編碼成離散枚舉
框架設(shè)計(jì)背景本文是 Schema-As-Code 證據(jù)鏈 的框架設(shè)計(jì)站屬于主題行的第一個(gè)關(guān)鍵設(shè)計(jì)——語(yǔ)義令牌表Semantic Token Table。在前序章節(jié)中階段一 Guard 結(jié)構(gòu)化診斷通過(guò)組件語(yǔ)義快照與三層判定模型發(fā)現(xiàn)了6 個(gè)漂移模式語(yǔ)義域建立了組件是空容器語(yǔ)義由場(chǎng)景定義的覆蓋層模型。但語(yǔ)義要能被機(jī)器識(shí)別、校驗(yàn)與生成必須先解決一個(gè)編碼問(wèn)題如何把語(yǔ)義概念變成機(jī)器可運(yùn)算的離散值本文要建立的正是 Schema-As-Code 的語(yǔ)義編碼層——當(dāng)語(yǔ)義規(guī)范體系需要被寫(xiě)入YAML 契約時(shí)語(yǔ)義必須以離散令牌的形式存在而非自然語(yǔ)言描述。1. 問(wèn)題語(yǔ)義是感覺(jué)還是可運(yùn)算的值行業(yè)現(xiàn)狀中語(yǔ)義以自然語(yǔ)言或視覺(jué)樣式存在設(shè)計(jì)師說(shuō)這個(gè)要用紅色前端看到 #EF4444AI 生成工具看到 color: red。但紅色在不同場(chǎng)景下含義完全不同——在語(yǔ)義域的 transactional 域它是阻斷確認(rèn)在 observational 域它可能是非法綁定跨層禁止。當(dāng)語(yǔ)義以顏色值、文案詞或感覺(jué)的形式流動(dòng)時(shí)機(jī)器無(wú)法區(qū)分同一個(gè)紅色在不同場(chǎng)景下是否合法。6 個(gè)漂移模式中的 ERR-001錯(cuò)誤狀態(tài)后果差異未分級(jí)根因正是如此致命錯(cuò)誤、網(wǎng)絡(luò)抖動(dòng)、限流、降級(jí)四種完全不同的后果共用同一種紅色——因?yàn)闄C(jī)器看到的只是 color: #EF4444而不是 error_severity.fatal 與 error_severity.retryable 的語(yǔ)義區(qū)別。沒(méi)有離散令牌就沒(méi)有機(jī)器可執(zhí)行的判定依據(jù)。2. 為什么自然語(yǔ)言守不住語(yǔ)義不可運(yùn)算設(shè)計(jì)規(guī)范文檔用自然語(yǔ)言描述語(yǔ)義“致命錯(cuò)誤用紅色脈沖限流用黃色時(shí)鐘”。但自然語(yǔ)言對(duì)機(jī)器是不可運(yùn)算的●AI 生成工具讀不懂致命錯(cuò)誤與限流的區(qū)別它的訓(xùn)練語(yǔ)料里只有 red 和 yellow●前端工程師看到的是 Design Token color-danger 和 color-warning但 danger 與 warning 的語(yǔ)義邊界沒(méi)有機(jī)器定義AI 可以把 color-danger 用在成功狀態(tài)●驗(yàn)收走查依賴人的主觀判斷感覺(jué)不對(duì)無(wú)法轉(zhuǎn)化為可復(fù)現(xiàn)的校驗(yàn)規(guī)則。組件語(yǔ)義快照的 6 字段記錄法已經(jīng)證明觀察界面時(shí)需要記錄 component_type、visual、copy、interaction、context 等維度。但這些字段的值如果是自由文本如 color: “red”仍然不可運(yùn)算。語(yǔ)義令牌表的作用就是把紅色編碼為 status.critical把限流編碼為 error_severity.retryable——讓語(yǔ)義成為機(jī)器可查詢、可校驗(yàn)、可攔截的離散值。3. 設(shè)計(jì)思路把語(yǔ)義概念編碼成離散枚舉本文的設(shè)計(jì)思路是三個(gè)遞進(jìn)命題●語(yǔ)義概念 → 離散令牌error_severity 不是文檔里的段落而是包含 fatal、transient、retryable、degraded 四個(gè)枚舉值的令牌表每個(gè)枚舉值綁定唯一的視覺(jué)映射status.critical → 紅色脈沖與行動(dòng)約束必須提供恢復(fù)路徑●令牌 → 字典注冊(cè)所有語(yǔ)義令牌在語(yǔ)義字典中注冊(cè)成為組織級(jí)唯一信源。契約YAML不定義令牌只引用令牌●令牌 → 可執(zhí)行規(guī)則編譯管線將令牌表編譯為 Prompt 前綴注入 AI 上下文、JSON Schema組件 Props 校驗(yàn)、CI 規(guī)則流水線攔截——同一組離散值在不同工具鏈中以不同格式執(zhí)行同一語(yǔ)義。這與語(yǔ)義規(guī)范體系的關(guān)系語(yǔ)義規(guī)范體系定義有哪些語(yǔ)義維度語(yǔ)義令牌表定義每個(gè)維度下有哪些離散值。沒(méi)有令牌表規(guī)范體系只是分類框架沒(méi)有規(guī)范體系令牌表只是孤立枚舉。3.1 把意思變成編號(hào)機(jī)器看不懂紅色代表很危險(xiǎn)機(jī)器看得懂 status.critical。把連續(xù)的自然語(yǔ)言描述變成離散的編號(hào)枚舉值。Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境里的例子不說(shuō)紅色、很緊急、要刷新 → 說(shuō) status.critical不說(shuō)黃色、等一等、能恢復(fù) → 說(shuō) status.warning不說(shuō)灰色、加載中、不用管 → 說(shuō) status.neutral為什么這樣做自然語(yǔ)言有同義詞“嚴(yán)重≈Critical≈危急”機(jī)器會(huì)搞混。編號(hào)沒(méi)有同義詞一個(gè)編號(hào)只對(duì)應(yīng)一個(gè)意思。3.2 一個(gè)編號(hào)只綁定一套視覺(jué)status.critical 只能是紅色脈沖 八邊形圖標(biāo)不能今天是紅色明天變成橙色。編號(hào)和視覺(jué)參數(shù)是鎖死的一對(duì)一映射。Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境里的例子編號(hào)顏色動(dòng)畫(huà)圖標(biāo)按鈕樣式status.critical紅色脈沖八邊形必須二次確認(rèn)status.warning黃色靜態(tài)三角顯示恢復(fù)時(shí)間status.info藍(lán)色靜態(tài)信息可自動(dòng)消失status.neutral灰色旋轉(zhuǎn)加載無(wú)為什么這樣做以前設(shè)計(jì)規(guī)范寫(xiě)錯(cuò)誤用紅色但不同前端可能用不同紅。編號(hào)鎖死后機(jī)器查表就知道唯一答案。3.3 同一個(gè)編號(hào)能翻譯成三種格式設(shè)計(jì)師寫(xiě)了一份 status.critical 的定義機(jī)器自動(dòng)把它變成三種東西給三種不同的人用。Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境里的三種格式給誰(shuí)用格式內(nèi)容給 AI 寫(xiě)界面的工程師Prompt 前綴“生成致命錯(cuò)誤時(shí)必須用紅色脈沖…”給校驗(yàn)代碼的機(jī)器JSON Schema{“color_token”: “status.critical”, “motion_token”: “pulse.red.urgent”}給 CI 流水線阻斷規(guī)則“如果在 observational 域用 critical阻斷合并”為什么這樣做設(shè)計(jì)師只寫(xiě)一次三種消費(fèi)方自動(dòng)拿到自己需要的東西。不用設(shè)計(jì)師給工程師寫(xiě)一遍、給運(yùn)維寫(xiě)一遍、給測(cè)試寫(xiě)一遍。3.4 同一個(gè)顏色不同編號(hào)代表不同意思機(jī)器看到 #EF4444紅色不知道這是系統(tǒng)故障還是刪除按鈕。必須看編號(hào)才知道。Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境里的對(duì)比編號(hào)都是紅色但意思完全不同場(chǎng)景status.critical紅色系統(tǒng)故障對(duì)話可能丟了錯(cuò)誤狀態(tài)action.destructive紅色刪除賬戶數(shù)據(jù)永久沒(méi)了操作按鈕為什么這樣做以前設(shè)計(jì)規(guī)范只規(guī)定紅色用在危險(xiǎn)場(chǎng)景但機(jī)器不知道危險(xiǎn)有 10 種。編號(hào)把哪種危險(xiǎn)說(shuō)清楚了。3.5 編號(hào)不能跨層亂用status.critical紅色脈沖只能在錯(cuò)誤狀態(tài)里用不能拿到提示信息里用。跨層使用會(huì)被機(jī)器自動(dòng)阻斷。Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境里的例子合法status.critical 用在消息流中斷系統(tǒng)故障非法status.critical 用在限流提示只是等一等不是故障機(jī)器攔截如果 AI 把限流提示做成紅色脈沖CI 直接阻斷代碼合不進(jìn)去為什么這樣做防止紅色濫用。以前所有錯(cuò)誤都用紅色用戶分不清多嚴(yán)重?，F(xiàn)在每個(gè)編號(hào)有指定的使用范圍超范圍就報(bào)錯(cuò)。4. 本文的核心命題把語(yǔ)義編碼成離散令牌必須翻譯成可驗(yàn)證的框架設(shè)計(jì)。本文回答三個(gè)命題命題驗(yàn)證標(biāo)準(zhǔn)語(yǔ)義可被離散編碼error_severity 的四級(jí)后果差異能被編碼為四個(gè)互斥枚舉值而非自然語(yǔ)言描述令牌綁定唯一視覺(jué)映射每個(gè)令牌如 retryable綁定且僅綁定一組視覺(jué)參數(shù)status.warning 時(shí)鐘圖標(biāo) 倒計(jì)時(shí)不可被自由替換令牌可被機(jī)器消費(fèi)同一組令牌能被編譯為 Prompt 前綴、JSON Schema、CI 規(guī)則三種格式在不同工具鏈中執(zhí)行同一語(yǔ)義判定一、調(diào)整前四個(gè)角色的真實(shí)反饋在沒(méi)有語(yǔ)義令牌之前各角色在界面層看到的世界用他們自己的話說(shuō)?前端與 AI 工程師的真實(shí)反饋“致命錯(cuò)誤和限流提示被渲染成了同一種紅色背景條?！盇I 生成工具里只有 Design Token——color.danger: { value: “#EF4444” }。紅色是一個(gè)色值不附帶任何場(chǎng)景含義。同一款 AI 對(duì)話產(chǎn)品中對(duì)話可能已丟失的致命錯(cuò)誤與請(qǐng)求太頻繁請(qǐng)等 30 秒的限流提示長(zhǎng)得一模一樣色板合規(guī)、對(duì)比度達(dá)標(biāo)視覺(jué)走查挑不出任何毛病但用戶從界面上讀不到兩者的區(qū)別。?設(shè)計(jì)師與產(chǎn)品經(jīng)理的真實(shí)反饋“同一個(gè) alert三個(gè)人三種理解每個(gè)人都沒(méi)錯(cuò)。”組件庫(kù)里的 Alert 只是視覺(jué)組件——圓角、圖標(biāo)位、關(guān)閉按鈕。它不知道自己在交易確認(rèn)場(chǎng)景里是阻斷性語(yǔ)義在信息展示場(chǎng)景里是旁觀性語(yǔ)義。前端理解為彈窗設(shè)計(jì)師指的是頂部通知條兩個(gè)人都對(duì)因?yàn)闆](méi)有任何注冊(cè)表裁定。?前端與 AI 工程師的另一條真實(shí)反饋“LLM 把 Critical 降級(jí)為’嚴(yán)重’代碼里查不出來(lái)?！痹?LLM 的詞匯表里“Critical和嚴(yán)重是近義詞。AI 生成告警時(shí)把 “Critical” 替換為嚴(yán)重”、把 “Data Loss Risk” 替換為請(qǐng)稍后重試——情緒權(quán)重在概率性輸出中被隨機(jī)降級(jí)而沒(méi)有任何機(jī)制判定這是違規(guī)。?DesignOps 與設(shè)計(jì)系統(tǒng)負(fù)責(zé)人的真實(shí)反饋“規(guī)范寫(xiě)在文檔平臺(tái)里人可能看漏AI 工具完全不可見(jiàn)?！卞e(cuò)誤狀態(tài)分四級(jí)供人閱讀機(jī)器查詢不了更校驗(yàn)不了。匯總成一張表工具 / 環(huán)節(jié)界面層呈現(xiàn)狀態(tài)缺失什么AI 生成工具只有色值與樣式語(yǔ)義靠概率猜這個(gè)紅代表什么的機(jī)器可讀定義組件庫(kù)組件只有視覺(jué)屬性組件在不同場(chǎng)景下的語(yǔ)義身份文案生成同義詞自由替換關(guān)鍵術(shù)語(yǔ)的權(quán)重錨定規(guī)范文檔供人閱讀機(jī)器可查詢、可校驗(yàn)的注冊(cè)表這四條反饋指向同一個(gè)根因語(yǔ)義沒(méi)有被編碼成機(jī)器可讀的東西。紅色只是色值組件只是容器術(shù)語(yǔ)只是字符串——機(jī)器拿不到語(yǔ)義就只能靠概率猜。二、把語(yǔ)義編碼為離散令牌不是自創(chuàng)概念2003年Eric Evans 在《Domain-Driven Design》中提出 Bounded Context限界上下文——同一個(gè)術(shù)語(yǔ)在不同業(yè)務(wù)邊界內(nèi)有不同含義域內(nèi)唯一定義互不污染。這與我的語(yǔ)義域設(shè)計(jì)是同一邏輯同一個(gè) Alert 在 transactional 域是阻斷確認(rèn)在 observational 域是旁觀通知條——域內(nèi)唯一定義域間含義不同。同期Evans 定義了 Anti-Corruption Layer防腐層——邊界之間做翻譯與隔離非法引用被拒絕。這與我的跨層禁止規(guī)則設(shè)計(jì)對(duì)應(yīng)status.critical 不可用于 observational 域非法綁定在編譯前置校驗(yàn)時(shí)直接阻斷。域邊界靠機(jī)器規(guī)則維護(hù)。工業(yè)界也在做。Microsoft Azure 將 ACL 作為官方架構(gòu)模式收錄W3C DTCG 已定義 Semantic Token 層。我的設(shè)計(jì)在其之上擴(kuò)展了行為約束與跨域規(guī)則。但行業(yè)也有反面的聲音。許多設(shè)計(jì)系統(tǒng)的語(yǔ)義令牌只是換名color-red-500 改叫 color-danger沒(méi)有場(chǎng)景定義組件分類模型在 AI 生成時(shí)代系統(tǒng)性失效 自帶語(yǔ)義導(dǎo)致升級(jí)時(shí)語(yǔ)義跟著重寫(xiě)。這恰恰反證了我為什么要設(shè)計(jì)覆蓋層模型——語(yǔ)義必須外賦于組件空容器由域邊界統(tǒng)一定義可被機(jī)器校驗(yàn)。參考鏈接●Eric Evans · DDD Reference 2015https://www.domainlanguage.com/wp-content/uploads/2016/05/DDD_Reference_2015-03.pdf●Microsoft Azure · Anti-Corruption Layer Patternhttps://learn.microsoft.com/en-us/azure/architecture/patterns/anti-corruption-layer●W3C DTCG · Design Tokens Format Module 2025.10https://www.designtokens.org/TR/2025.10/format/●W3C · Design Tokens Community Grouphttps://www.w3.org/community/design-tokens/三、關(guān)鍵設(shè)計(jì)語(yǔ)義令牌表3.1 四大命名空間碼本原子集語(yǔ)義令牌按回答的問(wèn)題分為四個(gè)命名空間每個(gè)令牌是離散索引編譯管線查表后展開(kāi)為連續(xù)約束status._ —— 這件事有多嚴(yán)重令牌含義視覺(jué)映射示例status.critical致命系統(tǒng)故障、數(shù)據(jù)丟失紅色脈沖 八邊形警告status.warning警告限流、降級(jí)、可恢復(fù)錯(cuò)誤黃色提示 時(shí)鐘圖標(biāo)status.info信息提示、說(shuō)明、部分可用藍(lán)色靜態(tài) 信息圖標(biāo)status.success成功保存完成、操作成功綠色靜態(tài) 對(duì)勾圖標(biāo)status.neutral中性加載中、等待中灰色動(dòng)畫(huà) 旋轉(zhuǎn)圖標(biāo)【Schema-As-Code 語(yǔ)義編碼層 · ① 語(yǔ)義令牌表演示環(huán)境status._ 命名空間令牌卡片】對(duì)應(yīng) HTML 演示環(huán)境位置頁(yè)面中status._標(biāo)簽頁(yè)下的五個(gè)彩色令牌卡片critical 紅脈沖 / warning 黃時(shí)鐘 / info 藍(lán)信息 / success 綠對(duì)勾 / neutral 灰旋轉(zhuǎn)每張卡片展示令牌名、含義、視覺(jué)映射顏色動(dòng)畫(huà)圖標(biāo)按鈕樣式。phase._ —— AI 處于什么階段用戶在等什么令牌含義視覺(jué)映射示例phase.research檢索搜索信息、查找來(lái)源藍(lán)色 放大鏡圖標(biāo) 來(lái)源計(jì)數(shù)phase.analysis綜合對(duì)比多源、識(shí)別分歧黃色 大腦圖標(biāo) 共識(shí)度phase.check驗(yàn)證核對(duì)鏈接、驗(yàn)證事實(shí)綠色 盾牌圖標(biāo) 驗(yàn)證狀態(tài)phase.output生成生成答案、輸出結(jié)果紫色 文檔圖標(biāo) 引用索引boundary._ —— 系統(tǒng)拒絕用戶時(shí)權(quán)利邊界在哪里令牌含義視覺(jué)映射示例boundary.soft軟性拒絕拒絕請(qǐng)求但保留會(huì)話黃色提示條 保留輸入框boundary.hard強(qiáng)制終止終止會(huì)話清空上下文紅色退出面板 數(shù)據(jù)政策說(shuō)明boundary.review升級(jí)審核提交人工審核藍(lán)色提示 預(yù)計(jì)審核時(shí)間action._ —— 用戶點(diǎn)擊后后果是什么令牌含義視覺(jué)映射示例action.destructive破壞性刪除、清空、不可逆紅色空心 二次確認(rèn) 輸入驗(yàn)證action.constructive建設(shè)性保存、提交、創(chuàng)建藍(lán)色實(shí)心 成功反饋action.neutral中性取消、關(guān)閉、返回灰色描邊 無(wú)后果3.2 字典注冊(cè)的 6 個(gè)語(yǔ)義綁定v1.0.0語(yǔ)義字典v1.0.0 注冊(cè)的 6 個(gè)語(yǔ)義綁定構(gòu)成組織級(jí)語(yǔ)義碼本的最小可行原子集語(yǔ)義綁定含義核心約束注入跨層禁止示例status.critical阻斷性、可能不可恢復(fù)紅色脈沖、八邊形圖標(biāo)必須二次確認(rèn)文案必須說(shuō)明后果不可用于 observational 域限流提示禁用致命紅status.warning需注意、可恢復(fù)黃色靜態(tài)、三角圖標(biāo)必須顯示恢復(fù)時(shí)間必須提供操作步驟—status.info中性信息告知藍(lán)色靜態(tài)、信息圖標(biāo)可自動(dòng)消失禁止附加操作說(shuō)明—status.success操作成功確認(rèn)綠色靜態(tài)、對(duì)勾圖標(biāo)可自動(dòng)消失禁止附加操作說(shuō)明—action.destructive不可逆操作紅色空心描邊、危險(xiǎn)圖標(biāo)必須二次確認(rèn)必須說(shuō)明不可恢復(fù)禁止使用普通主按鈕樣式action.primary場(chǎng)景主行動(dòng)品牌色實(shí)心、箭頭圖標(biāo)點(diǎn)擊后跳轉(zhuǎn)顯示下一步預(yù)覽—3.3 令牌如何展開(kāi)為連續(xù)約束每個(gè)令牌在契約中展開(kāi)為一組連續(xù)約束。以 status.critical 應(yīng)用于致命錯(cuò)誤ERR-001 · fatal 級(jí)別為例一個(gè)離散索引status.critical→ 展開(kāi)為視覺(jué)方向紅色脈沖 八邊形圖標(biāo) 行為約束恢復(fù)路徑、二次確認(rèn) 文案約束必須說(shuō)明后果 機(jī)器防線跨層禁止block。這就是碼本解碼的完整形態(tài)。碼本解碼演示status.critical → 展開(kāi)為連續(xù)約束【演示環(huán)境碼本解碼演示區(qū)塊】頁(yè)面中碼本解碼演示區(qū)塊包含離散索引status.critical、視覺(jué)方向紅色脈沖 八邊形圖標(biāo)、行為約束必須二次確認(rèn) 恢復(fù)路徑、文案約束必須說(shuō)明后果、機(jī)器防線·跨層禁止observational/navigational/conversational 域下非法五欄展開(kāi)。同一令牌編譯為三種消費(fèi)格式【演示環(huán)境三種消費(fèi)格式并排】頁(yè)面中同一令牌編譯為三種消費(fèi)格式區(qū)塊三欄并排展示 Prompt 前綴 / JSON Schema / CI 規(guī)則。Prompt 前綴在生成致命錯(cuò)誤界面時(shí) - 必須使用紅色脈沖視覺(jué) - 必須包含八邊形警告圖標(biāo) - 必須提供恢復(fù)路徑按鈕 - 文案必須說(shuō)明后果嚴(yán)重性 - 禁止在 observational 域使用JSON Schema{color_token:status.critical,motion_token:pulse.red.urgent,icon_token:alert.octagon,required_actions:[refresh,export],forbidden_domains:[observational]}CI 規(guī)則rules:critical-token-usage:token:status.criticalforbidden_in:[observational]required_visual:pulse.red.urgentviolation:block3.4 對(duì)比演示同一個(gè)紅色在不同令牌下的不同含義【演示環(huán)境同一個(gè)紅色對(duì)比卡片】頁(yè)面中對(duì)比演示同一個(gè)紅色在不同令牌下的不同含義區(qū)塊左右兩張卡片對(duì)比展示 status.critical系統(tǒng)故障與 action.destructive刪除賬戶。status.criticalaction.destructive都是紅色系統(tǒng)故障對(duì)話上下文可能丟失不可逆操作數(shù)據(jù)將永久刪除覆蓋層transactionaltransactional行為必須二次確認(rèn) 恢復(fù)路徑必須二次確認(rèn) 輸入驗(yàn)證樣式紅色脈沖 八邊形紅色空心描邊非實(shí)心跨層observational 域非法—沒(méi)有令牌時(shí)機(jī)器只看到 #EF4444有令牌時(shí)機(jī)器知道這是 status.critical 還是 action.destructive?！狙菔经h(huán)境跨層禁止演示CI 阻斷日志】頁(yè)面中跨層禁止區(qū)塊展示 CI 阻斷日志“[CI 阻斷] error-severity-cross-layer / Token: status.critical / Used in: observational domain / Expected: status.warning / Action: BLOCK”。3.5 五條思路的依賴關(guān)系第1條把意思變成編號(hào)離散編碼 ↓ 第2條編號(hào)鎖死一套視覺(jué)一對(duì)一映射 ↓ 第4條不同編號(hào)可以同顏色但不同意思區(qū)分場(chǎng)景 ↓ 第5條編號(hào)不能跨層亂用使用范圍限制 ↓ 第3條編號(hào)自動(dòng)翻譯成三種格式一次定義多方消費(fèi)四、架構(gòu)層概念設(shè)計(jì)背景碼本而非術(shù)語(yǔ)表。術(shù)語(yǔ)表供人查閱碼本供機(jī)器解碼每個(gè)令牌是離散索引編譯管線查表后展開(kāi)為連續(xù)約束視覺(jué)方向 行為約束 文案語(yǔ)氣。這決定了令牌的讀者不只是設(shè)計(jì)師更是編譯管線與 AI 工具。令牌層與呈現(xiàn)層分離。color_token 是語(yǔ)義標(biāo)識(shí)color 是實(shí)際色值同一個(gè) status.critical 在不同設(shè)計(jì)系統(tǒng)里可映射到不同色值Tailwind #EF4444 / Ant Design #F5222D / DevUI #FF4D4F。語(yǔ)義令牌不關(guān)心具體色值只關(guān)心語(yǔ)義映射關(guān)系——設(shè)計(jì)系統(tǒng)更新時(shí)改映射表契約不變。語(yǔ)義覆蓋層Semantic Overlay。組件庫(kù)是底層Underlay只負(fù)責(zé)渲染——它提供圓角、色值、圖標(biāo)位這些空容器語(yǔ)義覆蓋層在組件之上加蓋業(yè)務(wù)語(yǔ)義把空容器翻譯為業(yè)務(wù)語(yǔ)義組件。令牌是覆蓋層加蓋語(yǔ)義時(shí)使用的印泥。術(shù)語(yǔ)雙軌。面向不同讀者群時(shí)三層結(jié)構(gòu)有兩套叫法語(yǔ)義域 ≈ 覆蓋層目錄語(yǔ)義令牌 ≈ 語(yǔ)義重綁定場(chǎng)景映射 ≈ 約束注入。兩套術(shù)語(yǔ)指向同一份注冊(cè)表。五、這些坑怎么被解掉場(chǎng)景與角色對(duì)照回到開(kāi)頭那些真實(shí)反饋看令牌就位后它們各自怎么閉環(huán)。踩過(guò)的坑 1“這個(gè)紅到底代表什么走查時(shí)誰(shuí)也說(shuō)不清”● 癥狀A(yù)I 生成限流提示時(shí)Before 形態(tài)下選 color-danger 無(wú)可指責(zé)——紅色本身沒(méi)錯(cuò)視覺(jué)走查也合規(guī)但用戶看到紅色以為賬戶出了問(wèn)題實(shí)際只是需要等 30 秒。合規(guī)但錯(cuò)誤。● 根因Token 只定義顏色沒(méi)定義場(chǎng)景語(yǔ)義機(jī)器拿不到限流 ≠ 致命這條信息?！?關(guān)聯(lián)機(jī)制①語(yǔ)義令牌與字典《Token 層差異》● 解法路徑有了令牌后限流語(yǔ)義級(jí)別是 retryable黃色時(shí)鐘 倒計(jì)時(shí)AI 若選 status.critical直接違反跨層規(guī)則CI 阻斷PR 無(wú)法合入。錯(cuò)誤在生成階段就無(wú)法成立?！?驗(yàn)證方式前端與 AI 工程師的驗(yàn)收爭(zhēng)議從感覺(jué)不對(duì)變成違反了哪條綁定——爭(zhēng)議可引用、可定位、可裁決。踩過(guò)的坑 2“LLM 把 Critical 降級(jí)為’嚴(yán)重’代碼里查不出來(lái)”● 癥狀A(yù)I 生成告警時(shí)把 “Critical” 替換為嚴(yán)重、把 “Data Loss Risk” 替換為請(qǐng)稍后重試——情緒權(quán)重被概率性輸出隨機(jī)降級(jí)Schema 校驗(yàn)通過(guò)語(yǔ)義卻是錯(cuò)的?！?根因文案層沒(méi)有術(shù)語(yǔ)錨定同義詞自由替換沒(méi)有任何機(jī)制判定違規(guī)?！?關(guān)聯(lián)機(jī)制①語(yǔ)義令牌與字典B3 字典 synonym_firewall 同義詞防火墻 6 個(gè)漂移模式證據(jù)庫(kù)ALR-001● 解法路徑Y(jié)AML 定義禁止詞并編譯進(jìn) Prompt 前綴synonym_firewall 約束下關(guān)鍵術(shù)語(yǔ)替換即違規(guī)生成階段被校驗(yàn)規(guī)則命中?！?驗(yàn)證方式設(shè)計(jì)師與產(chǎn)品經(jīng)理精心設(shè)計(jì)的語(yǔ)義權(quán)重不再被概率性輸出隨機(jī)抹平——“Critical” 在所有產(chǎn)出中保持錨定替換即被校驗(yàn)規(guī)則命中。六、調(diào)整后工具界面層的呈現(xiàn)狀態(tài)同一批工具在語(yǔ)義令牌就位之后工具 / 環(huán)節(jié)調(diào)整前調(diào)整后AI 生成工具只有色值限流與致命錯(cuò)誤同紅Prompt 前綴注入令牌約束后致命錯(cuò)誤 紅色脈沖 八邊形圖標(biāo) 恢復(fù)路徑限流提示 黃色時(shí)鐘 倒計(jì)時(shí).同模型同任務(wù)產(chǎn)出語(yǔ)義分級(jí)文案生成“Critical” 被隨機(jī)替換為嚴(yán)重synonym_firewall 錨定關(guān)鍵術(shù)語(yǔ)替換即被校驗(yàn)規(guī)則命中驗(yàn)收環(huán)節(jié)走查結(jié)論停留在感覺(jué)不對(duì)Checklist 逐項(xiàng)核對(duì)語(yǔ)義分級(jí) / 文案 / 紅線違反紅線即阻斷結(jié)論注明契約版本號(hào)【推演條件】從演示環(huán)境進(jìn)入生產(chǎn)環(huán)境語(yǔ)義令牌表需要以下組織條件誰(shuí)來(lái)維護(hù)令牌建議由語(yǔ)義翻譯設(shè)計(jì)師角色 4擔(dān)任令牌管理員負(fù)責(zé)定義和更新語(yǔ)義令牌DesignOps角色 3負(fù)責(zé)版本發(fā)布與廣播。令牌不是公共文檔而是組織的語(yǔ)義憲法修改權(quán)限必須集中。變更如何不擊穿下游令牌升級(jí)如新增 status.degraded 級(jí)別必須自動(dòng)同步到所有消費(fèi)面設(shè)計(jì)師的 Checklist、前端的 Prompt 前綴、CI 的攔截規(guī)則。組織需要建立字典變更 → 契約重編譯 → 消費(fèi)格式換版 → 角色通知的閉環(huán)避免上游改了下游還在用舊定義。誰(shuí)來(lái)證明有效每次令牌升級(jí)后需通過(guò)語(yǔ)義分級(jí)器抽檢一定數(shù)量的 AI 生成文案驗(yàn)證新規(guī)則確實(shí)攔截了目標(biāo)錯(cuò)誤。驗(yàn)證結(jié)果應(yīng)沉淀到模式卡片中作為該模式置信度持續(xù)遞增的證據(jù)。邊界聲明語(yǔ)義令牌表不解決視覺(jué)值的一致性那是 Design Token 層的職責(zé)不定義具體場(chǎng)景的約束實(shí)例那是YAML 契約的職責(zé)也約束不了有沒(méi)有人查它消費(fèi)紀(jì)律在角色側(cè)見(jiàn)角色專題 ①設(shè)計(jì)師與產(chǎn)品經(jīng)理。當(dāng)前量化收益均為數(shù)據(jù)模型推演待生產(chǎn)數(shù)據(jù)驗(yàn)證。一句話總結(jié)給不同角色給設(shè)計(jì)師“你以前寫(xiě)’錯(cuò)誤用紅色’前端可能理解錯(cuò)?，F(xiàn)在你寫(xiě) status.critical機(jī)器查表就知道必須是紅色脈沖 八邊形 二次確認(rèn)不會(huì)跑偏?！苯o前端“你不需要猜設(shè)計(jì)師的意思查 status.critical 的表就知道顏色、動(dòng)畫(huà)、圖標(biāo)、按鈕樣式全部鎖死。”給 AI 工具開(kāi)發(fā)者“你不需要自己判斷用什么顏色輸入場(chǎng)景編號(hào)查表輸出 Prompt 前綴AI 按規(guī)矩生成。”給 DesignOps“你改一次編號(hào)定義Prompt 前綴、JSON Schema、CI 規(guī)則三處自動(dòng)更新不用發(fā)三遍文檔?！?