核心用法
Pi PPT 是一个命令行工具，通过调用 PI (Presentation Intelligence) 的 API 服务实现自动化 PPT 生成。用户需提供 PIPPT_BASE_URL、PIPPT_APP_ID 和 PIPPT_APP_SECRET 三个环境变量完成认证授权。
两种生成模式：
- 文档生成模式：上传
.doc/.docx/.txt/.md/.pdf/.pptx/.ppt文件，AI 自动解析内容结构生成 PPT，幻灯片数量由文档内容决定，无需指定--cards参数 - 主题生成模式：输入自然语言描述（如"以正式商务风格介绍中国 GPU 厂商"），可指定
--cards控制幻灯片数量（默认 8 页）
完整命令示例：
# 文档生成（推荐用于已有材料场景） PIPPT_BASE_URL=xxx PIPPT_APP_ID=xxx PIPPT_APP_SECRET=xxx python3 scripts/generate_pi_ppt.py \ --content "基于附件生成结构化业务报告 PPT" \ --language zh \ --file "/path/to/document.docx" # 主题生成（推荐用于从零创作场景） PIPPT_BASE_URL=xxx PIPPT_APP_ID=xxx PIPPT_APP_SECRET=xxx python3 scripts/generate_pi_ppt.py \ --content "正式商务风格介绍中国 GPU 厂商" \ --language zh \ --cards 10
显著优点
- 双模式灵活创作：既支持基于现有文档的智能转换，也支持一句话主题生成，覆盖从材料整理到创意构思的全场景
- 多语言支持：原生支持中英文（
zh/en），满足国际化商务需求 - 专业模板库：依托 PI 的商业级设计引擎，输出符合商务规范的版式与配色
- 广泛格式兼容：支持 7 种主流文档格式上传，降低文件预处理成本
潜在缺点与局限性
- 耗时较长：单次生成需 3-6 分钟，不适合实时交互场景
- 依赖外部服务：完全依赖 PI 云端 API，无离线能力，网络波动或服务中断将直接影响可用性
- 格式限制严格：仅支持 7 种指定格式，且单次只能上传单个文件，复杂多文档场景需手动合并
- 无预览与编辑：生成结果为终稿，不支持在线调整版式或内容
- 成本敏感：API 调用可能产生费用，高频使用需关注配额与计费
适合人群
- 商务人士：快速将报告、方案文档转换为演示文稿
- 市场团队：基于活动主题批量生成发布会、路演材料
- 教育工作者：将讲义、论文转换为课程课件
- 咨询顾问：基于客户提供的资料快速产出结构化提案
常规风险
- API 密钥泄露风险：
PIPPT_APP_SECRET等敏感信息需妥善保管，避免硬编码或日志泄露 - 数据隐私：上传文档内容将传输至 PI 云端处理，涉密材料需谨慎评估合规性
- 服务稳定性：第三方 SaaS 存在不可控的 SLA 风险，关键业务场景建议预留备份方案
- 生成结果不可控：AI 对复杂文档的结构理解可能存在偏差，重要场合需人工复核