OpenDesign ClickHouse 设计系统解析:纯黑画布上的高性能数据控制台美学实战指南
【免费下载链接】open-design🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your coding agent becomes the design engine: prototypes, landing pages, dashboards, slides, images & video — real files, HTML/PDF/PPTX/MP4 export. 🤖 Claude Code / Codex / Cursor / DeepSeek Harness / OpenCode & 20+ CLIs via BYOK.项目地址: https://gitcode.com/gh_mirrors/opend/open-design
本文基于 OpenDesign 仓库中 design-systems/clickhouse/DESIGN.md 设计系统包展开。ClickHouse 设计系统是一套以「酸黄绿荧光 × 曜石黑」为核心的高对比暗色视觉语言,专为高性能数据库、数据基础设施、开发者工具类产品打造。读完本文,你将掌握这套系统的完整色彩体系、字体层级、组件规范、深度机制与响应式策略,并能直接复用仓库中已编译好的
tokens.css语义令牌与组件夹具,把它应用到自己的暗色数据类产品界面中。
1. 视觉主题与氛围:终端级的高性能驾驶舱
ClickHouse 的界面是一台渲染在曜石黑之上的高性能驾驶舱:酸黄绿荧光(acid yellow-green)与纯黑(#000000)的碰撞,让访问者在阅读任何文字之前就已经感知到「速度」这个词。整个体验完全沉浸在黑暗中——纯黑页面背景搭配深炭色卡片(#414141边框),营造出终端级别的美学气质;唯一的色彩打断是标志性的霓虹黄绿(#faff69),它像黑暗控制台上的荧光笔一样划过 CTA、边框与高亮时刻。
这套系统通过极端的视觉重量来传达产品承诺:Inter 字体 weight 900(Black)配合 96px 的英雄标题,让文字块拥有近乎物理形态的「质量感」。这个「面向 AI 的数据库」网站用粗重的字体、高对比的霓虹强调和超大号的性能数据数字来沟通原始力量。ClickHouse 的设计没有任何含蓄之处——这正是它的意图:视觉本身就在镜像产品「极致速度与性能」的承诺。
真正让 ClickHouse 与众不同之处,是近黑画布与霓虹黄绿强调之间的电击般的张力。#faff69落在#000000上,构成了科技品牌中最高的对比配对之一,让每一个 CTA 按钮、每一张高亮卡片、每一条强调边框都无法被忽略。支撑这一体系的是森林绿(#166534)——用于次级 CTA,在不与霓虹竞争的前提下为操作层级增加深度。
关键特征一览
- 纯黑画布(
#000000)+ 霓虹黄绿(#faff69)强调——最大对比度 - 超重显示字体:Inter weight 900(Black),最大 96px
- 深炭色卡片系统,
#414141边框、80% 不透明度 - 森林绿(
#166534)次级 CTA 按钮 - 性能数据以超大号数字呈现
- 大写标签 + 宽字距(1.4px)支撑导航结构
- 激活/按下状态文字切换为淡黄(
#f4f692) - 所有链接 hover 均变为霓虹黄绿——统一的交互信号
- 下拉类元素使用内阴影,营造「压入表面」的凹陷深度
在仓库中,这套视觉基调被固化进 design-systems/clickhouse/tokens.css 的文件头注释里:Pure Black (#000000) page bg — never dark gray as page bg、Neon Volt (#faff69) as sole chromatic accent — maximum contrast on black、Charcoal borders (rgba(65,65,65,0.8)) — primary depth mechanism。也就是说,DESIGN.md 的每一项视觉决策都已经转化为可执行的 CSS 变量绑定,而非停留在纸面描述。
2. 色彩体系与角色分工
2.1 主色(Primary)
| 名称 | 色值 | 角色 |
|---|---|---|
| Neon Volt(霓虹伏特) | #faff69 | 标志性品牌色——黑画布上唯一的彩色强调。用于主 CTA、强调边框、链接 hover、高亮时刻 |
| Forest Green(森林绿) | #166534 | 次级 CTA 色——深饱和绿,用于需要与霓虹区分的「Get Started」等主操作按钮 |
| Dark Forest(暗森林) | #14572f | 更深的绿色变体,用于边框与次级强调 |
2.2 次级与强调色(Secondary & Accent)
| 名称 | 色值 | 角色 |
|---|---|---|
| Pale Yellow(淡黄) | #f4f692 | 激活/按下状态文字色——Neon Volt 的柔和版本,用于状态反馈 |
| Border Olive(橄榄边框) | #4f5100 | 幽灵按钮边框用暗橄榄黄——霓虹的哑光兄弟色 |
| Olive Dark(暗橄榄) | #161600 | 最深的霓虹调色,用于微妙的品牌文字 |
2.3 表面与背景色(Surface & Background)
| 名称 | 色值 | 角色 |
|---|---|---|
| Pure Black(纯黑) | #000000 | 主页面背景——绝对黑,追求最大对比 |
| Near Black(近黑) | #141414 | 按钮背景与轻微抬升的暗色表面 |
| Charcoal(炭色) | #414141 | 主边框色,80% 不透明度——卡片与容器收边的绝对主力 |
| Deep Charcoal(深炭色) | #343434 | 更暗的边框变体,用于微妙的分隔线 |
| Hover Gray(悬停灰) | #3a3a3a | 按钮 hover 状态背景——比近黑略亮 |
2.4 中性色与文字色(Neutrals & Text)
| 名称 | 色值 | 角色 |
|---|---|---|
| Pure White(纯白) | #ffffff | 暗色表面上的主文字 |
| Silver(银灰) | #a0a0a0 | 次级正文与弱化内容 |
| Mid Gray(中灰) | #585858(28%) | 用于深度效果的微妙灰色叠加 |
| Border Gray(边框灰) | #e5e7eb | 浅色边框变体(罕见浅色场景下使用) |
2.5 渐变体系:没有传统意义上的渐变
ClickHouse刻意不使用渐变。它依赖纯色色块与高对比边框;所谓的「渐变」就是对比本身——霓虹黄绿对纯黑的视觉强度,是任何渐变都会稀释掉的。
仓库印证:语义令牌如何固化这套色彩
tokens.css 把上述每个色值都映射为语义化的 CSS 变量,并且做了品牌化的语义绑定:
--bg: #000000; /* Pure Black — the page canvas, absolute */ --surface: #141414; /* Near Black — buttons, lifted dark surfaces */ --fg: #ffffff; /* Pure White — primary text on dark surfaces */ --fg-2: #a0a0a0; /* Silver — secondary body text on dark */ --border: rgba(65, 65, 65, 0.8); /* Charcoal — primary card edge */ --border-soft: #343434; /* Deep Charcoal — inner separator, quieter */ --accent: #faff69; /* Neon Volt — signature acid yellow-green */ --accent-on: #151515; /* Near Black text on neon — maximum readability */ --accent-hover: #1d1d1d; /* neon CTA inverts to dark on hover */ --accent-active: #f4f692; /* Pale Yellow — active/pressed state */ --success: #166534; /* Forest Green — brand-aligned secondary CTA / success */一个值得注意的设计决策是:Forest Green 直接复用作--success——因为它本来就是品牌的「Get Started」CTA 色,天然属于调色板的一部分;而--warn(#eab308)与--danger(#dc2626)使用 schema 默认值,以保证与警告/危险状态可区分。从 design-tokens.json 的契约报告看,这套令牌共 56 个,分为 A1-identity(8 个)、B-slot(4 个)、A2(26 个)、A1-structure(18 个)四层,全部有源码行号背书,契约评分 100、评级 excellent。这套约定也正是仓库 README 中「保持 schema token 名称不变,跨品牌切换才可靠」原则的落地。
3. 字体规范(Typography Rules)
3.1 字体族
- 主字体:
Inter(Next.js 优化变体__Inter_d1b8ee) - 次级展示字体:
Basier(__basier_a58b65),回退字体Arial, Helvetica - 代码字体:
Inconsolata(__Inconsolata_a25f62)
在 tokens.css 中对应为:
--font-display: "Inter", "Basier", Arial, Helvetica, ui-sans-serif, system-ui, sans-serif; --font-body: "Inter", ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, Arial, sans-serif; --font-mono: "Inconsolata", ui-monospace, "SF Mono", "JetBrains Mono", Menlo, Monaco, Consolas, monospace;3.2 层级表(完整字阶)
| 角色 | 字体 | 字号 | 字重 | 行高 | 字距 | 备注 |
|---|---|---|---|---|---|---|
| Display Mega | Inter | 96px (6rem) | 900 | 1.00(紧) | normal | 最大冲击力,超重 |
| Display / Hero | Inter | 72px (4.5rem) | 700 | 1.00(紧) | normal | 区块英雄标题 |
| Feature Heading | Basier | 36px (2.25rem) | 600 | 1.30(紧) | normal | 特性区块锚点 |
| Sub-heading | Inter / Basier | 24px (1.5rem) | 600–700 | 1.17–1.38 | normal | 卡片标题 |
| Feature Title | Inter / Basier | 20px (1.25rem) | 600–700 | 1.40 | normal | 小型特性标题 |
| Body Large | Inter | 18px (1.13rem) | 400–700 | 1.56 | normal | 引言段落、按钮文字 |
| Body / Button | Inter | 16px (1rem) | 400–700 | 1.50 | normal | 标准正文、导航、按钮 |
| Caption | Inter | 14px (0.88rem) | 400–700 | 1.43 | normal | 元数据、描述、链接 |
| Uppercase Label | Inter | 14px (0.88rem) | 600 | 1.43 | 1.4px | 区块眉标,宽字距 |
| Code | Inconsolata | 16px (1rem) | 600 | 1.50 | normal | 代码块、命令 |
| Small | Inter | 12px (0.75rem) | 500 | 1.33 | normal | 最小文字 |
| Micro | Inter | 11.2px (0.7rem) | 500 | 1.79(宽松) | normal | 标签、微型标注 |
3.3 字体原则
- Weight 900 是武器:展示标题使用 Inter Black(900)——大多数站点永远不会触碰的字重。配合 96px 字号,文字拥有了近乎建筑感的物理存在。
- 完整的字重光谱:系统覆盖 400、500、600、700、900——字重即层级。
- 大写 + 最大字距:区块眉标使用 1.4px 字距——比大多数系统更宽——在密集的暗色背景上形成醒目的结构标签。
- 双无衬线分工:Inter 负责展示与正文,Basier 以 600 字重负责特性区块标题。这形成了「数据/性能」(Inter)与「产品/特性」(Basier)两种语境间的微妙人格切换。
tokens.css 的字号令牌与 DESIGN.md 严格对齐(--text-4xl: 96px、--text-3xl: 72px、--text-2xl: 36px、--text-xl: 24px…),并强调--leading-tight: 1.0的极紧行高是「物理质量感」的来源、--tracking-display: normal对应 DESIGN.md 中展示字距为 normal 的规定。在 components.html 中,h1被直接固化为font-size: var(--text-4xl); font-weight: 900;,并注释为「Inter Black — the weapon」;h2对应--text-2xl+ 600 字重 + 1.30 行高(Basier 风格特性标题)。
4. 组件样式规范(Component Stylings)
4.1 按钮体系
霓虹主按钮(Neon Primary)
- 背景:Neon Volt(
#faff69) - 文字:近黑(
#151515) - 内边距:0 16px
- 圆角:锐利(4px)
- 边框:
1px solid #faff69 - Hover:背景变暗(
rgb(29, 29, 29)),文字保持 - Active:文字切换为 Pale Yellow(
#f4f692) - 定位:黑底上的吸睛 CTA
暗色实心按钮(Dark Solid)
- 背景:Near Black(
#141414) - 文字:纯白(
#ffffff) - 内边距:12px 16px
- 圆角:4px 或 8px
- 边框:
1px solid #141414 - Hover:背景变 Hover Gray(
#3a3a3a),文字 80% 不透明度 - Active:文字变 Pale Yellow
- 定位:标准操作按钮
森林绿按钮(Forest Green)
- 背景:Forest Green(
#166534) - 文字:纯白(
#ffffff) - 内边距:12px 16px
- 边框:
1px solid #141414 - Hover:同样的暗色转移
- Active:Pale Yellow 文字
- 定位:「Get Started」/ 主要转化按钮
幽灵/描边按钮(Ghost / Outlined)
- 背景:透明
- 文字:纯白(
#ffffff) - 内边距:0 32px
- 圆角:4px
- 边框:
1px solid #4f5100(橄榄色调) - Hover:暗色背景转移
- Active:Pale Yellow 文字
- 定位:带霓虹调边框的次级操作
胶囊切换(Pill Toggle)
- 背景:透明
- 圆角:胶囊(9999px)
- 用途:开关/切换元素
在 components.html 中,按钮体系的实现细节值得关注:.btn-primary使用padding: 0 16px; height: 40px的紧凑结构,hover 时反转为近黑背景 + 霓虹文字(background: var(--accent-hover); color: var(--accent))——这是 DESIGN.md「hover 反转」决策的代码级落地;.btn-ghost的border-color: #4f5100对应 Border Olive;所有按钮 hover/active 均通过--motion-fast(150ms)+--ease-standard(cubic-bezier(0.2, 0, 0, 1))过渡,且:focus-visible统一使用霓虹调焦点环box-shadow: var(--focus-ring)。
4.2 卡片与容器
- 背景:透明或 Near Black
- 边框:
1px solid rgba(65, 65, 65, 0.8)——标志性的炭色收边 - 圆角:4px(小元素)或 8px(卡片、容器)
- Shadow Level 1(轻微):
rgba(0,0,0,0.1) 0px 1px 3px, rgba(0,0,0,0.1) 0px 1px 2px -1px - Shadow Level 2(中等):
rgba(0,0,0,0.1) 0px 10px 15px -3px, rgba(0,0,0,0.1) 0px 4px 6px -4px - Shadow Level 3(内嵌):
rgba(0,0,0,0.06) 0px 4px 4px, rgba(0,0,0,0.14) 0px 4px 25px inset——「按压」效果 - 霓虹高亮卡片:选中/激活卡片获得霓虹黄绿边框或强调
4.3 导航
- 黑底上的暗色导航栏
- Logo:ClickHouse 字标 + 黄/霓虹色图标
- 链接:白色文字,hover 变 Neon Volt(
#faff69) - CTA:Neon Volt 按钮或 Forest Green 按钮
- 分类使用大写标签
4.4 特色组件
性能数据(Performance Stats)
- 超大号数字(72px+,字重 700–900)
- 下方配简短描述
- 关键指标使用高对比霓虹强调
- 这是性能主张的核心视觉证明
霓虹高亮卡片(Neon-Highlighted Card)
- 标准暗色卡片 + 霓虹黄绿边框高亮
- 营造「选中」或「精选」处理
- 强调边框让卡片在暗色画布上脱颖而出
代码块(Code Blocks)
- 暗色表面 + Inconsolata 600 字重
- 霓虹与白色语法高亮
- 终端式美学
信任条(Trust Bar)
- 暗色背景上的公司 Logo
- 单色/白色 Logo 处理
- 水平布局
components.html 的组件清单与 components.manifest.json 精确对应:全夹具共 69 个选择器、38 个类、25 个元素,按 9 个组件组组织——buttons(按钮与 CTA)、inputs(表单与控件)、cards(卡片与面板)、badges(徽章与状态标签)、links(链接与行内操作)、keyboard(键盘提示kbd)、icons(图标插槽)、typography(字阶与文本工具类)、layout(布局原语)。例如.badge-success使用color-mix(in oklab, var(--accent), transparent 92%)生成低饱和霓虹底色、.stat-number使用--text-3xl+ 700 字重 +letter-spacing: -0.02em、.stat-number-accent把数字染成霓虹色。每个组件组的tokenReferences记录了它消费了哪些令牌,方便审查者核对一致性。
5. 布局原则(Layout Principles)
5.1 间距系统
- 基础单位:8px
- 刻度:2px、6px、7px、8px、10px、12px、16px、20px、24px、25px、32px、40px、44px、48px、64px
- 按钮内边距:12px 16px(标准)、0 16px(紧凑)、0 32px(宽幽灵按钮)
- 区块垂直间距:宽裕(48–64px)
tokens.css 将间距刻度收敛为 8px 基线的令牌序列(--space-1: 4px到--space-12: 48px),并把区块节奏固化为响应式变量:--section-y-desktop: 64px、--section-y-tablet: 48px、--section-y-phone: 32px。
5.2 栅格与容器
- 最大容器宽度:可达 2200px(超宽屏)并随响应式缩放
- Hero:全宽暗色 + 巨型字体
- 特性区块:多列卡片栅格 + 暗色边框
- 数据:水平指标条
- 全页暗色——没有浅色区块
仓库实现把工作默认容器定为--container-max: 1280px——足够承载多列密集数据布局,同时兼容常规桌面;注释明确说明 DESIGN.md 的上限 2200px 是超宽屏场景。三档容器内边距--container-gutter-desktop: 24px/-tablet: 16px/-phone: 12px与section + section { border-top: 1px solid var(--border) }的分隔策略在 components.html 中都有对应媒体查询实现(1023px 与 639px 断点)。
5.3 留白哲学
- 暗黑虚空即画布:纯黑背景提供无限深度——元素悬浮于黑暗之中。
- 信息密集:特性卡片与数据高度密集,映射数据库产品的性能导向。
- 霓虹高亮即导航:黄绿强调像跑道灯一样引导视线穿越暗色界面。
5.4 圆角刻度
- 锐利(4px):按钮、徽章、小元素、代码块
- 舒适(8px):卡片、容器、分隔线
- 胶囊(9999px):切换按钮、状态指示器
tokens.css 用--radius-sm: 4px/--radius-md: 8px/--radius-lg: 8px/--radius-pill: 9999px落地,并特意将 lg 也定为 8px,注释「DESIGN.md caps radius at 8px」——圆角上限 8px 是数据库精密几何的一部分。
6. 深度与层级(Depth & Elevation)
| 层级 | 处理方式 | 用途 |
|---|---|---|
| 扁平(Level 0) | 无阴影 | 黑色背景、文本块 |
| 描边(Level 1) | 1px solid rgba(65,65,65,0.8) | 标准卡片、容器 |
| 轻微(Level 2) | 0px 1px 3px rgba(0,0,0,0.1) | 轻微卡片抬升 |
| 抬升(Level 3) | 0px 10px 15px -3px rgba(0,0,0,0.1) | 特性卡片、hover 状态 |
| 按压/内嵌(Level 4) | 0px 4px 25px rgba(0,0,0,0.14) inset | 激活/按下元素——「沉入表面」 |
| 霓虹高亮(Level 5) | Neon Volt 边框(#faff69) | 精选/选中卡片,最大强调 |
阴影哲学:ClickHouse 在黑色画布上使用阴影时几乎不可见——它们存在的意义更多是微妙的立体感而非明显的抬升。最独特的深度机制是内嵌阴影(Level 4),它创造出 ClickHouse 特有的「按压入表面」效果。而霓虹边框高亮(Level 5)才是最主要的注意力捕获式深度机制。
tokens.css 对此的编码尤其坦诚:--elev-flat: none、--elev-ring: 0 0 0 1px var(--border)(炭色发丝线)、--elev-raised(为契约一致性保留的轻微阴影),注释直言「Shadows are barely visible on black — depth comes from borders」——真正的深度信号是边框。此外还提供了霓虹调焦点环--focus-ring: 0 0 0 3px color-mix(in oklab, var(--accent), transparent 70%),让焦点反馈始终向强调色偏移,与「链接 hover 全部变霓虹」形成统一交互信号。
7. 做与不做(Do's and Don'ts)
Do(应当遵守)
- 将 Neon Volt(
#faff69)作为唯一的彩色强调——它必须在纯黑上弹跳出来 - 英雄展示文字使用 Inter weight 900——极端的字重就是人格本身
- 一切保持纯黑(
#000000)——绝不用深灰代替页面背景 - 所有卡片收边使用炭色边框(
rgba(65,65,65,0.8)) - 主 CTA 按钮使用 Forest Green(
#166534)——与霓虹区分以形成操作层级 - 性能数据用超大号数字展示——这是核心视觉论证
- 区块标签使用大写 + 宽字距(1.4px)
- 激活/按下文字状态使用 Pale Yellow(
#f4f692)——而不只是改不透明度 - 链接 hover永远切换为 Neon Volt——统一交互反馈
Don't(严禁事项)
- 不要引入额外颜色——调色板严格限定为黑、霓虹、绿、灰
- 不要把霓虹用作背景填充——它只是强调与边框色(CTA 按钮除外)
- 不要把展示字重降到 700 以下——粗重是人格核心
- 任何地方都不要使用浅色/白色背景——整个体验是暗色的
- 圆角不要超过 8px——锐利几何反映数据库的精密性
- 不要在黑色上使用柔和/扩散阴影——它们不可见,改用边框实现深度
- 不要省略激活状态的内嵌阴影——「按压」效果是标志性的
- 不要使用暖中性色——所有灰都是完全中性的
这些约束在仓库中不仅是文档,还被 USAGE.md 强化为使用守则:「Avoid raw hex values outside the copied:roottoken block」(避免在令牌块之外使用裸十六进制色值)、「Avoid redefining Tailwind or design-token values independently oftokens.css」(避免脱离 tokens.css 单独重定义)、「Avoid adding new component recipes that are not represented incomponents.htmlorDESIGN.md」。
8. 响应式行为(Responsive Behavior)
8.1 断点表
| 名称 | 宽度 | 关键变化 |
|---|---|---|
| 手机(Mobile) | <640px | 单列,卡片堆叠 |
| 小平板(Small Tablet) | 640–768px | 微调 |
| 平板(Tablet) | 768–1024px | 双列栅格 |
| 桌面(Desktop) | 1024–1280px | 标准布局 |
| 大桌面(Large Desktop) | 1280–1536px | 内容扩展 |
| 超宽(Ultra-wide) | 1536–2200px | 最大容器宽度 |
8.2 触控目标
- 按钮最小内边距 12px 16px
- 卡片表面可作为触控目标
- 导航链接间距充足
8.3 折叠策略
- Hero 文字:96px → 72px → 48px → 36px
- 特性栅格:多列 → 2 列 → 1 列
- 数据条:水平 → 堆叠
- 导航:完整 → 汉堡菜单
8.4 图片行为
- 产品截图保持宽高比
- 窄屏上代码块使用水平滚动
- 所有图片都置于暗色背景上
在实现层,components.html 展示了两个代表性断点:1023px 以下容器内边距切到 tablet 档、hero 栅格从1.5fr 1fr双列降为单列;639px 以下切到 phone 档。这种「先桌面后收缩」的写法与 DESIGN.md 的断点表一一对应。
9. Agent 提示词指南(Agent Prompt Guide)
9.1 快速色彩参考
- 品牌强调:
Neon Volt (#faff69) - 页面背景:
Pure Black (#000000) - CTA 绿:
Forest Green (#166534) - 卡片边框:
Charcoal (rgba(65,65,65,0.8)) - 主文字:
Pure White (#ffffff) - 次文字:
Silver (#a0a0a0) - 激活状态:
Pale Yellow (#f4f692) - 按钮表面:
Near Black (#141414)
9.2 组件提示词示例
- 「在 Pure Black(
#000000)上创建一个 hero 区块:96px Inter weight 900、行高 1.0 的巨型标题,纯白文字;加一个 Neon Volt(#faff69)CTA 按钮(深色文字、4px 圆角、0 16px 内边距)和一个幽灵按钮(透明、1px solid #4f5100边框)。」 - 「设计一张黑底特性卡片:
1px solid rgba(65,65,65,0.8)边框、8px 圆角;标题 24px Inter weight 700,正文 16px Silver(#a0a0a0);再加一个霓虹高亮变体(1px solid #faff69边框)。」 - 「构建一个性能数据条:大数字 72px Inter weight 700 纯白;下方 14px Silver 简短描述;黑底。关键指标用
#faff69强调。」 - 「创建一个 Forest Green(
#166534)CTA 按钮:白色文字、12px 16px 内边距、4px 圆角、1px solid #141414边框;hover 时背景变#3a3a3a、文字 80% 不透明度。」 - 「设计一个区块眉标:14px Inter weight 600、字距 1.4px、大写;黑底 Silver(
#a0a0a0)文字。」
9.3 迭代指南(供 Agent 自检)
- 一切保持纯黑——不要用深灰替代
- Neon Volt(
#faff69)只用于强调与 CTA——绝不大面积背景 - Hero 用 900 字重、标题 700、标签 600、正文 400–500
- 激活状态用 Pale Yellow(
#f4f692)——而不是仅改不透明度 - 所有链接 hover 变霓虹——一致交互反馈
- 炭色边框(
rgba(65,65,65,0.8))是主要深度机制
10. 在 OpenDesign 中使用:包结构与落地路径
ClickHouse 设计系统在 OpenDesign 中不是孤立文档,而是一个完整的可移植设计系统包(portable design-system package)。从 design-systems/README.md 可知,每个包遵循同一套最小机器可读结构:manifest.json(发现元数据与来源声明)+DESIGN.md(面向 Agent 的规范正文)+tokens.css(编译后的语义令牌样式表)。
design-systems/clickhouse/manifest.json 记录了 ClickHouse 包的完整契约:id: "clickhouse"、category: "Backend & Data"、schemaVersion: od-design-system-project/v1、importMode: "normalized",并声明了丰富的衍生文件——design-tokens.json(Design Tokens JSON)、tailwind-v4.css(Tailwind v4 映射)、components.html(组件夹具)、USAGE.md(Agent 阅读顺序)、preview/(colors、typography、spacing 三个预览页)以及source/(来源证据与令牌契约报告)。craft字段建议在组合时叠加color与accessibility-baseline两条工艺基线。
Agent 的正确使用顺序(见 USAGE.md):
- 先读 USAGE.md 理解包契约
- 读 DESIGN.md 掌握视觉意图、约束与反模式
- 把
tokens.css粘贴到第一个产物(artifact)的<style>块开头,再写组件 CSS——保证所有色值都来自令牌 - 用
components.manifest.json做组件清单速查;需要精确选择器或状态时打开components.html - 需要视觉核对时查看
preview/页面
如果使用 Tailwind v4,可直接引入派生的 tailwind-v4.css——它通过@theme把全部令牌映射为 Tailwind 主题变量(--color-accent、--text-4xl、--shadow-focus-ring、--duration-fast等),但文件头明确声明「Derived from tokens.css. Keep tokens.css as the source of truth」,即tokens.css 才是唯一事实源,衍生文件只读不手改。
值得注意的是 source/evidence.md 的声明:该包是 OpenDesign 策展的 bundled fixture(内置夹具),并非对上游品牌官网的实时抓取——品牌引用包仅是美学灵感,而非所引用品牌的官方资产。这一点在事实边界上值得使用者留意。
结语
ClickHouse 设计系统演示了一种极端的克制美学:一个彩色强调色 + 绝对黑画布 + 极限字重 + 边框深度,就足以构建出「高性能、快、专业」的完整品牌叙事。它证明了暗色数据类产品不需要花哨的渐变或复杂的装饰——把对比度拉满、把字重用足、让边框承担深度,就是一套可复现、可工程化、可交给 Agent 执行的方案。在 OpenDesign 中,这套体系已经被完整编码为令牌、组件夹具与提示词指南,任何开发者和编码代理都可以直接消费它,为数据库、分析工具、开发者平台类产品快速生成风格统一的高质量界面。
【免费下载链接】open-design🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your coding agent becomes the design engine: prototypes, landing pages, dashboards, slides, images & video — real files, HTML/PDF/PPTX/MP4 export. 🤖 Claude Code / Codex / Cursor / DeepSeek Harness / OpenCode & 20+ CLIs via BYOK.项目地址: https://gitcode.com/gh_mirrors/opend/open-design
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考