deathcats4/scholar-ppt-cn 使用教程：论文材料到中文组会 PPT

用 deathcats4/scholar-ppt-cn 做论文汇报时，最容易出错的不是 PPTX 文件本身，而是太早跳到“生成完整 PPT”。论文、图表、截图、模板和组会叙事没有先排清楚，后面就会出现图太小、证据链断、页面骨架重复、中文字体不统一这些问题。

这个仓库的强项，正是把“论文到中文学术 PPT”拆成可检查的路径：生产规划表、mockup family + variants、样板页、可编辑 PPTX 重建、montage QA。它不是把论文一股脑压进幻灯片，而是先把每页为什么存在、用哪张图、图件怎么摆、风险在哪里讲清楚。

从生产规划表开始

scholar-ppt-cn 的生产规划表不是普通提纲。它要求每页关联叙事段落、页面任务、使用素材、图件形态、核心信息、版式 archetype、密度、素材处理建议和风险。对于论文汇报来说，这一步能提前发现“核心图不够清楚”“一页塞太多结果”“缺少研究问题过渡”等问题。

仓库内置了一个 5 页参考模板 assets/templates/scholar-ppt-cn-reference-template.pptx，可作为中文学术汇报的视觉参考。如果你没有自己的组会模板，可以先用它抽取 Template DNA：标题层级、页脚、配色、图文比例、注释样式和页面密度。

样板页不是最终页

这个 skill 在规划表之后增加了 mockup family + variants 阶段。它会把页面分成若干视觉 family，再为每个 family 准备多个 variant，避免整套 PPT 只剩一种左图右文骨架。适合先做 5 到 8 页代表性样板，看封面、总览、证据大图、多图证据、讨论机制和结论页是否能形成统一视觉系统。

如果目标是预览视觉效果，可以说“按确认的生产规划表，先做 5–8 页视觉样板，不要生成 PPT”。如果目标是快速产出可编辑文件，可以说“不要生图，直接参考模板生成可编辑 PPT”。两条路径都能用，但不要把样板图当作最终 editable PPTX。

本地测试安装到 Codex skills 目录

仓库提供了 PowerShell 本地安装脚本。它会先运行校验，再把 SKILL.md、agents、assets、references 复制到 .codex\\skills\\scholar-ppt-cn。本地测试时可按仓库流程执行：

git clone https://github.com/deathcats4/scholar-ppt-cn.git
cd scholar-ppt-cn
pwsh ./dev/install-local.ps1

安装后开新 Codex 对话，启动方式可以很简单：

使用 $scholar-ppt-cn，参考内置模板，帮我为一篇论文规划中文组会 PPT。

第一次试跑建议只要生产规划表，不要立刻做完整 PPT。确认规划表能覆盖论文背景、研究问题、方法、结果、讨论和结论之后，再进入 family/variant 或直接 editable PPTX 阶段。

最终 PPTX 的四个验收点

它要求最终 PPTX 尽量使用可编辑对象：标题、正文、注释、页码、线条、框、箭头和简单图示都应可编辑；论文图、表格、截图等证据素材则以图片对象保真插入。不要把整页 mockup 直接贴成最终幻灯片背景。

中文学术 PPT 还要特别看字体。规则里要求包含中文的可编辑 run 使用 Microsoft YaHei / 微软雅黑，并开启加粗；英文、数字、单位和公式可以分 run 处理。最后还要看 preview montage：标题层级、页脚页码、来源注释、素材可读性、连续页面骨架是否重复、是否露出内部流程词。

deathcats4/scholar-ppt-cn 适合解决“论文材料很多，但 PPT 汇报容易散”的问题。先把生产规划表做稳，再让样板页验证视觉系统，最后用本地预览和 montage QA 检查 editable PPTX，才能让学术汇报既讲得顺，又交付得住。