核心用法
pi-ppt 是一款对接 PI (Presentation Intelligence) 平台的 AI PPT 生成工具，通过命令行调用 Python 脚本实现自动化幻灯片制作。核心能力分为两条路径：
1. 文档转 PPT：上传 .doc/.docx/.txt/.md/.pdf/.pptx/.ppt 格式文档，AI 自动提取核心内容并生成结构化演示文稿，幻灯片数量由文档内容智能决定。
2. 主题创作 PPT：输入一句话主题描述（如"以正式商务风格介绍中国 GPU 厂商"），指定语言（中/英）与期望页数（默认 8 页），AI 完成内容规划与视觉排版。
使用示例
# 文档模式（推荐）：基于已有材料生成 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/report.docx" # 创作模式：从零生成指定页数 PIPPT_BASE_URL=xxx PIPPT_APP_ID=xxx PIPPT_APP_SECRET=xxx python3 scripts/generate_pi_ppt.py \ --content "新能源汽车市场分析" \ --language zh \ --cards 12
显著优点
- 双模灵活输入：既支持长文档智能解析，也支持一句话主题创作，覆盖「已有材料整理」与「从零策划」两大场景。
- 多格式兼容：支持 Office 全家桶及 Markdown、PDF 等常见格式，降低用户预处理成本。
- 双语输出：原生支持中英文 PPT 生成，适配国际化商务场景。
- 专业级排版：依托 PI 平台的 AI 设计能力，自动完成版式、配色与内容层级规划。
潜在缺点与局限性
- 耗时较长：单次生成需 3-6 分钟，不适合即时性需求。
- 云端依赖：必须联网调用 PI API，无法离线使用；生成质量受 PI 服务端稳定性与算力排期影响。
- 格式约束：文档模式仅支持单文件上传，多文件需手动合并；不支持图片、视频等非文本富媒体解析。
- 输出不可控：AI 生成的内容结构与视觉风格由模型决定，用户对中间过程干预有限，需后期微调。
适合人群
- 商务人士：需快速将 Word 报告、会议纪要转化为演示文稿
- 咨询/投行从业者：高频制作行业研究、尽职调查 PPT
- 教育/培训场景：课件从教案或文献自动生成
- 跨国团队：需中英文双语版本的内容产出
常规风险
- API 密钥泄露风险：
PIPPT_APP_ID与PIPPT_APP_SECRET以环境变量形式传递，在共享环境或日志中可能被意外暴露。 - 内容合规风险：AI 可能引用过时数据或生成不准确信息，关键业务场景需人工复核。
- 数据隐私：上传文档传输至 PI 云端处理，敏感商业资料需确认 PI 平台的数据处理协议。
- 服务可用性：PI 为第三方商业服务，存在 API 变更、限流或下线风险。