中文演示文稿工坊
把主题变成一份能直接打开编辑的中文演示文稿。先梳理大纲，再取得版式包生成成品 .pptx。
本技能分免费能力（本地完成）与付费能力（远端版式包）两层，详见「能力与计费」。
触发规则
| 用户意图 | 处理 |
|---|---|
| 做个 PPT / 演示文稿 / 汇报材料 / 幻灯片 | 进入完整流程（从第 1 步开始） |
| 帮我整理个大纲 / 梳理汇报结构 | 只做第 1~2 步，不发起付费 |
| 已有大纲，直接出文件 | 跳过梳理，直接进入第 3 步 |
| 换个配色 / 换个版式 | 重新走第 3 步（可换风格重出） |
| 只问本技能能干嘛 | 仅介绍，不执行任何操作 |
能力与计费
| 能力 | 交付方式 | 计费 |
|---|---|---|
| 目标与受众梳理、素材重组 | 本地对话完成 | 免费 |
| 大纲骨架与信息密度检查 | 本地完成，产出 outline.json |
免费 |
| 演示文稿版式包（配色/字体/字号/版式坐标） | 远端服务按需下发 | ¥2.00 / 次 |
| .pptx 成品生成 | 本地脚本 scripts/build_deck.py，零依赖 |
含在上述单次费用内 |
- 单次价格：¥2.00（200 分），与远端账单金额、平台展示价保持一致。
- 支付渠道：支付宝 AI 按量付费（402 + Payment-Proof 协议）。
- 一次付费取得一份版式包，同一份版式包可反复用于生成多份大纲，不重复计费。
依赖
| 依赖 | 用途 | 安装 |
|---|---|---|
| Python 3.8+ | 运行生成脚本 | 系统自带 |
alipay-bot |
买家侧官方支付能力 | npx -y @alipay/agent-payment@latest install |
生成脚本只用标准库（zipfile / json），不装 python-pptx，离线可跑。
核心准则
- 先有大纲再排版：没有大纲不发起付费，避免花冤枉钱。
- 付费前必须说清：执行
probe后，向用户说明用途、金额（¥2.00）、计费单元，取得明确同意再pay。 - 信息密度优先：一页超过 6 条要点或单条超过 42 字，先建议拆分，再生成。
- 不虚构数据：指标页的数字必须来自用户提供的素材，不得编造。
工作流程
1. 明确目标与受众
问清三件事（用户已说明则跳过）：讲给谁听、要对方做什么决定、时长多少页。
据此确定页数区间与详略程度。
2. 产出大纲 JSON
把素材重组为 outline.json：
{
"title": "演示标题",
"subtitle": "副标题",
"style": "business-blue",
"slides": [
{"type": "cover", "title": "演示标题", "subtitle": "副标题"},
{"type": "agenda", "title": "本次汇报要点", "bullets": ["要点一", "要点二"]},
{"type": "section", "title": "一、第一部分"},
{"type": "bullets", "title": "核心结论", "bullets": ["不超过六条", "每条不超过四十二字"]},
{"type": "two-column", "title": "方案对比", "left": ["方案A特点"], "right": ["方案B特点"]},
{"type": "metrics", "title": "关键指标", "metrics": [{"value": "18.4%", "label": "年化收益"}]},
{"type": "quote", "text": "一句值得强调的话", "source": "出处"},
{"type": "summary", "title": "结论与下一步", "bullets": ["下一步动作"]},
{"type": "thanks", "title": "谢谢"}
]
}
可用的 type：cover / agenda / section / bullets / two-column / metrics / quote / summary / thanks。
可选的 style：business-blue（商务蓝）/ ink-minimal（极简墨黑）/ china-red（国潮红金）/ tech-dark（科技暗色）。
3. 取得版式包（付费）
付费由 scripts/pay_client.py 编排，脚本不接触支付密钥，也不自行实现支付与签名。
# ① probe：请求资源，未付款时取得 402 账单并落盘
python3 scripts/pay_client.py probe --skill deck --state-dir .state/<SESSION_ID> \
--payload-json '{"style":"business-blue","slide_count":9}'
# ② pay：把账单交给官方支付能力，等待用户确认付款
python3 scripts/pay_client.py pay --skill deck --state-dir .state/<SESSION_ID> --session-id <SESSION_ID>
# ③ complete：付款后携凭证重试，取得版式包
python3 scripts/pay_client.py complete --skill deck --state-dir .state/<SESSION_ID> \
--out-trade-no <OUT_TRADE_NO> --proof-file proof.txt
版式包落在 .state/<SESSION_ID>/result.json，取出 data 字段存为 deck_spec.json。
服务地址通过环境变量覆盖：export PAY_API_BASE="https://<YOUR_API_DOMAIN>"。
4. 生成成品
python3 scripts/build_deck.py --deck outline.json --spec deck_spec.json --out 演示文稿.pptx
缺少版式包时脚本会以退出码 3 报错并说明原因，不产出任何文件。
Agent 执行要求
- 先说清后支付：说明用途、¥2.00 单价与计费单元，用户确认后再
pay。 - 原样透传：官方支付能力的输出原样展示，不裁剪、不改写。
- 复用原订单：
complete必须复用 probe 阶段的同一订单，不重新下单、不重复付款。 - 失败如实报告：任一环节失败如实展示并停在当前步骤，不降级为「假装成功」。
- 脱敏后再上传：提交给远端的
payload只含风格与页数等排版参数，不含文档正文、账号或路径信息。
输出模板
## 演示大纲
受众：… 决策目标：… 建议页数：N
| 页序 | 类型 | 标题 | 要点数 |
|------|------|------|--------|
| 1 | 封面 | … | — |
| 2 | 目录 | 本次汇报要点 | 4 |
## 成品
文件：<路径>.pptx 页数：N 版式：商务蓝
信息密度检查：单页最多 6 条，最长 42 字（超限已自动折行/分页）
注意事项
- 不生成图片与图表，指标页只做文字排版；需要配图请在 PowerPoint/WPS 中补充。
- 中文字体依赖运行环境中已安装的字体（微软雅黑 / 思源系列）；缺失时由办公软件回退替代字体。
- 同一份版式包可重复用于多份大纲，不必每次重新付费。
- 本技能只做排版与结构，不对内容真实性负责；关键数字须由用户确认。
参考资料
scripts/build_deck.py— 零依赖 .pptx 生成器（需版式包）scripts/pay_client.py— 付费编排（probe / pay / complete）references/deck-authoring.md— 中文演示大纲撰写与信息密度规范references/paid-gateway.md— 付费链路（402 / Payment-Needed / Payment-Proof）契约
