核心功能与工作机制
Felo Slides 封装了 Felo 官方 PPT Task API (v2)，为 Claude Code 环境提供端到端的幻灯片自动化生成能力。用户仅需提供主题或结构化大纲，系统即可调用 POST /v2/ppts 创建异步任务，随后通过轮询 GET /v2/tasks/{task_id}/historical 监控状态，直至任务到达 COMPLETED/SUCCESS 或 FAILED/ERROR 终止态。
执行流程遵循严格的四步规范：① API Key 预检；② Node 脚本统一封装创建与轮询逻辑（无需外部 jq 依赖）；③ 终端状态判定；④ 结构化结果返回。脚本支持 --json --verbose 调试模式，可输出完整元数据（task_id、ppt_url、live_doc_url、livedoc_short_id、ppt_business_id）。
显著优点
- 官方 API 背书：直接对接 Felo openapi.felo.ai 域名，非第三方逆向接口，协议合规性高
- 异步任务追踪：内置 10 秒间隔轮询、最长 30 分钟等待、60 秒 HTTP 超时，避免长连接阻塞
- 双端输出兼容：同时返回可下载 PPT 链接与在线协作文档链接，满足不同分享场景
- 健壮的错误码映射：对
INVALID_API_KEY、PPT_TASK_CREATE_FAILED、PPT_TASK_QUERY_FAILED等已知错误提供可读提示
潜在局限
- 强依赖外部服务：任务执行完全依赖 Felo 服务端可用性，网络波动或 502 错误会导致创建/查询失败
- 轮询资源消耗：30 分钟最大等待期在高并发场景下可能占用本地执行资源
- API Key 人工配置：需用户手动 export 环境变量，无 OAuth 或密钥托管机制，易因遗忘导致阻断
- 有限的可控参数：当前仅暴露 query/interval/max-wait/timeout，不支持模板选择、页数强制约束、品牌配色等细粒度控制
适用人群
- 需要快速将文本大纲转化为视觉演示的知识工作者、产品经理、教育工作者
- 已在 Felo 平台开通 API 权限并持有有效 Key 的开发者
- 对输出格式要求为「可用即可」、无需深度定制的场景
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 密钥泄露 | 明文 export 于终端历史或脚本文件 | 使用密钥管理服务或 Claude Code 环境变量隔离 |
| 任务悬挂 | 网络中断导致轮询提前退出，任务实际仍在后台运行 | 始终返回 task_id，支持用户后续手动查询 |
| 内容合规 | 生成内容受 Felo 平台 AI 审核策略约束 | 避免输入敏感或违规主题 |
| 服务依赖 | Felo 平台 SLA 未公开，存在不可用时无法降级 | 关键场景准备本地备份方案 |