将普通ppt转为精品课课件
把一份普通课件按《2026学科课程精品课PPT模板》的母版与版式重制为精品课课件。
工作流程
- 确认输入。需要两个文件：
- 原课件.pptx（用户提供路径）
- 精品课模板.pptx（缺省用assets/2026学科课程精品课PPT模板.pptx；若用户另给模板，须与该模板结构一致：第 1 页封面、第 2 页目录、第 3 页含标题/横线/绿方块/正文文本框） - 先确认留白页，再生成（必须，不可跳过）。向用户询问：哪些页面需要在右侧留白（留出整页 1/3 供人物出镜）？用户确认前不要生成。若用户不确定，给出原课件的页面标题清单辅助选择。
- 运行转换脚本：
bash python scripts/convert.py --src "原课件.pptx" --blank "3-6,16-17" [--out "输出.pptx"] [--title "封面课名"]
---blank：右侧留白的页码，按原课件的页码填写，支持区间与逗号（如3-8,16-17）；不留白则省略。
---title：封面课名；缺省自动取原课件首页最大字号的文字。
- 输出缺省为原课件名（精品课版）.pptx，保存在原课件同目录。
- 解释器需装有python-pptx（本机可用C:\Users\xiaoshuye\.workbuddy\binaries\python\envs\default\Scripts\python.exe）。 - 交付前核对。用 PowerPoint COM 或 WPS 把成品导出 PNG 抽查：封面文字是否溢出、目录配色循环、留白页右侧是否干净、拆页处是否正常。发现具体页面问题（如封面两列没对齐、某页文字太密）时，参考
references/转换规范.md手工修该页 XML 后重渲染。
转换规则（已内置在脚本中）
- 封面/结束页：只替换
<a:t>文字，位置、字体、字号完全沿用模板；括注过长时并入副标题行。 - 目录页：复用模板的「序号标签＋章节名＋说明」三行组合，配色按 绿→蓝→红 循环（第 4 项回到绿色）；每页最多 4 项，超出自动拆页。
- 正文：华文楷体 24 号（不缩小字号），标题黑体 30 号居中；单页超过 8 行先把文本框加宽到通栏，仍超则按行数均衡拆为两页（标题加「（续）」）。
- 单图页（整页只有一张图片）：删除标题装饰，图片占满屏幕；非 16:9 时上下占满母版白色区域（y 0.97–6.86 英寸）、水平居中。
- 视频页（整页只有一个视频）：视频占满整屏。
- 留白页：标题块（标题＋绿方块＋横线）整体左移居中于左 2/3，正文收窄到左 2/3 内；留白页的配图自动拆为独立图片页，保证右侧 1/3 干净。
- 备注：原课件每页备注会带到新文件对应页。
注意事项
- 脚本会自动清洗原课件的装饰性文字（英文小标题、纯序号、纯符号），并把"编号/标签/说明"式小字结构合并成常规段落；合并结果仍可能有瑕疵，交付前抽查 2–3 页正文。
- 封面的"年级/学科/主讲人/学校"若原课件没有，会留空或用原课件文字带过；用户提供了就通过改封面页 XML 补上（两列用全角空格对齐，参照
references/转换规范.md）。 - 保存时若报
PermissionError，是目标文件被 PowerPoint/预览占用，先关闭对应窗口再重试。
