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

快速开始

# 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 字段选择。

使用模板母版

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

plan.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 覆写令牌）。

3.5 KiB Raw Permalink Blame History Unescape Escape