PPT-MASTER 使用指南

1. 平台介绍

1. 项目定位：一个运行在 AI Agent（如 Claude Code）中的开源工作流技能。它能将任意文档（PDF、DOCX、网页等）或话题，自动转化为原生可编辑的 PowerPoint (.pptx) 演示文稿。
2. 核心优势：生成的不是扁平图片或单张文本框，而是包含 PowerPoint 原生 Shape、数据驱动图表与表格、转场动画、母版/版式继承以及演讲者备注配音；工作流及文件生成完全在用户本地机器执行，数据不留存第三方平台；兼容任何支持 Agent 技能的 AI 交互环境（Claude、GPT、Gemini、Kimi 等均可驱动）。

2. 主要功能

1. 文档/话题一键生成：输入提炼素材或直接提问，AI 自动梳理逻辑链条、规划版面并输出 .pptx。
2. 数据驱动的图表与矢量元素：生成包含真实数据的 PPT 图表、表格，以及带控制句柄的原生矢量图形和连接线。
3. 模板提取与套用：可从参考演示文稿中提取品牌风格与版式布局，或将新内容填入现有的 .pptx 模板中。
4. 转场、动画与语音配音：支持一键配置原生 Slide 转场、元素动画，并可将演讲者备注转换为语音朗读（Audio Narration）。
5. 多风格视觉生成：内置极简瑞士排版、杂志风、数据新闻风、玻璃拟态 (Glassmorphism)、Memphis 流行风等多种视觉设计模板。

3. 适用人群

1. 职场人士 / 商务汇报者：需要快速将长篇 Word、PDF 报告或会议大纲提炼成高颜值 PPT。
2. 开发者 / 技术人员：习惯使用 AI 命令行/IDE 工具（如 Claude Code），希望通过自然语言直接生成可编辑文档。
3. 研究员 / 学者 / 创作者：需要将论文、行业研究报告快速转化为结构清晰的演示文稿。

4. 免费与付费情况

1. 完全免费开源：项目采用 MIT 开源协议，软件本体 100% 免费，无需支付任何 PPT 生成平台月费或订阅费；由于软件本身免费开源，项目没有官方付费定价页面。
2. 使用成本分析：唯一的成本是用户调用大语言模型（如 Kimi、Claude、OpenAI 等）及图片生成 API 的费用；实际花费取决于你所使用的 AI 模型厂商的 API 计费标准。

5. 如何使用（快速上手）

1. 准备环境：安装 Python 3.x 环境，以及支持 Agent 技能的 AI 工具（如 Claude Code、Cursor 等）。
2. 配置 Key：在 AI 工具中配置好你的大模型 API Key。推荐具备大上下文与强推理能力的模型（如 Kimi K3 或 Claude），以及图像生成 API。
3. 加载技能并交互：将 ppt-master 技能引入你的 Agent 环境；在对话框中发送指令，例如：“将这份报告 [附带 PDF] 生成一份 10 页的商业汇报 PPT"。
4. 导出与微调：生成结束后，在本地打开导出的 .pptx 文件，直接在 PowerPoint 中进行细节调整与演示。

6. 注意事项

1. 工具定位认知：PPT Master 提供的是工作流框架（Harness），生成质量的上限制取决于底座 AI 模型；建议配合大上下文、强推理的大模型（如 Kimi K3、Claude）以获得最佳逻辑与排版效果。
2. 人工微调预留：AI 能完成 80%~90% 的结构规划、内容提炼与基础美化工作，但最终的视觉对齐和细节微调仍需人工简单把关；PPT Master 并非许愿池，需理解其能力边界。