深入解析 OpenDesign 的 Stripe 设计系统包:从紫色调色板到 Agent 提示词协议的完整实现
深入解析 OpenDesign 的 Stripe 设计系统包:从紫色调色板到 Agent 提示词协议的完整实现
本文以 OpenDesign 仓库中的 Stripe 设计系统包 为研究对象,系统拆解其核心文档 DESIGN-ko.md(与 DESIGN.md 内容一致,为同一系统的多语言版本)中定义的视觉语言,并结合仓库内的 tokens.css、USAGE.md、components.manifest.json 等实现文件,说明这套"Stripe 风格"设计规范如何在 OpenDesign 中作为可移植的设计系统包被 Agent 消费、绑定与渲染。读者读完后,将掌握该包的色彩、排版、组件、布局与层级规范,并理解它如何通过语义化 token 契约驱动 AI Agent 生成可复现的 Stripe 风格页面。
一、包结构与阅读顺序:一个可移植的设计系统包
在 OpenDesign 中,每个 design-systems/<slug>/ 目录都是一个可移植的设计系统包,最小机器可读形态为 manifest.json + DESIGN.md + tokens.css(见 design-systems/README.md)。Stripe 包在此基础上还提供了更丰富的文件:
| 文件 | 作用 |
|---|---|
manifest.json |
包元数据:分类为 Fintech & Crypto,声明 importMode: "normalized",建议绑定 color 与 accessibility-baseline 两条 craft 规则 |
DESIGN.md |
Agent 阅读的规范正文(本文所讲内容的中文对应物) |
tokens.css |
编译后的语义化 token 样式表,Agent 生成产物时需逐字粘贴 :root 块 |
USAGE.md |
Agent 与审阅者的使用顺序指南 |
components.html / components.manifest.json |
组件夹具与组件/token 派生索引 |
tailwind-v4.css |
由 tokens.css 派生的 Tailwind v4 映射 |
preview/ |
色彩、排版、间距三张预览页 |
source/ |
导入证据、token 契约报告 |
USAGE.md 给出了明确的阅读顺序:先读 USAGE 理解包契约,再读 DESIGN.md 把握视觉意图与反模式,随后将 tokens.css 粘贴到首个 artifact 的 <style> 块,最后按需查看 components.manifest.json 与 preview/ 页面。其核心约束是:保留 schema token 名称不变以保证跨品牌切换可靠,所有值通过 var(--name) 引用,禁止在 :root 块之外散落裸 hex 值。
二、视觉主题与氛围:为什么 Stripe 风格是"低调的权威"
Stripe 的设计语言是金融科技设计的黄金标准——同时具备技术感与奢华感、精确与温暖。整个系统建立在一个纯净白色画布(#ffffff)、深海军蓝标题(#061b31)与品牌紫色(#533afd)之上。这不是企业软件的冰冷紫,而是饱和度高、读起来自信且高级的蓝紫色。
该包的核心视觉特征(也是 DESIGN 文档列出的"关键特性"):
sohne-var+ OpenType"ss01":所有文本启用ss01风格集,通过修改字形(可能是备选a、g、l形态)营造出明显的几何感与现代感——这是定义品牌字形的自定义风格集;- Weight 300 作为签名级标题字重:轻盈、自信、反常规;
- 显示尺寸下的负字距(56px 时 -1.4px,向下逐步放松);
- 蓝色调多层阴影(
rgba(50,50,93,0.25))——让"海拔"本身带有品牌色; - 深海军蓝(
#061b31)标题代替纯黑——温暖、高级、金融级质感; - 保守的圆角(4px-8px)——既非胶囊形,也非生硬直角;
- Ruby(
#ea2261)与 Magenta(#f96bee)仅用于渐变与装饰; SourceCodePro作为等宽辅助字体,用于代码与技术标签。
tokens.css 的头部注释解释了这套绑定的设计决策:Stripe 用七条带 #Stripe N 标注的绑定决策把共享 schema 落到品牌语义上(例如 #Stripe 6 指出 --elev-raised 承载 Stripe 标志性的多层蓝色调阴影,将其重绑为中性投影会抹掉 Stripe 的氛围,哪怕所有颜色都对)。
三、颜色调色板与角色
DESIGN 文档按角色完整定义了调色板,tokens.css 则把这些语义绑定到 --hds-* 风格的 schema token 上。逐层拆解如下。
主色(Primary)
- Stripe Purple(
#533afd):品牌主色、CTA 背景、链接文字、交互高亮,是整个系统的锚点; - Deep Navy(
#061b31):对应--hds-color-heading-solid,标题主色,不是黑也不是灰,而是带有温度与深度的极深蓝; - Pure White(
#ffffff):页面背景、卡片表面、深色背景上的按钮文字。
品牌与深色(Brand & Dark)
- Brand Dark(
#1c1e54):对应--hds-color-util-brand-900,深靛蓝,用于深色区块、页脚背景与沉浸式品牌时刻; - Dark Navy(
#0d253d):对应--hds-color-core-neutral-975,最深的中间色,带蓝色底的近黑色,在不生硬的前提下提供最大深度。
强调色(Accent)
- Ruby(
#ea2261):对应--hds-color-accentColorMode-ruby-icon-solid,暖红粉,用于图标、告警与强调元素; - Magenta(
#f96bee):对应--hds-color-accentColorMode-magenta-icon-gradientMiddle,鲜艳粉紫,用于渐变与装饰高亮; - Magenta Light(
#ffd7ef):对应--hds-color-util-accent-magenta-100,用于 Magenta 主题卡片与徽章的浅色表面。
交互态(Interactive)
| 名称 | 色值 | 语义 token | 用途 |
|---|---|---|---|
| Primary Purple | #533afd |
--accent | 链接主色、激活态、选中元素 |
| Purple Hover | #4434d4 |
--accent-hover | 主元素悬停 |
| Purple Deep | #2e2b8c |
--hds-color-button-ui-iconHover |
图标悬停 |
| Purple Light | #b9b9f9 |
--hds-color-action-bg-subduedHover |
柔和悬停背景 |
| Purple Mid | #665efd |
--hds-color-input-selector-text-range |
范围选择器与输入高亮 |
tokens.css 的 #Stripe 4 注释特别说明:--accent-hover 与 --accent-active 绑定的 Purple Hover(#4434d4)与 Purple Deep(#2e2b8c)是手挑值而非 schema 默认的黑色混合公式——Stripe 紫饱和度足够高,若用 color-mix(in oklab, var(--accent), black 8%) 会产生浑浊的紫,所以必须使用品牌自己的值。
中性色阶(Neutral Scale)
- Heading(
#061b31):主标题、导航文字、强调标签; - Label(
#273951):对应--hds-color-input-text-label,表单标签、次级标题; - Body(
#64748d):次级文字、说明、标题; - Success Green(
#15be53):状态徽章、成功指示器(背景/边框使用 0.2-0.4 alpha); - Success Text(
#108c3d):成功徽章文字色; - Lemon(
#9b6829):对应--hds-color-core-lemon-500,告警与高亮强调。
表面与边框(Surface & Borders)
- Border Default(
#e5edf5):卡片、分隔线、容器的标准边框; - Border Purple(
#b9b9f9):按钮与输入框的激活/选中态边框; - Border Soft Purple(
#d6d9fc):次级元素的柔和紫调边框; - Border Magenta(
#ffd7ef):Magenta 主题元素的粉调边框; - Border Dashed(
#362baa):拖放区与占位元素的虚线边框。
阴影色(Shadow Colors)
- Shadow Blue(
rgba(50,50,93,0.25)):签名级蓝色调主阴影色; - Shadow Dark Blue(
rgba(3,3,39,0.25)):更高层级的深蓝阴影; - Shadow Black(
rgba(0,0,0,0.1)):增强深度的次级阴影层; - Shadow Ambient(
rgba(23,23,23,0.08)):微妙抬升的柔和环境阴影; - Shadow Soft(
rgba(23,23,23,0.06)):轻微浮起的最小环境阴影。
tokens.css 把表面/前景/边框收敛为 schema 规定的层级:#Stripe 1 中 --surface-warm 绑定到冷调浅蓝 #f6f9fc(Stripe 用于嵌套面板、定价行与代码预览后的安静分隔),#Stripe 2 中前景只有三档(海军蓝标题 / 深板岩标签 / 板岩正文),--meta 直接别名 var(--muted),#Stripe 3 中只有一个边框档位,--border-soft 别名 --border。
四、排版规则:两个 OpenType 模式与渐进式字距
字体族(Font Family)
- 主字体:
sohne-var,回退SF Pro Display; - 等宽字体:
SourceCodePro,回退SFMono-Regular; - OpenType 特性:所有 sohne-var 文本全局启用
"ss01";金融数据与标题的数字用"tnum"表格数字。
tokens.css 中 --font-display 与 --font-body 都声明为 "sohne-var", "Söhne", "Sohne", "SF Pro Display", ... 的完整回退链(sohne-var 是定制字体,多数读者环境不会加载,回退链取最接近的 SF/系统无衬线字体),--font-mono 为 SourceCodePro 链。
完整排版层级表
| 角色 | 字体 | 字号 | 字重 | 行高 | 字距 | 特性 | 说明 |
|---|---|---|---|---|---|---|---|
| Display Hero | sohne-var | 56px (3.50rem) | 300 | 1.03(紧凑) | -1.4px | ss01 | 最大字号,低语式的权威感 |
| Display Large | sohne-var | 48px (3.00rem) | 300 | 1.15(紧凑) | -0.96px | ss01 | 次级英雄标题 |
| Section Heading | sohne-var | 32px (2.00rem) | 300 | 1.10(紧凑) | -0.64px | ss01 | 功能区块标题 |
| Sub-heading Large | sohne-var | 26px (1.63rem) | 300 | 1.12(紧凑) | -0.26px | ss01 | 卡片标题、子区块 |
| Sub-heading | sohne-var | 22px (1.38rem) | 300 | 1.10(紧凑) | -0.22px | ss01 | 更小的区块标题 |
| Body Large | sohne-var | 18px (1.13rem) | 300 | 1.40 | 正常 | ss01 | 功能描述、引言 |
| Body | sohne-var | 16px (1.00rem) | 300-400 | 1.40 | 正常 | ss01 | 标准阅读文本 |
| Button | sohne-var | 16px (1.00rem) | 400 | 1.00(紧凑) | 正常 | ss01 | 主按钮文字 |
| Button Small | sohne-var | 14px (0.88rem) | 400 | 1.00(紧凑) | 正常 | ss01 | 次级/紧凑按钮 |
| Link | sohne-var | 14px (0.88rem) | 400 | 1.00(紧凑) | 正常 | ss01 | 导航链接 |
| Caption | sohne-var | 13px (0.81rem) | 400 | 正常 | 正常 | ss01 | 小标签、元数据 |
| Caption Small | sohne-var | 12px (0.75rem) | 300-400 | 1.33-1.45 | 正常 | ss01 | 注释、时间戳 |
| Caption Tabular | sohne-var | 12px (0.75rem) | 300-400 | 1.33 | -0.36px | tnum | 金融数据、数字 |
| Micro | sohne-var | 10px (0.63rem) | 300 | 1.15(紧凑) | 0.1px | ss01 | 小标签、轴标记 |
| Micro Tabular | sohne-var | 10px (0.63rem) | 300 | 1.15(紧凑) | -0.3px | tnum | 图表数据、小数字 |
| Nano | sohne-var | 8px (0.50rem) | 300 | 1.07(紧凑) | 正常 | ss01 | 最小标签 |
| Code Body | SourceCodePro | 12px (0.75rem) | 500 | 2.00(宽松) | 正常 | -- | 代码块、语法 |
| Code Bold | SourceCodePro | 12px (0.75rem) | 700 | 2.00(宽松) | 正常 | -- | 粗体代码、关键字 |
| Code Label | SourceCodePro | 12px (0.75rem) | 500 | 2.00(宽松) | 正常 | 大写 | 技术标签 |
| Code Micro | SourceCodePro | 9px (0.56rem) | 500 | 1.00(紧凑) | 正常 | ss01 | 小型代码注释 |
排版原则
- 轻量字重即签名:显示尺寸下用 300 是 Stripe 最具辨识度的排版选择。别人用 600-700 夺取注意力时,Stripe 把"轻"当作"奢侈"——文本自信到不需要靠字重来确立权威;
- 处处 ss01:
"ss01"风格集不可妥协,它修改特定字形(可能是备选a、g、l形态)让所有 sohne-var 文本更几何、更现代; - 两种 OpenType 模式互不重叠:正文/显示用
"ss01",金融数据表格数字用"tnum"——段落里的数字用 ss01,数据表里的数字用 tnum; - 渐进式字距:字距随字号按比例收紧——56px 时 -1.4px、48px 时 -0.96px、32px 时 -0.64px、26px 时 -0.26px、16px 及以下回到正常;
- 两档字重的简洁:主要只用 300(正文与标题)与 400(UI/按钮)。主字体没有 700 粗体——SourceCodePro 用 500/700 制造代码对比。
在 token 层,tokens.css 把排版收敛为 #Stripe 5 的决策:字号天花板是 56px(--text-4xl)而不是 schema 默认的 64px——DESIGN.md §3 把显示英雄定义为 56px / 300 字重 / -1.4px 字距,这就是 Stripe 的"低语式权威",再加 64px 档会突破品牌自我设定的上限。行高方面 --leading-body: 1.40(比 schema 默认的 1.5 更紧,因为 300 字重的正文读起来更轻),--tracking-display: -0.02em 让显示范围内的负字距规则保持一致。
五、组件样式规范
按钮
主紫色按钮(Primary Purple)
- 背景:
#533afd;文字:#ffffff;内边距:8px 16px;圆角:4px; - 字体:16px sohne-var 字重 400,
"ss01";悬停背景:#4434d4; - 用途:主 CTA("Start now"、"Contact sales")。
幽灵/描边按钮(Ghost / Outlined)
- 背景:透明;文字:
#533afd;内边距:8px 16px;圆角:4px; - 边框:
1px solid #b9b9f9;字体:16px sohne-var 字重 400,"ss01"; - 悬停:背景变为
rgba(83,58,253,0.05);用途:次级动作。
透明信息按钮(Transparent Info)
- 背景:透明;文字:
#2874ad;内边距:8px 16px;圆角:4px; - 边框:
1px solid rgba(43,145,223,0.2);用途:三级/信息级动作。
中性幽灵按钮(Neutral Ghost)
- 背景:透明(
rgba(255,255,255,0));文字:rgba(16,16,16,0.3);内边距:8px 16px;圆角:4px; - 描边:
1px solid rgb(212,222,233);用途:禁用或静音动作。
从 components.manifest.json 的按钮组可见,.btn-primary / .btn-ghost / .btn-sm 等选择器引用 --accent、--accent-active、--accent-on、--radius-sm、--space-2、--text-base、--motion-fast、--ease-standard 等 token——按钮的配色、间距、动效全部来自 token 块,印证了"组件夹具证明 token 块单独就足以渲染出可识别的 Stripe 页面"这一设计意图。
卡片与容器
- 背景:
#ffffff;边框:1px solid #e5edf5(标准)或1px solid #061b31(深色强调); - 圆角:4px(紧凑)、5px(标准)、6px(舒适)、8px(推荐);
- 标准阴影:
rgba(50,50,93,0.25) 0px 30px 45px -30px, rgba(0,0,0,0.1) 0px 18px 36px -18px; - 环境阴影:
rgba(23,23,23,0.08) 0px 15px 35px 0px; - 悬停:阴影增强,通常叠加蓝色调层。
徽章 / 标签 / 胶囊
中性胶囊(Neutral Pill)
- 背景:
#ffffff;文字:#000000;内边距:0px 6px;圆角:4px; - 边框:
1px solid #f6f9fc;字体:11px 字重 400。
成功徽章(Success Badge)
- 背景:
rgba(21,190,83,0.2);文字:#108c3d;内边距:1px 6px;圆角:4px; - 边框:
1px solid rgba(21,190,83,0.4);字体:10px 字重 300。
输入与表单
- 边框:
1px solid #e5edf5;圆角:4px; - 焦点:
1px solid #533afd或紫色光环; - 标签:
#273951、14px sohne-var;文字:#061b31;占位符:#64748d。
导航
- 白色背景的干净水平导航,带模糊背景的 sticky 效果;
- 品牌标识左对齐;链接:sohne-var 14px 字重 400、
#061b31文字、"ss01"; - 导航容器圆角 6px;CTA 为右对齐紫色按钮("Sign in"、"Start now");移动端为 6px 圆角的汉堡菜单。
装饰元素
虚线边框:占位/拖放区用 1px dashed #362baa(紫);Magenta 主题装饰边框用 1px dashed #ffd7ef(粉)。
渐变强调:英雄装饰用 Ruby 到 Magenta 渐变(#ea2261 → #f96bee);品牌深色区块用 #1c1e54 背景 + 白字。
值得注意:tokens.css 的 Layer C 注释说明这些深色品牌区块与 Ruby/Magenta 渐变是装饰性的——它们只以 components.html 中的一次性内联表达式存在,通过 color-mix(...) 从 --accent 派生,不提升为 token,因为没有任何跨组件规则需要按名引用它们。
六、布局原则
间距系统
- 基础单位:8px;
- 刻度:1px、2px、4px、6px、8px、10px、11px、12px、14px、16px、18px、20px;
- 特点:刻度在小端密集(4-12 之间每 2px 一档),反映 Stripe 面向金融数据的精密 UI。
token 层把间距收敛为 schema 的 4/8/12/16/20/24/32/48 阶梯(--space-1 到 --space-12),文档里点名的 2px 级细粒度值被内联进具体金融数据组件,而不提升为 token。
栅格与容器
- 最大内容宽度:约 1080px(
--container-max: 1080px); - 英雄区:居中单列 + 宽裕内边距 + 轻量标题;
- 功能区块:2-3 列功能卡片栅格;
- 全宽深色区块(
#1c1e54背景)用于品牌沉浸; - 代码/仪表盘预览作为带蓝色调阴影的包含式卡片。
留白哲学
- 精确间距:与极简主义系统的大面积留白不同,Stripe 使用有度量、有目的的留白,每处空隙都是刻意的排版选择;
- 数据密集、外壳宽松:金融数据展示(表格、图表)排布紧密,周围 UI 外壳留白充足——像放在精美画框里的整理好的电子表格,营造受控的密度感;
- 区块节奏:白色区块与深色品牌区块(
#1c1e54)交替,形成戏剧性的明暗节奏,避免单调又不引入任意颜色。
圆角刻度
- 微(1px):细粒度元素,微妙圆角;
- 标准(4px):按钮、输入框、徽章、卡片——主力档位;
- 舒适(5px):标准卡片容器;
- 宽松(6px):导航、较大交互元素;
- 大(8px):推荐卡片、英雄元素;
- 复合:
0px 0px 6px 6px用于底部圆角容器(标签面板、下拉页脚)。
tokens.css 的 --radius-sm/md/lg 分别对应 4/6/8px,--radius-pill: 9999px 仅保留给头像(schema 槽位),绝不用在按钮与卡片等交互表面上。
七、深度与层级:蓝色调阴影的"色度深度"哲学
| 层级 | 处理方式 | 用途 |
|---|---|---|
| 平面(Level 0) | 无阴影 | 页面背景、行内文字 |
| 环境(Level 1) | rgba(23,23,23,0.06) 0px 3px 6px |
微妙的卡片浮起、悬停提示 |
| 标准(Level 2) | rgba(23,23,23,0.08) 0px 15px 35px |
标准卡片、内容面板 |
| 抬升(Level 3) | rgba(50,50,93,0.25) 0px 30px 45px -30px, rgba(0,0,0,0.1) 0px 18px 36px -18px |
推荐卡片、下拉、弹层 |
| 深(Level 4) | rgba(3,3,39,0.25) 0px 14px 21px -14px, rgba(0,0,0,0.1) 0px 8px 17px -8px |
模态框、浮动面板 |
| 环(无障碍) | 2px solid #533afd 轮廓 |
键盘焦点环 |
阴影哲学:Stripe 的阴影系统建立在"色度深度"原则上。多数设计系统用中性灰或黑阴影,而 Stripe 的主阴影色 rgba(50,50,93,0.25) 是呼应品牌海军蓝调色板的深蓝灰——阴影不只是加深,而是加品牌氛围。多层方法把这层蓝色调阴影与不同偏移的纯黑辅助层(rgba(0,0,0,0.1))配对,形成视差式深度:品牌阴影离元素更远,中性阴影更近。负 spread 值(-30px、-18px)确保阴影不会横向超出元素占地,让抬升保持垂直且受控。
tokens.css 的 --elev-raised 就是这条签名公式的 token 化版本(#Stripe 6),--focus-ring 则实现为双层紫色光晕——2px 实边 + 半透明外圈(#Stripe 7),因为支付流程是键盘重度场景,焦点清晰是头等需求。token 块里还定义了 motion 契约(--motion-fast: 150ms、--motion-base: 200ms、--ease-standard: cubic-bezier(0.2, 0, 0, 1)):Stripe 的悬停只过渡颜色与阴影,绝不变换 transform——按钮悬停不位移不缩放,卡片只通过阴影强度浮起。
八、该做什么与不该做什么
该做
- 所有文本元素用 sohne-var +
"ss01"——风格集就是品牌; - 所有标题与正文用字重 300——轻盈即签名;
- 所有抬升元素用蓝色调阴影(
rgba(50,50,93,0.25)); - 标题用
#061b31(深海军蓝)而不用#000000——温度很重要; - 圆角保持在 4px-8px——保守的圆角是刻意的;
- 表格/金融数字展示用
"tnum"; - 阴影分层:蓝色调远层 + 中性近层,制造深度视差;
- 用
#533afd紫色作为主交互/CTA 色。
不该做
- sohne-var 标题不要用 600-700 字重——300 才是品牌声音;
- 卡片或按钮不要用大圆角(12px+、胶囊形)——Stripe 是保守的;
- 不要用中性灰阴影——永远加蓝色调(
rgba(50,50,93,...)); - sohne-var 文本不要省略
"ss01"——备选字形定义了个性; - 标题不要用纯黑(
#000000)——永远用#061b31深海军蓝; - 交互元素不要用暖色强调(橙、黄)——紫色才是主色;
- 显示尺寸不要用正字距——Stripe 字距收紧;
- 按钮或链接不要用 Magenta/Ruby 强调——它们只属于装饰/渐变。
九、响应式行为
断点
| 名称 | 宽度 | 主要变化 |
|---|---|---|
| 移动端 | <640px | 单列、标题缩小、卡片堆叠 |
| 平板 | 640-1024px | 2 列栅格、适度内边距 |
| 桌面 | 1024-1280px | 完整布局、3 列功能栅格 |
| 大桌面 | >1280px | 大留白下的居中内容 |
触控目标
- 按钮用舒适内边距(垂直 8px-16px);
- 导航链接 14px 且间距充足;
- 徽章最小 6px 水平内边距以保证点按目标;
- 移动端导航切换按钮 6px 圆角。
折叠策略
- 英雄区:56px 显示 → 移动端 32px,保持 300 字重;
- 导航:水平链接 + CTA → 汉堡菜单;
- 功能卡片:3 列 → 2 列 → 单列堆叠;
- 深色品牌区块:保持全宽处理,缩小内部内边距;
- 金融数据表:移动端横向滚动;
- 区块间距:64px+ → 移动端 40px;
- 排版刻度压缩:跨断点 56px → 48px → 32px 英雄字号。
tokens.css 通过 --section-y-desktop: 96px、--section-y-tablet: 64px、--section-y-phone: 40px 与 --container-gutter-desktop/tablet/phone: 32/24/16px 把这套响应式节奏 token 化——桌面端给 56px 英雄标题留足上下空气,移动端每一像素都是内容。
图片行为
- 仪表盘/产品截图在所有尺寸下保持蓝色调阴影;
- 英雄渐变装饰在移动端简化;
- 代码块保持
SourceCodePro处理,可横向滚动; - 卡片图片保持一致的 4px-6px 圆角。
十、Agent 提示词指南:把规范变成可执行的指令
DESIGN 文档最后一节是该包最独特的部分——面向 Agent 的提示词协议,把整套规范压缩成可粘贴的指令。
快速颜色参考
- 主 CTA:Stripe Purple(
#533afd);CTA 悬停:Purple Dark(#4434d4); - 背景:纯白(
#ffffff);标题文字:深海军蓝(#061b31);正文:板岩(#64748d);标签:深板岩(#273951); - 边框:柔蓝(
#e5edf5);链接:Stripe Purple(#533afd);深色区块:Brand Dark(#1c1e54); - 成功:绿(
#15be53);装饰强调:Ruby(#ea2261)、Magenta(#f96bee)。
组件提示词示例(原文保留的 5 个可直接使用的提示词)
英雄区:"白背景创建英雄区。标题 48px sohne-var 字重 300、line-height 1.15、letter-spacing -0.96px、color #061b31、font-feature-settings 'ss01'。副标题 18px 字重 300、line-height 1.40、color #64748d。紫色 CTA 按钮(#533afd、4px 圆角、8px 16px 内边距、白字)与幽灵按钮(透明、1px solid #b9b9f9、#533afd 文字、4px 圆角)。"
卡片:"设计卡片:白背景、1px solid #e5edf5 边框、6px 圆角。阴影:rgba(50,50,93,0.25) 0px 30px 45px -30px、rgba(0,0,0,0.1) 0px 18px 36px -18px。标题 22px sohne-var 字重 300、letter-spacing -0.22px、color #061b31、'ss01'。正文 16px 字重 300、#64748d。"
成功徽章:"创建成功徽章:rgba(21,190,83,0.2) 背景、#108c3d 文字、4px 圆角、1px 6px 内边距、10px sohne-var 字重 300、边框 1px solid rgba(21,190,83,0.4)。"
导航:"创建导航:backdrop-filter blur(12px) 的白色 sticky 头部。链接用 sohne-var 14px 字重 400、#061b31 文字、'ss01'。右对齐紫色 CTA 'Start now'(#533afd 背景、白字、4px 圆角)。导航容器 6px 圆角。"
深色品牌区块:"设计深色品牌区块:#1c1e54 背景、白字。标题 32px sohne-var 字重 300、letter-spacing -0.64px、'ss01'。正文 16px 字重 300、rgba(255,255,255,0.7)。内部卡片用 rgba(255,255,255,0.1) 边框、6px 圆角。"
迭代指南(8 条铁律)
- sohne-var 文本始终启用
font-feature-settings: "ss01"——这是品牌的排版 DNA; - 字重 300 是默认值;400 只用于按钮/链接/导航;
- 阴影公式:
rgba(50,50,93,0.25) 0px Y1 B1 -S1, rgba(0,0,0,0.1) 0px Y2 B2 -S2(Y1/B1 更大为远层阴影,Y2/B2 更小为近层阴影); - 标题色
#061b31(深海军蓝)、正文#64748d(板岩)、标签#273951(深板岩); - 圆角保持在 4px-8px——绝不用胶囊形或大圆角;
- 表格、图表、金融展示中的任何数字用
"tnum"; - 深色区块用
#1c1e54——不是黑也不是灰,而是深品牌靛蓝; - 代码用 SourceCodePro,12px/500 字重,2.00 行高(非常宽松,保证可读性)。
十一、落地到产物:token 契约与 Tailwind 映射
这套规范的最终落地方式是 token 契约。OpenDesign 的每个设计系统包都要把语义 token 绑定到共享 schema(详见 design-systems/_schema 与 docs/design-systems.md),Stripe 包的 tokens.css 就是这份预编译绑定:Agent 生成 Stripe 风格产物时,把 :root { ... } 块逐字粘贴进第一个 <style>,之后所有值一律通过 var(--name) 引用,绝不重写行内 hex。
配套的 tailwind-v4.css 进一步把这些 CSS 变量映射为 Tailwind v4 的 @theme 令牌(--color-accent、--font-display、--text-4xl、--shadow-raised、--duration-base 等),让偏好 Tailwind 工作流的 Agent 也能直接消费同一套值。components.manifest.json 记录了夹具验证结果:79 个选择器、45 个类、31 个元素,声明的 57 个 token 中无一个"未声明却被引用"的悬空引用,colorExpressions: 15、pixelValues: 51——即组件夹具中仍有少量内联数值,但全部是装饰性的一次性表达式(虚线边框、渐变等),这正是 tokens.css 头部注释所说明的边界。
从 OpenDesign 的运行机制看(design-systems/README.md),选择该包后,提示词组装会把 USAGE.md、tokens.css、组件信息、craft 绑定(color、accessibility-baseline)与 manifest 派生的拉取索引合入 Agent 上下文;派生文件(design-tokens.json、tailwind-v4.css)是缓存而非竞争性的真相源,必须与 tokens.css 保持一致,并由 scripts/check-design-system-manifests.ts、scripts/check-tokens-fixture-sync.ts 等仓库守卫脚本持续校验。
结语
Stripe 设计系统包是 OpenDesign 设计系统目录中"品牌灵感如何被工程化"的一个典型样本:一份面向人的 DESIGN 文档 定义视觉意图与反模式,一份面向机器的 tokens.css 把意图预编译成语义 token,一份 USAGE.md 规定两者的消费顺序,而 components.html 夹具则用"仅凭 token 块就能渲染出可识别的 Stripe 页面"证明契约闭环。无论你是想在 OpenDesign 中调用该包生成产物,还是想把某个品牌的视觉语言整理成同样的包结构,本文梳理的"色彩角色表 + 排版层级表 + 阴影公式 + 迭代八条"都是一份可复制的模板。