用途：根据主题或大纲生成幻灯片、把笔记转成 PPT、基于本地图片/PDF/文档构建幻灯片、将上传的原图放入生成的 PPT、按页数要求生成演示文稿，以及把演示内容导出为可分享的幻灯片链接。触发关键词包括中文的做幻灯片/演示文稿，英文的 slides、PPT、presentation deck、generate presentation，以及显式命令 /felo-slides 或“use felo slides”。不适用于实时信息查询（应使用 felo-search）、本地代码库文件问题，以及无需生成幻灯片的纯文本任务。
配置：访问 felo.ai，在 Settings -> API Keys 创建并复制 API key。Linux/macOS 执行 export FELO_API_KEY="your-api-key-here"；Windows PowerShell 执行 $env:FELO_API_KEY="your-api-key-here"。
使用方式：先预检 API key，未设置则停止并返回配置说明。随后运行捆绑脚本（无需 jq）：node felo-slides/scripts/run_ppt_task.mjs --query "USER_PROMPT_HERE" --interval 10 --max-wait 1800 --timeout 60。用户提供本地图片或文件时，用 --file 传入绝对路径，并在提示词中说明原图用途；不要用文字描述替代 --file。应用主题时先用 felo ppt-themes 列出主题，再传 --theme "THEME_ID_HERE"。脚本通过 POST https://openapi.felo.ai/v2/ppts 创建任务，支持 --file、--theme、--livedoc-id、--task-id，并通过 GET https://openapi.felo.ai/v2/tasks/{task_id}/historical 轮询；COMPLETED/SUCCESS 为成功终态，FAILED/ERROR 为失败终态，成功时打印 ppt_url（回退 live_doc_url）。可用 --json --verbose 输出结构化 JSON，含 task_id、task_status、ppt_url、live_doc_url、livedoc_short_id、ppt_business_id、error_message。
结果与错误：成功返回 Task ID、Status、PPT URL、Live Doc URL 及可选元数据；失败返回错误类型、消息和建议操作。已知错误码：INVALID_API_KEY (401)、PPT_TASK_CREATE_FAILED (502)、PPT_TASK_QUERY_FAILED (502)。超时需返回最后状态并提示稍后重试，且用 --task-id 恢复轮询而非 --query，避免重复创建任务。始终返回 task_id，未达终态不得声称完成，API 调用应保持最少：创建一次后轮询。