核心用法
AiPPT Skill 是一款与 AiPPT.cn 开放平台深度集成的智能演示文稿生成工具，采用协作式流程设计，拒绝黑盒一键到底。其核心工作流程遵循"场景识别 → 配置收集 → 大纲生成 → 用户确认 → 内容合成"的透明路径。
五大场景覆盖：
- 智能生成：仅提供主题即可生成完整 PPT，支持高阶配置（页数、受众、场景、语气、语言、模型切换、联网搜索）
- 文档上传：支持 Word、PDF、TXT、Markdown、WPS 等格式，可选择保持原文/适当扩写/润色美化
- 导入 PPT 生成：基于现有 PPTX 文件结构再生成
- 链接生成 PPT：抓取网页内容自动构建演示文稿
- AI 单页生成：针对封面页、目录页、总结页等特定页面的精准生成
关键交互节点：所有场景强制展示"大纲/结构确认"阶段，用户可修改大纲后再进入模板选择和最终合成，确保生成结果符合预期。
显著优点
安全合规设计：强制通过环境变量管理 API 凭证（AIPPT_APP_KEY / AIPPT_SECRET_KEY），SKILL.md 中 5 处明确禁止用户在聊天中输入密钥，具备企业级安全意识。支持多用户隔离（AIPPT_UID）。
流程透明可控：v4.0.1 核心设计理念"不做黑盒"，12 个执行阶段全程可见（鉴权检查→任务创建→解析输入→生成大纲→等待确认→保存修改→生成内容→获取结构→加载模板→合成作品→导出完成）。
高阶配置灵活：智能生成和文档上传场景支持拉取真实 API 枚举的高阶选项，避免凭空编造配置项；其他场景自动隐藏不适用配置，防止误导用户。
来源可信保障：由 OpenClaw/ClawHub 平台认证开发者维护，MIT-0 开源许可，代码完全可审计，依赖仅系统级工具（curl/python3/openssl），供应链风险极低。
潜在缺点与局限性
场景能力边界：导入 PPT、链接生成、AI 单页生成不支持高阶配置，如需复杂定制需绕道智能生成场景。
网络依赖较重：全流程依赖 AiPPT.cn 官方 API，无离线能力；部分接口（如文档导入）可能因未开通权限返回 40008 错误，需管理员开通对应能力。
大纲编辑门槛：虽提供树形结构编辑，但用户需理解 PPT 结构逻辑（页面顺序、父子关系、正文内容、页面类型），非技术用户可能存在学习成本。
Token 缓存风险：本地缓存 .token_cache.json 文件，虽为正常设计，但需用户自行确保文件权限（建议 0600）。
文件路径校验不足：generate_from_file 函数存在潜在路径遍历风险，建议使用者配合 realpath 等工具规范化输入路径。
适合的目标群体
- 企业办公人员：需要快速将会议主题、报告文档转换为专业 PPT 的职场人群
- 教育从业者：课件制作、教学演示文稿生成，支持按受众（学生/教师/家长）定制语气
- 内容运营团队：基于公众号文章、网页链接批量生成分享 PPT
- 咨询/策划顾问：需严格把控大纲结构的商务提案场景，协作式流程契合专业需求
- AI 技能开发者：研究多轮对话工作流、API 集成模式的参考案例
使用风险
常规运行风险：
- API 配额与余额：依赖 AiPPT.cn 账户余额，欠费将导致服务中断
- 内容审核失败：敏感主题可能触发平台内容审核，需修改后重试
- 任务过期机制：长时间未确认大纲或选择模板可能导致任务失效
- 模板可用性：企业模板若配置不当可能加载失败
部署环境风险：
- 环境变量在多用户系统可能泄露，建议容器化部署隔离进程空间
- HTTPS 通信未显式指定 --tlsv1.2，依赖系统 curl 默认配置
- 建议统一配置请求超时和重试机制提升稳定性
安全维护建议：
- 定期在 AiPPT 控制台轮换 Secret Key
- 监控 API 调用日志识别异常访问
- 90 天认证有效期到期前重新评估版本更新