xingjunm/autoppt

选用指南

AI 根据 README 整理 · 2026/11/3 22:37:35

目标用户

面向教师，尤其是需要制作教学课件的教育工作者。

查看 README 依据

<p align="center"> <img src="assets/logo.svg" alt="AutoPPT · AI备课神器" width="600"> </p> <p align="center"> <b>AI备课神器：只需一句话，即可一键生成一整周精美、可交互的 HTML 格式教学课件。</b><br> 无需编程和复杂设计，让备课变得简单高效。<br> _{人人都能用 · 说一句话，生成一堂好课} </p> <p align="center"> 支持 <b>Claude Code</b> · <b>OpenAI Codex</b> </p> <p align="center"> 🧑‍🏫 <b>零编程</b> &nbsp;·&nbsp; 📚 <b>全学科</b> &nbsp;·&nbsp; 🖱️ <b>交互式课件</b> </p> <p align="center"> <img src="docs/demo.gif" alt="演示：一句话 → 设计文档 → 一整周课件" width="860"><br> _{演示：输入一句话 → 智能体写设计文档、生成三节课、真实运行代码、自检 → 成品（流程示意已加速，成品为真实课件截图）} </p> <p align="center">

<a href="#快速开始">快速开始</a> · <a href="#三种课件风格">三种风格</a> · <a href="#工作流程">工作流程</a> · <a href="#给智能体看的说明">给智能体看的说明</a> · <a href="examples/week01/">第 1 周示例</a> · <a href="README.en.md">English</a> </p> <p align="center"> <img src="docs/styles.jpg" alt="三种课件风格：A 学术刊物、B 黑底舞台、C 几何色块" width="860"><br> _{三种课件风格任选：A 学术刊物 · B 黑底舞台 · C 几何色块} </p> --- ## AutoPPT 是什么 AutoPPT 是一款“AI备课神器”：一套**给 AI 编程智能体（Claude Code、OpenAI Codex）用的技能（skill）+ 课件引擎**。你只要说出课程主题（或者给它一份教学大纲），智能体就按固定流程交付**一整周可以直接上课的课件**——你不需要写一行代码，也不需要排一页 PPT：

使用方式

通过安装技能后在智能体中用自然语言描述需求来使用，例如“帮我做第 1 周的课件：人工智能概述”。

查看 README 依据

| 技能位置 | `~/.claude/skills/autoppt` 或 `<课程文件夹>/.claude/skills/autoppt` | `~/.agents/skills/autoppt` 或 `<课程文件夹>/.agents/skills/autoppt` | | 怎么调用 | 直接说“帮我做第 1 周的课件：……” | `$autoppt 帮我做第 1 周的课件：……`，或直接描述需求 | | 需求访谈 | 弹出选择题 | 一条消息里列出编号问题和选项，回复编号即可 | | 网络 | 按 Claude Code 的权限设置 | 沙箱默认不联网：搜图、装依赖时需批准或在设置中打开网络（见 [codex.md](skills/autoppt/references/codex.md)） | 两套技能共用同一套引擎、模板和脚本，做出来的课件完全一样；Codex 版的 `SKILL.md` 由 `SKILL.codex.md` 安装而来，多了 Codex 的使用说明。 ### 3. 打开示例看一眼 ```bash cd autoppt/examples/week01 python3 start.py # 浏览器自动打开；按 S 看讲稿，按 → 翻页 ``` ### 4. 说一句话，开始做课 在课程文件夹里启动智能体，然后说：

> **快速模式**：帮我做第 1 周的课件：人工智能概述。面向大一新生、零编程基础，用「学术刊物」风格。 智能体会先问你几个它推断不出来的问题（学生是谁、风格选哪种），其余先用默认值，然后写设计文档、做出成品、自检，最后告诉你需要确认的事。 > **整门课模式**（推荐）：我要上一门《中国古代史》，这是我的教学大纲（附上 docx / pdf）。请先问清楚我的需求，整理出整学期的课程内容设计给我确认，再做第 1 周。 读完、按你的实际需求改完设计文档之后： > 我改好了，开干！ 之后每一周都只需要一句：“设计第 N 周的课程内容” → 改 → “开干”。 ## 工作流程 ```text ⓪ 说清你的课（一次） ──► ① 课程内容设计（一次） ──► ② 每周设计文档 ──► ③ 开干：实现 ──► ④ 验证与交付 需求访谈、选风格 课程大纲（你确认） 你按需修改 三节课 + 配图 截图检查、更新约定 ``` **⓪ 说清你的课（整门课一次）**

部署要求

需要 AI 编程智能体（Claude Code 或 OpenAI Codex），Python 3.9+，Node.js 18+ 与 Playwright。

查看 README 依据

<td><img src="docs/screenshots/08-teacher-guide.jpg" alt="教师指南"><br>_{教师授课指南：课前待办 + 由讲稿自动生成的分钟级安排}</td> </tr> </table> > 示例中的照片、新闻截图、电影剧照属于课堂教学引用，不能公开再分发，开源版已换成标有原内容的占位图。 ## 快速开始 ### 1. 准备环境 - 一个能读写文件、运行命令的 AI 编程智能体：**Claude Code** 或 **OpenAI Codex**（两套技能都已提供）。其他支持 `AGENTS.md` / skill 的智能体也可以按 [AGENTS.md](AGENTS.md) 使用。 - Python 3.9+（构建；可选 `pip install fonttools`，配合 Noto CJK 字体按实际用字裁剪字体）。 - Node.js 18+ 与 Playwright（检查与截图）：`npm i -g playwright && npx playwright install chromium`。 - 实践课需要什么就装什么（NumPy、pandas、scikit-learn……）。 > 唯一的前提是有一个 AI 编程智能体。你自己不需要会编程：上面这些依赖也可以让智能体帮你装。

已知限制

生成的是 HTML 课件而非 .pptx 文件；互动在 PDF 导出后会变成静态画面。

查看 README 依据

**真的什么学科都能做吗？** 引擎只管“怎么呈现”：页型、讲稿、互动、代码、检查。内容由设计文档决定——历史课可以做史料对照与时间轴，物理课可以做参数模拟，医学课可以做病例判断，语言课可以做逐句对照。需要编程实践的课最能发挥“可以直接跑的代码”这一点；不需要编程的课，实践课可以换成讨论、案例分析或小测。 **叫 AutoPPT，生成的是 .pptx 吗？** 不是。生成的是 HTML 课件——这正是它比 PPT 好用的地方：互动能真实计算、代码能真实运行、离线双击就能打开、可以用 git 管理。需要文件时，在 Chrome 里给课件网址加 `?print-pdf` 导出 PDF。 **只能做中文课吗？** 不是。引擎与语言无关；模板与讲稿格式是中文的，换成英文写设计文档即可（讲稿标签如【建议用时】可以保留，构建脚本依赖它们生成教案）。 **能导出 PowerPoint 吗？** 课件是网页。需要文件时用 Chrome 打开课件、在网址后加 `?print-pdf` 打印为 PDF。互动在 PDF 里会变成静态画面。