麦当秀AI PPT

它解决什么问题

麦当秀 AI PPT 面向一个具体流程：把“一句话主题”或“上传文档”变成可下载的 PPT，并让调用方能在界面里实时看到大纲、正文进度和任务状态。它不是简单的 prompt 包装，而是通过 aippt-cli.js 这类零依赖 Node.js CLI 调用 AIPPT API，用 apidoc.json 作为接口结构来源，避免手写请求字段和重复解析响应。

技能如何工作

• 接口调用：CLI 支持列出接口、查看 schema、调用普通 JSON 接口和 SSE 流式接口；普通接口输出机器可读 JSON，流式接口直接输出原始 data: 事件。
• 主题生成：从 /v1/gpt/gen_outline_by_topic 生成 Markdown 大纲；若用户未指定页数，默认 page_count 为 25。
• 模板策略：默认不传 template_id，使用系统推荐模板；只有用户明确要求选择或展示模板时，才调用 /v1/template/list 并展示 preview_img_list。
• 内容生成：用 /v1/gpt/gen_content_by_outline 生成完整 Markdown，界面应按事件覆盖内容并更新 progress_percent。
• 任务轮询：/v1/job/ppt_create_by_markdown 创建任务后，通过 /v1/job/get 轮询 status 和 data.job.progress_percent，成功后取 ppt_url 和预览图。
• 文件生成：先调用 /v1/resource/upload 上传文档，再把 resource_id 传给大纲接口，后续流程复用主题生成。

边界与注意点

• 需要 AIPPT_TOKEN，token 优先级为 --token、环境变量、./.env；不要打印或散落到 shell 外。
• 要同时判断 HTTP status 与 data.code，data.code 非 0 时需要报告 data.info 和 request_id。
• SSE 输出不是外层 JSON 包装，调用方必须逐条解析 data: 事件。
• 请求字段不要猜测，优先读取 schema；服务地址默认来自 apidoc.json，只有用户明确提供其他环境时覆盖。