# DESIGN.md 编写原则

DESIGN.md 是 slide-mcp 写类工具的前置设计契约。它只回答“这份 PPT 应该长什么样，以及 JSX 应如何落地”，不要重复完整叙事内容。

## 1. DESIGN 的输入

写 DESIGN 前应已有：

- 用户需求或材料摘要。
- 当前 PPT 状态脚本输出：页数、尺寸、是否空白、是否已有 DESIGN。
- 0-1 构建时的大纲：每页标题、类型、角色、核心观点、证据/素材。
- 必要的搜索事实卡片。

## 2. DESIGN 必填结构

```markdown
# DESIGN.md

## 1. 项目定位
## 2. 画布与母版
## 3. 色彩系统
## 4. 字体系统
## 5. 视觉策略
## 6. 页面映射表
## 7. JSX 落地约束
## 8. 自检门禁
```

## 3. 项目定位

必须写清楚：

- 主题：这份 PPT 讲什么。
- 受众：给谁看。
- 场景：汇报、路演、教学、评审、发布、内训等。
- 页数：预计总页数。
- 语气：例如专业理性、科技感、稳重正式、活力亲和。

## 4. 画布与母版

默认按 1280×720 设计。若工具返回 960×540，仍按 16:9 等比布局。

常规页采用三区母版：

| 区域 | px 范围 | 用途 |
|---|---:|---|
| A 标题区 | y=0-120 | 页标题、章节标识 |
| B 内容区 | y=120-660 | 正文、图表、图片、卡片 |
| C 页脚区 | y=660-720 | 项目名、来源、页码 |

必须声明：

- 左右安全边距，默认 60-80px。
- 标题、页码、来源、角标的位置。
- 封面、章节页、结束页是否突破常规母版。

## 5. 色彩系统

色彩池不超过 4 个主色，必须写具体 hex。

| 角色 | 说明 |
|---|---|
| 背景色 | 全局默认背景 |
| 主色 | 标题、大色块、关键结构 |
| 辅色 | 卡片、线条、图表第二层级 |
| 强调色 | 只用于焦点元素 |
| 文本色 | 主文本和弱文本 |

约束：

- 单页不得出现两套主色板。
- 常规页强调色面积 ≤ 10%。
- Hero 页强调色面积可到 15%-20%。
- 全篇至少 2 页色彩重量明显不同，避免流水线感。

## 6. 字体系统

必须写字体名、字号、字重、行高。

| 层级 | 推荐范围 | 用途 |
|---|---:|---|
| 封面主标题 | 56-72px | 封面 |
| 页面标题 | 28-32px | A 标题区 |
| 巨型数字/锚点 | 48-80px | Hero/数据冲击 |
| 卡片标题 | 18-22px | 模块标题 |
| 正文 | 16-18px | 正文段落 |
| 注释/页码 | 11-12px | 页脚、来源 |

要求：

- 中文字体和英文/数字字体分开声明。
- 禁止只写“默认字体”。
- 视觉锚点必须和正文形成明显层级差。

## 7. 视觉策略

必须说明：

- 主视觉类型：摄影、插画、3D、SVG 结构图、图表。
- 哪些页面需要 L1 主视觉。
- 哪些页面使用图表、流程图、时间线、矩阵、架构图。
- 装饰规则：背景纹理、分割线、角标、几何元素。

约束：

- 每页至少一个视觉锚点：大图、巨型数字、大色块、核心图表或结构图。
- 内容页 B 区横向填充率 ≥ 70%。
- 内容页 B 区纵向填充率 ≥ 70%。
- 常规页留白 ≤ 35%；Hero 页可放宽，但留白必须围绕焦点。
- 禁止把 200×70 小图片塞进标题区充当主视觉。

## 8. 页面映射表

DESIGN 必须把大纲逐页转成可执行设计表：

| # | 类型 | 角色 | 版式 | 核心内容 | 视觉元素 | 色彩分配 | 密度 | JSX 关键约束 |
|---|---|---|---|---|---|---|---|---|
| 01 | cover | hero | 全幅图+骑线标题 | 开场主张 | L1 主视觉 | 主色60/强调15 | 文字约30/留白35% | 主标题≥60px |
| 02 | catalog | supporting | 左标题+右目录 | 章节导航 | L3 角标 | 主色30/辅色20 | 文字约80/留白25% | 页脚固定 |

字段要求：

- `核心内容` 写内容意图，不复述完整文案。
- `视觉元素` 明确 L1/L2/L3、图表或 SVG。
- `JSX 关键约束` 写尺寸、位置、最小字号、禁止项。

## 9. JSX 落地约束

写明全局 JSX 规则：

- `<Slide>` 画布 1280×720。
- 页面安全区和母版区边界。
- 统一页脚/页码写法。
- 组件使用偏好：Text、Box、Image、Chart、Table、SVG 等。
- 图片资源命名规则：英文、无空格、无特殊字符。

## 10. 自检门禁

不满足以下任一项，重写 DESIGN：

- 有具体 hex。
- 有具体字体、字号、行高。
- 有母版 px 边界。
- 有逐页页面映射表。
- 每页有视觉锚点。
- 每页有密度和留白约束。
- 每页有 JSX 关键约束。
- 没有重复大纲的完整叙事。
- 能直接指导 `slide_add_page_with_jsx` 生成页面。