01 / 03

Claymorphism

适合儿童应用、趣味引导和轻娱乐产品，膨胀圆润的黏土式立体组件配鲜亮色面与柔软阴影，亲切有触感。

通用设计明快多彩

设计语言预览

Clay Surfaces

Primary Blue

#3b82f6

主行动、核心黏土模型和最高优先级内容面。

White Clay

#ffffff

蓬松组件、次级按钮和高对比模型表面。

Deep Blue Text

#1c398e

标题、正文、边框和浅色表面上的控件文字。

Semantic Status

Success

#16a34a

仅表达成功、完成与稳定状态，并同时显示文字。

Warning

#d97706

仅表达需要检查、临近和注意状态。

Danger

#dc2626

仅表达失败、错误和破坏性操作。

字体层级

display-playful

Poppins · 64 / 800 / -4.5%

几乎可以触摸的大想法。

heading-mission

Poppins · 40 / 700 / -3%

通过塑造模型理解概念

body-helpful

Montserrat · 16 / 400 / 1.6

说明简洁、自信、有帮助，让每一步和结果都容易理解。

label-caps

JetBrains Mono · 12 / 600 / +8%

MISSION 04 · READY TO TRY · STABLE ORBIT

间距、层级与形状

xs 4px

sm 8px

md 12px

lg 16px

xl 24px

2xl 32px

形状

full

功能控件使用 4px，按钮和卡片使用 8px；装饰模型可使用圆形与蓬松轮廓，但不能改变控件语义。

层级

Level 0 · 浅蓝白色画布Level 1 · 白色或蓝色黏土表面Level 2 · 内高光 + 柔软内阴影 + 16-28px 外投影

组件样张

button-primary

蓝色填充、白色文字、8px 圆角并带内高光与柔和外阴影，承担主行动。

button-secondary

白色黏土表面、深蓝文字、浅蓝边框，用于次级浏览。

button-icon

组件覆盖 default、hover、focus-visible、active、disabled、loading 和 error，焦点轮廓必须高于阴影可见。

text-input 搜索内容

content-row

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

元信息 · 状态 · 更新时间

布局与响应式

先保持任务层级，再让黏土体积增强可触感。

桌面端使用大模型、双栏首屏和不同跨度的黏土课程块；平板减少模型尺寸；移动端按任务优先级单列，并保留阴影边界和触控空间。

断点	宽度	关键变化
移动端	< 768 px	标题缩放至 46px，模型缩小，所有课程与任务卡按语义顺序单列。
平板	768 - 1099 px	使用双栏课程分组，核心模型占据一栏，辅助浮层减少。
桌面端	>= 1100 px	使用 64-70px 表现型标题、双栏首屏和 24px 组件间距。

使用边界

应该

用内高光、柔和内阴影和外投影让蓝白表面呈现可塑黏土体积。
所有主要组件共享同一黏土隐喻，不混入玻璃、金属或纸张效果。
Poppins 承担展示标题，Montserrat 承担正文，JetBrains Mono 承担状态标签。
主蓝与白色建立高对比，深蓝文字保证浅色表面可读性。
功能按钮与卡片保持 4-8px 规范圆角，圆形仅用于黏土模型和图形对象。
成功、警告和危险状态必须同时显示颜色与明确文字。

不要

不要把 Claymorphism 简化成普通圆角卡片加一层统一投影。
不要混用玻璃拟态、金属高光、纸张纹理或 Neobrutalism 硬偏移阴影。
不要引入规范之外的彩虹色或无语义装饰色。
不要用大 pill 控件代替 4-8px 的功能几何。
不要让高光和阴影降低文字、边框或焦点状态的对比度。
不要只依赖颜色表达任务结果或交互状态。

---
name: Claymorphism
colors:
  primary: "#3B82F6"
  secondary: "#FFFFFF"
  success: "#16A34A"
  warning: "#D97706"
  danger: "#DC2626"
  surface: "#FFFFFF"
  text: "#1C398E"
  neutral: "#FFFFFF"
typography:
  h1:
    fontFamily: "Poppins"
    fontSize: 3rem
  body-md:
    fontFamily: "Montserrat"
    fontSize: 1rem
  label-caps:
    fontFamily: "JetBrains Mono"
    fontSize: 0.75rem
  sourceScale: "desktop-first expressive scale"
  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"
---

## 概览

柔软圆润的类 3D 形态：像可塑黏土一样蓬松，表面色彩鲜活。

## 风格基础

- **视觉风格：** 现代、高对比、活泼
- **字号级差：** 桌面优先的富表现字号级差
- **字体：** primary=Montserrat, display=Poppins, mono=JetBrains Mono
- **字重：** 100, 200, 300, 400, 500, 600, 700, 800, 900
- **色板：** 主色、中性、成功、警告、危险
- **间距级差：** 4/8/12/16/24/32

## 色板

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

## 技能指引

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

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

## 品牌

一种现代 UI 潮流，特征是柔软、圆润、类 3D 的"胖乎乎"形状，模仿多彩、可塑的黏土。

## 风格基础
- 视觉风格：现代、高对比、活泼
- 字号级差：桌面优先的富表现字号级差 | 字体：primary=Montserrat, display=Poppins, mono=JetBrains Mono | 字重=100, 200, 300, 400, 500, 600, 700, 800, 900
- 色板：主色、中性、成功、警告、危险 | Tokens：primary=#3B82F6, secondary=#FFFFFF, success=#16A34A, warning=#D97706, danger=#DC2626, surface=#FFFFFF, text=#1C398E
- 间距级差：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 -->