{"id":"68e05a0c-635d-4d18-9bd3-d6247e45d155","entityType":"agent","slug":"clawhub-kahn520-chatppt-agent","name":"chatppt-agent","canonicalUrl":"https://www.xpersona.co/agent/clawhub-kahn520-chatppt-agent","canonicalPath":"/agent/clawhub-kahn520-chatppt-agent","generatedAt":"2026-10-11T17:42:19.367Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T15:00:44.486Z","emptyReason":null},"description":"使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。 Skill: chatppt-agent Owner: kahn520 Summary: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-04-24T09:33:17.015Z | user No functional or documentation changes detected in this version. - Version updated to 1.0.4 with no file or SKILL.md changes. - Behavior and documentation remain the sam","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s178cb2g33fbhtnmpv2n13qca584536g:chatppt-agent","sourceUrl":"https://clawhub.ai/kahn520/chatppt-agent","homepage":"https://clawhub.ai/kahn520/skills/chatppt-agent","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/kahn520/chatppt-agent","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/kahn520/skills/chatppt-agent","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。 Skill: chatppt-agent Owner: kah"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T15:00:44.486Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T15:00:44.486Z","emptyReason":null},"stars":null,"forks":null,"downloads":1045,"packageName":null,"latestVersion":"1.0.4","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T15:00:44.420Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T15:00:44.486Z","lastCrawledAt":"2026-10-11T15:00:44.420Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T15:00:44.420Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.4","createdAt":"2026-04-24T09:33:17.015Z","changelog":"No functional or documentation changes detected in this version. - Version updated to 1.0.4 with no file or SKILL.md changes. - Behavior and documentation remain the same as the previous release.","fileCount":3,"zipByteSize":7068},{"version":"1.0.3","createdAt":"2026-04-24T09:30:25.916Z","changelog":"### chatppt-agent 1.0.3 - 强化轮询失败处理，任务失败时不再自动重新生成，新增询问用户是否重试。 - 新增用户权益用尽时的提示，并引导前往 clawppt 官网充值点数。 - 明确 web-search 默认行为，未获用户授权时强制设为 false。 - 补充约束：需在展示 PPT 模板时展示模板图片，便于用户挑选。 - 其他细节与参数处理逻辑描述进行了完善与补充说明。","fileCount":2,"zipByteSize":5898},{"version":"1.0.2","createdAt":"2026-04-22T09:45:36.075Z","changelog":"- 增强普通生成与绘图生成参数确认流程，新增详细的模板、风格、排版参数提取和追问说明。 - 普通生成路径新增对 template-id 预置模板选择的支持，指定获取和确认方式。 - 明确在轮询流程中，Agent 不允许中途停止或转入其他对话流程，需直至成功或失败。 - 规范图片风格(image-style)、模板风格(template-id)、绘图排版(banana-doc-type)等参数的获取指令及操作流程。 - 补充普通与绘图生成路径参数边界、默认值策略和参数确认顺序，方便用户更好地理解配置要求。","fileCount":2,"zipByteSize":5753},{"version":"1.0.1","createdAt":"2026-04-22T03:42:01.368Z","changelog":"- 修正 `--web-search` 参数默认值为 false，并强调需用户明确同意后才可启用 - 增加 Banana PPT 模板风格选择说明，明确引导用户可用 `chatppt ppt banana-template` 命令浏览和获取风格参数 - 细化 Banana 路径任务参数获取及风格选择流程 - 明确风格参数获取的分页用法和示例，便于用户浏览多个模板 - “生成任务默认开启轮询”描述更新为“接口内自动调用轮询接口”以强调无需手动操作 - 其他细节字段统一与命令实际行为对齐（如移除对后续未实现接口的假设说明）","fileCount":2,"zipByteSize":5442},{"version":"1.0.0","createdAt":"2026-04-21T06:43:45.278Z","changelog":"Initial release of chatppt-agent. - Introduces CLI tool for automatic PPT generation based on topic text or document import (Word, PDF, Markdown). - Supports full workflow: authentication, PPT generation, file import, results polling, and download/editor link creation. - Enforces strict agent execution flow and clear user guidance for path/parameter selection. - Provides detailed error handling, command reference, and environment setup instructions. - Includes logic for web search fee confirmation and user-driven parameter configuration (with default fallback).","fileCount":2,"zipByteSize":5157}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s178cb2g33fbhtnmpv2n13qca584536g:chatppt-agent","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T17:42:19.366Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kahn520-chatppt-agent/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T15:00:44.486Z","emptyReason":null},"readme":"Skill: chatppt-agent\n\nOwner: kahn520\n\nSummary: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。\n\nTags: latest:1.0.4\n\nVersion history:\n\nv1.0.4 | 2026-04-24T09:33:17.015Z | user\n\nNo functional or documentation changes detected in this version.\n\n- Version updated to 1.0.4 with no file or SKILL.md changes.\n- Behavior and documentation remain the same as the previous release.\n\nv1.0.3 | 2026-04-24T09:30:25.916Z | user\n\n### chatppt-agent 1.0.3\n\n- 强化轮询失败处理，任务失败时不再自动重新生成，新增询问用户是否重试。\n- 新增用户权益用尽时的提示，并引导前往 clawppt 官网充值点数。\n- 明确 web-search 默认行为，未获用户授权时强制设为 false。\n- 补充约束：需在展示 PPT 模板时展示模板图片，便于用户挑选。\n- 其他细节与参数处理逻辑描述进行了完善与补充说明。\n\nv1.0.2 | 2026-04-22T09:45:36.075Z | user\n\n- 增强普通生成与绘图生成参数确认流程，新增详细的模板、风格、排版参数提取和追问说明。\n- 普通生成路径新增对 template-id 预置模板选择的支持，指定获取和确认方式。\n- 明确在轮询流程中，Agent 不允许中途停止或转入其他对话流程，需直至成功或失败。\n- 规范图片风格(image-style)、模板风格(template-id)、绘图排版(banana-doc-type)等参数的获取指令及操作流程。\n- 补充普通与绘图生成路径参数边界、默认值策略和参数确认顺序，方便用户更好地理解配置要求。\n\nv1.0.1 | 2026-04-22T03:42:01.368Z | user\n\n- 修正 `--web-search` 参数默认值为 false，并强调需用户明确同意后才可启用\n- 增加 Banana PPT 模板风格选择说明，明确引导用户可用 `chatppt ppt banana-template` 命令浏览和获取风格参数\n- 细化 Banana 路径任务参数获取及风格选择流程\n- 明确风格参数获取的分页用法和示例，便于用户浏览多个模板\n- “生成任务默认开启轮询”描述更新为“接口内自动调用轮询接口”以强调无需手动操作\n- 其他细节字段统一与命令实际行为对齐（如移除对后续未实现接口的假设说明）\n\nv1.0.0 | 2026-04-21T06:43:45.278Z | user\n\nInitial release of chatppt-agent.\n\n- Introduces CLI tool for automatic PPT generation based on topic text or document import (Word, PDF, Markdown).\n- Supports full workflow: authentication, PPT generation, file import, results polling, and download/editor link creation.\n- Enforces strict agent execution flow and clear user guidance for path/parameter selection.\n- Provides detailed error handling, command reference, and environment setup instructions.\n- Includes logic for web search fee confirmation and user-driven parameter configuration (with default fallback).\n\nArchive index:\n\nArchive v1.0.4: 3 files, 7068 bytes\n\nFiles: skill-card.md (2014b), SKILL.md (13838b), _meta.json (132b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: chatppt-cli\ndescription: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。\n---\n\n# ChatPPT CLI Skill\n\n## 环境准备\n\n### CLI 安装\n运行npm命令进行安装，安装前先检查是否已存在chatppt命令。\n\n```bash\nnpm install -g @yooai/cli\n```\n\n安装后可运行chatppt命令进行调用，比如：\n```bash\nchatppt --help\n```\n\n### 全局 Flag\n\n| Flag | 说明 |\n|------|------|\n| `--config string` | 配置文件路径（默认 `$HOME/.chatppt/config.yaml`） |\n| `-d, --debug` | 启用调试模式 |\n| `-f, --format string` | 输出格式：`json`（默认）/ `table` / `pretty` |\n| `-h, --help` | 帮助 |\n| `-v, --version` | 版本 |\n\n---\n\n## 标准工作流\n\n```\n1. 检查登录状态（auth status\n2. 未登录 → 执行登录（auth login）\n3. 生成 PPT（ppt generate 或 ppt import_file）\n4. 自动轮询等待结果（直到 `2` 或 `3`）\n5. 询问用户要直接下载pptx文件还是跳转到线上编辑器\n```\n\n### Agent 执行强约束（必须遵守）\n\n1. **严格流程顺序**：始终按“检查登录 -> 登录（如需要） -> 生成 PPT -> 轮询结果”执行，不得跳步。\n2. **路径二选一**：在生成前必须询问用户选择：\n   - 普通生成路径\n   - 绘图生成路径\n3. **自动提取参数**：先从用户输入中自动提取可识别参数值；仅对缺失且必要的信息追问用户。\n4. **用户不想配置参数**：若用户明确表示不关心参数或不想填写，全部使用默认值发起请求。\n5. **轮询展示图片**：轮询期间如果返回 `images.urls`，可直接把图片链接展示给用户。\n6. **成功即停止**：当任务状态为 `2`或`3` 后，仅返回成功结果与关键信息，不执行任何后续操作（后续接口未就绪）。\n7. **Web Search 收费确认**：`--web-search` 涉及额外收费，启用前必须先告知用户并获得明确确认；未确认则按关闭处理（传 `--web-search=false`）。\n8. **如果已经进入到了自动轮询流程中，要一直等待轮询成功或失败，不能在轮询过程中又进行生成。如果是Agent手动轮询，也需要轮询到成功或失败，不能中途停止对话等待用户继续输入。**\n9. **如果轮询接口返回了失败，不要再次生成，要询问用户是否要再次生成。**\n10. **如果用户权益用完了，提示用户去clawppt官网 <https://chat-ppt.com/openclaw> 进行充值点数。**\n\n### 参数提取与追问规则（Agent）\n\n1. **先提取后追问**：先从用户自然语言中提取参数（主题、路径选择、样式参数等），再补问缺失信息。\n2. **最小追问原则**：仅追问生成任务必需信息（如 `主题` 或导入时的 `文件路径`）。\n3. **路径参数边界**：\n   - 普通生成路径只处理：`font-name`、`theme-color`、`ai-picture`、`image-style`、`template-id`、`custom-template-id`、`custom-page-count`\n   - 绘图生成路径只处理：`banana-style-id`、`banana-doc-type`、`banana-reference-image`\n4. **默认值策略**：若用户明确“不想设置参数/你看着办/默认就行”，则所有未指定参数使用默认值，不再反复追问。\n5. **收费项单独确认**：`web-search` 为额外收费项，不能并入“默认就行”；必须单独征得用户同意后才启用。\n\n### 确认普通生成与绘图生成路径后的参数提取与追问规则（Agent）\n1. **模板风格确认**：在普通生成和绘图生成中，都需要询问用户是否需要预览模板风格并指定模板生成。\n   - 普通生成路径参数：`template-id`\n   - 绘图生成路径参数：`banana-style-id`\n2. **普通生成路径中的图片风格确认**：在普通生成中询问用户是否需要指定AI图片风格，如果指定了，则参数--ai-picture必须等于true。参考--image-style参数获取方式。\n3. **绘图生成排版风格确认**：在绘图模式中还需要确认用户是否需要指定排版样式，如果需要，参考--banana-doc-type参数获取方式。\n\n---\n\n## 命令速查\n\n| 目标 | 命令 |\n|------|------|\n| 查看登录状态 | `auth status` |\n| 登录 | `auth login` |\n| 登出 | `auth logout` |\n| 刷新令牌 | `auth refresh` |\n| 生成 PPT（主题文字） | `ppt generate \"主题\"` |\n| 生成绘图PPT（主题文字） | `ppt generate_banana \"主题\"` |\n| 生成 PPT（文件导入） | `ppt import_file \"/path/to/file\"` |\n| 生成绘图PPT（文件导入） | `ppt import_file_banana \"/path/to/file\"` |\n| 查询 PPT 结果 | `ppt result <ppt_id>` |\n| 查看配置 | `config show` |\n| 重载配置 | `config reload` |\n| 查看版本 | `version` |\n\n---\n\n## chatppt auth — 认证管理\n\n所有 PPT 生成命令都需要先登录。\n\n```bash\n# 查看当前登录状态\nchatppt auth status\n\n# 登录（默认自动打开浏览器）\nchatppt auth login\n\n# 登录但不自动打开浏览器\nchatppt auth login --no-browser\n\n# 刷新令牌（令牌即将过期时使用）\nchatppt auth refresh\n\n# 登出\nchatppt auth logout\n```\n\n**典型返回（status）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"is_logged_in\": true,\n    \"user\": { \"id\": \"string\", \"nickname\": \"string\", \"mobile\": \"string\" }\n  }\n}\n```\n\n---\n\n## chatppt ppt generate — 根据主题生成 PPT\n\n**普通生成**\n```bash\nchatppt ppt generate \"主题描述\" [options]\n```\n\n**绘图生成**\n```bash\nchatppt ppt generate_banana \"主题描述\" [options]\n```\n\n### 必填\n\n| 参数 | 说明 |\n|------|------|\n| `主题描述` | PPT 主题，1–200 字符 |\n\n### 可选参数（公共）\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--complex` | int | 0 | 内容复杂度 1=简单，2=中等，3=复杂 |\n| `--language` | string | — | 语言：`zh-CN` / `en-US` / `zh-TW` |\n| `--web-search` | bool | false | 联网补充内容（额外收费，启用前需用户明确确认） |\n| `--poll` | bool | true | 是否自动轮询等待结果 |\n| `--interval` | int | 5 | 轮询间隔（秒） |\n| `--max-retries` | int | 60 | 最大轮询次数（约 5 分钟） |\n\n### 普通生成路径参数（与 Banana 路径平级）\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--font-name` | string | — | 字体名，如 `微软雅黑` |\n| `--theme-color` | string | — | 主题色：`蓝色` `红色` `绿色` `橙色` `紫色` `黄色` `粉色` |\n| `--ai-picture` | bool | true | 是否启用 AI 配图 |\n| `--image-style` | string | — | 配图风格描述，如 `商务风` |\n| `--template-id` | string | — | 预制矢量模板 ID |\n| `--custom-template-id` | string | — | 自定义模板 ID |\n| `--custom-page-count` | int | 0 | 页数，0 = 自动 |\n\n> 约束说明：\n> - 在生成之前询问用户是否需要浏览并指定模板，需要的话调用chatppt ppt template获取--template-id参数数据，调用之后的数据，一定要将每一项的至少一张图片展示给用户挑选。\n\n#### --image-style 参数获取方式\n\n```bash\nchatppt ppt picture_style\n```\n\n#### --template-id 参数获取方式\n获取PPT模板风格列表，支持分页查询\n\n支持查看模板的详细信息，包括：\n  - 模板ID、标题、风格描述\n  - 预览图片（封面、章节页、内容页、目录页）\n  - 配色方案\n\n示例:\n  chatppt ppt template                    # 获取第1页，每页10个\n  chatppt ppt template --page 2           # 获取第2页\n  chatppt ppt template --limit 20         # 每页显示20个\n  chatppt ppt template --page 2 --limit 5 # 获取第2页，每页5个\n\n```bash\nchatppt ppt template\n```\n\n### 绘图生成路径参数（与普通路径平级）\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| `--banana-style-id` | string | 绘图风格ID |\n| `--banana-doc-type` | string | 绘图排版样式 |\n| `--banana-reference-image` | string | 参考图片 URL 或路径 |\n\n> 约束说明：\n> - 绘图生成路径参数允许全部为空。\n> - 普通路径与绘图生成路径是两条平级路线，不存在“更高级”关系。\n> - Agent 必须先确认用户走哪条路径，再组装对应参数。\n> - 生成任务默认开启轮询（`--poll=true`），接口内自动调用轮询接口持续查询直到 `SUCCESS` 或 `FAILED`。\n> - 在生成之前询问用户是否需要浏览并指定风格，需要的话调用chatppt ppt banana-template获取--banana-style-id参数数据。\n\n#### --banana-style-id 页面绘图风格参数获取方式\n\n获取绘图生成PPT模板风格列表，支持分页查询\n\n支持查看模板的详细信息，包括：\n  - 模板ID、标题、风格描述\n  - 预览图片（封面、章节页、内容页、目录页）\n  - 配色方案\n\n示例:\n  chatppt ppt banana-template                    # 获取第1页，每页10个\n  chatppt ppt banana-template --page 2           # 获取第2页\n  chatppt ppt banana-template --limit 20         # 每页显示20个\n  chatppt ppt banana-template --page 2 --limit 5 # 获取第2页，每页5个\n\n```bash\nchatppt ppt banana-template\n```\n\n#### --banana-doc-type 页面排版样式参数获取方式\n\n```bash\nchatppt ppt template_banana_style\n```\n\n### 示例\n\n```bash\n# 基础生成\nchatppt ppt generate \"人工智能发展趋势\" --language zh\n\n# 普通生成路径（带样式）\nchatppt ppt generate \"2024年度工作总结\" \\\n  --language zh \\\n  --font-name \"微软雅黑\" \\\n  --theme-color blue \\\n  --custom-page-count 15 \\\n  --image-style \"商务风\"\n\n# 绘图生成风格路径（参数可部分或全部为空）\nchatppt ppt generate_banana \"产品介绍\" \\\n  --banana-style-id style_001 \\\n  --banana-doc-type business\n\n# 异步模式（不等待结果，手动查询）\nchatppt ppt generate \"主题\" --poll=false\n```\n\n### 成功返回\n\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"ppt_id\": \"ppt_1234567890\",\n    \"request_id\": \"string\",\n    \"title\": \"string\",\n    \"task_status\": \"2\",\n    \"images\": {\n      \"urls\": [{ \"url\": \"https://example.com/ppt/slide1.jpg\" }]\n    }\n  }\n}\n```\n\n**task_status 说明**\n\n| 值 | 含义 |\n|----|------|\n| `1` | 生成中 |\n| `2` | 已完成 |\n| `3` | 失败 |\n\n---\n\n## chatppt import file — 文件导入生成 PPT\n\n上传本地文件后基于其内容生成 PPT，适合将现有 Word / PDF / Markdown 转为演示文稿。\n\n**导入生成普通PPT**\n```bash\nchatppt ppt import_file --file-path \"/绝对路径/文档.docx\"\n```\n\n**导入生成绘图PPT**\n```bash\nchatppt ppt import_file_banana --file-path \"/绝对路径/文档.docx\"\n```\n\n### 必填\n\n| 参数 | 说明 |\n|------|------|\n| `--file-path` | 本地文件绝对路径 |\n\n### 支持格式\n\n| 格式 | 扩展名 | 大小上限 |\n|------|--------|---------|\n| Word | `.doc` `.docx` | 100 MB |\n| PDF | `.pdf` | 100 MB |\n| Markdown | `.md` | 100 MB |\n| 纯文本 | `.txt` | 100 MB |\n\n> 文本文件须为 UTF-8 编码。\n\n其余可选参数与 `ppt generate` 完全相同，包括普通路径参数与 Banana 路径参数。\n\n### 示例\n\n```bash\n# Word 文档导入\nchatppt ppt import_file \\\n  --file-path \"/Users/me/docs/product.docx\" \\\n  --theme-color 蓝色\n\n# PDF 导入，绘图生成风格\nchatppt ppt import_file_banana \\\n  --file \"/Users/me/docs/annual.pdf\" \\\n  --banana-style-id style_002 \\\n  --banana-doc-type business \n```\n\n返回格式与 `ppt generate` 相同。\n\n---\n\n## chatppt ppt result — 查询 PPT 生成结果\n\n在异步模式（`--poll=false`）下使用，主动查询任务状态。\n\n```bash\nchatppt ppt result <ppt_id> [-f pretty]\n```\n\n| 参数 | 说明 |\n|------|------|\n| `ppt_id` | `ppt generate` / `ppt import_file` 返回的 `ppt_id` |\n| `-f` | 输出格式（继承全局 flag） |\n\n---\n\n## config — 配置管理\n\n```bash\n# 查看当前配置\nchatppt config show\n\n# 重新加载配置文件\nchatppt config reload\n```\n\n**典型返回（show）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"app\": { \"name\": \"ChatPPT CLI\", \"version\": \"1.0.0\" },\n    \"api\": { \"url\": \"http://localhost:9157\", \"timeout\": 30000 },\n    \"auth\": { \"type\": \"Bearer\", \"access_key_id\": \"csVyGKphwM...\" },\n    \"ppt\": { \"default_ai_picture\": true }\n  }\n}\n```\n\n---\n\n## 生成下载链接 chatppt downloadppt\n\n```bash\nchatppt ppt downloadppt [ppt-id]\n```\n\n---\n\n## 生成线上编辑器链接 chatppt editor\n\n```bash\nchatppt ppt editor [ppt-id]\n```\n\n---\n\n## 错误处理\n\n### 常见错误码\n\n| 错误码 | 原因 | 处理 |\n|--------|------|------|\n| 400 | 参数错误（topic 超长、路径无效等） | 修正参数后重试 |\n| 401 | 未登录或令牌失效 | 执行 `auth login` |\n| 403 | 文件上传权限不足 | 检查 BCE AK/SK 配置 |\n| 413 | 文件超过 100 MB | 压缩或拆分文件 |\n| 429 | 请求频率过高 | 等待 5 秒后重试，最多 3 次 |\n| 500 | 服务端错误 | 等待 10 秒后重试，最多 3 次 |\n\n### 通用错误格式\n\n```json\n{\n  \"success\": false,\n  \"code\": 400,\n  \"message\": \"错误描述\",\n  \"error_type\": \"VALIDATION_ERROR\",\n  \"error_details\": { \"field\": \"topic\", \"reason\": \"主题长度必须在 1-200 字符之间\" },\n  \"suggestion\": \"请检查输入参数并重试\"\n}\n```\n\n---\n\n## 注意事项\n\n- **并发限制**：同一用户同时只能有一个 PPT 生成任务，需串行执行。\n- **文件上传**：依赖百度 BOS 服务，需正确配置 BCE 参数（AK/SK、Bucket 权限）。\n- **令牌自动刷新**：运行时令牌过期会自动刷新；刷新失败则需重新 `auth login`。\n- **敏感信息**：勿在日志中记录 AK/SK 或密码；定期清理云端不再使用的 PPT 文件。\n- **Agent 提问策略**：优先自动提取用户输入中的参数；仅在缺失关键信息时追问；若用户不想配置参数，按默认值执行。\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7akw0m5rtgarw268vaxsqap182sxw9\",\n  \"slug\": \"chatppt-agent\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1777023197015\n}\n\nFile v1.0.4:skill-card.md\n\n## Description:\n\nUses the ChatPPT CLI to generate PowerPoint presentations from a topic or from Word, PDF, Markdown, or text files, including login, generation, import, polling, download, and editor-link workflows.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[kahn520](https://clawhub.ai/user/kahn520)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to drive ChatPPT CLI workflows that turn prompts or existing documents into PPT presentations and retrieve finished results.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Global npm installation and CLI execution can affect the local environment.\n\nMitigation: Install and run the CLI in a restricted or disposable environment and avoid elevated npm installs unless explicitly required.\n\nRisk: Document-import workflows upload local content to the ChatPPT/Baidu BOS-backed service.\n\nMitigation: Do not upload confidential documents unless the user is comfortable sending their contents to that service.\n\nRisk: Authentication and storage configuration can expose AK/SK values, passwords, tokens, or raw auth config if logged or pasted.\n\nMitigation: Avoid displaying or storing raw credential material in chat logs, command output, or shared artifacts.\n\n## Reference(s):\n\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with shell commands and JSON response examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Single-stream agent guidance; generated PPT files and links are produced by the ChatPPT service.]\n\n## Skill Version(s):\n\n1.0.4 (source: evidence.release.version)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.3: 2 files, 5898 bytes\n\nFiles: SKILL.md (13840b), _meta.json (132b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: chatppt-cli\ndescription: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。\n---\n\n# ChatPPT CLI Skill\n\n## 环境准备\n\n### CLI 安装\n运行npm命令进行安装，安装前先检查是否已存在chatppt命令。\n\n```bash\nnpm install -g @yooai/cli\n```\n\n安装后可运行chatppt命令进行调用，比如：\n```bash\nchatppt --help\n```\n\n### 全局 Flag\n\n| Flag | 说明 |\n|------|------|\n| `--config string` | 配置文件路径（默认 `$HOME/.chatppt/config.yaml`） |\n| `-d, --debug` | 启用调试模式 |\n| `-f, --format string` | 输出格式：`json`（默认）/ `table` / `pretty` |\n| `-h, --help` | 帮助 |\n| `-v, --version` | 版本 |\n\n---\n\n## 标准工作流\n\n```\n1. 检查登录状态（auth status\n2. 未登录 → 执行登录（auth login）\n3. 生成 PPT（ppt generate 或 ppt import_file）\n4. 自动轮询等待结果（直到 `2` 或 `3`）\n5. 询问用户要直接下载pptx文件还是跳转到线上编辑器\n```\n\n### Agent 执行强约束（必须遵守）\n\n1. **严格流程顺序**：始终按“检查登录 -> 登录（如需要） -> 生成 PPT -> 轮询结果”执行，不得跳步。\n2. **路径二选一**：在生成前必须询问用户选择：\n   - 普通生成路径\n   - 绘图生成路径\n3. **自动提取参数**：先从用户输入中自动提取可识别参数值；仅对缺失且必要的信息追问用户。\n4. **用户不想配置参数**：若用户明确表示不关心参数或不想填写，全部使用默认值发起请求。\n5. **轮询展示图片**：轮询期间如果返回 `images.urls`，可直接把图片链接展示给用户。\n6. **成功即停止**：当任务状态为 `2`或`3` 后，仅返回成功结果与关键信息，不执行任何后续操作（后续接口未就绪）。\n7. **Web Search 收费确认**：`--web-search` 涉及额外收费，启用前必须先告知用户并获得明确确认；未确认则按关闭处理（传 `--web-search=false`）。\n8. **如果已经进入到了自动轮询流程中，要一直等待轮询成功或失败，不能在轮询过程中又进行生成。如果是Agent手动轮询，也需要轮询到成功或失败，不能中途停止对话等待用户继续输入。**\n9. **如果轮询接口返回了失败，不要再次生成，要询问用户是否要再次生成。**\n10. **如果用户权益用完了，提示用户去clawppt官网（https://chat-ppt.com/openclaw）进行充值点数。**\n\n### 参数提取与追问规则（Agent）\n\n1. **先提取后追问**：先从用户自然语言中提取参数（主题、路径选择、样式参数等），再补问缺失信息。\n2. **最小追问原则**：仅追问生成任务必需信息（如 `主题` 或导入时的 `文件路径`）。\n3. **路径参数边界**：\n   - 普通生成路径只处理：`font-name`、`theme-color`、`ai-picture`、`image-style`、`template-id`、`custom-template-id`、`custom-page-count`\n   - 绘图生成路径只处理：`banana-style-id`、`banana-doc-type`、`banana-reference-image`\n4. **默认值策略**：若用户明确“不想设置参数/你看着办/默认就行”，则所有未指定参数使用默认值，不再反复追问。\n5. **收费项单独确认**：`web-search` 为额外收费项，不能并入“默认就行”；必须单独征得用户同意后才启用。\n\n### 确认普通生成与绘图生成路径后的参数提取与追问规则（Agent）\n1. **模板风格确认**：在普通生成和绘图生成中，都需要询问用户是否需要预览模板风格并指定模板生成。\n   - 普通生成路径参数：`template-id`\n   - 绘图生成路径参数：`banana-style-id`\n2. **普通生成路径中的图片风格确认**：在普通生成中询问用户是否需要指定AI图片风格，如果指定了，则参数--ai-picture必须等于true。参考--image-style参数获取方式。\n3. **绘图生成排版风格确认**：在绘图模式中还需要确认用户是否需要指定排版样式，如果需要，参考--banana-doc-type参数获取方式。\n\n---\n\n## 命令速查\n\n| 目标 | 命令 |\n|------|------|\n| 查看登录状态 | `auth status` |\n| 登录 | `auth login` |\n| 登出 | `auth logout` |\n| 刷新令牌 | `auth refresh` |\n| 生成 PPT（主题文字） | `ppt generate \"主题\"` |\n| 生成绘图PPT（主题文字） | `ppt generate_banana \"主题\"` |\n| 生成 PPT（文件导入） | `ppt import_file \"/path/to/file\"` |\n| 生成绘图PPT（文件导入） | `ppt import_file_banana \"/path/to/file\"` |\n| 查询 PPT 结果 | `ppt result <ppt_id>` |\n| 查看配置 | `config show` |\n| 重载配置 | `config reload` |\n| 查看版本 | `version` |\n\n---\n\n## chatppt auth — 认证管理\n\n所有 PPT 生成命令都需要先登录。\n\n```bash\n# 查看当前登录状态\nchatppt auth status\n\n# 登录（默认自动打开浏览器）\nchatppt auth login\n\n# 登录但不自动打开浏览器\nchatppt auth login --no-browser\n\n# 刷新令牌（令牌即将过期时使用）\nchatppt auth refresh\n\n# 登出\nchatppt auth logout\n```\n\n**典型返回（status）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"is_logged_in\": true,\n    \"user\": { \"id\": \"string\", \"nickname\": \"string\", \"mobile\": \"string\" }\n  }\n}\n```\n\n---\n\n## chatppt ppt generate — 根据主题生成 PPT\n\n**普通生成**\n```bash\nchatppt ppt generate \"主题描述\" [options]\n```\n\n**绘图生成**\n```bash\nchatppt ppt generate_banana \"主题描述\" [options]\n```\n\n### 必填\n\n| 参数 | 说明 |\n|------|------|\n| `主题描述` | PPT 主题，1–200 字符 |\n\n### 可选参数（公共）\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--complex` | int | 0 | 内容复杂度 1=简单，2=中等，3=复杂 |\n| `--language` | string | — | 语言：`zh-CN` / `en-US` / `zh-TW` |\n| `--web-search` | bool | false | 联网补充内容（额外收费，启用前需用户明确确认） |\n| `--poll` | bool | true | 是否自动轮询等待结果 |\n| `--interval` | int | 5 | 轮询间隔（秒） |\n| `--max-retries` | int | 60 | 最大轮询次数（约 5 分钟） |\n\n### 普通生成路径参数（与 Banana 路径平级）\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--font-name` | string | — | 字体名，如 `微软雅黑` |\n| `--theme-color` | string | — | 主题色：`蓝色` `红色` `绿色` `橙色` `紫色` `黄色` `粉色` |\n| `--ai-picture` | bool | true | 是否启用 AI 配图 |\n| `--image-style` | string | — | 配图风格描述，如 `商务风` |\n| `--template-id` | string | — | 预制矢量模板 ID |\n| `--custom-template-id` | string | — | 自定义模板 ID |\n| `--custom-page-count` | int | 0 | 页数，0 = 自动 |\n\n> 约束说明：\n> - 在生成之前询问用户是否需要浏览并指定模板，需要的话调用chatppt ppt template获取--template-id参数数据，调用之后的数据，一定要将每一项的至少一张图片展示给用户挑选。\n\n#### --image-style 参数获取方式\n\n```bash\nchatppt ppt picture_style\n```\n\n#### --template-id 参数获取方式\n获取PPT模板风格列表，支持分页查询\n\n支持查看模板的详细信息，包括：\n  - 模板ID、标题、风格描述\n  - 预览图片（封面、章节页、内容页、目录页）\n  - 配色方案\n\n示例:\n  chatppt ppt template                    # 获取第1页，每页10个\n  chatppt ppt template --page 2           # 获取第2页\n  chatppt ppt template --limit 20         # 每页显示20个\n  chatppt ppt template --page 2 --limit 5 # 获取第2页，每页5个\n\n```bash\nchatppt ppt template\n```\n\n### 绘图生成路径参数（与普通路径平级）\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| `--banana-style-id` | string | 绘图风格ID |\n| `--banana-doc-type` | string | 绘图排版样式 |\n| `--banana-reference-image` | string | 参考图片 URL 或路径 |\n\n> 约束说明：\n> - 绘图生成路径参数允许全部为空。\n> - 普通路径与绘图生成路径是两条平级路线，不存在“更高级”关系。\n> - Agent 必须先确认用户走哪条路径，再组装对应参数。\n> - 生成任务默认开启轮询（`--poll=true`），接口内自动调用轮询接口持续查询直到 `SUCCESS` 或 `FAILED`。\n> - 在生成之前询问用户是否需要浏览并指定风格，需要的话调用chatppt ppt banana-template获取--banana-style-id参数数据。\n\n#### --banana-style-id 页面绘图风格参数获取方式\n\n获取绘图生成PPT模板风格列表，支持分页查询\n\n支持查看模板的详细信息，包括：\n  - 模板ID、标题、风格描述\n  - 预览图片（封面、章节页、内容页、目录页）\n  - 配色方案\n\n示例:\n  chatppt ppt banana-template                    # 获取第1页，每页10个\n  chatppt ppt banana-template --page 2           # 获取第2页\n  chatppt ppt banana-template --limit 20         # 每页显示20个\n  chatppt ppt banana-template --page 2 --limit 5 # 获取第2页，每页5个\n\n```bash\nchatppt ppt banana-template\n```\n\n#### --banana-doc-type 页面排版样式参数获取方式\n\n```bash\nchatppt ppt template_banana_style\n```\n\n### 示例\n\n```bash\n# 基础生成\nchatppt ppt generate \"人工智能发展趋势\" --language zh\n\n# 普通生成路径（带样式）\nchatppt ppt generate \"2024年度工作总结\" \\\n  --language zh \\\n  --font-name \"微软雅黑\" \\\n  --theme-color blue \\\n  --custom-page-count 15 \\\n  --image-style \"商务风\"\n\n# 绘图生成风格路径（参数可部分或全部为空）\nchatppt ppt generate_banana \"产品介绍\" \\\n  --banana-style-id style_001 \\\n  --banana-doc-type business\n\n# 异步模式（不等待结果，手动查询）\nchatppt ppt generate \"主题\" --poll=false\n```\n\n### 成功返回\n\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"ppt_id\": \"ppt_1234567890\",\n    \"request_id\": \"string\",\n    \"title\": \"string\",\n    \"task_status\": \"2\",\n    \"images\": {\n      \"urls\": [{ \"url\": \"https://example.com/ppt/slide1.jpg\" }]\n    }\n  }\n}\n```\n\n**task_status 说明**\n\n| 值 | 含义 |\n|----|------|\n| `1` | 生成中 |\n| `2` | 已完成 |\n| `3` | 失败 |\n\n---\n\n## chatppt import file — 文件导入生成 PPT\n\n上传本地文件后基于其内容生成 PPT，适合将现有 Word / PDF / Markdown 转为演示文稿。\n\n**导入生成普通PPT**\n```bash\nchatppt ppt import_file --file-path \"/绝对路径/文档.docx\"\n```\n\n**导入生成绘图PPT**\n```bash\nchatppt ppt import_file_banana --file-path \"/绝对路径/文档.docx\"\n```\n\n### 必填\n\n| 参数 | 说明 |\n|------|------|\n| `--file-path` | 本地文件绝对路径 |\n\n### 支持格式\n\n| 格式 | 扩展名 | 大小上限 |\n|------|--------|---------|\n| Word | `.doc` `.docx` | 100 MB |\n| PDF | `.pdf` | 100 MB |\n| Markdown | `.md` | 100 MB |\n| 纯文本 | `.txt` | 100 MB |\n\n> 文本文件须为 UTF-8 编码。\n\n其余可选参数与 `ppt generate` 完全相同，包括普通路径参数与 Banana 路径参数。\n\n### 示例\n\n```bash\n# Word 文档导入\nchatppt ppt import_file \\\n  --file-path \"/Users/me/docs/product.docx\" \\\n  --theme-color 蓝色\n\n# PDF 导入，绘图生成风格\nchatppt ppt import_file_banana \\\n  --file \"/Users/me/docs/annual.pdf\" \\\n  --banana-style-id style_002 \\\n  --banana-doc-type business \n```\n\n返回格式与 `ppt generate` 相同。\n\n---\n\n## chatppt ppt result — 查询 PPT 生成结果\n\n在异步模式（`--poll=false`）下使用，主动查询任务状态。\n\n```bash\nchatppt ppt result <ppt_id> [-f pretty]\n```\n\n| 参数 | 说明 |\n|------|------|\n| `ppt_id` | `ppt generate` / `ppt import_file` 返回的 `ppt_id` |\n| `-f` | 输出格式（继承全局 flag） |\n\n---\n\n## config — 配置管理\n\n```bash\n# 查看当前配置\nchatppt config show\n\n# 重新加载配置文件\nchatppt config reload\n```\n\n**典型返回（show）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"app\": { \"name\": \"ChatPPT CLI\", \"version\": \"1.0.0\" },\n    \"api\": { \"url\": \"http://localhost:9157\", \"timeout\": 30000 },\n    \"auth\": { \"type\": \"Bearer\", \"access_key_id\": \"csVyGKphwM...\" },\n    \"ppt\": { \"default_ai_picture\": true }\n  }\n}\n```\n\n---\n\n## 生成下载链接 chatppt downloadppt\n\n```bash\nchatppt ppt downloadppt [ppt-id]\n```\n\n---\n\n## 生成线上编辑器链接 chatppt editor\n\n```bash\nchatppt ppt editor [ppt-id]\n```\n\n---\n\n## 错误处理\n\n### 常见错误码\n\n| 错误码 | 原因 | 处理 |\n|--------|------|------|\n| 400 | 参数错误（topic 超长、路径无效等） | 修正参数后重试 |\n| 401 | 未登录或令牌失效 | 执行 `auth login` |\n| 403 | 文件上传权限不足 | 检查 BCE AK/SK 配置 |\n| 413 | 文件超过 100 MB | 压缩或拆分文件 |\n| 429 | 请求频率过高 | 等待 5 秒后重试，最多 3 次 |\n| 500 | 服务端错误 | 等待 10 秒后重试，最多 3 次 |\n\n### 通用错误格式\n\n```json\n{\n  \"success\": false,\n  \"code\": 400,\n  \"message\": \"错误描述\",\n  \"error_type\": \"VALIDATION_ERROR\",\n  \"error_details\": { \"field\": \"topic\", \"reason\": \"主题长度必须在 1-200 字符之间\" },\n  \"suggestion\": \"请检查输入参数并重试\"\n}\n```\n\n---\n\n## 注意事项\n\n- **并发限制**：同一用户同时只能有一个 PPT 生成任务，需串行执行。\n- **文件上传**：依赖百度 BOS 服务，需正确配置 BCE 参数（AK/SK、Bucket 权限）。\n- **令牌自动刷新**：运行时令牌过期会自动刷新；刷新失败则需重新 `auth login`。\n- **敏感信息**：勿在日志中记录 AK/SK 或密码；定期清理云端不再使用的 PPT 文件。\n- **Agent 提问策略**：优先自动提取用户输入中的参数；仅在缺失关键信息时追问；若用户不想配置参数，按默认值执行。\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7akw0m5rtgarw268vaxsqap182sxw9\",\n  \"slug\": \"chatppt-agent\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1777023025916\n}\n\nArchive v1.0.2: 2 files, 5753 bytes\n\nFiles: SKILL.md (13523b), _meta.json (132b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: chatppt-cli\ndescription: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。\n---\n\n# ChatPPT CLI Skill\n\n## 环境准备\n\n### CLI 安装\n运行npm命令进行安装，安装前先检查是否已存在chatppt命令。\n\n```bash\nnpm install -g @yooai/cli\n```\n\n安装后可运行chatppt命令进行调用，比如：\n```bash\nchatppt --help\n```\n\n### 全局 Flag\n\n| Flag | 说明 |\n|------|------|\n| `--config string` | 配置文件路径（默认 `$HOME/.chatppt/config.yaml`） |\n| `-d, --debug` | 启用调试模式 |\n| `-f, --format string` | 输出格式：`json`（默认）/ `table` / `pretty` |\n| `-h, --help` | 帮助 |\n| `-v, --version` | 版本 |\n\n---\n\n## 标准工作流\n\n```\n1. 检查登录状态（auth status\n2. 未登录 → 执行登录（auth login）\n3. 生成 PPT（ppt generate 或 ppt import_file）\n4. 自动轮询等待结果（直到 `2` 或 `3`）\n5. 询问用户要直接下载pptx文件还是跳转到线上编辑器\n```\n\n### Agent 执行强约束（必须遵守）\n\n1. **严格流程顺序**：始终按“检查登录 -> 登录（如需要） -> 生成 PPT -> 轮询结果”执行，不得跳步。\n2. **路径二选一**：在生成前必须询问用户选择：\n   - 普通生成路径\n   - 绘图生成路径\n3. **自动提取参数**：先从用户输入中自动提取可识别参数值；仅对缺失且必要的信息追问用户。\n4. **用户不想配置参数**：若用户明确表示不关心参数或不想填写，全部使用默认值发起请求。\n5. **轮询展示图片**：轮询期间如果返回 `images.urls`，可直接把图片链接展示给用户。\n6. **成功即停止**：当任务状态为 `2`或`3` 后，仅返回成功结果与关键信息，不执行任何后续操作（后续接口未就绪）。\n7. **Web Search 收费确认**：`--web-search` 涉及额外收费，启用前必须先告知用户并获得明确确认；未确认则按关闭处理（传 `--web-search=true`）。\n8. **如果已经进入到了自动轮询流程中，要一直等待轮询成功或失败，不能在轮询过程中又进行生成。如果是Agent手动轮询，也需要轮询到成功或失败，不能中途停止对话等待用户继续输入。**\n\n### 参数提取与追问规则（Agent）\n\n1. **先提取后追问**：先从用户自然语言中提取参数（主题、路径选择、样式参数等），再补问缺失信息。\n2. **最小追问原则**：仅追问生成任务必需信息（如 `主题` 或导入时的 `文件路径`）。\n3. **路径参数边界**：\n   - 普通生成路径只处理：`font-name`、`theme-color`、`ai-picture`、`image-style`、`template-id`、`custom-template-id`、`custom-page-count`\n   - 绘图生成路径只处理：`banana-style-id`、`banana-doc-type`、`banana-reference-image`\n4. **默认值策略**：若用户明确“不想设置参数/你看着办/默认就行”，则所有未指定参数使用默认值，不再反复追问。\n5. **收费项单独确认**：`web-search` 为额外收费项，不能并入“默认就行”；必须单独征得用户同意后才启用。\n\n### 确认普通生成与绘图生成路径后的参数提取与追问规则（Agent）\n1. **模板风格确认**：在普通生成和绘图生成中，都需要询问用户是否需要预览模板风格并指定模板生成。\n   - 普通生成路径参数：`template-id`\n   - 绘图生成路径参数：`banana-style-id`\n2. **普通生成路径中的图片风格确认**：在普通生成中询问用户是否需要指定AI图片风格，如果指定了，则参数--ai-picture必须等于true。参考--image-style参数获取方式。\n3. **绘图生成排版风格确认**：在绘图模式中还需要确认用户是否需要指定排版样式，如果需要，参考--banana-doc-type参数获取方式。\n\n---\n\n## 命令速查\n\n| 目标 | 命令 |\n|------|------|\n| 查看登录状态 | `auth status` |\n| 登录 | `auth login` |\n| 登出 | `auth logout` |\n| 刷新令牌 | `auth refresh` |\n| 生成 PPT（主题文字） | `ppt generate \"主题\"` |\n| 生成绘图PPT（主题文字） | `ppt generate_banana \"主题\"` |\n| 生成 PPT（文件导入） | `ppt import_file \"/path/to/file\"` |\n| 生成绘图PPT（文件导入） | `ppt import_file_banana \"/path/to/file\"` |\n| 查询 PPT 结果 | `ppt result <ppt_id>` |\n| 查看配置 | `config show` |\n| 重载配置 | `config reload` |\n| 查看版本 | `version` |\n\n---\n\n## chatppt auth — 认证管理\n\n所有 PPT 生成命令都需要先登录。\n\n```bash\n# 查看当前登录状态\nchatppt auth status\n\n# 登录（默认自动打开浏览器）\nchatppt auth login\n\n# 登录但不自动打开浏览器\nchatppt auth login --no-browser\n\n# 刷新令牌（令牌即将过期时使用）\nchatppt auth refresh\n\n# 登出\nchatppt auth logout\n```\n\n**典型返回（status）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"is_logged_in\": true,\n    \"user\": { \"id\": \"string\", \"nickname\": \"string\", \"mobile\": \"string\" }\n  }\n}\n```\n\n---\n\n## chatppt ppt generate — 根据主题生成 PPT\n\n**普通生成**\n```bash\nchatppt ppt generate \"主题描述\" [options]\n```\n\n**绘图生成**\n```bash\nchatppt ppt generate_banana \"主题描述\" [options]\n```\n\n### 必填\n\n| 参数 | 说明 |\n|------|------|\n| `主题描述` | PPT 主题，1–200 字符 |\n\n### 可选参数（公共）\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--complex` | int | 0 | 内容复杂度 1=简单，2=中等，3=复杂 |\n| `--language` | string | — | 语言：`zh-CN` / `en-US` / `zh-TW` |\n| `--web-search` | bool | false | 联网补充内容（额外收费，启用前需用户明确确认） |\n| `--poll` | bool | true | 是否自动轮询等待结果 |\n| `--interval` | int | 5 | 轮询间隔（秒） |\n| `--max-retries` | int | 60 | 最大轮询次数（约 5 分钟） |\n\n### 普通生成路径参数（与 Banana 路径平级）\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--font-name` | string | — | 字体名，如 `微软雅黑` |\n| `--theme-color` | string | — | 主题色：`蓝色` `红色` `绿色` `橙色` `紫色` `黄色` `粉色` |\n| `--ai-picture` | bool | true | 是否启用 AI 配图 |\n| `--image-style` | string | — | 配图风格描述，如 `商务风` |\n| `--template-id` | string | — | 预制矢量模板 ID |\n| `--custom-template-id` | string | — | 自定义模板 ID |\n| `--custom-page-count` | int | 0 | 页数，0 = 自动 |\n\n> 约束说明：\n> - 在生成之前询问用户是否需要浏览并指定模板，需要的话调用chatppt ppt template获取--template-id参数数据。\n\n#### --image-style 参数获取方式\n\n```bash\nchatppt ppt picture_style\n```\n\n### 绘图生成路径参数（与普通路径平级）\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| `--banana-style-id` | string | 绘图风格ID |\n| `--banana-doc-type` | string | 绘图排版样式 |\n| `--banana-reference-image` | string | 参考图片 URL 或路径 |\n\n> 约束说明：\n> - 绘图生成路径参数允许全部为空。\n> - 普通路径与绘图生成路径是两条平级路线，不存在“更高级”关系。\n> - Agent 必须先确认用户走哪条路径，再组装对应参数。\n> - 生成任务默认开启轮询（`--poll=true`），接口内自动调用轮询接口持续查询直到 `SUCCESS` 或 `FAILED`。\n> - 在生成之前询问用户是否需要浏览并指定风格，需要的话调用chatppt ppt banana-template获取--banana-style-id参数数据。\n\n\n#### --template-id 参数获取方式\n获取PPT模板风格列表，支持分页查询\n\n支持查看模板的详细信息，包括：\n  - 模板ID、标题、风格描述\n  - 预览图片（封面、章节页、内容页、目录页）\n  - 配色方案\n\n示例:\n  chatppt ppt template                    # 获取第1页，每页10个\n  chatppt ppt template --page 2           # 获取第2页\n  chatppt ppt template --limit 20         # 每页显示20个\n  chatppt ppt template --page 2 --limit 5 # 获取第2页，每页5个\n\n```bash\nchatppt ppt template\n```\n\n#### --banana-style-id 页面绘图风格参数获取方式\n\n获取绘图生成PPT模板风格列表，支持分页查询\n\n支持查看模板的详细信息，包括：\n  - 模板ID、标题、风格描述\n  - 预览图片（封面、章节页、内容页、目录页）\n  - 配色方案\n\n示例:\n  chatppt ppt banana-template                    # 获取第1页，每页10个\n  chatppt ppt banana-template --page 2           # 获取第2页\n  chatppt ppt banana-template --limit 20         # 每页显示20个\n  chatppt ppt banana-template --page 2 --limit 5 # 获取第2页，每页5个\n\n```bash\nchatppt ppt banana-template\n```\n\n#### --banana-doc-type 页面排版样式参数获取方式\n\n```bash\nchatppt ppt template_banana_style\n```\n\n### 示例\n\n```bash\n# 基础生成\nchatppt ppt generate \"人工智能发展趋势\" --language zh\n\n# 普通生成路径（带样式）\nchatppt ppt generate \"2024年度工作总结\" \\\n  --language zh \\\n  --font-name \"微软雅黑\" \\\n  --theme-color blue \\\n  --custom-page-count 15 \\\n  --image-style \"商务风\"\n\n# 绘图生成风格路径（参数可部分或全部为空）\nchatppt ppt generate_banana \"产品介绍\" \\\n  --banana-style-id style_001 \\\n  --banana-doc-type business\n\n# 异步模式（不等待结果，手动查询）\nchatppt ppt generate \"主题\" --poll=false\n```\n\n### 成功返回\n\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"ppt_id\": \"ppt_1234567890\",\n    \"request_id\": \"string\",\n    \"title\": \"string\",\n    \"task_status\": \"2\",\n    \"images\": {\n      \"urls\": [{ \"url\": \"https://example.com/ppt/slide1.jpg\" }]\n    }\n  }\n}\n```\n\n**task_status 说明**\n\n| 值 | 含义 |\n|----|------|\n| `1` | 生成中 |\n| `2` | 已完成 |\n| `3` | 失败 |\n\n---\n\n## chatppt import file — 文件导入生成 PPT\n\n上传本地文件后基于其内容生成 PPT，适合将现有 Word / PDF / Markdown 转为演示文稿。\n\n**导入生成普通PPT**\n```bash\nchatppt ppt import_file --file-path \"/绝对路径/文档.docx\"\n```\n\n**导入生成绘图PPT**\n```bash\nchatppt ppt import_file_banana --file-path \"/绝对路径/文档.docx\"\n```\n\n### 必填\n\n| 参数 | 说明 |\n|------|------|\n| `--file-path` | 本地文件绝对路径 |\n\n### 支持格式\n\n| 格式 | 扩展名 | 大小上限 |\n|------|--------|---------|\n| Word | `.doc` `.docx` | 100 MB |\n| PDF | `.pdf` | 100 MB |\n| Markdown | `.md` | 100 MB |\n| 纯文本 | `.txt` | 100 MB |\n\n> 文本文件须为 UTF-8 编码。\n\n其余可选参数与 `ppt generate` 完全相同，包括普通路径参数与 Banana 路径参数。\n\n### 示例\n\n```bash\n# Word 文档导入\nchatppt ppt import_file \\\n  --file-path \"/Users/me/docs/product.docx\" \\\n  --theme-color 蓝色\n\n# PDF 导入，绘图生成风格\nchatppt ppt import_file_banana \\\n  --file \"/Users/me/docs/annual.pdf\" \\\n  --banana-style-id style_002 \\\n  --banana-doc-type business \n```\n\n返回格式与 `ppt generate` 相同。\n\n---\n\n## chatppt ppt result — 查询 PPT 生成结果\n\n在异步模式（`--poll=false`）下使用，主动查询任务状态。\n\n```bash\nchatppt ppt result <ppt_id> [-f pretty]\n```\n\n| 参数 | 说明 |\n|------|------|\n| `ppt_id` | `ppt generate` / `ppt import_file` 返回的 `ppt_id` |\n| `-f` | 输出格式（继承全局 flag） |\n\n---\n\n## config — 配置管理\n\n```bash\n# 查看当前配置\nchatppt config show\n\n# 重新加载配置文件\nchatppt config reload\n```\n\n**典型返回（show）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"app\": { \"name\": \"ChatPPT CLI\", \"version\": \"1.0.0\" },\n    \"api\": { \"url\": \"http://localhost:9157\", \"timeout\": 30000 },\n    \"auth\": { \"type\": \"Bearer\", \"access_key_id\": \"csVyGKphwM...\" },\n    \"ppt\": { \"default_ai_picture\": true }\n  }\n}\n```\n\n---\n\n## 生成下载链接 chatppt downloadppt\n\n```bash\nchatppt ppt downloadppt [ppt-id]\n```\n\n---\n\n## 生成线上编辑器链接 chatppt editor\n\n```bash\nchatppt ppt editor [ppt-id]\n```\n\n---\n\n## 错误处理\n\n### 常见错误码\n\n| 错误码 | 原因 | 处理 |\n|--------|------|------|\n| 400 | 参数错误（topic 超长、路径无效等） | 修正参数后重试 |\n| 401 | 未登录或令牌失效 | 执行 `auth login` |\n| 403 | 文件上传权限不足 | 检查 BCE AK/SK 配置 |\n| 413 | 文件超过 100 MB | 压缩或拆分文件 |\n| 429 | 请求频率过高 | 等待 5 秒后重试，最多 3 次 |\n| 500 | 服务端错误 | 等待 10 秒后重试，最多 3 次 |\n\n### 通用错误格式\n\n```json\n{\n  \"success\": false,\n  \"code\": 400,\n  \"message\": \"错误描述\",\n  \"error_type\": \"VALIDATION_ERROR\",\n  \"error_details\": { \"field\": \"topic\", \"reason\": \"主题长度必须在 1-200 字符之间\" },\n  \"suggestion\": \"请检查输入参数并重试\"\n}\n```\n\n---\n\n## 注意事项\n\n- **并发限制**：同一用户同时只能有一个 PPT 生成任务，需串行执行。\n- **文件上传**：依赖百度 BOS 服务，需正确配置 BCE 参数（AK/SK、Bucket 权限）。\n- **令牌自动刷新**：运行时令牌过期会自动刷新；刷新失败则需重新 `auth login`。\n- **敏感信息**：勿在日志中记录 AK/SK 或密码；定期清理云端不再使用的 PPT 文件。\n- **Agent 提问策略**：优先自动提取用户输入中的参数；仅在缺失关键信息时追问；若用户不想配置参数，按默认值执行。\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7akw0m5rtgarw268vaxsqap182sxw9\",\n  \"slug\": \"chatppt-agent\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1776851136075\n}\n\nArchive v1.0.1: 2 files, 5442 bytes\n\nFiles: SKILL.md (11738b), _meta.json (132b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: chatppt-cli\ndescription: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。\n---\n\n# ChatPPT CLI Skill\n\n## 环境准备\n\n### CLI 安装\n运行npm命令进行安装，安装前先检查是否已存在chatppt命令。\n\n```bash\nnpm install -g @yooai/cli\n```\n\n安装后可运行chatppt命令进行调用，比如：\n```bash\nchatppt --help\n```\n\n### 全局 Flag\n\n| Flag | 说明 |\n|------|------|\n| `--config string` | 配置文件路径（默认 `$HOME/.chatppt/config.yaml`） |\n| `-d, --debug` | 启用调试模式 |\n| `-f, --format string` | 输出格式：`json`（默认）/ `table` / `pretty` |\n| `-h, --help` | 帮助 |\n| `-v, --version` | 版本 |\n\n---\n\n## 标准工作流\n\n```\n1. 检查登录状态（auth status\n2. 未登录 → 执行登录（auth login）\n3. 生成 PPT（ppt generate 或 ppt import_file）\n4. 自动轮询等待结果（直到 `2` 或 `3`）\n5. 询问用户要直接下载pptx文件还是跳转到线上编辑器\n```\n\n### Agent 执行强约束（必须遵守）\n\n1. **严格流程顺序**：始终按“检查登录 -> 登录（如需要） -> 生成 PPT -> 轮询结果”执行，不得跳步。\n2. **路径二选一**：在生成前必须询问用户选择：\n   - 普通生成路径\n   - Banana 风格路径\n3. **自动提取参数**：先从用户输入中自动提取可识别参数值；仅对缺失且必要的信息追问用户。\n4. **用户不想配置参数**：若用户明确表示不关心参数或不想填写，全部使用默认值发起请求。\n5. **轮询展示图片**：轮询期间如果返回 `images.urls`，可直接把图片链接展示给用户。\n6. **成功即停止**：当任务状态为 `2`或`3` 后，仅返回成功结果与关键信息，不执行任何后续操作（后续接口未就绪）。\n7. **Web Search 收费确认**：`--web-search` 涉及额外收费，启用前必须先告知用户并获得明确确认；未确认则按关闭处理（传 `--web-search=true`）。\n8. **如果已经进入到了轮询流程中，要一直等待轮询成功或失败，不能在轮询过程中又进行生成。**\n\n### 参数提取与追问规则（Agent）\n\n1. **先提取后追问**：先从用户自然语言中提取参数（主题、路径选择、样式参数等），再补问缺失信息。\n2. **最小追问原则**：仅追问生成任务必需信息（如 `主题` 或导入时的 `文件路径`）。\n3. **路径参数边界**：\n   - 普通生成路径只处理：`font-name`、`theme-color`、`ai-picture`、`image-style`、`custom-template-id`、`custom-page-count`\n   - Banana 路径只处理：`banana-style-id`、`banana-doc-type`、`banana-reference-image`\n4. **默认值策略**：若用户明确“不想设置参数/你看着办/默认就行”，则所有未指定参数使用默认值，不再反复追问。\n5. **收费项单独确认**：`web-search` 为额外收费项，不能并入“默认就行”；必须单独征得用户同意后才启用。\n\n---\n\n## 命令速查\n\n| 目标 | 命令 |\n|------|------|\n| 查看登录状态 | `auth status` |\n| 登录 | `auth login` |\n| 登出 | `auth logout` |\n| 刷新令牌 | `auth refresh` |\n| 生成 PPT（主题文字） | `ppt generate \"主题\"` |\n| 生成绘图PPT（主题文字） | `ppt generate_banana \"主题\"` |\n| 生成 PPT（文件导入） | `ppt import_file \"/path/to/file\"` |\n| 生成绘图PPT（文件导入） | `ppt import_file_banana \"/path/to/file\"` |\n| 查询 PPT 结果 | `ppt result <ppt_id>` |\n| 查看配置 | `config show` |\n| 重载配置 | `config reload` |\n| 查看版本 | `version` |\n\n---\n\n## chatppt auth — 认证管理\n\n所有 PPT 生成命令都需要先登录。\n\n```bash\n# 查看当前登录状态\nchatppt auth status\n\n# 登录（默认自动打开浏览器）\nchatppt auth login\n\n# 登录但不自动打开浏览器\nchatppt auth login --no-browser\n\n# 刷新令牌（令牌即将过期时使用）\nchatppt auth refresh\n\n# 登出\nchatppt auth logout\n```\n\n**典型返回（status）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"is_logged_in\": true,\n    \"user\": { \"id\": \"string\", \"nickname\": \"string\", \"mobile\": \"string\" }\n  }\n}\n```\n\n---\n\n## chatppt ppt generate — 根据主题生成 PPT\n\n**普通生成**\n```bash\nchatppt ppt generate \"主题描述\" [options]\n```\n\n**绘图生成**\n```bash\nchatppt ppt generate_banana \"主题描述\" [options]\n```\n\n### 必填\n\n| 参数 | 说明 |\n|------|------|\n| `主题描述` | PPT 主题，1–200 字符 |\n\n### 可选参数（公共）\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--complex` | int | 0 | 内容复杂度 1=简单，2=中等，3=复杂 |\n| `--language` | string | — | 语言：`zh-CN` / `en-US` / `zh-TW` |\n| `--web-search` | bool | false | 联网补充内容（额外收费，启用前需用户明确确认） |\n| `--poll` | bool | true | 是否自动轮询等待结果 |\n| `--interval` | int | 5 | 轮询间隔（秒） |\n| `--max-retries` | int | 60 | 最大轮询次数（约 5 分钟） |\n\n### 普通生成路径参数（与 Banana 路径平级）\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--font-name` | string | — | 字体名，如 `微软雅黑` |\n| `--theme-color` | string | — | 主题色：`蓝色` `红色` `绿色` `橙色` `紫色` `黄色` `粉色` |\n| `--ai-picture` | bool | true | 是否启用 AI 配图 |\n| `--image-style` | string | — | 配图风格描述，如 `商务风` |\n| `--custom-template-id` | string | — | 自定义模板 ID |\n| `--custom-page-count` | int | 0 | 页数，0 = 自动 |\n\n### Banana 风格路径参数（与普通路径平级）\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| `--banana-style-id` | string | Banana 风格 ID |\n| `--banana-doc-type` | string | 文档类型：`business` / `education` / `marketing` / `technology` / `medical` / `finance` |\n| `--banana-reference-image` | string | 参考图片 URL 或路径 |\n\n> 约束说明：\n> - Banana 路径参数允许全部为空。\n> - 普通路径与 Banana 路径是两条平级路线，不存在“更高级”关系。\n> - Agent 必须先确认用户走哪条路径，再组装对应参数。\n> - 生成任务默认开启轮询（`--poll=true`），接口内自动调用轮询接口持续查询直到 `SUCCESS` 或 `FAILED`。\n> - 在生成之前询问用户是否需要浏览并指定风格，需要的话调用chatppt ppt banana-template获取--banana-style-id参数数据。\n\n#### --banana-style-id 参数获取方式\n\n获取Banana PPT模板风格列表，支持分页查询\n\n支持查看模板的详细信息，包括：\n  - 模板ID、标题、风格描述\n  - 预览图片（封面、章节页、内容页、目录页）\n  - 配色方案\n\n示例:\n  chatppt ppt banana-template                    # 获取第1页，每页10个\n  chatppt ppt banana-template --page 2           # 获取第2页\n  chatppt ppt banana-template --limit 20         # 每页显示20个\n  chatppt ppt banana-template --page 2 --limit 5 # 获取第2页，每页5个\n\n```bash\nchatppt ppt banana-template\n```\n\n### 示例\n\n```bash\n# 基础生成\nchatppt ppt generate \"人工智能发展趋势\" --language zh\n\n# 普通生成路径（带样式）\nchatppt ppt generate \"2024年度工作总结\" \\\n  --language zh \\\n  --font-name \"微软雅黑\" \\\n  --theme-color blue \\\n  --custom-page-count 15 \\\n  --image-style \"商务风\"\n\n# Banana 风格路径（参数可部分或全部为空）\nchatppt ppt generate_banana \"产品介绍\" \\\n  --banana-style-id style_001 \\\n  --banana-doc-type business\n\n# 异步模式（不等待结果，手动查询）\nchatppt ppt generate \"主题\" --poll=false\n```\n\n### 成功返回\n\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"ppt_id\": \"ppt_1234567890\",\n    \"request_id\": \"string\",\n    \"title\": \"string\",\n    \"task_status\": \"2\",\n    \"images\": {\n      \"urls\": [{ \"url\": \"https://example.com/ppt/slide1.jpg\" }]\n    }\n  }\n}\n```\n\n**task_status 说明**\n\n| 值 | 含义 |\n|----|------|\n| `1` | 生成中 |\n| `2` | 已完成 |\n| `3` | 失败 |\n\n---\n\n## chatppt import file — 文件导入生成 PPT\n\n上传本地文件后基于其内容生成 PPT，适合将现有 Word / PDF / Markdown 转为演示文稿。\n\n**导入生成普通PPT**\n```bash\nchatppt ppt import_file --file-path \"/绝对路径/文档.docx\"\n```\n\n**导入生成绘图PPT**\n```bash\nchatppt ppt import_file_banana --file-path \"/绝对路径/文档.docx\"\n```\n\n### 必填\n\n| 参数 | 说明 |\n|------|------|\n| `--file-path` | 本地文件绝对路径 |\n\n### 支持格式\n\n| 格式 | 扩展名 | 大小上限 |\n|------|--------|---------|\n| Word | `.doc` `.docx` | 100 MB |\n| PDF | `.pdf` | 100 MB |\n| Markdown | `.md` | 100 MB |\n| 纯文本 | `.txt` | 100 MB |\n\n> 文本文件须为 UTF-8 编码。\n\n其余可选参数与 `ppt generate` 完全相同，包括普通路径参数与 Banana 路径参数。\n\n### 示例\n\n```bash\n# Word 文档导入\nchatppt ppt import_file \\\n  --file-path \"/Users/me/docs/product.docx\" \\\n  --theme-color 蓝色\n\n# PDF 导入，Banana 风格\nchatppt ppt import_file_banana \\\n  --file \"/Users/me/docs/annual.pdf\" \\\n  --banana-style-id style_002 \\\n  --banana-doc-type business \n```\n\n返回格式与 `ppt generate` 相同。\n\n---\n\n## chatppt ppt result — 查询 PPT 生成结果\n\n在异步模式（`--poll=false`）下使用，主动查询任务状态。\n\n```bash\nchatppt ppt result <ppt_id> [-f pretty]\n```\n\n| 参数 | 说明 |\n|------|------|\n| `ppt_id` | `ppt generate` / `ppt import_file` 返回的 `ppt_id` |\n| `-f` | 输出格式（继承全局 flag） |\n\n---\n\n## config — 配置管理\n\n```bash\n# 查看当前配置\nchatppt config show\n\n# 重新加载配置文件\nchatppt config reload\n```\n\n**典型返回（show）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"app\": { \"name\": \"ChatPPT CLI\", \"version\": \"1.0.0\" },\n    \"api\": { \"url\": \"http://localhost:9157\", \"timeout\": 30000 },\n    \"auth\": { \"type\": \"Bearer\", \"access_key_id\": \"csVyGKphwM...\" },\n    \"ppt\": { \"default_ai_picture\": true }\n  }\n}\n```\n\n---\n\n## 生成下载链接 chatppt downloadppt\n\n```bash\nchatppt ppt downloadppt [ppt-id]\n```\n\n---\n\n## 生成线上编辑器链接 chatppt editor\n\n```bash\nchatppt ppt editor [ppt-id]\n```\n\n---\n\n## 错误处理\n\n### 常见错误码\n\n| 错误码 | 原因 | 处理 |\n|--------|------|------|\n| 400 | 参数错误（topic 超长、路径无效等） | 修正参数后重试 |\n| 401 | 未登录或令牌失效 | 执行 `auth login` |\n| 403 | 文件上传权限不足 | 检查 BCE AK/SK 配置 |\n| 413 | 文件超过 100 MB | 压缩或拆分文件 |\n| 429 | 请求频率过高 | 等待 5 秒后重试，最多 3 次 |\n| 500 | 服务端错误 | 等待 10 秒后重试，最多 3 次 |\n\n### 通用错误格式\n\n```json\n{\n  \"success\": false,\n  \"code\": 400,\n  \"message\": \"错误描述\",\n  \"error_type\": \"VALIDATION_ERROR\",\n  \"error_details\": { \"field\": \"topic\", \"reason\": \"主题长度必须在 1-200 字符之间\" },\n  \"suggestion\": \"请检查输入参数并重试\"\n}\n```\n\n---\n\n## 注意事项\n\n- **并发限制**：同一用户同时只能有一个 PPT 生成任务，需串行执行。\n- **文件上传**：依赖百度 BOS 服务，需正确配置 BCE 参数（AK/SK、Bucket 权限）。\n- **令牌自动刷新**：运行时令牌过期会自动刷新；刷新失败则需重新 `auth login`。\n- **敏感信息**：勿在日志中记录 AK/SK 或密码；定期清理云端不再使用的 PPT 文件。\n- **Agent 提问策略**：优先自动提取用户输入中的参数；仅在缺失关键信息时追问；若用户不想配置参数，按默认值执行。\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7akw0m5rtgarw268vaxsqap182sxw9\",\n  \"slug\": \"chatppt-agent\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1776829321368\n}\n\nArchive v1.0.0: 2 files, 5157 bytes\n\nFiles: SKILL.md (10949b), _meta.json (132b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: chatppt-cli\ndescription: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。\n---\n\n# ChatPPT CLI Skill\n\n## 环境准备\n\n### CLI 安装\n运行npm命令进行安装，安装前先检查是否已存在chatppt命令。\n\n```bash\nnpm install -g @yooai/cli\n```\n\n安装后可运行chatppt命令进行调用，比如：\n```bash\nchatppt --help\n```\n\n### 全局 Flag\n\n| Flag | 说明 |\n|------|------|\n| `--config string` | 配置文件路径（默认 `$HOME/.chatppt/config.yaml`） |\n| `-d, --debug` | 启用调试模式 |\n| `-f, --format string` | 输出格式：`json`（默认）/ `table` / `pretty` |\n| `-h, --help` | 帮助 |\n| `-v, --version` | 版本 |\n\n---\n\n## 标准工作流\n\n```\n1. 检查登录状态（auth status\n2. 未登录 → 执行登录（auth login）\n3. 生成 PPT（ppt generate 或 ppt import_file）\n4. 自动轮询等待结果（直到 `2` 或 `3`）\n5. 询问用户要直接下载pptx文件还是跳转到线上编辑器\n```\n\n### Agent 执行强约束（必须遵守）\n\n1. **严格流程顺序**：始终按“检查登录 -> 登录（如需要） -> 生成 PPT -> 轮询结果”执行，不得跳步。\n2. **路径二选一**：在生成前必须询问用户选择：\n   - 普通生成路径\n   - Banana 风格路径\n3. **自动提取参数**：先从用户输入中自动提取可识别参数值；仅对缺失且必要的信息追问用户。\n4. **用户不想配置参数**：若用户明确表示不关心参数或不想填写，全部使用默认值发起请求。\n5. **轮询展示图片**：轮询期间如果返回 `images.urls`，可直接把图片链接展示给用户。\n6. **成功即停止**：当任务状态为 `2`或`3` 后，仅返回成功结果与关键信息，不执行任何后续操作（后续接口未就绪）。\n7. **Web Search 收费确认**：`--web-search` 涉及额外收费，启用前必须先告知用户并获得明确确认；未确认则按关闭处理（传 `--web-search=true`）。\n8. **如果已经进入到了轮询流程中，要一直等待轮询成功或失败，不能在轮询过程中又进行生成。**\n\n### 参数提取与追问规则（Agent）\n\n1. **先提取后追问**：先从用户自然语言中提取参数（主题、路径选择、样式参数等），再补问缺失信息。\n2. **最小追问原则**：仅追问生成任务必需信息（如 `主题` 或导入时的 `文件路径`）。\n3. **路径参数边界**：\n   - 普通生成路径只处理：`font-name`、`theme-color`、`ai-picture`、`image-style`、`custom-template-id`、`custom-page-count`\n   - Banana 路径只处理：`banana-style-id`、`banana-doc-type`、`banana-reference-image`\n4. **默认值策略**：若用户明确“不想设置参数/你看着办/默认就行”，则所有未指定参数使用默认值，不再反复追问。\n5. **收费项单独确认**：`web-search` 为额外收费项，不能并入“默认就行”；必须单独征得用户同意后才启用。\n\n---\n\n## 命令速查\n\n| 目标 | 命令 |\n|------|------|\n| 查看登录状态 | `auth status` |\n| 登录 | `auth login` |\n| 登出 | `auth logout` |\n| 刷新令牌 | `auth refresh` |\n| 生成 PPT（主题文字） | `ppt generate \"主题\"` |\n| 生成绘图PPT（主题文字） | `ppt generate_banana \"主题\"` |\n| 生成 PPT（文件导入） | `ppt import_file \"/path/to/file\"` |\n| 生成绘图PPT（文件导入） | `ppt import_file_banana \"/path/to/file\"` |\n| 查询 PPT 结果 | `ppt result <ppt_id>` |\n| 查看配置 | `config show` |\n| 重载配置 | `config reload` |\n| 查看版本 | `version` |\n\n---\n\n## chatppt auth — 认证管理\n\n所有 PPT 生成命令都需要先登录。\n\n```bash\n# 查看当前登录状态\nchatppt auth status\n\n# 登录（默认自动打开浏览器）\nchatppt auth login\n\n# 登录但不自动打开浏览器\nchatppt auth login --no-browser\n\n# 刷新令牌（令牌即将过期时使用）\nchatppt auth refresh\n\n# 登出\nchatppt auth logout\n```\n\n**典型返回（status）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"is_logged_in\": true,\n    \"user\": { \"id\": \"string\", \"nickname\": \"string\", \"mobile\": \"string\" }\n  }\n}\n```\n\n---\n\n## chatppt ppt generate — 根据主题生成 PPT\n\n**普通生成**\n```bash\nchatppt ppt generate \"主题描述\" [options]\n```\n\n**绘图生成**\n```bash\nchatppt ppt generate_banana \"主题描述\" [options]\n```\n\n### 必填\n\n| 参数 | 说明 |\n|------|------|\n| `主题描述` | PPT 主题，1–200 字符 |\n\n### 可选参数（公共）\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--complex` | int | 0 | 内容复杂度 1=简单，2=中等，3=复杂 |\n| `--language` | string | — | 语言：`zh-CN` / `en-US` / `zh-TW` |\n| `--web-search` | bool | true | 联网补充内容（额外收费，启用前需用户明确确认） |\n| `--poll` | bool | true | 自动轮询等待结果 |\n| `--interval` | int | 5 | 轮询间隔（秒） |\n| `--max-retries` | int | 60 | 最大轮询次数（约 5 分钟） |\n\n### 普通生成路径参数（与 Banana 路径平级）\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--font-name` | string | — | 字体名，如 `微软雅黑` |\n| `--theme-color` | string | — | 主题色：`蓝色` `红色` `绿色` `橙色` `紫色` `黄色` `粉色` |\n| `--ai-picture` | bool | true | 是否启用 AI 配图 |\n| `--image-style` | string | — | 配图风格描述，如 `商务风` |\n| `--custom-template-id` | string | — | 自定义模板 ID |\n| `--custom-page-count` | int | 0 | 页数，0 = 自动 |\n\n### Banana 风格路径参数（与普通路径平级）\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| `--banana-style-id` | string | Banana 风格 ID |\n| `--banana-doc-type` | string | 文档类型：`business` / `education` / `marketing` / `technology` / `medical` / `finance` |\n| `--banana-reference-image` | string | 参考图片 URL 或路径 |\n\n> 约束说明：\n> - Banana 路径参数允许全部为空。\n> - 普通路径与 Banana 路径是两条平级路线，不存在“更高级”关系。\n> - Agent 必须先确认用户走哪条路径，再组装对应参数。\n> - 生成任务默认开启轮询（`--poll=true`），按流程持续查询直到 `SUCCESS` 或 `FAILED`。\n\n### 示例\n\n```bash\n# 基础生成\nchatppt ppt generate \"人工智能发展趋势\" --language zh\n\n# 普通生成路径（带样式）\nchatppt ppt generate \"2024年度工作总结\" \\\n  --language zh \\\n  --font-name \"微软雅黑\" \\\n  --theme-color blue \\\n  --custom-page-count 15 \\\n  --image-style \"商务风\"\n\n# Banana 风格路径（参数可部分或全部为空）\nchatppt ppt generate_banana \"产品介绍\" \\\n  --banana-style-id style_001 \\\n  --banana-doc-type business\n\n# 异步模式（不等待结果，手动查询）\nchatppt ppt generate \"主题\" --poll=false\n```\n\n### 成功返回\n\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"ppt_id\": \"ppt_1234567890\",\n    \"request_id\": \"string\",\n    \"title\": \"string\",\n    \"task_status\": \"2\",\n    \"images\": {\n      \"urls\": [{ \"url\": \"https://example.com/ppt/slide1.jpg\" }]\n    }\n  }\n}\n```\n\n**task_status 说明**\n\n| 值 | 含义 |\n|----|------|\n| `1` | 生成中 |\n| `2` | 已完成 |\n| `3` | 失败 |\n\n---\n\n## chatppt import file — 文件导入生成 PPT\n\n上传本地文件后基于其内容生成 PPT，适合将现有 Word / PDF / Markdown 转为演示文稿。\n\n**导入生成普通PPT**\n```bash\nchatppt ppt import_file --file-path \"/绝对路径/文档.docx\"\n```\n\n**导入生成绘图PPT**\n```bash\nchatppt ppt import_file_banana --file-path \"/绝对路径/文档.docx\"\n```\n\n### 必填\n\n| 参数 | 说明 |\n|------|------|\n| `--file-path` | 本地文件绝对路径 |\n\n### 支持格式\n\n| 格式 | 扩展名 | 大小上限 |\n|------|--------|---------|\n| Word | `.doc` `.docx` | 100 MB |\n| PDF | `.pdf` | 100 MB |\n| Markdown | `.md` | 100 MB |\n| 纯文本 | `.txt` | 100 MB |\n\n> 文本文件须为 UTF-8 编码。\n\n其余可选参数与 `ppt generate` 完全相同，包括普通路径参数与 Banana 路径参数。\n\n### 示例\n\n```bash\n# Word 文档导入\nchatppt ppt import_file \\\n  --file-path \"/Users/me/docs/product.docx\" \\\n  --theme-color 蓝色\n\n# PDF 导入，Banana 风格\nchatppt ppt import_file_banana \\\n  --file \"/Users/me/docs/annual.pdf\" \\\n  --banana-style-id style_002 \\\n  --banana-doc-type business \n```\n\n返回格式与 `ppt generate` 相同。\n\n---\n\n## chatppt ppt result — 查询 PPT 生成结果\n\n在异步模式（`--poll=false`）下使用，主动查询任务状态。\n\n```bash\nchatppt ppt result <ppt_id> [-f pretty]\n```\n\n| 参数 | 说明 |\n|------|------|\n| `ppt_id` | `ppt generate` / `ppt import_file` 返回的 `ppt_id` |\n| `-f` | 输出格式（继承全局 flag） |\n\n---\n\n## config — 配置管理\n\n```bash\n# 查看当前配置\nchatppt config show\n\n# 重新加载配置文件\nchatppt config reload\n```\n\n**典型返回（show）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"app\": { \"name\": \"ChatPPT CLI\", \"version\": \"1.0.0\" },\n    \"api\": { \"url\": \"http://localhost:9157\", \"timeout\": 30000 },\n    \"auth\": { \"type\": \"Bearer\", \"access_key_id\": \"csVyGKphwM...\" },\n    \"ppt\": { \"default_ai_picture\": true }\n  }\n}\n```\n\n---\n\n## 生成下载链接 chatppt downloadppt\n\n```bash\nchatppt ppt downloadppt [ppt-id]\n```\n\n---\n\n## 生成线上编辑器链接 chatppt editor\n\n```bash\nchatppt ppt editor [ppt-id]\n```\n\n---\n\n## 错误处理\n\n### 常见错误码\n\n| 错误码 | 原因 | 处理 |\n|--------|------|------|\n| 400 | 参数错误（topic 超长、路径无效等） | 修正参数后重试 |\n| 401 | 未登录或令牌失效 | 执行 `auth login` |\n| 403 | 文件上传权限不足 | 检查 BCE AK/SK 配置 |\n| 413 | 文件超过 100 MB | 压缩或拆分文件 |\n| 429 | 请求频率过高 | 等待 5 秒后重试，最多 3 次 |\n| 500 | 服务端错误 | 等待 10 秒后重试，最多 3 次 |\n\n### 通用错误格式\n\n```json\n{\n  \"success\": false,\n  \"code\": 400,\n  \"message\": \"错误描述\",\n  \"error_type\": \"VALIDATION_ERROR\",\n  \"error_details\": { \"field\": \"topic\", \"reason\": \"主题长度必须在 1-200 字符之间\" },\n  \"suggestion\": \"请检查输入参数并重试\"\n}\n```\n\n---\n\n## 注意事项\n\n- **并发限制**：同一用户同时只能有一个 PPT 生成任务，需串行执行。\n- **文件上传**：依赖百度 BOS 服务，需正确配置 BCE 参数（AK/SK、Bucket 权限）。\n- **令牌自动刷新**：运行时令牌过期会自动刷新；刷新失败则需重新 `auth login`。\n- **敏感信息**：勿在日志中记录 AK/SK 或密码；定期清理云端不再使用的 PPT 文件。\n- **Agent 提问策略**：优先自动提取用户输入中的参数；仅在缺失关键信息时追问；若用户不想配置参数，按默认值执行。\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7akw0m5rtgarw268vaxsqap182sxw9\",\n  \"slug\": \"chatppt-agent\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1776753825278\n}","readmeExcerpt":"Skill: chatppt-agent Owner: kahn520 Summary: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-04-24T09:33:17.015Z | user No functional or documentation changes detected in this version. - Version updated to 1.0.4 with no file or SKILL.md changes. - Behavior and documentation remain the sam","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"npm install -g @yooai/cli"},{"language":"bash","snippet":"chatppt --help"},{"language":"text","snippet":"1. 检查登录状态（auth status\n2. 未登录 → 执行登录（auth login）\n3. 生成 PPT（ppt generate 或 ppt import_file）\n4. 自动轮询等待结果（直到 `2` 或 `3`）\n5. 询问用户要直接下载pptx文件还是跳转到线上编辑器"},{"language":"bash","snippet":"# 查看当前登录状态\nchatppt auth status\n\n# 登录（默认自动打开浏览器）\nchatppt auth login\n\n# 登录但不自动打开浏览器\nchatppt auth login --no-browser\n\n# 刷新令牌（令牌即将过期时使用）\nchatppt auth refresh\n\n# 登出\nchatppt auth logout"},{"language":"json","snippet":"{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"is_logged_in\": true,\n    \"user\": { \"id\": \"string\", \"nickname\": \"string\", \"mobile\": \"string\" }\n  }\n}"},{"language":"bash","snippet":"chatppt ppt generate \"主题描述\" [options]"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: chatppt-cli\ndescription: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。\n---\n\n# ChatPPT CLI Skill\n\n## 环境准备\n\n### CLI 安装\n运行npm命令进行安装，安装前先检查是否已存在chatppt命令。\n\n```bash\nnpm install -g @yooai/cli\n```\n\n安装后可运行chatppt命令进行调用，比如：\n```bash\nchatppt --help\n```\n\n### 全局 Flag\n\n| Flag | 说明 |\n|------|------|\n| `--config string` | 配置文件路径（默认 `$HOME/.chatppt/config.yaml`） |\n| `-d, --debug` | 启用调试模式 |\n| `-f, --format string` | 输出格式：`json`（默认）/ `table` / `pretty` |\n| `-h, --help` | 帮助 |\n| `-v, --version` | 版本 |\n\n---\n\n## 标准工作流\n\n```\n1. 检查登录状态（auth status\n2. 未登录 → 执行登录（auth login）\n3. 生成 PPT（ppt generate 或 ppt import_file）\n4. 自动轮询等待结果（直到 `2` 或 `3`）\n5. 询问用户要直接下载pptx文件还是跳转到线上编辑器\n```\n\n### Agent 执行强约束（必须遵守）\n\n1. **严格流程顺序**：始终按“检查登录 -> 登录（如需要） -> 生成 PPT -> 轮询结果”执行，不得跳步。\n2. **路径二选一**：在生成前必须询问用户选择：\n   - 普通生成路径\n   - 绘图生成路径\n3. **自动提取参数**：先从用户输入中自动提取可识别参数值；仅对缺失且必要的信息追问用户。\n4. **用户不想配置参数**：若用户明确表示不关心参数或不想填写，全部使用默认值发起请求。\n5. **轮询展示图片**：轮询期间如果返回 `images.urls`，可直接把图片链接展示给用户。\n6. **成功即停止**：当任务状态为 `2`或`3` 后，仅返回成功结果与关键信息，不执行任何后续操作（后续接口未就绪）。\n7. **Web Search 收费确认**：`--web-search` 涉及额外收费，启用前必须先告知用户并获得明确确认；未确认则按关闭处理（传 `--web-search=false`）。\n8. **如果已经进入到了自动轮询流程中，要一直等待轮询成功或失败，不能在轮询过程中又进行生成。如果是Agent手动轮询，也需要轮询到成功或失败，不能中途停止对话等待用户继续输入。**\n9. **如果轮询接口返回了失败，不要再次生成，要询问用户是否要再次生成。**\n10. **如果用户权益用完了，提示用户去clawppt官网 <https://chat-ppt.com/openclaw> 进行充值点数。**\n\n### 参数提取与追问规则（Agent）\n\n1. **先提取后追问**：先从用户自然语言中提取参数（主题、路径选择、样式参数等），再补问缺失信息。\n2. **最小追问原则**：仅追问生成任务必需信息（如 `主题` 或导入时的 `文件路径`）。\n3. **路径参数边界**：\n   - 普通生成路径只处理：`font-name`、`theme-color`、`ai-picture`、`image-style`、`template-id`、`custom-template-id`、`custom-page-count`\n   - 绘图生成路径只处理：`banana-style-id`、`banana-doc-type`、`banana-reference-image`\n4. **默认值策略**：若用户明确“不想设置参数/你看着办/默认就行”，则所有未指定参数使用默认值，不再反复追问。\n5. **收费项单独确认**：`web-search` 为额外收费项，不能并入“默认就行”；必须单独征得用户同意后才启用。\n\n### 确认普通生成与绘图生成路径后的参数提取与追问规则（Agent）\n1. **模板风格确认**：在普通生成和绘图生成中，都需要询问用户是否需要预览模板风格并指定模板生成。\n   - 普通生成路径参数：`template-id`\n   - 绘图生成路径参数：`banana-style-id`\n2. **普通生成路径中的图片风格确认**：在普通生成中询问用户是否需要指定AI图片风格，如果指定了，则参数--ai-picture必须等于true。参考--image-style参数获取方式。\n3. **绘图生成排版风格确认**：在绘图模式中还需要确认用户是否需要指定排版样式，如果需要，参考--banana-doc-type参数获取方式。\n\n---\n\n## 命令速查\n\n| 目标 | 命令 |\n|------|------|\n| 查看登录状态 | `auth status` |\n| 登录 | `auth login` |\n| 登出 | `auth logout` |\n| 刷新令牌 | `auth refresh` |\n| 生成 PPT（主题文字） | `ppt generate \"主题\"` |\n| 生成绘图PPT（主题文字） | `ppt generate_banana \"主题\"` |\n| 生成 PPT（文件导入） | `ppt import_file \"/path/to/file\"` |\n| 生成绘图PPT（文件导入） | `ppt import_file_banana \"/path/to/file\"` |\n| 查询 PPT 结果 | `ppt result <ppt_id>` |\n| 查看配置 | `config show` |\n| 重载配置 | `config reload` |\n| 查看版本 | `version` |\n\n---\n\n## chatppt auth — 认证管理\n\n所有 PPT 生成命令都需要先登录。\n\n```bash\n# 查看当前登录状态\nchatppt auth status\n\n# 登录（默认自动打开浏览器）\nchatppt auth login\n\n# 登录但不自动打开浏览器\nchatppt auth login --no-browser\n\n# 刷新令牌（令牌即将过期时使用）\nchatppt auth refresh\n\n# 登出\nchatppt auth logout\n```\n\n**典型返回（status）**\n```json\n{\n  \"success\": true,\n  \"code\": 200,\n  \"data\": {\n    \"is_logged_in\": true,\n    \"user\": { \"id\": \"string"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7akw0m5rtgarw268vaxsqap182sxw9\",\n  \"slug\": \"chatppt-agent\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1777023197015\n}"},{"path":"skill-card.md","content":"## Description:\n\nUses the ChatPPT CLI to generate PowerPoint presentations from a topic or from Word, PDF, Markdown, or text files, including login, generation, import, polling, download, and editor-link workflows.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[kahn520](https://clawhub.ai/user/kahn520)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to drive ChatPPT CLI workflows that turn prompts or existing documents into PPT presentations and retrieve finished results.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Global npm installation and CLI execution can affect the local environment.\n\nMitigation: Install and run the CLI in a restricted or disposable environment and avoid elevated npm installs unless explicitly required.\n\nRisk: Document-import workflows upload local content to the ChatPPT/Baidu BOS-backed service.\n\nMitigation: Do not upload confidential documents unless the user is comfortable sending their contents to that service.\n\nRisk: Authentication and storage configuration can expose AK/SK values, passwords, tokens, or raw auth config if logged or pasted.\n\nMitigation: Avoid displaying or storing raw credential material in chat logs, command output, or shared artifacts.\n\n## Reference(s):\n\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with shell commands and JSON response examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Single-stream agent guidance; generated PPT files and links are produced by the ChatPPT service.]\n\n## Skill Version(s):\n\n1.0.4 (source: evidence.release.version)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。 Skill: chatppt-agent Owner: kahn520 Summary: 使用 ChatPPT CLI 命令行工具通过 AI 自动生成 PPT 演示文稿。适用场景：用户需要根据主题文字或现有文件（Word/PDF/Markdown）生成 PPT 时触发本 skill。支持登录认证、PPT 生成、文件导入生成、结果查询等完整流程。 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-04-24T09:33:17.015Z | user No functional or documentation changes detected in this version. - Version updated to 1.0.4 with no file or SKILL.md changes. - Behavior and documentation remain the sam","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":926,"uniquenessScore":52,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T15:00:44.486Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T15:00:44.486Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T17:42:19.367Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}