94 lines
3.5 KiB
Markdown
94 lines
3.5 KiB
Markdown
# 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 覆写令牌）。
|