ChatPPT-Creator: 智能 PPT 自动化 Skill 套件

ChatPPT-Creator 是一款专为 AI Agent 设计的高级 PPT 自动化 tool 套件，集成了意图识别、结构化大纲生成、多模态内容处理及在线实时编辑等功能。它作为一个标准的 Skill 插件，可以被集成到任何支持 Skill 扩展的 AI 助手或 IDE 中，帮助用户通过简单的自然语言指令，快速生成高质量的项目汇报、技术分享或业务方案 PPT。

🌟 核心特性

• 多模态生成: 支持从一句话主题、Markdown 文本、本地文档（.txt, .docx）甚至直接分析当前代码项目生成 PPT。
• 专家级大纲: 内置专家级 Prompt 流程，支持生成、审阅、微调结构化大纲，确保内容逻辑严密。
• 即时预览与编辑: 任务启动后立即可查看实时生成进度，生成完成后支持跳转至 Web 端进行深度在线编辑。
• 智能增强: 支持一键生成演讲稿备注、在指定位置插入页面、更换主题风格与字体。
• 主动引导交互: 具备智能意图识别，能够根据用户需求主动建议合适的模板或后续修改操作。

🚀 快速开始

1. 安装依赖

在 chatppt-creator 目录下运行：

npm install

2. 配置 API Key (重要)

本工具依赖 yoo-ai 提供的 PPT 生成引擎，你需要配置有效的 API Key 才能使用。

申请 API Key

1. 访问 yoo-ai 开发者平台获取 API Key。
2. 注册并登录后，创建应用获得你的专属 API_KEY。

替换/配置 API Key

你可以通过以下两种方式之一进行配置：

• 配置文件（推荐）: 将项目根目录下的 config.json.template 重命名为 config.json，并将你的 Key 填入：

  {
    "API_KEY": "你的_API_KEY_在此"
  }

• 环境变量: 在你的系统中设置环境变量 YOO_AI_API_KEY。

💡 Skill 使用方式

在支持 Skill 的 AI 助手聊天窗口中，你可以直接通过自然语言指令调用此套件。以下是一些典型示例：

创建 PPT

• 从主题创建: "帮我写一个关于 AI 未来发展的 PPT，主色调要蓝色，字体用幼圆。"
• 从文件创建: "基于这个文档 [选中文件] 生成一份技术方案汇报。"
• 创意PPT生成: "生成创意设计型PPT，支持超过200+创意设计风格PPT。"
• 分析项目: "总结一下当前项目的架构，并生成一份汇报 PPT。"

修改与增强

• 生成演讲稿: "为刚才生成的 PPT 添加演讲稿。"
• 更换风格: "这个 PPT 太严肃了，帮我换成小清新风格，重新生成一下。"
• 插入页面: "在第 3 页后面插入一页关于‘安全性’的内容。"

预览模板

• 预览封面: "我想看看商务风格的 PPT 封面模板。"

📂 项目结构

• scripts/chatppt_creator.js: 统一的任务调度中心与入口。
• scripts/ppt_api.js: 封装了 yoo-ai 的核心 API 调用逻辑。
• scripts/outline_parser.js: 负责 Markdown 大纲与结构化 JSON 的转换。
• scripts/project_analyzer.js: 自动分析项目代码结构的逻辑。
• SKILL.md: 定义了 AI Agent 的函数调用规范与交互准则。