01 / 03

Bento

适合功能总览、产品介绍和轻量仪表盘，不同尺寸的圆角卡片配桃粉、浅蓝和奶油底色，模块清楚而温和。

通用设计极简主义

设计语言预览

Modular Surfaces

Peach

#fad4c0

用于高优先级卡片和主模块表面，以深色文字保证对比度。

Muted Blue

#80a1c1

用于次级重点模块和数据卡片，搭配深色文字保证 AA 对比度。

Cream

#fff5e6

页面画布、柔和分区和低层级卡片表面。

White

#ffffff

主要内容卡片和需要更清晰分离的工作区。

Ink

#111827

标题、正文、边框和高对比主行动。

Semantic Status

Success

#16a34a

仅表示完成、正常和通过状态，并同时提供文字标签。

Warning

#d97706

仅表示待复核、临近期限和注意状态。

Danger

#dc2626

仅表示错误、阻断和破坏性操作。

字体层级

heading-page

Inter · 32 / 700 / -3%

所有重要信息，一眼就能掌握。

heading-card

Inter · 20 / 600 / -1.5%

让每个模块只承担一项任务

body-default

Inter · 14 / 400 / 1.5

用清晰、简洁且有帮助的文字说明状态、结果与下一步。

label-caps

JetBrains Mono · 12 / 600 / +8%

UPDATED 2 MIN AGO · STATUS READY

间距、层级与形状

xs 4px

sm 8px

md 12px

lg 16px

xl 24px

2xl 32px

形状

full

小控件使用 4px，卡片与按钮使用 8px；以平面色块、细边框和留白建立层级，避免 pill 与厚阴影。

层级

Level 0 · 奶油色页面画布Level 1 · 白色、桃粉或浅蓝模块表面Level 2 · 1px 细边框，不依赖阴影

组件样张

button-primary

深色填充、白色文字、8px 圆角，用于每个视图的唯一主行动。

button-secondary

白底、1px 深色边框、8px 圆角，用于次级浏览操作。

button-icon

状态必须包含明确文字，并实现 hover、focus-visible、active、disabled 和 loading 状态。

text-input 搜索内容

content-row

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

元信息 · 状态 · 更新时间

布局与响应式

用卡片跨度表达优先级，用稳定间距保持可扫读性。

桌面端使用 12 栏网格组合不同跨度的模块；平板减少为两栏；移动端按任务优先级折叠为单列，同时保持标签、状态和操作可见。

断点	宽度	关键变化
移动端	< 768 px	所有模块按语义顺序变为单列，触控目标至少 44px，长标签允许换行。
平板	768 - 1099 px	使用两栏简化网格，主要模块可跨两栏，次级模块保持单栏。
桌面端	>= 1100 px	使用 12 栏网格和不同跨度，卡片间距固定为 16px。

使用边界

应该

用不同卡片跨度建立清晰层级，让最重要的信息获得更大面积。
每张卡片只承担一个明确任务，标题、状态和行动标签必须具体。
使用 16px 网格间距、8px 卡片圆角和 4px 小控件圆角保持一致节奏。
桃粉与浅蓝用于模块表面对比，不作为无意义的装饰色块。
交互状态必须同时使用颜色、文字和可见的 focus-visible 焦点样式。
移动端保留桌面端的任务优先级与语义阅读顺序。

不要

不要让所有卡片尺寸完全相同，否则无法体现 Bento 的模块层级。
不要在一张卡片中混合多个无关任务、指标和行动。
不要使用大圆角或 pill 控件，它们不属于 4px / 8px 的形状规范。
不要引入渐变、发光、厚阴影或规范之外的强调色。
不要在桃粉或浅蓝表面使用低对比文字。
不要为了填满移动端空间而改变任务的优先顺序。

---
name: Bento
colors:
  primary: "#FAD4C0"
  secondary: "#80A1C1"
  success: "#16A34A"
  warning: "#D97706"
  danger: "#DC2626"
  surface: "#FFF5E6"
  text: "#111827"
  neutral: "#FFF5E6"
typography:
  h1:
    fontFamily: "Inter"
    fontSize: 2rem
  body-md:
    fontFamily: "Inter"
    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"
---

## 概览

Bento 便当式的模块网格：卡片分区、清晰层级、柔和留白与细腻对比，让内容井然可扫读。

## 风格基础

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

## 色板

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

## 技能指引

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

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

## 品牌

Bento 便当盒风格是一种创新的设计思路，用不同大小的网格块以视觉友好的方式组织内容。

## 风格基础
- 视觉风格：现代、干净
- 字号级差：12/14/16/20/24/32 | 字体：primary=Inter, display=Inter, mono=JetBrains Mono | 字重=100, 200, 300, 400, 500, 600, 700, 800, 900
- 色板：主色、中性、成功、警告、危险 | Tokens：primary=#FAD4C0, secondary=#80A1C1, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFF5E6, 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 -->