状态:已确认的七角色×固定 step、三文字角色各九档与六条原则保持不变。D01 色值、D02 系统字体/四端尺度、D05 几何/可访问设计目标与 D07 动效由代理依用户授权采用为初始设计基线(理由与撤回条件见 决策与讨论记录「代理初始设计基线D01—D08」);FND-RESTRAINT 是据用户选择的 Geist 方向由 YUDS 推导的审查工作稿,可修订。非颜色资源交换格式、平台 API 与实际支持版本仍未确定;全部真实运行未执行,设计资产、对比实测、辅助技术和端到端验证均未执行。 更新:2026-10-18(UTC+8);FND-RESTRAINT 的来源与取舍记于 2026-10-19。
本章适用于 YUDS 规范与设计资源;平台、框架及实现项目尚未锁定。
1. 本章解决什么
基础规则使用户在不同产品中能够识别同一种信息、状态和操作。它首先回答“这个颜色、字号、间距或图标表达什么”,再回答“具体画成什么样”。同一业务对象可以在桌面表格与窄屏摘要中采用不同布局,但“未提交”“已过期”“无查看权限”等含义不能随布局改变。
本章承担视觉与内容表达的共同规则,不替代组件行为、产品业务词典或计算公式。一个红色 Token 不能决定合同是否违约;一个只读样式不能建立访问权限;一个动效结束也不能证明提交成功。
规则如何落到资源
- 先说明用户任务与语义,例如“让审核者找到当前键盘焦点”。
- 定义角色、状态和组合,例如“焦点仍需在选中行及错误字段上可见”。
- 消费 D01/D02/D05/D07 已采用的初始值;新增候选另记主题、字体、密度和平台条件。
- 将稳定决定映射为 Token、设计样式与组件引用。
- 在真实内容和状态中验证,而非只审查色板或默认态截图。
其中第 3 至 5 步未完成时,资源必须标注相应证据缺口。规范已写、设计已画、代码已实现、任务已验证是四种不同状态。
2. 基础角色地图
| 主题 | 需要统一的含义 | 可以按条件变化的部分 | 专题 |
|---|---|---|---|
| Token | 公共颜色的七角色+固定职责色阶;物理色板仅作中心配置 | 平台调用语法、输出格式;非颜色资源结构与单位另行确定 | Token 契约、主题与状态 |
| 色彩 | 正文、操作、状态、选择、焦点与图表编码 | 品牌映射、明暗值、对比偏好 | 色彩语义与可辨状态 |
| 排版与内容 | label/prose/heading 各九档;业务用途映射与数据可读性 | 字体、平台字号/行高、语言与可用空间,均需记录确认与验证状态 | 排版层级与文字可读性 |
| 布局与密度 | 分组、阅读顺序、操作区域和上下文 | 列数、面板安排、空白与行距 | 布局、响应式与信息密度 |
| 图标与动效 | 操作含义、状态变化和层级关系 | 视觉风格、平台资源与过渡形式 | 图标、层级与动态反馈 |
| 界面文案与语言 | 术语、标签、操作动词、反馈及内容边界 | 语言表达、复数、方向与长度 | 界面文案、术语与多语言 |
数字、币种、时间、空值及来源属于数据表达契约,见 数据表达与分析。表格在这些规则上建立列、焦点和选择行为,见 数据表与交互网格契约。
3. 状态需要分维度表达
设计资源至少分清以下维度:
- 交互:默认、悬浮、按下、键盘焦点。
- 选择:未选、已选、混合选择;“当前页”与“已选择”不是同一概念。
- 可用性:可编辑、只读、禁用;不存在权限时是否隐藏由产品安全边界决定。
- 校验与反馈:有效、错误、警告、已完成;成功反馈不等于所有业务条件都满足。
- 数据:加载、可用、缺失、部分、旧数据、失败及受限;具体语义见数据章节。
这些维度可能并存。正在编辑且有错误的字段仍可获得焦点;选中的记录仍可能过期;旧数据在后台刷新期间仍可能可阅读。资源应表达合法组合,不能用最后出现的背景色抹去其他含义。非法组合由组件契约约束,不能依靠视觉层猜测。
4. 内容也是基础资源
共同术语应记录:用户可见名称、精确定义、适用范围、易混淆词、状态词、操作动词及产品例外。例如“保存草稿”仅表示草稿已持久化,“提交审核”表示进入审核流程;两者不得统一成“保存成功”。同一产品中的“撤回”“撤销”“取消”分别说明作用对象及后果。
标签应描述对象或动作,避免把内部模块名、接口名称、英文缩写直接当作用户概念。低频专业术语可以保留,但在首次需要理解的位置提供说明。高风险操作应同时说明对象和范围,例如“作废合同”优于“确定”;必要的范围、后果和不可逆提示放在操作前,而非藏在帮助页。
反馈采用“事实 + 影响 + 可行下一步”的结构。已知失败原因写具体原因;未知时写已知事实,不编造解释。“连接中断,尚未确认提交结果。请查看任务状态”优于“提交失败,请重试”。不让文案承诺技术上不存在的自动保存、撤销或恢复能力。
5. 主题、密度与语言的边界
主题改变视觉映射,密度调整空间使用,响应式改变组织方式,语言改变内容和排版方向。四者应能分别评审,不定义“深色紧凑英文桌面版”这种混合概念作为唯一资源单位。
品牌替换不能改写成功、风险和错误的含义。紧凑模式不能降低操作后果提示、数字单位或读屏信息。窄屏不能自动意味着只读;触控设备也可能带键盘。语言适配必须考虑较长文本、双向文字、数字与日期,而非仅替换字符串。
6. 企业场景正反例
合适:审核合同付款计划
页面标题与对象身份清楚;金额右对齐;统一表头注明币种;异常行同时有“付款日期早于合同生效日”文本;焦点框与错误提示均保留;窄屏提供逐项核查,但不删除金额、期间和风险说明。
不合适:以“统一”为由固定整页像素布局
小窗口将风险说明截断、表格文字缩小、选中行与错误行都改成同一种红色。虽然色号和行高一致,用户失去了必要信息与操作能力。
合适:客户主题使用不同品牌色
主操作引用同一语义角色,状态文案、风险提示、焦点与对比要求不变,并分别验证实际前景背景组合。
不合适:将所有状态都映射成客户主色
用户无法区分“处理中”“已完成”“部分失败”,视觉一致性反而破坏业务含义。
7. 基础验收与交付
每个基础资源交付以下内容:用途与禁用场景、采用值/新候选及其决定状态、支持维度、组件引用、组合限制、来源与许可、测试样例、测试结果及负责人。自动检查只能证明可机器验证的部分;可读性、术语理解和任务完成仍须人工验证。
最低样例应覆盖:长对象名、中英混排、负数与大金额、缺失和受限数据、深浅背景、选中且聚焦、错误且聚焦、窄窗口、放大文字、减少动态效果。D05 已将 RTL 纳入四端设计目标,必须加入逻辑方向与混合文字样例;实际语言、字体和平台验证均未执行,不以设计目标宣称支持。
验收结果统一使用“通过/失败/未执行/不适用”,并记录环境和日期。本章记录已确认语义及 D 系列代理采用设计;设计资产、对比实测、辅助技术和端到端验证均未执行。
7.1 可执行基础规则的阅读与验收入口
以下编号是文档规则 ID,用于评审与证据定位,不是代码 API。规则正文只保存当前契约;迭代评审的评分、来源读取与失败发现另存于索引附件。引用外部平台规则不改变 定位、使用者与职责边界 的业务模型边界,也不把平台文档称为 YUDS 已实现能力。
| 任务中的问题 | 主档与规则 | 合格的文档证据 |
|---|---|---|
| 这对颜色能否用于选中、错误或主操作 | Token 契约、主题与状态 FND-C01;色彩语义与可辨状态 FND-C02~C04 | 允许表、使用位置、主题配对与拒绝反例 |
| 长合同名、大数字、放大后如何阅读 | 排版层级与文字可读性 FND-T01~T03 | 角色档位、D02 初始平台映射、完整值和失败恢复 |
| 紧凑布局能否点击、输入、离开 | 布局、响应式与信息密度 FND-L01~L03 | 命中区单位、输入替代、软键盘与窗口重排夹具 |
| 动画被关闭或中断后结果是否正确 | 图标、层级与动态反馈 FND-M01~M03 | 每类替代、任务状态与结束条件 |
| 更换语言是否改掉业务事实 | 界面文案、术语与多语言 FND-I01~I02 | 完整消息、方向隔离、输入法和格式边界 |
文档走查可检查“给定输入—动作—预期”是否明确且互不冲突;实际样式、命中区域、读屏播报和系统偏好响应必须在固定构建中测试。任何规范分数都不能替代后者。
8. 仍需决策
- D06 合成中性任务及 D05 四端/RTL 设计目标已确定;真实产品任务、角色、翻译和实际支持版本另缺证。
- 品牌与多租户主题是否纳入首期,允许客户更改哪些角色。
- D01/D02/D05/D07 已采用初始色板、系统字体、尺度、密度/几何与动效;仍需真实字体回退、渲染、对比、输入和偏好验证,以及未来品牌替换许可。
- Token 主档、审批人及与设计工具、实现项目的同步方式。
外部无障碍条款在专题中分别列出。D05 采用 WCAG 2.2 AA 设计验收目标不等于宣称产品已经符合 WCAG;完整符合性需按页面、流程和所选级别评估,见 WCAG 2.2 符合性要求。
FND-RESTRAINT:克制视觉的组件审查契约
本节把用户选择的 Geist 简洁克制方向转成可检查工作稿,不新增颜色别名、字体角色或已批准尺寸。视觉简化以信息和操作保真为前提:保留名称、当前值、必要单位、选中/焦点/错误、时间与范围、恢复入口;先减少重复装饰,再考虑布局密度。不能把低对比、仅悬浮出现、无文本状态或隐藏主要动作当成简洁。
- 层级先用内容分组、顺序、留白与既有三文字角色表达;增加表面、描边、阴影都要能指出承担的分组或浮层职责。不要给每个字段、每段说明再套一张卡片。同一视觉分界避免父子重复叠边造成更重交点。
- 中性界面承载常规结构,强调色只承担已声明动作或状态;同一任务的主操作仍遵循独立任务边界。状态标记与焦点可以同时辨认,不能为统一单色抹掉必要差别,也不以一屏彩色标签制造等强竞争。
- 同一元素只选一套材质职责;阴影和边框跟实际层叠关系一致。优先能清楚区分层次的较低强调,不把重阴影当作交互性。浅/深主题分别检查边界;forced-colors 或减少透明度时以边界、名称和结构保持区分,不要求透明效果本身保留。
- 密度调整优先缩短重复间距、合并冗余信息,保留可读文字和独立命中区;不以缩小字号替代结构设计。纯图标只用于含义稳定且有可访问名称的动作;新用户必须理解的关键动作保留文字。
- 样例同时给默认、焦点+选择、错误+焦点、长中文、空/失败、窄窗和高对比状态。不能只展示一张默认态截图就说视觉已吸收 Geist 或达到同等质量。
审查夹具 FND-RESTRAINT-F1
- 设置:同一中性集合含标题、两字段、主动作、次动作及一条失败说明;分别绘制浅/深主题与窄窗,列出每条边框/表面/强调色的职责。
- 检查:移除纯重复装饰后,逐项检查信息、动作、焦点、错误和命中区域均未减少。
- 失败条件:任何必要内容只能靠悬浮或低对比辨认即失败。
- 状态:该夹具是后续设计/实现验收步骤,当前没有渲染图、对比度测量或视觉通过结果。
来源与取舍
2026-10-19 已读 Geist Colors 的颜色职责及重复边界提示、Geist Materials 的层级职责与低噪声建议;只借方法,不引入其原色阶数字、材质类名或品牌值。上述通用审查条款是 YUDS 推导,可修订。Stripe Apps 公开模式说明组件可组合为加载/反馈等模式,但不能据此认定已读取 Stripe Sail 完整规范;跨系统目录及证据边界见索引附件。