深入解析 OpenDesign 的 Stripe 设计系统包:从紫色调色板到 Agent 提示词协议的完整实现

原创2026-09-20 09:15:301,726 阅读
文章标签:AI 应用AI Agent人工智能AI 技能MCP 服务Agent 编排媒体生成设计系统桌面应用前端后端插件系统dsh-plugin

深入解析 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 条铁律)

  1. sohne-var 文本始终启用 font-feature-settings: "ss01"——这是品牌的排版 DNA;
  2. 字重 300 是默认值;400 只用于按钮/链接/导航;
  3. 阴影公式:rgba(50,50,93,0.25) 0px Y1 B1 -S1, rgba(0,0,0,0.1) 0px Y2 B2 -S2(Y1/B1 更大为远层阴影,Y2/B2 更小为近层阴影);
  4. 标题色 #061b31(深海军蓝)、正文 #64748d(板岩)、标签 #273951(深板岩);
  5. 圆角保持在 4px-8px——绝不用胶囊形或大圆角;
  6. 表格、图表、金融展示中的任何数字用 "tnum";
  7. 深色区块用 #1c1e54——不是黑也不是灰,而是深品牌靛蓝;
  8. 代码用 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 中调用该包生成产物,还是想把某个品牌的视觉语言整理成同样的包结构,本文梳理的"色彩角色表 + 排版层级表 + 阴影公式 + 迭代八条"都是一份可复制的模板。

登录后查看全文
open-design