Slidemuse

SlideMuse · 视觉优先的 AI PPT 技能

先把 PPT 做得值得展示，再让它可编辑。

将书籍、PDF、论文与报告变成风格统一的图片 PPT，按需继续还原为原生可编辑 PPTX。
重点面向挑战杯（大挑/小挑）、中国国际大学生创新大赛、计算机设计大赛、软件杯、服创大赛、信息安全作品赛、集创赛、嵌入式芯片赛、机创赛、化工设计竞赛、结构设计竞赛、交科赛、三创赛、正大杯、生命科学竞赛、节能减排、工创赛、3D 大赛、大广赛、睿抗、研创赛、MPA/MPAcc 案例大赛、IMA、CFA、iGEM、教学创新大赛、大创等竞赛与答辩场景，也适用于学术汇报、论文答辩、项目路演、课程展示与电影质感 PPT，支持图片转可编辑 PPT。

简体中文 · English

作品展示 · 核心优势 · 快速开始 · 使用指南 · 参与贡献

一句话开始

推荐：直接把这一句话发给 Codex / Claude Code / OpenCode：

安装 SlideMuse，仓库是 https://github.com/helloo1568/slidemuse 。
请运行仓库自带的 install.py，注册 Skill、安装隔离依赖并完成自检；如果检测到多个客户端，请用 --client 指定当前客户端。

安装后直接说：使用 $slidemuse，把这份 PDF 做成 10 页竞赛 PPT。

Agent 会先阅读材料、展示内容方案，再给风格选择。无需学习状态码或填写检查表；你已授权代定的部分直接继续。默认交付图片版，需要可编辑版时直接说明。

手动安装与运行条件见快速开始。

当前版本能做什么

当前版本 2.24.3。未指定的风格、页数和交付采用合理默认值；默认只在内容方案和风格选择处确认，已有授权直接继续。完整变更见 CHANGELOG。

先看作品

竞赛作品与风格展示

三套完整竞赛作品，每套 8 页，以及「雪线守望」「釉光新生」两套风格展示。点击预览图可查看大图。

浏览完整 24 页竞赛作品 · 本地作品集浏览器

焊隙智检 · 科技创新

面向小批量制造的焊缝外观检测方案，展示采集、质量门控、人工复核与对照评测。

_{01 / 项目封面   ·   04 / 算法与数据处理架构}

查看完整 8 页 · 下载图片版 PPTX

路口先知 · 交通应用

面向行人与转向车辆冲突的路侧预警方案，展示风险判断、场景验证及误报取舍。

_{01 / 项目封面   ·   06 / 固定回放的演示对照}

查看完整 8 页 · 下载图片版 PPTX

邻里守望 · 社区服务

面向独居长者的社区支持服务方案，展示人工调度、责任分工、服务指标与持续运营。

_{01 / 项目封面   ·   04 / 服务网络与责任分工}

查看完整 8 页 · 下载图片版 PPTX

雪线守望 · 冰川蓝银科技

高原冰川智能巡检与生态预警系统，以冰川蓝银配色呈现项目场景、痛点、方案与技术对比。

_{01 / 项目封面   ·   04 / 技术对比}

釉光新生 · 红金竞赛风格

以红金配色呈现工艺主题，展示项目痛点、解决方案与工艺技术。

_{03 / 解决方案   ·   04 / 工艺技术}

查看全部 7 页风格示例

_{作品均为原创概念展示，业务与技术数据为演示内容。三套竞赛作品提供图片版 PPTX；风格示例用于展示视觉效果。}

为什么选择 SlideMuse

运行方式： SlideMuse 是 Agent 技能。宿主负责读材料、视觉理解与生图；仓库脚本负责合并、裁剪、编译和审查。完整制作需要宿主具备相应能力。模型选择参见运行环境与模型说明。

图表需要精确比例时，可生成单系列或分组条形图、柱状图的精确参考。数据修改可通过可选依赖契约预览并同步图表、衍生数值、正文和讲稿；两页合成交通示例提供可运行命令。

可编辑版提供文字溢出预警，定位可能放不下的文本框或表格单元格，由 Agent 查看真实渲染后处理；不会自动缩字或删内容。保守估算不能代替逐页视觉检查。

完成渲染后，可打开离线逐页审阅面板，对照源图与当前画面，保存检查结果和问题位置，并防止页面更新后沿用过期结论。面板是可选入口，用户无需逐页手动填写；具备视觉能力的 Agent 可以实际看图、核对后记录，也可直接使用原有 JSON 流程。 使用面板时，下载记录（或复制完整导出文本保存为 JSON），导入后重新评分；填写“通过”不会自动产生交付通过结论。

2.16.0 增加渲染超时、环境变化自动刷新与按页数据依赖缓存；可选 PowerPoint 实测文字和重叠检查。固定六页真实渲染回归及制作成本记录帮助比较返修与首次交付结果，使用方式见流水线。

适合制作哪些 PPT

电影质感、科技风、红金风等属于可指定的视觉方向；实际效果取决于素材、宿主生图能力和逐页审校。

重点竞赛：创新创业路演、学科竞赛答辩与教学说课

准备以下赛事的答辩或路演时，可以把项目书、论文、调研报告和赛事要求一起交给 SlideMuse。下表提供内容组织思路，制作大纲以当届通知和赛道要求为准。

创新创业与团队路演

学科竞赛与案例答辩

教学与说课

也适合大学生创新创业训练计划（大创）立项答辩、中期汇报与结题答辩 PPT。大创在这里作为项目汇报场景单列。

赛事清单按当届通知为准；未列出的学科竞赛、案例大赛与说课活动，同样可以用"论文或报告转答辩页"的方式制作。

从材料到交付，三步完成

默认先确认内容，再选择风格。仅在明确要求可编辑版时进入第三步；已有幻灯片图片或扫描 PDF 的还原任务可直接从第三步开始。跳过预览、代选等规则见完整流程。

内容大纲须展开成可审阅的逐页内容稿：页面类型、结论、支撑要点、可定位证据、解释与页面实际展示内容。普通内容页默认 3–5 条有区别的要点；图表主导、简洁聚焦或密集查阅页按密度规则声明用途和理由，封面与过渡页按作用处理。图表已表达的事实不必再逐句抄成正文，可用语义覆盖映射记录承载元素，关键数值与必要边界仍须保留并实查。进入风格阶段前先自检内容质量，再获得用户确认或明确内容代定授权；不设统一字数或文字占比。详见内容深度规范。

快速开始

1. 确认运行条件

可直接使用上方的安装提示词，也可按下面的步骤手动安装。

2. 手动安装：clone 后只运行一条命令

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 可用后再自行移除旧目录。

安装完成后，材料与产物仍应保存在独立工作目录，不要放进技能安装目录。

3. 附上材料，复制这段话

使用 $slidemuse，把附件报告做成 10 页项目路演 PPT。
受众是比赛评委，没有指定参考风格。
先给我内容大纲，确认后再展示四套幻灯片浏览视图供我选择。
选定风格后生成图片版，再继续还原为可编辑 PPTX。
请一并交付 page-spec.json、scene.json、素材和审查报告。

使用 $slidemuse，把附件材料做成 12 页课堂汇报 PPT，受众是同学。
没有参考风格，只需要图片版。先确认内容大纲，再给我四套总览选型。

使用 $slidemuse，从 Step 3 开始，把附件的全部幻灯片图片还原为可编辑 PPTX。
保持原始文字、比例、布局与页序，拆出文字、图表和需要修改的主体。
复杂插画保留为独立图片，清理背景残影，并交付 Scene、素材和审查报告。

“可编辑”具体能改什么

复杂插画内部仍是像素。识别、分层和背景补全依赖宿主工具；完整重建后端提供本地文字尺寸提示、素材板处理及可选 OCR；几何提示不等于文字识别。结构审查不能代替视觉验收，不能保证恢复被遮挡的信息。详见能力边界与验收。

已有任务：检查、运行与恢复

下面的命令面向已准备好规格和素材的任务。宿主 Agent 仍负责内容确认、生图和实际审阅；流水线负责统一编译、渲染和检查。

在仓库或技能根目录运行。统一入口会优先使用该目录下的 .venv，无需激活环境；没有隔离环境时使用当前 Python。示例中的 task/ 必须已存在，包含 page-spec.json、其引用的图片，以及可编辑模式所需的 scene.json 和素材。

python slidemuse.py doctor
python slidemuse.py init task --mode editable
python slidemuse.py check task/job.json task-output
python slidemuse.py run task/job.json task-output

图片版任务使用 --mode image，无需 Scene。初始化不会覆盖已有 job.json；缺图或待确认时会列出问题，修复后对已有配置重新执行 check。任务中断后重复最后一条命令即可恢复，符合缓存条件的未变页面可复用渲染与有效审阅记录。原有 scripts/*.py 命令继续可用。

python slidemuse.py --help 列出常用命令，python slidemuse.py render --help 查看具体参数。环境诊断支持 doctor --json；默认缺少渲染器只提示警告，交付前可使用 doctor --require-renderer --backend auto 要求检测到后端。实际渲染与画面仍需核验。完整用法见命令与诊断指南。

awaiting_review（退出码 3）表示仍有待审证据。无需用户逐页手填：具备视觉能力的 Agent 可在实际看图后记录；使用面板时，下载或复制导出的 JSON、导入后，再运行原命令重新评分。complete 表示本次声明的检查通过，不能代替对来源事实和语义的判断。详细配置、缓存条件与退出码见流水线说明，导入步骤见审阅面板。

文档与社区

致谢与许可

感谢 Hugo He 的 PPT Master、banana-slides 和 PPTAgent 带来的方法启发，以及小黑盒作者“玩家22186848”和 B 站 UP 主“一往无前河井”的教程分享。场景编译器为独立实现，来源与取舍见调研记录。

基本工具无需 API Key；完整重建的联网 OCR/图像接口需按所选服务配置。宿主或第三方服务可能接收材料，费用与隐私规则以实际服务为准。

让下一次汇报，从好内容开始。

如果这个技能对你有帮助，欢迎 Star，也欢迎分享你的作品与改进。

MIT License © 2026 风清云影（helloo1568）

完整图片转可编辑后端（2.19.0）

集成 ningzimu/image-to-editable-ppt-skill 的完整安装用后端，保留 MIT 来源。支持 PDF/PPTX 输入、文字尺寸提示、原生曲线和表格、素材去背拆分、公式及逐页恢复。使用 python install.py --client codex --with-editable 安装扩展依赖，再运行 python slidemuse.py rebuild --help。详见完整接入指南。

完整图片生成后端（2.20.0）

集成 ningzimu/codex-ppt-skill 图片流水线的前半段，保留 MIT 来源。支持逐页生图任务与提示、分派/结果/阻塞登记、运行状态汇总、图片版组装和纯色去底，以及页面类型与有明确例外的密度规则、12 套内置风格参考。使用 python install.py --client codex --with-generate 安装扩展依赖，再运行 python slidemuse.py generate --help。详见完整接入指南。