--- name: cherry-studio-design-language description: Cherry Studio 品牌设计语言 v1.0（20 张截图+Logo 提炼）+ 51 页飞书 PPT 模板库（场景索引/CLI 工作流/排障）。做 PPT/海报/封面/招商材料等任何 Cherry 视觉设计时使用，确保风格统一且可直接套模板。 version: 1.0.0 license: MIT platforms: [macos, linux] metadata: hermes: tags: [design, cherry-studio, ppt, brand, 设计语言, 品牌规范] ---

# Cherry Studio 设计语言 v1.0

> ⭐ **默认模板（2026-08-19 定稿，2026-08-20 更新定位）**：本 skill 是 Cherry Studio 相关 PPT 的默认设计系统。

> **70/30 使用策略（2026-08-20 用户定稿）**： > - **70% 遵循模板**：优先使用模板库（templates/）的页面骨架、布局模式、设计令牌与组件样式——保证跨页一致性（页眉/标题区/页脚稳定，翻页不跳动） > - **30% 自由发挥**：内容与模板版式不贴合时，允许在**内容区**内自由组合组件、调整卡片数量与密度、增减装饰——贴合内容表达 > - **底线（100% 必须满足）**：排版准确——对齐、居中、不重叠、不溢出、不越界；自由只发生在内容区，骨架（页眉/标题/页脚）不动；任何改动必须过三级校验 + 截图目检 > - **判断标准**：模板是默认选项，自由是有理由的例外；拿不准先用模板，内容确实塞不下再微调

> **模板优先流程（2026-08-20 用户定稿，制作 PPT 必走）**： > 1. **先搜索模板，再想布局**：接到任何一段内容，先翻 `templates/INDEX.md` 的场景索引，找有没有**贴合或稍加改造可用**的模板页（如"四步流程"找 P26、"问题方案"找 P13/P35、"数据对比"找 P25/P36） > 2. **匹配就用/改造，不新建**：找到了就用该模板页，只做内容替换 + 必要微调；**不要从零新建一套布局**（51 页模板覆盖了绝大多数场景） > 3. **没有匹配才新建**：只有 INDEX.md 里找不到贴合场景时，才允许用组件库自由组合新建页面 > 4. **Lucide 图标尺寸规范**：Lucide 只做**小尺寸装饰 icon**（≤40px，用于卡片标题/列表项/标签），**禁止放大做主视觉**（线条风格放大后细节不足、显呆板）；大尺寸视觉用 `<img>`（生图）或 `<chart>`（图表） > - **模板描述即场景**：INDEX.md 每页的「适用/适合内容」就是搜索依据——内容与描述匹配 = 用该页

> **模板严格场景规则（2026-08-20 用户定稿）**： > 1. **目录模板有严格应用场景**：P07（编号列表）只用于 **5 章节**目录、P08（卡片网格）只用于 **6 章节/主题**、P09（进度条）只用于**长 deck 分节定位**——**必须严格遵守页数要求**，不要往目录模板硬塞不同数量的章节（如 P07 塞 8 个 = 误用） > 2. **套模板必须清理全部模板文字**：交付前把每页 `<p>` 全部列出，检查有无模板原话残留（如「结论：先明确希望听众记住什么。」「每一步都有明确输入、负责人和可验证输出。」）——**正文、结论条、统一原则、底部说明都要换干净**，只留品牌名/页脚 > 3. **编号列表 ≠ 内容卡**（2026-08-20 用户定稿）：P16/P26 等编号列表模板**只用于流程/步骤/要点**；表达「痛点/机会/对比」等内容时用**卡片墙/双栏对照/2×2 网格**（卡片化表达），不要用编号列表（视觉上像目录，不贴合内容） > 4. **禁止空文本框（2026-08-20 用户定稿）**：交付前**必须扫描删除所有空文本框**（`<shape type="text"><content...><p></p></content>` 或无 `<p>` 的 content）——飞书渲染时会在空文本框显示「点击添加正文」占位符，很丑；模板右上角标注（如「封面 · 左对齐大标题」）替换后若留空框，必须整体删除该 shape（不是清空文字） > 在线预览：https://mcnnox2fhjfq.feishu.cn/slides/Tm0as9VdtlFknLdYX4BcOJdin4b

> **与其他 skill 的关系（重要）**：本 skill 是 Cherry 品牌设计语言与 51 页模板库。当用户要求 Cherry 风格/套用本库模板时，**本 skill 优先于 `lark/lark-slides` 的通用设计原则**（如"信息密度极高""禁止装饰线条"等通用规则，本库按品牌需求采用极简+留白+彩线）。但**必须继续遵守 lark-slides 的硬性技术规则**：960×540 画布边界、fontSize 显式设置、`<img>` 元素、lineSpacing 写法、图表用 `<chart>`、表格行高合计=表格高度。技术排障以 `lark/lark-slides` 官方为准，本 skill 的排障表是实战备忘。

> 依据 20 张官网与桌面端截图 + 官方 Logo 提炼。所有视觉产出（PPT/海报/封面/招商材料）应遵循本规范。

## 设计理念

**以温和的中性色构建专业秩序，用克制而多元的色彩表达 AI 的开放、友好与创造力。**

- 现代：系统无衬线字体、模块化网格、真实产品界面 - 极简：暖白画布、细边框、大留白、少装饰 - 友好：柔和圆角、浅彩色图标底、珊瑚红品牌色 - 专业：黑色主 CTA、清晰层级、稳定对齐、真实数据

核心不是"科技炫酷"，而是"可信赖的日常 AI 工作台"。中性色负责结构，彩色负责识别和引导。

---

## 色彩系统

### 核心中性色

| 令牌 | 色值 | 使用场景 | |---|---:|---| | Canvas | `#FAFAF9` | 主画布、背景 | | Surface | `#FFFFFF` | 卡片、面板 | | Subtle | `#F7F7F6` | 次级区域 | | Hover | `#F3F3F2` | 悬停背景 | | Selected | `#EFEFEE` | 选中状态 | | Text/Primary | `#171717` | 标题、关键数字（勿用纯黑 #000） | | Text/Body | `#55555B` | 正文 | | Text/Secondary | `#77777E` | 副标题、元信息 | | Text/Muted | `#96969C` | 占位、说明 | | Border/Default | `#E8E8E6` | 卡片边框 | | Border/Strong | `#DCDCD9` | 需明确识别的控件 | | Action/Black | `#0A0A0A` | 主 CTA 按钮 |

### 模板实际色板（追认，2026-08）

模板库（51 页）经深度 review 后实际用色，**与上方规范兼容但更精确**，agent 套模板时**以模板实际色值为准**，不要按上方规范"纠正"模板：

| 令牌 | 色值 | 使用 | |---|---|---| | Text/Body 实 | `#48484E` (72,72,78) | 正文（比规范 #55555B 略深，投影更清晰）| | Text/Header 实 | `#696970` (105,105,112) | 页眉/页脚/水印 | | Border/Default 实 | `#D6D6D2` (214,214,210) | 卡片边框（比规范 #E8E8E6 深，更鲜明）| | Table/Header 实 | `#F5F5F4` / `#F7F7F6` | 表格表头浅底 | | Table/Alt 实 | `#F0F0EE` / `#EEEEEC` | 表格交替行 | | Brand/Light 实 | `#FDEDED` (253,235,237) | 推荐行浅红（比规范 #FFF0F1 深一档）| | Text/Weak 实 | `#58585F` (88,88,95) | Logo 墙占位文字 | | Dark/Canvas 实 | `#111111` (17,17,17) | 深色仅作局部 CTA/章节卡背景（深色整页已禁用）| | Dark/Text 实 | `#A8A8AD` (168,168,173) | 深色页正文 |

### 品牌色：珊瑚红

| 令牌 | 色值 | 场景 | |---|---:|---| | Brand/Primary | `#FF5A5F` | Logo、品牌识别 | | Brand/Dark | `#F24D53` | 按压态 | | Brand/Light | `#FFF0F1` | 图标底 | | Brand/Border | `#FFC9CB` | 品牌浅描边 |

规则：品牌红不承担全部交互；不做大面积红色渐变；与 AI 多元色不同时大量出现。

### AI 多元色

| 色系 | 主色 | 浅底色 | 场景 | |---|---:|---:|---| | 粉 | `#F45D9B` | `#FFF0F6` | 智能对话、关键词下划线 | | 青 | `#2BC9D1` | `#ECFBFC` | Agent、连接、流程 | | 紫 | `#A66BEA` | `#F6EEFF` | 创作、绘图、助手 | | 蓝 | `#589EF7` | `#EDF5FF` | 对话、工具 | | 绿 | `#22C76A` | `#ECFAF2` | 在线、成功 | | 黄橙 | `#F5A623` | `#FFF5E5` | 性能、效率 |

用法：2-4px 关键词下划线、8-10px 状态圆点、48-64px 图标浅色底座、选中卡片 1px 彩色描边。 避免：六色同时大面积填充、混用两种强调色于同一组件。

### 色彩比例

- 82-88%：白/暖白/极浅灰 - 9-14%：黑灰文字/边框/黑按钮 - 3-5%：品牌色 + AI 多元色

深色页禁用：整页深色背景 / 大面积深色填充块均禁用（黑仅用于文字与图标线条）。

---

## 字体排版

### 字体栈

```css font-family: Inter, "SF Pro Display", "PingFang SC", "HarmonyOS Sans SC", "Microsoft YaHei", sans-serif; ```

- macOS 中文：PingFang SC - 跨平台：HarmonyOS Sans SC / 思源黑体 - 英文数字：Inter / SF Pro - 不用衬线、圆体、艺术字、未来主义字体

### PPT 字号映射（16:9, 1920×1080）

| 层级 | 字号 | 字重 | |---|---:|---:| | 封面标题 | 48-60 pt | 700-800 | | 章节标题 | 40-48 pt | 700-800 | | 内容页标题 | 28-34 pt | 650-700 | | 数据数字 | 42-64 pt | 700-800 | | 卡片标题 | 18-22 pt | 600-700 | | 正文 | 14-17 pt | 400-500 | | 标签 | 11-13 pt | 500 | | 页脚 | 9-11 pt | 400 |

> **飞书 SML 模板（960×540 画布）实际字号**（模板库为准，字号即 pt）： > 封面标题 36-40 / 章节标题 40 / 内容页标题 28-30 / 数据数字 42-64 / 卡片标题 16-18 / 正文 12-14 / 标签 10-11 / 页脚 10。 > 套模板时**用实际字号，不按 1920 表缩放**；替换文字后以 xml_lint 溢出检查为准。

### 间距

- 大标题行高 1.05-1.15；正文 1.5-1.65；卡片标题 1.25-1.35 - 标题-副标题 16-24px；副标题-主体 40-64px；卡片标题-正文 12-16px - 8px 基础间距单位：4/8/12/16/24/32/48/64/96

### 文案原则

- 一页一个观点、一卡一个概念 - 标题一行；副标题一句话或用中点连 3-4 短语 - 正文每卡 ≤3 行，不靠缩小字号 - 数字前置："50+ AI 服务商" - 关键词用粗体 + 彩色短下划线（3-4px 厚），不整段变色 - 外链用 ↗ 箭头，不另放冗余按钮

---

## 布局系统

- 12 栏网格，左右边距 96px，栏间距 24px，单栏约 122px（1920 宽） - 顶部安全边距 64-72px，底部 56-72px - 内容占画布 55-70%，其余留白 - 对齐：官网标题居中、产品界面左对齐；一页一个主对齐轴 - 层级顺序：留白 > 字号字重 > 背景差 > 细边框 > 局部色彩 > 阴影

### 页面结构模板

- **封面**：品牌 → 主张 → 行动 → 产品证明（上下结构） - **章节页**：居中大标题 + 编号 + 一行浅灰说明 + 彩线（留白 60%） - **内容页**：3×2 功能卡 / 2×2 长卡 / 左截图右说明卡 / 徽章+Logo 矩阵 - **CTA 页**：一个结论 + 一个黑色主按钮 + 二维码/联系入口

### 卡片系统

| 类型 | 圆角 | 内边距 | 边框 | 阴影 | |---|---:|---:|---|---| | 标准信息卡 | 16-20px | 24-32px | 1px #E8E8E6 | 无/S | | 大功能卡 | 20-24px | 30-36px | 1px #E8E8E6 | 通常无 | | 产品面板 | 18-22px | 20-28px | 1px #E8E8E6 | 无 | | 产品截图容器 | 20-28px | 0-16px | 1px #E5E5E3 | M/L | | 标签 | 14-18px | 6×14px | 通常无 | 无 |

---

## 组件规范

### 按钮

主按钮：黑底 `#0A0A0A`、白字 16-18px/600、高 48-54px、圆角 14-16px、无阴影。 次按钮：白底/透明、1px `#DEDEDC` 描边、文字 `#55555B`、高 38-42px、圆角 10-12px。 **一组按钮只允许一个黑色实心。**

### 标签与徽章

属性标签：高 30-34px、圆角 15-17px、`#F6F6F4` 底、文字 14-16px `#77777E`。 荣誉徽章：高 64-72px、白底、第三方品牌色描边、保留原始标志。

### 图标

- 默认 20-24px、大功能 26-32px、线宽 1.5-2px、圆角端点 - 容器 56-64px、圆角 14-18px、AI 色浅底 + 对应主色图标 - 统一线性或简化面性，不混 3D/拟物/插画

### 产品截图展示

- 桌面壳层：macOS 三色圆点 + 顶部标签栏 + 左侧 72-76px 图标栏 - 窗口圆角 24-30px、边框 1px `#E5E5E3` - 保留窗口顶部 56-68px 壳层，周围留 ≥32px 空白 - 聚焦弹窗时外围降至 30-45% 不透明度 - 多图统一缩放/圆角/阴影方向

### 状态元素

- 状态圆点：8-10px 直径，绿色 `#22C76A` 表示在线/成功 - 彩线下划线：3-4px 厚、距基线 3-5px、覆盖关键词 70-100%、每行 ≤3 处、关键词保持黑色

---

## 阴影体系

| 层级 | 参数 | 场景 | |---|---|---| | S | 0 2px 8px rgba(20,20,20,.04) | 小浮层 | | M | 0 8px 24px rgba(20,20,20,.06) | 输入框、弹窗 | | L | 0 16px 40px rgba(20,20,20,.08) | 主产品截图 |

规则：中性黑灰、不带蓝紫；不叠加厚边框+重阴影；同页阴影一致；静态卡片优先无阴影。

---

## 反模式（17 条）

1. 大面积蓝紫渐变、霓虹光晕、"赛博 AI"背景 2. 珊瑚红铺满整页、所有按钮做成品牌红 3. 同页大量高饱和彩色填充 4. 每卡重阴影、玻璃拟态、发光描边 5. 小圆角硬矩形或全胶囊 6. 纯黑大面积背景作为常规内容页 7. 艺术字、科技字体、斜体中文、过宽字距 8. 无意义粒子/网格/波纹/装饰球填满页面 9. 卡片正文超 4 行或缩小字号硬塞 10. 一页多个核心观点 + 多个黑色 CTA 11. 产品截图裁掉窗口特征或透视倾斜 12. 混用线性/3D/照片/卡通图标 13. 用彩色文字替代关键词下划线 14. 统一重绘第三方荣誉徽章 15. 只靠颜色传达状态 16. 粗黑边框、强烈分割线、高对比棋盘区块 17. 原样引用截图里时效性数字/模型名，不重新核实

---

## PPT 落地规范（1920×1080, 16:9）

### 全局

- 背景 `#FAFAF9`；安全区左右 96px、顶 64px、底 56px - 12 栏网格，栏距 24px - 页标题左边线 X=96；页脚基线 Y=1024 - Logo 左上角：X=96、Y=64、宽 150-190px - 每页只有一个黑色主行动元素

### 封面母版

- Logo X=96 Y=64 W≈180 H≈44 - 主标题 X=96 Y=240 W=850-1050 H=150（48-60pt） - 副标题 X=96 Y=420 W=780 H=70 - CTA X=96 Y=520 W=210-260 H=56 - 产品窗口 X=880 Y=185 W=920 H=720 - 或居中版：主标题 X=260 Y=190 W=1400 居中；产品截图 X=280 Y=560 W=1360 底部可裁切

### 章节页

- 编号 X=160 Y=250 14-18pt 彩色；主标题 X=160 Y=310 W=1600 40-48pt - 副标题 X=160 Y=420 W=1200 18-22pt；标题关键词下 4px 彩线 - 深色章节页 ≤20%，深色背景 `#111111`、文字白、辅助 `#A8A8AD`

### 内容页

- 眉题 X=96 Y=64；标题 X=96 Y=105 W=1500 28-34pt；结论 X=96 Y=170 16-20pt；内容起始 Y=250 - 页码 X=1770 Y=1015 9-11pt `#96969C` - 3×2 功能卡：内容区 X=96 Y=270 W=1728 H=680，单卡 W=560 H=318，间距 24px，内边距 32px，图标 60×60 - 2×2 优势卡：左卡 X=96 右卡 X=972，单卡 W=852 H=300，内边距 32-40px - 左截图右卡：截图 X=96 Y=280 W=840 H=650；右侧 2-3 张纵向卡 X=984 W=840

### 数据卡

- 400-550×230-300px、圆角 18-20px、内边距 28-32px - 大数字 44-60pt `#171717` + 数字下 3px 彩线 - 标题 18-21pt/600、说明 13-15pt `#77777E` - 不用饼状渐变或仪表盘装饰

### 对比卡

- 左右等宽、间距 24px、白底浅边框 - 推荐方案：1px 品牌红/AI 色描边 + "推荐"浅色标签 - 支持项用简洁勾选，不支持用浅灰短横线 - 最多 6-8 个维度，重要差异粗体+彩线

### 流程卡

- 水平 3-5 步：01 → 02 → 03... - 每步 W=280-320 H=180-220 圆角 18px - 编号 14-16pt 浅灰/彩色、图标容器 48-56px、步骤名 18-20pt/600 - 连接线 1-2px `#DCDCD9`；关键步用青/紫描边

### 章节编号/页码/页眉页脚

- 章节编号格式 `01 / 市场机会`，11-14pt，编号用 AI 色 - 页码右下 `08 / 24` 或单独 `08`，9-11pt `#96969C`，封面/章节页可隐藏 - 页眉左章节名/Logo，右材料属性"合作伙伴计划 · 2026"，9-11pt - 页脚左来源，右页码；联系方式集中在 CTA 页

---

## Review 能力（排版检查 + 设计护栏）

**三级准出链**（2026-08-20 升级）： 1. **官方 schema**：`xml_lint.py` → error_count=0（技术合法性） 2. **排版检查**：`scripts/review_layout.py` → errors=0, warnings=0（越界/溢出/重叠/错位） 3. **设计护栏**：`scripts/review_design.py` → errors=0（颜色白名单/字号层级/结论条/CTA/深色页），warnings 人工裁决

```bash python3 scripts/review_design.py --dir templates/ # 目录全检 python3 scripts/review_design.py --input slide.xml # 单文件 ```

**设计护栏检查项（G1-G8）**： - G1 颜色白名单：所有颜色必须来自 `tokens.yaml`（单一来源），禁止自由近似色 - G2 强调色限量：每页高饱和强调色 ≤2 种（珊瑚红 + ≤1 个 AI 色） - G3 字号层级：页标题 28-30 / 卡标题 16-18 / 正文 12-14 / 标签 10-11；正文 <10 报错 - G4 结论组件可选：如用结论，**禁止页面底部（y>430）横贯式长胶囊条**；结论可用内容区内短条/卡片（宽度 ≤420、圆角 ≤12） - G5 CTA 唯一：每页行动按钮 ≤1，**禁用黑色填充 CTA**（白底 + 珊瑚红描边） - G6 排版底检：越界/负坐标/溢出/重叠（沿用 review_layout） - G7 密度与留白：内容区占画布 55-70%，单卡正文 ≤4 行 - G8 深色禁用：**整页深色背景禁用；大面积深色填充块禁用**（黑仅用于文字）

本 skill 自带排版 Review 脚本：`scripts/review_layout.py`，创建/修改模板后**必须**跑一遍，自动检查：

| 检查项 | 检测内容 | |--------|----------| | 越界/负坐标 | 元素超出 960×540 画布或负坐标 | | 文本溢出 | 单行超宽 / 多行超框（含 wrap 自动换行估算） | | 文本重叠 | 两个文本元素实际文字区域相交（排除装饰引号、框虚宽） | | 重复属性 | 同一标签内属性名重复（XML 隐患） | | 空段落 | `<p></p>` 空段落 | | 字面换行 | `<p>` 内的 `\n`（渲染时可能被省略） | | 一致性 | 页眉 Logo 位置、页脚 Y 坐标 |

**用法**： ```bash # 检查整个模板库 python3 scripts/review_layout.py --dir templates/ # 检查单个文件 python3 scripts/review_layout.py --input slide01.xml # JSON 输出（供脚本解析） python3 scripts/review_layout.py --dir templates/ --json ```

**准出标准**：`errors=0, warnings=0` 才算通过。warning 允许人工判断（如封底稀疏内容属预期）。

**配合**：官方 `xml_lint.py`（schema 语法）+ 本脚本（排版布局）+ 截图目检（渲染最终确认），三者为完整 Review 链。

## 组件库（2026-08-20 从 V3.0 合作方案 PDF + 51 页模板提炼）

制作 PPT 时**按内容选组件自由组合**，不必完整套用模板页。所有组件遵循白底设计语言（PDF 深色风格已转白底版）：

| 组件 | 用途 | 规格 | |------|------|------| | **双栏对照卡** | 客户/伙伴、问题/方案、强项/弱项 | 左右等宽等高（各 ~380px），顶部色条区分（左珊瑚红 #FF5A5F / 右科技青 #37D8FF 或黑），细线边框 #D6D6D2，内留白 16px | | **四步流程卡** | 合作模式/行动步骤 | 4 张横排卡（各 ~200px），序号圆标（珊瑚红底白字），箭头连接（细线 + 三角） | | **大数字对比** | 定价/ROI/数据 | 超大数字（48-64pt 黑粗体）+ 标签（次要灰），横向排列，中间连接符（→/=/vs） | | **三标签徽章** | 封面/章节页 | 3 个胶囊标签（圆角 16px、浅灰底 #F5F5F3、黑字），可加珊瑚红强调 | | **要点列表卡** | 功能/特性 | 白卡 + 细边框，左侧珊瑚红圆点，标题粗黑 + 说明次要灰 | | **短结论卡（可选）** | 收束要点 | 浅红底 #FDEBED + 珊瑚红字，内容区内短条（宽度 ≤420、圆角 ≤12；**禁 y>430 横贯长条**） | | **角色色编码** | 合作双方区分 | 甲方用珊瑚红 #FF5A5F，乙方用科技青 #37D8FF（白底版），贯穿卡片/圆点/线条 | | **细线分区** | 标题与内容区分 | 标题下方 1px #D6D6D2 分隔线，宽度 ~820px |

**组合原则**：每页 1 个主标题 + 1 类核心组件；高饱和色（珊瑚红/青）每页 ≤3 处；文字层级 主标题 30pt → 卡标题 18pt → 正文 13-14pt → 说明 10-11pt。

## 模板库（51 页布局，参考页）

`templates/` 目录含 **51 页完整布局 XML**（960×540 飞书 slides 格式）+ `INDEX.md`（51 页场景索引与选择指南，每页标注适用场景/结构/示例/替换指引）。 **在线预览**：https://mcnnox2fhjfq.feishu.cn/slides/Tm0as9VdtlFknLdYX4BcOJdin4b （51 页完整版，可直接打开对照）

### 使用流程（6 步，不可跳过）

1. 读 `templates/INDEX.md` 按内容类型定位最合适布局（或用下方决策树） 2. 复制模板 + Logo 到工作目录（**从 skill 根目录拷**）： ```bash SKILL_ROOT=~/.hermes/skills/creative/cherry-studio-design-language cp $SKILL_ROOT/templates/slideXX.xml ./my-slide.xml cp $SKILL_ROOT/assets/cherry-logo.png ./cherry-logo.png test -f ./cherry-logo.png # 门禁：图片必须到位（lint 不查图片存在性） ``` 3. 替换内容（**注意**：模板是"示例内容"，不是 `[占位]` 占位符——按 INDEX.md 每页的"必换字段"清单定点替换：标题、数据、图片、邮箱、年份、右上版式名、页脚 Internal Template；禁止把示例数据/虚构客户/邮箱直接交付。**版式可微调**：内容多少与模板不符时，允许按上方"替换原则"调整卡片尺寸/间距/字号/模块数，以内容呈现最优为准，但保持品牌视觉规范） 4. 校验（**官方准出**）：`xml_lint.py`（当