Codex Slides

社区

在 Codex 内运行的的开源 AI 幻灯片工作室

分类: 开发工具第 26 / 438
Stars: ★ 941 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+
凭据: 无需凭据
许可证: MIT
最近提交: 3 个月前
工具数: 38

67FMRS · C

Codex Slides 把一整套幻灯片生产流程搬进了 Codex 代码代理：浏览器优先、过程可见、项目持久化在本地。它用已有的 codex login 认证，无需额外 API key，提供 38 个类型化 MCP 工具和等价的 Node CLI，Fast 模式并行渲染大约 4–5 分钟出 10 页以上。主要限制是导出的 PPTX 为整页图像、文字不可编辑，同时不具备实时协作功能。适合已经深度使用 Codex、重视视觉保真度和本地数据所有权的用户。

最强项 · 文档质量 17/20 最弱项 · 可靠性 11/20

可靠性

11/20

安全与权限

12/20

维护活跃度

14/20

文档质量

17/20

安装易用性

13/20

查看各项评分依据

可靠性 11/20: 仅能读取 README 与仓库描述，MCP 清单未被缓存，无法核对 38 个工具是否与真实行为一致。README 声明存在 pnpm typecheck/test/check:mcp/check:skill 等验证门禁以及 release-desktop.yml 会在三平台启动打包服务器并要求核心路由返回 200，属于文件层面的可复现证据，但仓库内并未提供本审阅可见的实际 CI 工作流内容或已提交测试文件，因此依据静态校准，可靠性不得高于 12。存在明确的错误处理说明（90 秒心跳超时后仅重试未完成页、可恢复中断生成、多标签页轮询与焦点刷新），依赖可控（Node 20+、复用 codex login、无需额外 API Key），但缺少可见测试证据与工具清单核验，扣分明显。综合评为 11。
安全与权限 12/20: 未触发红线：未发现恶意代码、凭据窃取、隐蔽外传、无确认的破坏性默认操作，也未发现安装示例中包含真实令牌。凭据处理较克制——复用既有 codex login 会话，明确声明不存储独立 API Key、不写 .env；项目数据默认落在仓库 data/ 目录并提示不要提交个人数据与上传素材。但仅授予本地回环 HTTP 服务（127.0.0.1:4311）的 MCP 自动启动能力，未见对网络出口、外部搜索与图像生成调用范围的白名单或最小权限说明；对导出、删除模板/项目、批量生成等有副作用操作未见显式二次确认机制；第三方社区预览素材沿用上游 CC BY 4.0 许可，MIT 不覆盖，存在再分发合规风险。上述权限范围与确认机制不完整，故扣分至 12。
维护活跃度 14/20: 仓库未归档，881 星、7 个开放 issue，MIT 许可明确，具备 SECURITY.md、CONTRIBUTING.md、CODE_OF_CONDUCT.md 与私有漏洞上报渠道，治理框架较完整。README 显示路线图分已交付/进行中/下一步/探索四档，并有版本化发布流程（pnpm release、Actions 手动触发 Release desktop apps、生成 draft release 与 SHA256SUMS.txt），版本与更新路径清晰。但所有信息均来自自述性 README，静态审阅无法核对提交频率、issue 响应时效、依赖更新节奏与真实发布记录，缺少可验证的维护证据，因此不能给满分，评为 14。
文档质量 17/20: 文档质量是全项中最强的维度。安装（GitHub marketplace 与本地 checkout 两种路径）、认证（codex login，无需额外 Key）、使用（首副牌创建、文件来源、修改已有牌组、标注编辑、品牌系统）、CLI/MCP 工具分组表、环境变量表、数据目录结构、本地与桌面开发命令、生命周期管理、故障排查（插件不可见、应用不启动、标签页陈旧、渲染卡住、PPTX 文本不可编辑）以及验证命令清单均有条目化说明。限制披露较诚实：明确说明当前 PPTX 每页为整页图片、形状不可编辑且列入路线图，也说明桌面构建未公证及对应绕过方式，并给出媒体与创作工具包的可用/不可声称护栏。扣分点在于工具参数的逐项细节仍需跳转 CAPABILITY_MATRIX.md，本审阅不可见；成本与时延仅有“约 4–5 分钟”的口径。评 17。
安装易用性 13/20: 安装路径清晰且步骤少：codex plugin marketplace add 加 codex plugin add 两条命令即可，另有本地克隆与 pnpm 开发模式。前置条件明确（Codex 插件支持、Node 20+、已 codex login、Git），端口与 URL 固定为 127.0.0.1:4311，环境变量有默认值可覆盖。但依赖链较长：需要 Node 20 以上、corepack/pnpm、codex login 会话，且工作流高度绑定 Codex 插件体系与 Codex 内置 Browser，非 Codex 客户端（如 Claude Desktop、Cursor 等主流 MCP 客户端）没有配置示例，跨客户端可移植性未说明。静态校准下，缺少文件内可验证的执行证据，设置项不得高于 15；实际是否能在目标客户端一次连通无法核验，扣分后评 13。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络控制浏览器

适合谁

已经在使用 Codex 并且希望在代码代理内直接做演示的开发者和团队
需要图像原生、高视觉保真度幻灯片的工作流
想把研究、数据、文档快速转成 PPTX/PDF 的报告与发布场景
希望项目数据保留在本地磁盘、不想额外配置 API key 的用户

不适合谁

希望导出可单独编辑 PowerPoint 形状与文本框的用户（当前导出为整页图像）
只使用 Claude Desktop 等非 Codex 客户端的用户（安装方式面向 Codex 插件）
需要多人实时协作或公开只读分享链接的用户（尚未发布）
需要视频或动画幻灯片导出的用户（仍在探索阶段）

所需权限

在本地磁盘读写项目数据目录（默认 <repo>/data，桌面版为操作系统应用数据目录）
访问本地 HTTP 服务（默认 http://127.0.0.1:4311）
网络访问：用于联网深度研究与图像生成
复用已有的 codex login 凭据调用文本、研究与图像生成能力

风险与副作用

导出的 PPTX 中文字不可编辑，因为每页是完整图像
生成的幻灯片内容与图像质量取决于底层模型与提示词，可能需要多次重绘
项目数据、上传素材与生成图像都保存在本地，可能包含敏感信息，不应提交到版本库
社区风格预览素材保留上游许可与署名要求，MIT 许可不覆盖这些资源，再分发前需核对原始许可
桌面构建尚未公证，macOS/Windows 首次运行需手动确认

安装接入

准备工作

运行环境：Node.js 20+

其他可选配置项（6 个）

CODEX_SLIDES_URL 可选浏览器与本地 API 的基础 URL，默认 http://127.0.0.1:4311。

CODEX_SLIDES_HOME 可选便携 Skill 使用的源码检出路径，自动检测。

CODEX_SLIDES_APP_DIR 可选 MCP server 使用的源码检出路径，默认为插件根目录。

CODEX_SLIDES_LOG 可选自动启动服务器日志的存放路径，默认为系统临时目录。

CODEX_SLIDES_NO_AUTO_START 可选设为 1 可禁用 MCP 自动启动。

CODEX_SLIDES_DATA_DIR 可选项目与模板数据根目录，默认 <repo>/data。

确认已安装支持插件的 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）。

验证是否装好

安装后在 Codex 中启动新任务，运行 `codex plugin list` 确认 codex-slides 已启用；向客户端发送“Open Codex Slides and build me a 6-slide deck about …”，应能打开本地 http://127.0.0.1:4311 界面并出现 open_codex_slides、start_project 等工具。

常见排障

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 指向已有服务。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

打开 Codex Slides，创建一个关于2026年人形机器人市场的12页市场报告，先做研究并在大纲处暂停等待确认。
把附件里的数据集做成一个9页的数据故事幻灯片，先展示大纲再渲染。
打开我最新的 Codex Slides 项目，把第3页重写为面向高管的内容，只重新生成那一页。
把这个项目保存为可复用的项目模板，然后把整套幻灯片导出为 PPTX 和 PDF。

工具能力 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 只读

等待某次项目运行完成

展开其余 30 个工具

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 写入

自动生成演讲者备注

使用场景

用一句话描述主题，生成 10 页以上、约 4–5 分钟完成的高质量演示文稿

把 PDF、表格、Markdown 或仓库文件转成演示幻灯片

在渲染前审阅并修改大纲与视觉方向，而不是等待隐藏的黑盒结果

用 Mark 标记直接在幻灯片上画箭头和批注后重绘该页

把项目保存为可复用模板，复用品牌规则、基础风格与参考图

通过 MCP 工具让 Codex 代理以无界面方式批量生成幻灯片

支持客户端

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 个工具，并支持持久化项目运行的启动/查询/等待/取消。