先把 PPT 做得值得展示，再让它可编辑。
将书籍、PDF、论文与报告变成风格统一的图片 PPT，按需继续还原为原生可编辑 PPTX。
重点面向挑战杯（大挑/小挑）、中国国际大学生创新大赛、全国大学生交通运输科技大赛（交科赛）、三创赛、正大杯、大创等竞赛，也适用于学术汇报、论文答辩、项目路演、课程展示与电影质感 PPT，支持图片转可编辑 PPT。
简体中文 · English
推荐：直接把这一句话发给 Codex / Claude Code / OpenCode：
安装 SlideMuse，仓库是 https://github.com/helloo1568/slidemuse 。
请运行仓库自带的 install.py，注册 Skill、安装隔离依赖并完成自检；如果检测到多个客户端，请用 --client 指定当前客户端。
安装后直接说：使用 $slidemuse，把这份 PDF 做成 10 页竞赛 PPT。
手动安装与运行条件见快速开始。
| 需求 | 已有能力 |
|---|---|
| 从材料开始制作 | 逐页内容稿、四套风格总览、图片版 PPTX，按需重建可编辑对象。 |
| 保留演讲内容 | 图片版和可编辑版均支持演讲备注，可另行导出带来源的 Markdown 讲稿。 |
| 修改图表数据 | 精确生成单系列或分组条形图、柱状图；通过显式数据依赖同步已声明的图表、正文与讲稿。 |
| 接着上次继续做 | 输入预检、断点恢复、受影响页重渲染，以及集中列出的逐页待办。 |
| 核对交付质量 | 对象与内容检查、当前文件绑定的评分卡，以及可选的离线逐页审阅面板。 |
当前版本 2.16.0。完整变更见 CHANGELOG；这些工具辅助制作与核验，实际内容和画面仍需审阅。
同一套工作流，两种视觉表达。以下为本项目工作流产出的实际页面，点击图片可查看原图。
高原冰川智能巡检与生态预警系统：以冷色科技视觉串联项目叙事、场景与技术对比，展示科技风竞赛 PPT 与电影质感 PPT 的视觉方向。
用红金配色呈现工艺主题，让痛点、方案和技术信息保持一致的视觉语言，为国赛 PPT、比赛答辩 PPT 和创新创业路演提供风格参考。
作品图用于展示视觉效果；可编辑性以实际 PPTX 对象与审查报告为准。案例中的业务与技术数据属于演示内容，不代表本技能的性能指标。
| 带给你的价值 | |
|---|---|
| 🎨 先选风格，再做整套 | 内容大纲确认后，用同一组内容生成 4 套幻灯片浏览视图。先看到整体方向，再逐页制作。 |
| 🧩 好看，也能继续改 | 按需还原为原生文本、形状、表格与 5 类图表；照片和复杂插画拆成独立图片，便于替换和复用。 |
| 📝 准确内容，有据可循 | Page Spec 保存确认过的文字、数字、来源与元素 ID；可将图片观察记录与关键内容逐项比对，修改后只复查受影响页。 |
| 🔁 修改有记录，任务可接续 | deck-spec.md 保存制作状态，scene.json 保存布局。局部修改针对受影响的元素与素材，可重新导出。 |
| 🔍 交付有检查依据 | 脚本检查原生对象、文字、表格与图表数据、层级及整页底图残留；统一渲染工具生成逐页预览和基准对照，质量回归可生成版本绑定评分卡。 |
| 🔓 开放、可迁移、可扩展 | MIT 开源，兼容具备所需能力的 Agent；本地 Python 工具不发起网络请求，也不需要 API Key。 |
运行方式： SlideMuse 是 Agent 技能。宿主负责读材料、视觉理解与生图；仓库脚本负责合并、裁剪、编译和审查。完整制作需要宿主具备相应能力。模型选择参见运行环境与模型说明。
图表需要精确比例时，可生成单系列或分组条形图、柱状图的精确参考。数据修改可通过可选依赖契约预览并同步图表、衍生数值、正文和讲稿；两页合成交通示例提供可运行命令。
可编辑版提供文字溢出预警，定位可能放不下的文本框或表格单元格，由 Agent 查看真实渲染后处理；不会自动缩字或删内容。保守估算不能代替逐页视觉检查。
完成渲染后，可打开离线逐页审阅面板，对照源图与当前画面，保存检查结果和问题位置，并防止页面更新后沿用过期结论。面板是可选入口，用户无需逐页手动填写；具备视觉能力的 Agent 可以实际看图、核对后记录，也可直接使用原有 JSON 流程。 使用面板时，下载记录（或复制完整导出文本保存为 JSON），导入后重新评分；填写“通过”不会自动产生交付通过结论。
2.16.0 增加渲染超时、环境变化自动刷新与按页数据依赖缓存；可选 PowerPoint 实测文字和重叠检查。固定六页真实渲染回归及制作成本记录帮助比较返修与首次交付结果，使用方式见流水线。
| 场景与风格 | 如何使用 SlideMuse |
|---|---|
| 竞赛 PPT / 比赛答辩 PPT / 国赛 PPT | 围绕项目痛点、解决方案、技术优势与应用价值组织叙事，统一整套竞赛演示的视觉风格。 |
| 挑战杯 / 创新大赛 / 交科赛 / 三创赛 / 正大杯 / 大创 | 将项目书、论文、调研报告、商业计划书或赛事要求转成竞赛答辩页面，围绕评审逻辑组织内容并统一视觉表达。 |
| 电影质感 PPT / 电影感 PPT / 海报风 PPT | 将电影感光影、场景构图和海报式封面作为风格方向，在四套总览中比较后选定。 |
| 学术汇报 PPT / 论文答辩 PPT / 组会 PPT | 从论文、PDF 和研究报告提炼问题、方法、结果与结论，保留准确数据与来源。 |
| 商业路演 PPT / 项目汇报 PPT / 课程展示 / 读书分享 PPT | 根据受众和页数梳理内容，把长材料转成适合演讲和展示的页面。 |
| AI PPT 生成 / PDF 转 PPT / 图片转可编辑 PPT | 从材料生成图片版，或从已有页面图片、扫描 PDF 开始，按需还原原生可编辑 PPTX。 |
电影质感、科技风、红金风等属于可指定的视觉方向；实际效果取决于素材、宿主生图能力和逐页审校。
准备以下赛事的路演或答辩时，可以把项目书、论文、调研报告和赛事要求一起交给 SlideMuse。下表提供内容组织思路，制作大纲以当届通知和赛道要求为准。
| 赛事名称 | 常见搜索词 | 可组织的汇报内容 |
|---|---|---|
| 中国国际大学生创新大赛 | 大学生创新大赛 PPT / 互联网+ PPT / 创新创业大赛 PPT | 项目痛点、创新方案、应用验证、团队与发展规划。 |
| “挑战杯”全国大学生课外学术科技作品竞赛 | 挑战杯 PPT / 大挑 PPT / 科技作品答辩 PPT | 研究问题、技术方法、创新点、实验结果与应用价值。 |
| “挑战杯”中国大学生创业计划竞赛 | 小挑 PPT / 挑战杯创业计划 PPT / 创业计划书路演 | 用户需求、产品方案、市场分析、商业模式与实施计划。 |
| 全国大学生交通运输科技大赛（交科赛） | 交科赛 PPT / 交通运输科技大赛 PPT / 交通科技竞赛答辩 | 交通问题、方案设计、技术路线、实验或应用验证与创新价值。 |
| 全国大学生电子商务“创新、创意及创业”挑战赛 | 三创赛 PPT / 电商三创赛 PPT / 三创赛答辩 | 电商场景、创意方案、运营实践、项目成果与商业价值。 |
| “正大杯”全国大学生市场调查与分析大赛 | 正大杯 PPT / 市调大赛 PPT / 市场调查与分析大赛 PPT | 调研问题、调查设计、数据分析、主要发现与建议。 |
也适合大学生创新创业训练计划（大创）立项答辩、中期汇报与结题答辩 PPT。大创在这里作为项目汇报场景单列。
| 01 · 内容与风格 | 02 · 图片版 PPT | 03 · 可编辑还原（按需） |
|---|---|---|
| 提炼逐页内容稿，自检后确认 | 保存 Page Spec，逐页生成 | 结合规格与页面图分层重建 |
| 四套总览，选定视觉方向 | 检查文字与视觉，合并 PPTX | 编译原生对象，审查并渲染核对 |
| 得到：确认后的制作方案 | 得到：页面图片 + 图片版 PPTX | 得到：可编辑 PPTX + Scene + 素材 |
默认先确认内容，再选择风格。仅在明确要求可编辑版时进入第三步；已有幻灯片图片或扫描 PDF 的还原任务可直接从第三步开始。跳过预览、代选等规则见完整流程。
内容大纲须展开成可审阅的逐页内容稿：结论、支撑、可定位证据、解释与页面实际展示内容。进入风格阶段前先自检内容质量，再获得用户确认或明确内容代定授权；后续生图保留已确认的分析和必要边界。封面与过渡页按作用简化，不设统一字数或文字占比，详见内容深度规范。
| 环节 | 需要准备 |
|---|---|
| 安装与本地脚本 | Python 3.10+；使用下方克隆命令时还需 Git。安装器创建隔离环境并安装 Python 依赖。 |
| 材料理解与页面生成 | 支持技能文件、材料读取、视觉理解、生图和本地文件操作的 Agent。宿主提供相应模型与服务。 |
| PPTX 渲染与视觉核对 | Windows 可使用已安装的 PowerPoint；或准备 LibreOffice + Poppler，确保 soffice、pdftoppm 在 PATH 中。安装器不安装这些渲染工具。 |
可直接使用上方的安装提示词，也可按下面的步骤手动安装。
git clone https://github.com/helloo1568/slidemuse.git slidemuse
python slidemuse/install.py安装器会检测 Codex / Claude Code / OpenCode；只检测到一个客户端时会自动选择，同时检测到多个客户端时会停止并要求用 --client 明确指定，避免装到错误目录。随后会复制最小运行文件、创建隔离的 Python 环境、安装依赖，并运行 Page Spec 自检：
python slidemuse/install.py --client codex
python slidemuse/install.py --client claude
python slidemuse/install.py --client opencode升级会先在临时目录完成安装与验证，失败时保留原有版本。检测到旧名称的技能目录时，安装器会提示其位置；确认 $slidemuse 可用后再自行移除旧目录。
安装完成后，材料与产物仍应保存在独立工作目录，不要放进技能安装目录。
使用 $slidemuse，把附件报告做成 10 页项目路演 PPT。
受众是比赛评委，没有指定参考风格。
先给我内容大纲，确认后再展示四套幻灯片浏览视图供我选择。
选定风格后生成图片版，再继续还原为可编辑 PPTX。
请一并交付 page-spec.json、scene.json、素材和审查报告。
更多用法：只做图片版 / 还原已有页面
课堂或读书分享，只需要图片版：
使用 $slidemuse，把附件材料做成 12 页课堂汇报 PPT，受众是同学。
没有参考风格，只需要图片版。先确认内容大纲，再给我四套总览选型。
已有图片，想继续修改：
使用 $slidemuse，从 Step 3 开始，把附件的全部幻灯片图片还原为可编辑 PPTX。
保持原始文字、比例、布局与页序，拆出文字、图表和需要修改的主体。
复杂插画保留为独立图片，清理背景残影，并交付 Scene、素材和审查报告。
| 页面内容 | 还原后的对象 | 可以修改 |
|---|---|---|
| 标题、正文、标签、页码 | 原生文本框 | 文字、字体、颜色、位置 |
| 几何形状、箭头、流程节点 | 原生形状、线条、组合 | 尺寸、样式，取消组合后分别编辑 |
| 表格 | 原生表格 | 单元格内容与格式 |
| 柱形、条形、折线、饼图、环形图 | 原生图表 + 内嵌数据工作簿 | 数据、图表样式 |
| 照片、人物、复杂插画 | 独立图片对象 | 移动、缩放、裁剪、替换 |
复杂插画内部仍是像素。识别、分层和背景补全依赖宿主工具；本地脚本不包含自动 OCR 或分割模型。结构审查不能代替视觉验收，不能保证恢复被遮挡的信息。详见能力边界与验收。
下面的命令面向已准备好规格和素材的任务。宿主 Agent 仍负责内容确认、生图和实际审阅；流水线负责统一编译、渲染和检查。
在仓库或技能根目录运行，python 应使用已安装依赖的解释器；安装版解释器路径记录在 .skill-python。示例中的 task/ 必须已存在，包含 page-spec.json、其引用的图片，以及可编辑模式所需的 scene.json 和素材。
python scripts/init_deck.py task --mode editable
python scripts/run_deck.py task/job.json task-output --check
python scripts/run_deck.py task/job.json task-output图片版任务使用 --mode image，无需 Scene。初始化不会覆盖已有 job.json；缺图或待确认时会列出问题，修复后对已有配置重新执行 --check。任务中断后重复最后一条命令即可恢复，符合缓存条件的未变页面可复用渲染与有效审阅记录。
| 输出 | 用途 |
|---|---|
summary.md / summary.json |
查看当前状态、逐页待办、实际 PPTX 路径和工具阶段耗时。 |
review.png / render-report.json |
查看页面预览、基准对照与渲染记录；细节需打开原尺寸页面。 |
review-panel.html |
默认审阅记录流程的可选离线面板，对照源图和渲染图记录检查结果。 |
visual-review.json / content-observations.json |
保存实际视觉核对与文字观测，支持 Agent 直接记录。 |
scorecard.json |
本次交付检查结果；可编辑模式另有 object-audit.json。 |
awaiting_review（退出码 3）表示仍有待审证据。无需用户逐页手填：具备视觉能力的 Agent 可在实际看图后记录；使用面板时，下载或复制导出的 JSON、导入后，再运行原命令重新评分。complete 表示本次声明的检查通过，不能代替对来源事实和语义的判断。详细配置、缓存条件与退出码见流水线说明，导入步骤见审阅面板。
| 想做什么 | 从这里开始 |
|---|---|
| 了解安装、流程、命令与验收 | 使用与技术指南 |
| 让 Agent 执行技能 | SKILL.md |
| 保留演讲备注与导出讲稿 | 讲稿说明 |
| 精确绘图与联动修改数据 | 图表可靠性 · 数据依赖 · 可运行示例 |
| 恢复任务与核对交付 | 交付流水线 · 审阅面板 · 交付评估 |
| 扩展内容规格与可编辑对象 | Page Spec · Scene v1 · 重建指南 |
| 查看版本变化与设计来源 | Changelog · 调研记录 |
| 反馈问题、提建议或贡献代码 | Discussions · 贡献指南 |
感谢 Hugo He 的 PPT Master、banana-slides 和 PPTAgent 带来的方法启发，以及小黑盒作者“玩家22186848”和 B 站 UP 主“一往无前河井”的教程分享。场景编译器为独立实现，来源与取舍见调研记录。
本地脚本无需 API Key；宿主生图与视觉服务可能接收所提供的材料，费用与隐私规则以宿主为准。