适合谁
- 已经在使用 Codex 并且希望在代码代理内直接做演示的开发者和团队
- 需要图像原生、高视觉保真度幻灯片的工作流
- 想把研究、数据、文档快速转成 PPTX/PDF 的报告与发布场景
- 希望项目数据保留在本地磁盘、不想额外配置 API key 的用户
C
67FMRS · C
Codex Slides 把一整套幻灯片生产流程搬进了 Codex 代码代理：浏览器优先、过程可见、项目持久化在本地。它用已有的 codex login 认证，无需额外 API key，提供 38 个类型化 MCP 工具和等价的 Node CLI，Fast 模式并行渲染大约 4–5 分钟出 10 页以上。主要限制是导出的 PPTX 为整页图像、文字不可编辑，同时不具备实时协作功能。适合已经深度使用 Codex、重视视觉保真度和本地数据所有权的用户。
Codex Slides 是一个在 Codex 代码代理内运行的开源幻灯片工作室，以浏览器优先的方式驱动从研究、大纲、视觉风格、渲染、编辑、演示到导出 PDF/PPTX 的完整流程。每一页幻灯片都是一整块视觉画布，采用图像原生（image-native）方式生成；Fast 模式会并行渲染每一页，因此约 4–5 分钟即可产出 10 页以上高质量幻灯片。它内置 45 套精选演示模板、73 套社区风格和 24 个引导式场景，使用已有的 codex login 认证，无需额外 API key，所有项目都保存在本地磁盘上。仓库同时提供便携式 Node CLI（skills/codex-slides/scripts/codex-slides.mjs）和位于 mcp/server.mjs 的类型化 MCP 服务器，共 38 个工具，并支持持久化项目运行的启动/查询/等待/取消。
工具能力
open_codex_slides
在 Codex 浏览器中打开 Codex Slides 界面
start_project
根据主题与页数等参数创建一个新项目
get_capabilities
列出当前可用的能力（CLI/MCP 接口）
list_projects
列出本地已有项目
get_project
获取指定项目的详情
start_project_run
启动一次持久化的项目运行
get_project_run
查询某次项目运行的状态
wait_project_run
等待某次项目运行完成
cancel_project_run
取消某次项目运行
list_scenarios
列出 24 个引导式场景
upload_material
上传素材供项目使用
list_design_files
列出项目中的设计文件
read_design_file
读取指定的设计文件内容
write_design_file
写入或修改设计文件内容
upload_design_file
上传设计文件
list_templates
列出内置演示模板
list_project_templates
列出可复用的项目模板
save_project_as_template
将当前项目保存为可复用模板
delete_project_template
删除某个项目模板
get_onboarding_questions
获取针对当前简报的澄清问题
deep_research
执行多轮联网深度研究并生成可编辑的 Markdown 简报
create_outline
根据简报生成演示大纲
revise_outline
根据反馈修改演示大纲
rank_inspiration
根据主题和大纲对社区风格进行排序推荐
get_brand_design_system
读取项目的品牌与设计系统设置
update_brand_design_system
更新品牌标识、色板、字体、图像风格等设计系统设置
create_deck
一次性创建整套幻灯片（无界面快速路径）
render_deck
渲染幻灯片
edit_deck
通过对话式指令编辑幻灯片
restyle_deck
按新的视觉风格重绘整套幻灯片
manage_slide
新增、复制、移动、删除幻灯片或设置转场
regenerate_slide
重新生成指定幻灯片
upload_slide_image
上传幻灯片图像
mark_edit_slide
根据标记（箭头、标签、批注）重新生成指定幻灯片
export_deck
导出为 PPTX 或 PDF，并保留演讲者备注
get_speaker_notes
获取演讲者备注
update_speaker_notes
更新演讲者备注
generate_speaker_notes
自动生成演讲者备注
安装接入
- 确认已安装支持插件的 Codex、Node.js 20 及以上版本，并已执行过 codex login。
- 从 GitHub 市场安装：
codex plugin marketplace add nexu-io/codex-slides
codex plugin add codex-slides@codex-slides
- 或者从本地克隆安装：
git clone https://github.com/nexu-io/codex-slides.git
cd codex-slides
codex plugin marketplace add "$PWD"
codex plugin add codex-slides@codex-slides
- 重启 Codex 或 ChatGPT 桌面应用，然后新建一个任务。
- 更新 Git 安装：codex plugin marketplace upgrade codex-slides，然后移除并重新添加插件，再重启 Codex。
- 本地开发可执行 pnpm install、pnpm dev（Web + 桌面），或 pnpm dev:web（仅 Web，默认 http://127.0.0.1:4311）。
选型与风险
不适合谁
- 希望导出可单独编辑 PowerPoint 形状与文本框的用户（当前导出为整页图像）
- 只使用 Claude Desktop 等非 Codex 客户端的用户（安装方式面向 Codex 插件）
- 需要多人实时协作或公开只读分享链接的用户（尚未发布）
- 需要视频或动画幻灯片导出的用户（仍在探索阶段）
所需权限
- 在本地磁盘读写项目数据目录（默认 <repo>/data，桌面版为操作系统应用数据目录）
- 访问本地 HTTP 服务（默认 http://127.0.0.1:4311）
- 网络访问：用于联网深度研究与图像生成
- 复用已有的 codex login 凭据调用文本、研究与图像生成能力
风险与副作用
- 导出的 PPTX 中文字不可编辑，因为每页是完整图像
- 生成的幻灯片内容与图像质量取决于底层模型与提示词，可能需要多次重绘
- 项目数据、上传素材与生成图像都保存在本地，可能包含敏感信息，不应提交到版本库
- 社区风格预览素材保留上游许可与署名要求，MIT 许可不覆盖这些资源，再分发前需核对原始许可
- 桌面构建尚未公证，macOS/Windows 首次运行需手动确认
常见排障
- Codex 看不到插件：执行 codex plugin list 确认 codex-slides 已启用，重新安装并重启 Codex，然后新建任务（旧任务可能仍用旧 Skill 快照）。
- 本地应用无法启动：确认 node --version 为 20 以上，执行 pnpm install、pnpm build、pnpm start，并查看 CODEX_SLIDES_LOG 或系统临时目录中的日志。
- 某个浏览器标签页显示旧幻灯片：项目页面会轮询标准项目状态并在聚焦时刷新；若仍是旧构建，重启本地服务并刷新两个标签页，可用 curl http://127.0.0.1:4311/api/projects/<project-id> 检查 API。
- 项目卡在渲染中：系统在项目心跳消失 90 秒后才恢复，重新打开项目即可，已完成页面会保留，只重试待处理或失败页面。
- MCP 自动启动问题：可设置 CODEX_SLIDES_NO_AUTO_START=1 关闭自动启动，或用 CODEX_SLIDES_URL 指向已有服务。
使用场景
用一句话描述主题，生成 10 页以上、约 4–5 分钟完成的高质量演示文稿
把 PDF、表格、Markdown 或仓库文件转成演示幻灯片
在渲染前审阅并修改大纲与视觉方向，而不是等待隐藏的黑盒结果
用 Mark 标记直接在幻灯片上画箭头和批注后重绘该页
把项目保存为可复用模板，复用品牌规则、基础风格与参考图
通过 MCP 工具让 Codex 代理以无界面方式批量生成幻灯片
支持客户端
Codex完整支持