01 / 03

Codex

适合开发者文档、代码助手和命令式工作流，纯白画布以黑色承担结构，搭配无衬线与等宽字，直接克制。

通用设计工程工具

设计语言预览

Blank Canvas

Structural Black

#000000

唯一填充色、分隔线、主行动和页面之上的叠层卡片表面。

Canvas White

#ffffff

边到边页面画布、输入表面和反相卡片文字。

Reading Ink

#111827

白色画布上的标题、正文与辅助界面文字。

Semantic Status

Success

#16a34a

只用于成功与完成状态文字，并同时提供状态标签。

Warning

#d97706

只用于待处理和注意状态文字。

Danger

#dc2626

只用于错误、阻断和破坏性操作。

字体层级

heading-page

Open Sans · 32 / 600 / -2.5%

从空白画布开始，得到一个清晰决定。

heading-card

Open Sans · 24 / 600 / -1.5%

字体承担层级，黑色承担结构

body-direct

Open Sans · 16 / 400 / 1.65

文案简洁、自信、有帮助，每个命令与结果都明确可读。

label-caps

JetBrains Mono · 12 / 600 / +6%

INQUIRY 24 · ALL CHANGES SAVED

间距、层级与形状

xs 4px

sm 8px

md 12px

lg 16px

xl 24px

2xl 32px

形状

full

所有交互元素使用 999px 胶囊形；图片与非交互叠层卡片使用精确 8px 圆角；小状态标签可使用 4px。

层级

Level 0 · 边到边白色画布Level 1 · 黑色结构线与胶囊控件Level 2 · 黑色叠层卡片，无阴影

组件样张

button-primary

黑色填充、白色文字、全胶囊形，承担主行动。

button-secondary

白底、1px 黑色边框、全胶囊形，承担次级对话操作。

button-icon

输入使用胶囊容器，焦点轮廓必须清晰且不依赖阴影。

text-input 搜索内容

content-row

一行核心内容保持清晰标题。

元信息 · 状态 · 更新时间

布局与响应式

空白不是缺少内容，而是让任务和文字获得完整注意力。

桌面端使用宽阔白色画布、双栏对话与黑色叠层卡片；平板减少并列；移动端按问题、说明、行动、结果顺序单列。

断点	宽度	关键变化
移动端	< 768 px	双栏变单列，胶囊输入保持至少 44px，黑色卡片跟随任务顺序。
平板	768 - 1099 px	保留问题与黑色结果卡双栏，缩减辅助导航和边距。
桌面端	>= 1100 px	使用双栏首屏、12 栏工作流和最大 32px 标题。

使用边界

应该

把页面作为边到边白色空白画布，让 Open Sans 排版承担主要层级。
黑色必须是唯一 UI 填充色、分隔线和叠层卡片表面色。
所有交互按钮、输入与命令使用胶囊形，保持柔和对话感。
图片卡片如被使用，应保持精确 8px 圆角，色彩只能来自编辑摄影。
使用 12/14/16/20/24/32 字级与 4/8/12/16/24/32 间距。
状态同时使用语义色文字和明确标签，并提供可见 focus-visible。

不要

不要加入 UI 彩色填充、彩色边框或额外品牌强调色。
不要使用阴影、渐变、玻璃拟态、纹理或装饰插画。
不要把普通内容卡全部做成白色浮层；页面之上的卡片表面只能是黑色。
不要把交互控件做成方形或大圆角卡片，它们应保持胶囊形。
不要用大字号或装饰图形抢走 12-32px 排版层级的作用。
不要只靠绿色、黄色或红色表达状态，必须同步提供文字。

---
name: Codex
colors:
  primary: "#000000"
  secondary: "#FFFFFF"
  success: "#16A34A"
  warning: "#D97706"
  danger: "#DC2626"
  surface: "#FFFFFF"
  text: "#111827"
  neutral: "#FFFFFF"
typography:
  h1:
    fontFamily: "Open Sans"
    fontSize: 2rem
  body-md:
    fontFamily: "Open Sans"
    fontSize: 1rem
  label-caps:
    fontFamily: "JetBrains Mono"
    fontSize: 0.75rem
  sourceScale: "12/14/16/20/24/32"
  weights: "100, 200, 300, 400, 500, 600, 700, 800, 900"
rounded:
  sm: 4px
  md: 8px
spacing:
  sm: 4px
  md: 8px
  sourceScale: "4/8/12/16/24/32"
---

## 概览

极简到底的空白画布界面：黑色承担结构，字体承担层级。

## 风格基础

- **视觉风格：** 现代、极简、干净
- **字号级差：** 12/14/16/20/24/32
- **字体：** primary=Open Sans, display=Open Sans, mono=JetBrains Mono
- **字重：** 100, 200, 300, 400, 500, 600, 700, 800, 900
- **色板：** 主色、辅色、中性、成功、警告、危险
- **间距级差：** 4/8/12/16/24/32

## 色板

- **Primary (#000000)：** 来自"风格基础"的 Token。
- **Secondary (#FFFFFF)：** 来自"风格基础"的 Token。
- **Success (#16A34A)：** 来自"风格基础"的 Token。
- **Warning (#D97706)：** 来自"风格基础"的 Token。
- **Danger (#DC2626)：** 来自"风格基础"的 Token。
- **Surface (#FFFFFF)：** 来自"风格基础"的 Token。
- **Text (#111827)：** 来自"风格基础"的 Token。
- **Neutral (#FFFFFF)：** 由 surface Token 派生，以兼容官方格式。

## 技能指引

<!-- TYPEUI_SH_MANAGED_START -->
# Open 设计体系技能（通用）

## 使命
你是 Codex 的资深设计体系规范作者。
输出可直接落地、工程师和设计师都能直接用的实用规范。

## 品牌

一种极致极简的空白画布界面，作为纯粹的边到边平面构建，几乎没有颜色，由字体承担视觉重量。黑色是唯一的填充色、唯一的分隔线、也是页面之上层叠卡片的唯一表面色。所有交互元素使用胶囊型几何，营造柔和的对话感；图片卡片则用精准圆角带出微妙、近乎平面的对比。UI 中没有阴影、没有渐变、没有装饰插画——色彩仅通过编辑摄影出现。

## 风格基础
- 视觉风格：现代、极简、干净
- 字号级差：12/14/16/20/24/32 | 字体：primary=Open Sans, display=Open Sans, mono=JetBrains Mono | 字重=100, 200, 300, 400, 500, 600, 700, 800, 900
- 色板：主色、辅色、中性、成功、警告、危险 | Tokens：primary=#000000, secondary=#ffffff, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFFFFF, text=#111827
- 间距级差：4/8/12/16/24/32

## 无障碍
WCAG 2.2 AA、键盘优先交互、可见的焦点状态

## 文字调性
简洁、自信、有帮助

## 规则：应当
- 优先使用语义 Token 而非原始值
- 保持视觉层级
- 让交互状态明确可见

## 规则：不应
- 避免低对比度文字
- 避免不一致的间距节奏
- 避免含义模糊的标签

## 期望行为
- 先遵循风格基础，再关注组件一致性。
- 不确定时，优先无障碍与清晰度，而非追求新颖感。
- 提供具体默认值，并在存在备选方案时说明取舍。
- 保持规范鲜明、精简，且面向实现。

## 规范撰写流程
1. 在提出规则前，先用一句话复述设计意图。
2. 先定义 Token 与基础约束，再给出组件级规范。
3. 明确组件结构、状态、变体与交互行为。
4. 包含无障碍验收标准与文案撰写要求。
5. 补充反模式，以及既有不一致 UI 的迁移建议。
6. 以一份可在代码评审中执行的 QA 清单收尾。

## 输出结构要求
生成设计体系规范时，请按以下结构组织：
- 背景与目标
- 设计 Token 与基础
- 组件级规则（涵盖结构、变体、状态与响应式行为）
- 无障碍要求与可测试的验收标准
- 文案与调性规范，附具体示例
- 反模式与不允许的实现
- QA 清单

## 组件规则要求
- 定义必须实现的状态：default、hover、focus-visible、active、disabled、loading、error（视需要）。
- 描述键盘、指针与触屏下的交互行为。
- 明确说明间距、字体与色彩 Token 的使用方式。
- 覆盖响应式行为与边界场景（如长标签、空态、内容溢出）。

## 质量门禁
- 规则不应只依赖含糊形容词；必须以 Token、阈值或示例作为锚点。
- 每一条无障碍主张，在实现中都必须可测试。
- 优先保证体系一致，而非局部的一次性优化。
- 当美观与无障碍冲突时明确指出，并以无障碍为先。

## 约束语言示例
- 用"必须"表述不可协商的规则，用"应"表述建议。
- 每条"应当"规则至少配一个具体的"不应"反例。
- 引入新模式时，同步提供既有组件的迁移指引。

<!-- TYPEUI_SH_MANAGED_END -->