UI 视觉设计 / 系统课时
贯通设计变更到上线的审批流程
贯通设计变更到上线的审批流程
一次按钮配色修改可能已通过设计评审,却在令牌包、组件包和业务应用中形成三个不同版本。本篇用一条可追踪的变更单贯通评审、PR、测试、发布和升级,并预留失败时的回滚入口,让每个放行决定都有依据。
学习目标
- 为设计变更建立唯一编号、责任人和验收证据。
- 配置设计评审、PR 检查与应用上线的分级关卡。
- 按版本映射升级业务项目,并在故障时恢复已验证版本。
用一张变更单锁定范围
假设需求 DS-142 将按钮的 color.action.primary 从 #2563EB 改为 #1D4ED8。不要只发一张改色截图;在任务卡及关联 PR 中填写以下字段,让设计和工程讨论的是同一次变更。
| 字段 | DS-142 的示例 |
|---|---|
| 设计证据 | Figma 文件链接、Button 前后对比、设计评审结论 |
| 影响范围 | Light/Dark 模式、Button Primary/Hover/Focus、Web 与 App |
| 接口判定 | 令牌名称和组件 Props 不变;仍需验证视觉兼容性 |
| 目标版本 | 令牌包 1.5.1、组件包 2.8.1,按团队 PATCH 规则发布 |
| 回退基线 | 令牌包 1.5.0、组件包 2.8.0、应用上一个稳定构建 |
先确认新颜色下按钮文字对比度符合项目验收线:普通文本至少 4.5:1,焦点样式与 Disabled 状态也要单独复查。视觉变化即使不改 API,也不能跳过设计复核。
按责任人设置四道审批关卡
- 设计评审:设计负责人核对 Figma 前后状态、Light/Dark 和受影响页面;不通过时退回修改,不进入代码发布。支持分支的 Figma Organization/Enterprise 团队可先审分支再合并;其他团队用独立草稿与评审记录,不假设有分支审批功能(见 Figma 分支权限)。
- 令牌与组件 PR:工程负责人将
DS-142、Figma 评审链接写入 PR;检查引用有效性、Button 状态测试和视觉差异。令牌和组件可以分开提 PR,但都必须指向同一变更单。 - 版本发布审批:维护者确认变更级别、两个包的兼容关系、变更日志和可用的上一版;通过后从受审提交构建并发布,不直接用未审核工作区打包。
- 业务应用升级审批:应用负责人提交依赖升级 PR,在预发布环境验证关键页面;验收通过才允许生产发布,并记录部署版本与负责人员。

Figma 的分支合并不等于已发布共享库。设计审批通过后,可在库源文件主文件的 Assets → Libraries → This file → Publish 发布更新;使用方仍需在自己的设计文件中审核并接受库更新(见 发布共享库)。把该操作的时间和结果写回 DS-142。
让 PR 检查成为合并条件
片段示例:以下为完整 GitHub Actions 工作流文件 .github/workflows/design-system-ci.yml,但依赖仓库已有 package-lock.json,以及 package.json 中可执行的 test:tokens、test:components、build 脚本。两项测试应分别覆盖令牌引用和组件状态;没有这些脚本时须先实现,不能把检查视为已配置。
name: design-system-ci
on:
pull_request:
branches: [main]
permissions:
contents: read
jobs:
design-system-ci:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v7
with:
node-version: '22'
cache: npm
# 锁定依赖版本,避免 CI 与本地解析出不同依赖
- run: npm ci
# 两组检查对应令牌引用与组件状态
- run: npm run test:tokens
- run: npm run test:components
- run: npm run build预期结果:依赖安装、两组测试和构建全部成功时,PR 的 design-system-ci 检查显示成功;缺少脚本或测试失败时检查失败。工作流本身不会自动要求审批,还须在 GitHub 仓库 Settings → Branches 的 main 保护规则中开启 PR 审批,并将 design-system-ci 设为必需状态检查。建议至少两位独立审阅人;其中设计批准仍须通过变更单中的 Figma 记录核实,不能用代码检查代替。具体选项见 GitHub 分支保护规则。
按固定版本升级并验收
审批完成后,分别发布令牌包 1.5.1 与组件包 2.8.1,在发布说明里记录 DS-142、适配范围和迁移要求。业务项目的升级 PR 应提交依赖清单和锁文件,避免只改声明而实际安装了旧版本。
在预发布环境建立最小验收矩阵:视口 375×800 和 1280×800,主题 Light/Dark,按钮 Default/Hover/Focus/Disabled;共检查 2×2×4=16 组组合。逐组对照已批准的 Figma 状态,核对文字对比度、焦点可见性与控制台报错。测试未通过则阻止该应用上线,但不要求其他未受影响应用同步升级。
上线记录至少包含应用提交号、令牌包版本、组件包版本、发布时间和验收链接;只有当这些信息能对应到 DS-142,才能判断线上使用的是哪套设计。
保留能真正执行的回滚路径
假设应用升级后焦点描边消失,先暂停继续推广,重新部署上一份已验证的应用构建,并确认它锁定令牌包 1.5.0、组件包 2.8.0。检查线上 Button 焦点与主题状态已恢复,再把事故、回滚提交和待修复项关联到 DS-142。
最后在变更单中记下“回滚触发条件、稳定构建标识、复验结果、重新放行人”。这四项缺一项,下一次升级就无法安全复用本次处理结论。