---
name: slidep-pro
description: 汇报级 PPT 工场——用 slidep/Tencent-pptx 引擎产出高质量可编辑 .pptx 的完整方法论。触发词：做PPT、生成演示文稿、汇报PPT、PPT美化、高质量幻灯片。覆盖叙事骨架、双风格视觉系统、逐页校验、图文混排、原生图表与常见坑修复。
agent_created: true
---

# slidep-pro · 汇报级 PPT 工场方法论

> 核心认知：**slidep 是画布引擎，不是审美引擎**。出图丑是执行层问题；审美靠「叙事骨架 + 风格系统 + 细节纪律」拉满。

## 一、引擎死规则（违反即失败）

- 只用 slidep / Tencent-pptx（JSX DSL），严禁 python-pptx 等替代工具。
- 画布固定 1280×720；内容高度必须显式计算：`上padding + 标题区 + 内容区 + 间距 + 下padding ≤ 720`。
- 布局只用 flex；**禁止** `display:grid`、`calc()`、`import/export`；文件最后一个表达式必须是 `<Slide>`。
- **禁止 `map()` 批量生成节点**——手写每个元素。
- 页脚页码用表达式字符串 `{`04 / 12`}`，防止 `04` 被误判为整数。
- 装饰元素用 `position:absolute` 时**严禁负偏移**（`right:-80` 这类会触发 CONTENT_OVERFLOW，且报错显示 "0 overflow(s) [unknown]" 极具迷惑性）——装饰一律放画布内正坐标。
- `Slide` 的 padding 是安全区，不得用绝对定位绕过。

## 二、标准工作流（六步）

### Step 1 · 叙事骨架（STORY.md）
动笔前先回答：目标受众/核心目标/页数（Hero 页占 20-30% 且不相邻）/视觉调性三到五个词/内容边界（必讲与禁碰）。
再排骨架：目录声明 N 章 → 必须恰好 N 个章节扉页一一对应；每页标 `role`(hero/supporting/transition)、`rhythm`(peak/valley/transition，连续≥3个valley必须打破)、`layout`（非对称版式占比≥40%，相邻页版式不重复）、`visual`(L1主视觉/L2支撑/L3角标)、`anti_pattern`（写具体禁止项，不写空话）。
含数据的页必须写成「数据+判断」两段式，禁止只摆数字。

### Step 2 · 风格系统
- 学术风（蓝白克制）：宝蓝 #1E4FA8/藏蓝 #0E3F8C/浅蓝 #E8EFF8；正文≥22px；卡内五段骨架（标题条/引导句/正文/关键数据锚底/尾部标签）。
- 科技数智风：深蓝渐变 #0A1F3C→#003366 + 青蓝 #00B4D8 点缀；网格点阵、数据流线装饰；深底用 #E8F1F8 字。
- 全篇锁死 ≤4 个 hex + ≤2 套字体家族；角标/页眉/页脚全篇位置一致。

### Step 3 · 启动引擎并立即预览
`slidep-start --project <项目目录> --filename "中文名.pptx"` 后**立即**打开预览给用户，逐页过程实时可见。

### Step 4 · 逐页生成
每页一个 `slides/NN.slide`（或 `pages/slide_XX_*.jsx`）。每页提交前自检：母版三区齐全 / 主视觉占内容区≥30% / 视觉锚点≥1个 / 与上一页版式不重复 / 色彩配额合规（红黄合计≤5%）。

### Step 5 · 全量校验与修复
`slidep-validate --all --project <目录>`，必须全部 success。修复三板斧：
1. **垂直预算超限**（标签药丸顶出卡片）：正文降字号收行距 + `flex:1` spacer 锚底。
2. **横向溢出**：等宽卡片拼排一律改 `flex:1` 平分，不做像素算术。
3. **图文对齐**：SVG 节点图别和可变高文本列强行对齐——每行自带节点最稳。

### Step 6 · 交付
- 文件被占用（`~$xxx.pptx` Office 锁文件 / mtime 不变 / rm 报"正在使用"）→ **换新文件名输出**（v2/v3）绕开锁。
- 验证产物是否真的更新：解包 `ppt/slides/slideN.xml` 查关键文本与 `sz="..."`（px×0.75×100，如 15.5px→"1163"）；图片看 `ppt/slides/media/`、图表看 `charts/chart*.xml`。

## 三、图文混排与图表

### 配图（先图后写，强制）
1. 生成/获取图片 → 存 `assets/`（英文文件名）→ **逐张 Read 核对**内容/比例/清晰度/风格统一（全篇要么全摄影要么全插画，禁混用）。
2. 写实类主视觉用生图渠道（提示词含：主体+场景+构图+风格+色彩+"画面中不出现任何文字标识"）。
3. 嵌入：`<Image src='assets/xx.png' style={{ width:'100%', height:158, objectFit:'cover', borderRadius:10 }} />`；图框尺寸比例尽量与源图一致。
4. 禁全屏背景图；单页图/图 ≤3 个，总面积 ≤ 内容区 60%。

### 原生图表（可编辑，非贴图）
`<Chart chartType='barChart' barDirection='bar' style={{height:300}} data={[['方向','缺口'],['制造端',116.9],['售端',82.4]]} />`
- **必须给 `style.height`**（否则高度为0）；数值必须 number；饼/环仅单系列两列。
- 文本色（titleColor/axisColor 等）只支持纯色；背景与系列色可渐变。
- 图表页骨架：L0 引导问题条 → 主图 ≥50% → 洞察（数据+判断）→ KPI 锚底 + 来源标注。

## 四、一句话调用范例

- 学术风汇报：`用 tencent-pptx 帮我把这份材料做成学术风格的汇报PPT，蓝白配色、深蓝标题，12页以内，图文混排，数据用图表呈现。`
- 科技风汇报：`用 slidep 做一版科技数智风的汇报PPT，深蓝渐变封面配青蓝点缀，内容基于以下要点：……`
- 增量修改：`第4页右卡加一张实训现场的照片，正文精简；再加一页柱状图页展示人才缺口数据。`

## 五、交付清单

- [ ] 12/12（或 N/N）validate 通过
- [ ] 全部页脚页码与总页数一致（插页后全局重排）
- [ ] 图片已 Read 核对且嵌入后解包可见（media/ 下存在）
- [ ] 交付 .pptx 绝对路径 + 页数 + 风格说明
- [ ] 无占位文、无 [?]、无杜撰数据