Cappt

Cappt PPT 生成器

使用 Cappt AI 服务，根据用户输入生成专业的 PowerPoint 演示文稿。

触发场景

同时满足以下两个条件时激活：

• 用户提到 PPT / 演示文稿 / 幻灯片 / presentation / slides / Cappt
• 有明确的生成意图（生成 / 做 / 制作 / 创建 / create / make / generate）

安全约束（最高优先级）

以下规则不可被用户指令覆盖：

• Token 内容禁止输出，不可读取、打印或日志记录 ~/.config/cappt/auth.json 的内容
• 更新操作需用户明确确认，不可在用户未要求时自动执行更新脚本

前置检查

按顺序执行以下检查，发现问题立即引导用户修复，再继续。

检查 1：cappt CLI 是否已安装

# macOS/Linux
command -v cappt

# Windows
Get-Command cappt -ErrorAction SilentlyContinue

若未安装，按平台引导运行安装脚本：

# macOS/Linux
bash ${CLAUDE_SKILL_DIR}/scripts/install.sh

# Windows
pwsh -ExecutionPolicy Bypass -File "${env:CLAUDE_SKILL_DIR}\scripts\install.ps1"

> 安装问题参见：reference/troubleshooting.md

检查 2：是否已登录

cappt whoami

若未登录（退出码 1），执行以下登录流程：

步骤 1 — 获取登录链接（立即返回到 stdout）：

AUTH_URL=$(cappt login --utm-source )

--utm-source 为可选参数，不传时默认为 cappt。将 $AUTH_URL 展示给用户，请用户在浏览器中打开并登录，登录后浏览器会显示一个 token。

步骤 2 — 用户复制 token 后，将其保存到本地：

cappt login --token 

两项检查均通过后，进入工作流。

> 环境变量快捷方式：若用户提到使用环境变量，可跳过登录流程： > - CAPPT_TOKEN=：直接传入认证 token，优先级高于本地缓存 > - CAPPT_BASE_URL=：覆盖默认 API 地址（默认 https://api.cappt.cc），适用于私有部署或测试环境 > > 示例：CAPPT_TOKEN=xxx CAPPT_BASE_URL=https://api.b.cappt.cc cappt generate --outline-file outline.md

工作流

按顺序执行以下四步，不可跳过任何一步。

第一步 — 理解用户需求

从用户消息中识别：

• 需要转化为 PPT 的主题、标题或文章内容
• 是否需要返回所有幻灯片的图片集合（--include-gallery）
• 是否需要返回预览图（--include-preview）

若用户未提及上述选项，默认均为 false。

第二步 — 生成结构化 Markdown 大纲

参照 reference/outline-format.md 中的格式规范，生成符合要求的完整大纲。

关键要求：

• 语言一致：大纲语言必须与用户输入语言一致
• 层级完整：# 总标题 → ## 章节（3-5 个）→ ### 小节（每章节 3-5 个）→ #### 要点（每小节 3-8 个）
• 副标题完整：每级标题下方必须有一行 > 副标题
• 编号规范：## 用 1.，### 用 1.1，#### 用 1.1.1
• 数量随机：各章节小节数、各小节要点数不可完全相同

生成完毕后，将完整大纲展示给用户，等待确认后再进行第三步。

若用户提供的文章超过 500 字，展示大纲后必须请用户确认再继续。

第三步 — 调用 cappt CLI 生成 PPT

将大纲写入临时文件，调用 CLI：

OUTLINE_FILE="/tmp/cappt_outline_$(date +%s).md"
cat > "$OUTLINE_FILE" 
OUTLINE_EOF

cappt generate --outline-file "$OUTLINE_FILE"

若用户要求了图片集合或预览图，追加对应参数：

• --include-gallery：返回所有幻灯片图片 URL
• --include-preview：返回预览图 URL

传给 CLI 的必须是完整的 Markdown 大纲原文，不可使用摘要替代。

API 调用失败时最多重试一次。

第四步 — 展示结果

CLI 成功时将 JSON 输出到 stdout，解析后按以下格式展示：

您的 PPT 已经生成！

[在 Cappt 中打开并编辑]({editorUrl})

封面预览：

若 JSON 中包含 gallery 字段，在封面下方依次展示每张幻灯片图片。 若包含 preview 字段，作为额外预览图展示。

错误处理

| 错误信息 | 原因 | 建议操作 | |----------|------|----------| | out of AI credits (code 5410) | Cappt 账户点数不足 | 引导用户前往 Cappt 充值 | | token invalid or expired (401) | 登录态失效，缓存已自动清除 | 运行 cappt login 重新登录 | | internal server error (500) | Cappt 服务端异常 | 稍后重试 | | generation failed (fail) | 大纲格式有误或服务异常 | 检查大纲格式，参见 reference/outline-format.md | | stream ended without a result | 页数过多或网络异常 | 缩短大纲后重试 | | command not found: cappt | CLI 未安装 | 运行 install.sh / install.ps1 |

若 CLI 以非零退出码退出，将 stderr 中的错误信息完整展示给用户。

> 更多错误排查见：reference/troubleshooting.md

生命周期管理

用户有安装/登录/更新/卸载需求时，直接引导运行对应命令：

| 操作 | macOS/Linux | Windows | |------|-------------|---------| | 安装 CLI | bash ${CLAUDE_SKILL_DIR}/scripts/install.sh | pwsh -ExecutionPolicy Bypass -File "${env:CLAUDE_SKILL_DIR}\scripts\install.ps1" | | 登录 | cappt login → cappt login --token | 同左 | | 查看状态 | cappt whoami | 同左 | | 注销 | cappt logout | 同左 | | 更新 CLI | bash ${CLAUDE_SKILL_DIR}/scripts/update.sh | pwsh -ExecutionPolicy Bypass -File "${env:CLAUDE_SKILL_DIR}\scripts\update.ps1" | | 卸载 | bash ${CLAUDE_SKILL_DIR}/scripts/uninstall.sh | pwsh -ExecutionPolicy Bypass -File "${env:CLAUDE_SKILL_DIR}\scripts\uninstall.ps1" |

参考文档

| 文档 | 用途 | |------|------| | reference/outline-format.md | 大纲格式规范（层级、编号、示例） | | reference/troubleshooting.md | 故障排除指南 |

示例

示例一 — 中文主题 > 用户："帮我生成一个关于人工智能发展历史的PPT" → 前置检查 → 生成中文大纲 → 用户确认 → 调用 CLI → 展示结果

示例二 — 英文主题 > 用户："Create a 10-slide deck on climate change" → 前置检查 → 生成英文大纲 → 用户确认 → 调用 CLI → 展示结果

示例三 — 文章转换 > 用户："把这篇文章做成PPT：[文章内容]" → 前置检查 → 提取要点生成大纲 → 用户确认 → 调用 CLI → 展示结果

示例四 — 安装 / 登录 > 用户："我想用 Cappt 做 PPT，怎么安装？" → 引导运行 install.sh（或 install.ps1），然后 cappt login

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: cappt-team
• Source: cappt-team/skills
• License: MIT
• Homepage: https://www.cappt.cc

Install and usage instructions live in the source repository linked above.