先認識完整表面
每個目前 V3 Theme 都必須給 13 個名稱完整提供 light 與 dark 值。未知名稱、缺失模式、CSS var 引用、URL、import、宣告語句或結構性 CSS 語法都會被髮布契約拒絕。
| Token | 作用 | 檢查項 |
|---|---|---|
| --dsw-alias-bg-base | 主畫布 | primary 與 secondary 文字均可讀 |
| --dsw-alias-bg-layer-1 | 第一層抬升表面 | 能與 base 分開，又不過度突出 |
| --dsw-alias-bg-layer-2 | 第二層抬升表面 | 巢狀層級仍然清楚 |
| --dsw-alias-bg-overlay | 覆蓋層表面 | 文字在實際疊加背景上仍可讀 |
| --dsw-alias-border-l1 | 主要分隔線 | 能被看見但不搶奪內容注意力 |
| --dsw-alias-border-l2 | 次級分隔線 | 保留更弱的層級關係 |
| --dsw-alias-brand-primary | 品牌與主要強調 | 與鄰近文字和表面顏色協調 |
| --dsw-alias-label-primary | 主要文字 | 滿足必需的前景對比度 |
| --dsw-alias-label-secondary | 次要文字 | 保持可讀，又不與主要文字同權重 |
| --dsw-alias-state-error-primary | 錯誤狀態 | 與 warning 和背景角色可區分 |
| --dsw-alias-state-success-primary | 成功狀態 | 與 brand 和背景角色可區分 |
| --dsw-alias-state-warn-primary | 警告狀態 | 與 error、success 角色可區分 |
| --dsw-specific-sidebar-fill | 側欄填充 | 在兩種模式中都與主畫布協調 |
執行可重複的檢查
- 01
選擇已驗證 Theme
工作台只接收包資訊與相容資訊能匹配倉庫內已驗證 sidecar 的樣本。
- 02
明確選擇 light 或 dark
檢查色塊、預覽與宣告值時，始終讓目前模式保持明確。
- 03
走完 13 個角色
先結合上下文理解目前值，再與另一模式中的配對值比較。
- 04
只複製可以追溯的值
複製結果只是參考資料；評審記錄應同時保留 token 名、模式、來源版本與 sidecar hash。
繼續使用這些值
常見問題
修改前需要了解的事項
關於格式、相容性、證據與回滾的簡明說明。
這篇指南核實哪些範圍？
本指南涵蓋：精確 RC.8 13-token 目錄；已驗證 sidecar 樣本；light 與 dark 宣告覆制
我應該先做什麼？
Token Lab 展示目前已驗證 Theme 使用的精確固定語義表面。它用於解釋差異，不代表瀏覽網頁已經修改你的本機 DSH。
最需要記住的邊界是什麼？
它不會編輯 DSH profile、釋出包，也不能證明未驗證社群上傳是安全的。執行時狀態屬於已安裝製品與真實 DSH 會話。
繼續學習
檢視驗證證據並繼續操作
對比已釋出製品，或返回安裝文件。