# aura-ppt 技能包使用说明

> 本地AI演示文稿引擎 ｜ 综合 Gamma 设计感 / WPS 中文理解 / 7牛 内容保真 / Beautiful.ai 无损导出

## 安装位置

```
C:\Users\xunhe\.config\opencode\skills\aura-ppt\
├── SKILL.md                    ← 技能指令（触发条件/工作流/内容保真规则）
├── references/
│   ├── chinese-typography.md   ← 中文排版规范
│   ├── content-fidelity.md     ← 内容保真规则（数据零改写）
│   └── design-system.md        ← 设计系统 + 全局视觉规范
└── scripts/
    └── engine.py               ← 渲染引擎（1600+行，全部能力实现）
```

备份副本：`D:\AIDEPT\讯和能力知识库构建\aura-ppt\`（目录）+ `aura-ppt技能包.zip`

## 快速开始

```bash
# 1. 创建 plan.json（见下方结构）
# 2. 生成 PPT
python scripts/engine.py --plan plan.json --output out.pptx

# 3. 验证（必须执行）
python scripts/engine.py --verify out.pptx --plan plan.json
```

## 三种设计系统

| 系统名 | 风格 | 适用 | 比例 |
|---|---|---|---|
| `business-report` | 火焰蓝商务（白底+火焰蓝+红） | 中文管理层汇报 | 16:9 |
| `report-jp` | 日式商务（法人蓝+浅天蓝卡片+Meiryo UI） | 日本客户/总部 | 10.83×7.5 |
| `aura-dark` | 深色高级（深蓝黑+电光青） | 科技感/发布会 | 16:9 |

plan.json 的 `design` 字段选择。

## 使用模板母版

```bash
python scripts/engine.py --plan plan.json --output out.pptx \
  --template "公司模板.pptx"    # 继承母版背景/页脚/Logo
```

## plan.json 结构

```json
{
  "title": "标题",
  "design": "business-report",
  "notes_template": true,
  "slides": [
    {"type": "cover", "title": "主标题", "stats": [["70%", "说明"]]},
    {"type": "toc", "content": ["01. 章节", "02. 章节"]},
    {"type": "content", "content": ["**要点标题** ｜ 描述"]},
    {"type": "table", "data": [[...]], "charts": [{"type":"bar","data":{}}]},
    {"type": "two_table", "tables": [{"title":"表1","data":[[...]]}, {"title":"表2","data":[[...]]}]},
    {"type": "chart", "chart": {"type": "bar", "data": {}}},
    {"type": "flowchart", "rows": ["泳道1"], "content": [["步骤A", "步骤B"]]},
    {"type": "timeline", "content": ["Phase 0\n描述"]},
    {"type": "quote", "title": "引言"},
    {"type": "end", "title": "谢谢"}
  ]
}
```

## 全部能力清单

- **封面大数字墙**（stats）：右侧数字卡片（70%/6个/30-50%）
- **要点卡片**：content 中 `**标题** ｜ 描述` 自动渲染卡片网格
- **双表并排**（two_table）：左右表格，表头/字号自适应
- **表格+图表混合**：table 支持 chart/charts 字段
- **渐变柱体**：柱状图垂直渐变+网格线
- **卡片投影**：所有卡片柔和阴影
- **泳道流程图**：3层泳道 / 横向流程（窄卡自动缩字号）
- **时间线**：双圈节点
- **内容保真验证**：数字+术语+备注三合一
- **演讲者备注**：自动生成（主题/数据/要点/过渡）

## 常见问题

**Q1: 数据会被AI改写吗？** 不会。渲染引擎是纯代码，plan.json 中的数据逐字符保留，验证器强制校验。

**Q2: 能处理日文吗？** 能。report-jp 用 Meiryo UI，日文标题/表格自适应。

**Q3: 输出能编辑吗？** 能。python-pptx 输出标准 PPTX，全矢量可编辑。

**Q4: 需要网络/API吗？** 不需要。纯本地 Python（python-pptx）。

**Q5: 如何加新设计系统？** 在 engine.py 的 DESIGN_SYSTEMS 注册表扩展（继承 DesignSystem 覆写令牌）。