Pi PPT 生成

功能说明

1. 通过 PI（Presentation Intelligence）API 生成 PPT。

环境配置

1. API 密钥：请确保已正确设置环境变量 `PIPPT_BASE_URL`、`PIPPT_APP_ID` 和 `PIPPT_APP_SECRET`，其值为您的有效 API 密钥。您可前往 PI 官网获取密钥：https://www.pi.inc/ 。
2. 运行环境：上述 API 密钥需在运行时环境中可用。

生成 PPT

执行以下脚本：

PIPPT_BASE_URL=xxx PIPPT_APP_ID=xxx PIPPT_APP_SECRET=xxx python3 scripts/generate_pi_ppt.py --content  --language --cards --file

输入参数说明：
  `content`（字符串，必填）：主题及描述，例如："Create a PPT introducing Chinese GPU vendors in a formal business style."
  `cards`（整数，可选）：期望生成的幻灯片数量，例如 10；默认值为 8。若基于上传文档生成 PPT，则无需指定该参数，幻灯片数量将由文档内容自动确定。
  `language`（字符串，必填）：PPT 目标语言，'zh' 表示中文，'en' 表示英文；默认值为 'zh'。
  `file`（字符串，可选）：待上传文档的本地路径，例如："/Users/jack/download/weekly_report_20250304.doc"。支持的文件类型包括：`.doc` / `.docx` / `.txt` / `.md` / `.pdf` / `.pptx` / `.ppt`；不支持其他格式；每次仅允许上传一个文档。

完整命令示例：

基于上传文档生成 PPT（幻灯片数量由内容决定，不传入 --cards 参数）：

PIPPT_BASE_URL=xxx PIPPT_APP_ID=xxx PIPPT_APP_SECRET=xxx python3 scripts/generate_pi_ppt.py 
  --content "Generate a well-structured business report PPT based on the attached document" 
  --language zh 
  --file "/Users/YourName/Documents/quarterly_review.docx"

基于单行提示词 / 主题生成 PPT（可指定幻灯片数量）：

PIPPT_BASE_URL=xxx PIPPT_APP_ID=xxx PIPPT_APP_SECRET=xxx python3 scripts/generate_pi_ppt.py 
  --content "Create a PPT introducing Chinese GPU vendors in a formal business style" 
  --language zh 
  --cards 10

注意事项

• 生成一份 PPT 通常耗时约 3–6 分钟，请提醒用户耐心等待。