跳转至

设计规范

设计规范记录由人负责的视觉和交互意图:层级、 结构、状态表示、允许的变化以及代表性示例。 它们可以描述一个组件或跨组件的模式。

状态分类

状态记录按变更的驱动者进行划分。以下是仅有的三个状态分类记录:

记录 拥有
用户状态 由人驱动的静止、悬停、按压、聚焦、选择及操作状态
系统状态 由系统驱动的禁用、加载、处理、状态及瞬时反馈状态
智能体状态 由智能体驱动的思考、流式传输、工具执行、等待、同步、检查和渲染状态

其他记录

记录 拥有
空间层级 通过邻近性、间距层级和对齐实现感知分组
控件节奏 混合控件之间的对齐和密度关系
形状关系 嵌套表面的基于角色和同心几何
高程层级 感知深度与实际图层顺序之间的一致性
字体排版层级 跨主题和布局的可读、可区分的文本角色
图标设计 图标的含义、大小、图形、颜色、构图和无障碍性
颜色强调 语义颜色角色、对比意图和局部强调
动效 有意义的运动、时间层级和缓动意图
减少动效 在减少动效下,触摸时交叉淡入淡出,否则立即变化
有序集合重排 有序集合的拖拽预览、候选插入、提交和落位意图
模板组合 页面和块级布局、层级、间距、组件保真度和主题

当一个主题具有不同的所有者、审批生命周期、需求集、证据集或独立变更的理由时,请单独创建一条记录。将实现机制、公共 API 语法、审计结果和消费者用法保留在这些记录之外,并改为链接到其权威所有者。

设计规范不拥有实现机制、公共 prop 语法、当前审计结果或消费者使用指南。组件和家族契约链接到稳定的设计需求 ID,而不是复制其理由。

可公开的安全规范截图、图表和视觉状态引用位于 docs/design/assets/<design-id>/ 下。每个被引用的资源都记录其替代文本、状态、主题/模式、相关的视口以及它所展示的决策。生成的审计截图仍然是审计证据,而非设计权威。私有设计来源保持私有,绝不在此处命名或链接。

新设计规范以 draft 状态开始。首次提升为 current、后续更改以及规范资源更新,都需要获得 .github/ENGOWNERS 或 .github/DESIGNOWNERS 中任何现任成员对其内容的批准(architecture:knowledge-contracts DEC-14)。混合 PR 仍然需要一位 ENGOWNER 负责非设计的 current 记录。设计记录会在此仓库门禁之外单独注明其内容所有者。

DESIGNOWNER 通过审核或 /approve-spec <sha> 来批准,如同其他所有所有者一样;在混合 PR 中,所有其他适用的代码或规范所有者组仍然是必需的。该门禁仅决定批准;它从不启用自动合并。

使用 docs/templates/knowledge/design-spec.md。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx