ppt-to-notes-mdlisted
Install: claude install-skill vegness/ppt-to-notes-md
# 课件转 Markdown 笔记
目标只有一个:产出**一份脱离课件也能读懂**的中文复习笔记。所有规则都是为了让这件事成立——原文必须出现在笔记里,读者不需要翻回 PPT 才能补全句子。
## 成品长什么样
```markdown
> 源文件:第4章 树与二叉树.pptx | 总页数:64 | 页码基准:幻灯片序号
# 4 树与二叉树
## 4.1 树的定义
树是 n(n≥0)个结点的有限集合。n=0 时称为空树;n>0 时,有且仅有一个特定的结点称为根,其余结点可分为 m(m≥0)个互不相交的有限集合,每个集合本身又是一棵树。(PPT P12)
> 定义的落点在「互不相交」——它同时给出了树的判定方法:能拆成互不相交的子树就是树,出现交叉就不是。
**例(PPT P13)** 判断下列结构是否为树:……
> 只要检查任意两结点间是否只有一条路径即可。
```
注意:元信息块也是引用块,但它是固定头部,不算解释。除此之外**凡灰底皆解释,白底皆是课件原文**。这张样例就是验收标准,下面的每条规则都在解释它为什么长这样。
## 开工前
| 项 | 说明 |
|---|---|
| 脚本 | 与本文件同级的 `scripts/` 目录 |
| Python | `C:/Users/50416/.workbuddy/binaries/python/envs/default/Scripts/python.exe`(已装 python-pptx / pymupdf / Pillow / pywin32,不要重复安装) |
| 笔记输出 | `<课件所在目录>/notes/<原文件名>-notes.md` |
| 插图输出 | `<课件所在目录>/notes/img/<笔记名>-图X.Y.png` |
| 中间产物 | `<课件所在目录>/_ppt2notes_tmp/`,交付前删除 |
用户指定了根目录、或一次给了多个目录的课件时,所有产物统一落到 `<根>/notes/`。`img/` 扁平存放,靠文件名前缀区分不同笔记。
命名冲突(同名课件)时在 `notes/` 内加 `-2` 后缀,绝不覆盖已有笔记。
## 七步工作流
### 1. 抽取结构
```bash
python <skill>/scripts/extract.py "课件.pptx" -o _ppt2notes_tmp/slides.json
```
读这份 JSON。它是唯一可信的原文来源——**写笔记时逐字取自这里,不要凭对课件的印象复述**,这是保证「引用原文」不走样的前提。
若脚本报「全部页面无文本层」,说明是扫描件,直接停下告诉用户需要先 OCR,不要硬猜内容。
### 2. 渲染整页
```bash
python <skill>/scripts/render_pages.py "课件.pptx" -o _ppt2notes_tmp/pages
```
### 3. 规划,再动笔
先定三件事,写进一份临时提纲(不必给用户看,除非页数超过 80):
1. **分节**:按第 4 节「标题与顺序」的规则决定哪些标题照抄、哪些重写。
2. **详略**:逐页打上 L1/L2/L3 标签(见第 6 节)。
3. **配图**:标出哪几页需要截图(见第 7 节)。
超过 80 页的课件,把分节提纲先给用户确认一次,避免写完 60 页发现结构不合意。
### 4. 写正文
严格照第 5 节的标记约定。一次写完整节,不要边写边改格式—