\r \r

课件帮 AIPPT — 一句话生成专业 PPT\r

\r 接入「课件帮」AI 平台，全流程自动完成 PPT 生成：大纲确认 → 模板匹配 → 智能生成 → 交付链接，无需手动操作任何 API。\r \r

适用场景\r

\r | 场景 | 示例 |\r |------|------|\r | 商务汇报 | 季度总结、战略分析 |\r | 产品介绍 | 融资 Pitch、新品发布 |\r | 学术演示 | 研究报告、毕业答辩 |\r | 培训课件 | 员工培训、技能分享 |\r \r

前提条件\r

\r 需要环境变量：\r \r

KEJIAN365_AUTH_TOKEN=\x3CYour_Token_Here>\r
```\r
密钥获取：https://kejian365.com/oapi-portal\r
\r
## 使用方式\r
\r
直接说：「帮我做一个关于 **XX** 的 PPT」即可启动。\r
\r
---\r
\r
\x3C!-- 以下为 AI Agent 内部执行指令，用户无需关注 -->\r
\r
## Execution Checklist\r
\r
Run through these steps in order. Track completion in context — **never repeat a completed step**.\r
\r
```\r
[ ] Step 1  Gather requirements from user\r
[ ] Step 2  Generate outline (local LLM) → show to user → confirm\r
[ ] Step 3  run list_themes.py → pick theme → tell user\r
[ ] Step 4  Write params.json + run script (creates task ONCE on success)\r
[ ] Step 5  Re-run script every 30s to poll until terminal state\r
[ ] Step 6  Report final result\r
```\r
\r
**Hard rules:**\r
- NEVER call `POST /skill/task/create` directly — always use the script\r
- NEVER change `--work-dir` for the same task (causes duplicates)\r
- NEVER show `ppt_id`, `work_dir`, file paths, or raw URLs to the user\r
\r
**Script idempotency:**\r
\r
| task_state.json status | Script behaviour |\r
|------------------------|-----------------|\r
| Missing / `CREATE_FAILED` | Calls create API (or retries) |\r
| `PENDING` / `RUNNING` | Polls only, never creates again |\r
| `DONE` | Returns success immediately |\r
| `GENERATION_FAILED` | Returns failure; delete state file to retry |\r
\r
---\r
\r
## Step 1 — Gather Requirements\r
\r
Ask in one message:\r
\r
> 好的！请告诉我：\r
> 1. PPT 的主题是什么？\r
> 2. 有什么特别要求吗？（受众、风格、页数、语言等，没有就跳过）\r
\r
Extract:\r
\r
| Parameter | Default |\r
|-----------|---------|\r
| `topic` | required |\r
| `settingPages` | `"智能决策"` → `"精简"` ~10p / `"标准"` ~20p / `"长篇"` ~30p |\r
| `settingLanguage` | `"中文"` |\r
| `settingAudience` | `"智能决策"` |\r
| `illustrationMode` | `"standard"` (`"pro"` = premium) |\r
\r
---\r
\r
## Step 2 — Generate Outline\r
\r
Generate locally (no API). Then **show the outline to the user** and wait for confirmation:\r
\r
> 已为您生成以下大纲，共 {N} 页：\r
> 1. 封面 — {title}\r
> 2. 目录 — {title}\r
> …（逐页列出）\r
>\r
> 满意的话我来继续选模板；如需调整请告诉我。\r
\r
**Outline array rules:**\r
- `pageNumber` sequential from 1, no gaps\r
- Page 1 = `封面`, last = `结束`, at least 1 `内容`\r
- Add `目录` when ≥ 6 pages; `章节` + its `内容` pages share `chapterNumber`\r
\r
```json\r
[\r
  { "pageNumber": 1, "pageType": "封面", "title": "主标题", "content": "" },\r
  { "pageNumber": 2, "pageType": "目录", "title": "目录", "content": "1. 概述\
2. 分析" },\r
  { "pageNumber": 3, "pageType": "章节", "title": "第一章", "content": "", "chapterNumber": "01" },\r
  { "pageNumber": 4, "pageType": "内容", "title": "内容页", "content": "...", "chapterNumber": "01" },\r
  { "pageNumber": 5, "pageType": "结束", "title": "谢谢", "content": "" }\r
]\r
```\r
\r
**Material (optional):** also generate a short research summary to improve content quality and pass it as the `material` field.\r
\r
---\r
\r
## Step 3 — Select Theme\r
\r
Use the script — **never call the API directly** (raw JSON response is too large for context):\r
\r
```bash\r
python kejian365-aippt/scripts/list_themes.py\r
```\r
\r
Output per theme: `THEME: theme_id|theme_name|style|scene`\r
\r
Reason over the full list, pick the `theme_id` that best fits the PPT `topic`, audience, and tone. Save it for Step 4 `themeId`.\r
\r
Tell the user:\r
\r
> 已为您选择「{theme_name}」模板（{style} 风格 · {scene} 场景），即将开始生成…\r
\r
---\r
\r
## Step 4 — Create Task\r
\r
### Work directory\r
\r
Use a stable slug per topic — **same task = same directory every time**:\r
```\r
/mnt/user-data/workspace/{topic-slug}-ppt-tmp\r
```\r
\r
### params.json (UTF-8, no BOM, no `\uXXXX` escaping)\r
\r
```json\r
{\r
  "topic": "主题名称",\r
  "themeId": "theme_xxx",\r
  "outline": [ ... ],\r
  "authToken": "\x3Ccredential>",\r
  "requirements": "用户的特别要求",\r
  "material": "# 研究摘要\
...",\r
  "themeConfig": {\r
    "settingPages": "标准",\r
    "settingLanguage": "中文",\r
    "settingAudience": "智能决策",\r
    "contentDepth": "智能生成",\r
    "illustration": "智能配图",\r
    "sourceMode": "智能参考"\r
  },\r
  "illustrationMode": "standard"\r
}\r
```\r
\r
### Run script\r
\r
```bash\r
python kejian365-aippt/scripts/create_ppt_task.py \\r
  --params-file {work-dir}/params.json \\r
  --work-dir    {work-dir}\r
```\r
\r
On `SUBMITTED:`, parse `查看链接:` from stdout and say:\r
\r
> 🎉 PPT 任务已创建成功！\r
> 主题：「{topic}」，模板：「{theme_name}」\r
> 生成大约需要 5–15 分钟，可以先[点这里预览]({view_url})（生成完成前内容可能为空）。\r
> 我会每隔 30 秒自动查询进度，请稍候。\r
\r
---\r
\r
## Step 5 — Poll Progress\r
\r
Re-run every 30s (omit `--params-file` after first run):\r
\r
```bash\r
python kejian365-aippt/scripts/create_ppt_task.py \\r
  --work-dir {work-dir}\r
```\r
\r
| Exit | First line | Action |\r
|------|------------|--------|\r
| `0` | `SUBMITTED:` | Poll again in 30s |\r
| `0` | `DONE:` | → Step 6 |\r
| `2` | `PENDING:` | Report progress, poll again in 30s |\r
| `1` | `FAILED:` | → Error handling |\r
\r
When pending, parse `进度:` and `查看链接:` and say:\r
\r
> 正在生成中，已完成 {N}/{total} 页，完成后可[在这里查看]({view_url})。\r
\r
---\r
\r
## Step 6 — Report Result\r
\r
### Success (`DONE:`)\r
\r
Parse `主题:` / `页数:` / `查看链接:` and say:\r
\r
> 🎉 「{topic}」的 PPT 已生成完成，共 {N} 页！\r
> [点击这里查看您的 PPT]({view_url})\r
\r
Provide raw URL only if the user explicitly asks.\r
\r
### Failure (`FAILED:`)\r
\r
| stdout keyword | Say to user |\r
|----------------|-------------|\r
| `余额不足` | 账户余额不足，充值后告诉我，我来帮您重新生成。 |\r
| `鉴权` / `401` / `缺少账号凭证` | 未检测到有效密钥，请配置环境变量： `KEJIAN365_AUTH_TOKEN=your_token`，密钥可到[课件帮开放平台](https://kejian365.com/oapi-portal/#/dashboard)获取。 |\r
| anything else | 生成时遇到了问题，要重新试一次吗？ |\r
\r
Lines starting with `[INTERNAL]` are for the agent only — never show to user. Delete `task_state.json` silently to retry.\r
\r
---\r
\r
## Appendix — API Reference\r
\r
[api-reference.md](api-reference.md)\r