核心用法
Pi PPT Generation 是一个基于 PI (Presentation Intelligence) 服务的自动化 PPT 生成工具，通过命令行脚本调用 API 实现智能演示文稿创建。该 skill 提供两种核心生成模式：
1. 文档转 PPT 模式：上传本地文档（支持 .doc/.docx/.txt/.md/.pdf/.pptx/.ppt 格式），系统自动解析内容并生成结构化的演示文稿，此模式下幻灯片数量由文档内容自动决定，无需指定页数。
2. 主题生成模式：通过自然语言描述主题与风格需求（如"以正式商务风格介绍中国 GPU 厂商"），可自定义指定幻灯片数量（默认 8 页），快速生成完整 PPT。
使用时需配置三项环境变量：PIPPT_BASE_URL（服务地址）、PIPPT_APP_ID 和 PIPPT_APP_SECRET（身份凭证），通过 Python 脚本执行生成任务。
显著优点
- 双模式灵活输入：既支持结构化文档智能转换，也支持一句话主题快速生成，覆盖从资料整理到创意构思的全场景需求
- 多格式文档兼容：支持 7 种常见办公文档格式，降低素材准备门槛
- 双语输出能力：原生支持中英文 PPT 生成，适应国际化商务场景
- 自动化工作流：命令行调用方式便于集成到自动化脚本或 CI/CD 流程中
潜在缺点与局限性
- 生成耗时较长：单次 PPT 生成需 3-6 分钟，不适合实时性要求高的场景
- 依赖外部服务：完全依赖 PI 第三方 API，存在服务可用性和数据外泄风险
- 无可视化编辑：纯命令行交互，无法中途预览或实时调整生成结果
- 单文档限制：每次仅支持上传单个文档，复杂资料需预先合并处理
- 环境配置门槛：需正确配置三项环境变量，对非技术用户不够友好
适合人群
- 企业职员需将报告文档快速转换为演示文稿
- 市场运营人员批量生成产品介绍或活动方案 PPT
- 开发者构建自动化办公工具链
- 内容创作者需基于素材文档生成视觉化内容
常规风险
- API 密钥泄露：
PIPPT_APP_ID和PIPPT_APP_SECRET以明文环境变量形式存储，存在被窃取或意外暴露风险 - 敏感数据外泄：上传的文档内容将传输至第三方 PI 服务进行处理，涉及商业机密或个人隐私的资料需谨慎评估
- 服务稳定性依赖：第三方 API 故障或网络中断将直接导致生成任务失败
- 生成结果不可控：AI 生成的内容可能存在事实性错误、排版不符合预期等问题，需人工复核后使用