Codex Slides

写代码的人最烦的就是把技术方案同步到 PPT 里，为了汇报得对着代码库手动截图、复制文字，极其低效。Codex Slides 这种“Prompt/Repo to Deck”的逻辑正好切中了这个痛点，它本质上是一个开源的 AI 幻灯片工作室，核心能力是能直接读取仓库内容并将其转化为演示文稿。

一个最典型的使用场景是：你刚完成一个复杂的开源项目，需要给团队做技术分享。你不需要重新梳理逻辑，直接把 Repo 链接喂给它，AI 会分析代码结构和 README，自动生成对应的 Slide 页面。

对于想尝试部署的同学，这玩意儿是开源的，建议直接在本地跑起来。

部署与快速上手指南

这套工具基于 Codex 驱动，部署流程比较标准，但建议在干净的 Docker 环境中操作，避免依赖冲突。

一、环境准备与克隆
首先得把源码拉下来，确保你本地有 Node.js 18+ 环境。

git clone https://github.com/nexu-io/codex-slides.git
cd codex-slides
npm install

二、配置环境变量
你需要准备好 API Key。在根目录下创建 .env 文件，配置你的 LLM 密钥。注意，如果你想让它精准分析 Repo，API 的上下文窗口（Context Window）得足够大，否则遇到大项目会直接截断，导致生成的 PPT 逻辑不连贯。

OPENAI_API_KEY=your_api_key_here
NEXT_PUBLIC_APP_URL=http://localhost:3000

三、启动服务
运行开发命令，启动后访问本地 3000 端口即可。

npm run dev

实际体验与踩坑细节

我实测用一个约 20 个文件的中型 JS 项目跑了一下，结果有些出乎意料：

• 解析速度： 从输入 Repo 链接到生成初步大纲，大约耗时 12-15 秒。
• 内容准确度： 对 README 的总结非常精准，但对深层嵌套文件夹里的逻辑代码解析能力一般，容易出现“幻觉”，把某些辅助函数误认为核心功能。
• 样式控制： 这是一个最大的坑。目前生成的 Slide 样式比较单一，如果你追求那种精美的商业 PPT 视觉效果，它给不了。它更像是一个“技术白板”，适合在内部技术评审时快速出草稿，而不是在年度汇报时用。

核心维度评估

• 自动化程度： 极高。实现了从代码库到演示文稿的端到端转换，省去了手动整理大纲的时间。
• 上手成本： 低。只要会 npm install 就能跑起来，不需要复杂的配置。
• 适用人群： 开发者、技术产品经理。特别是那些需要频繁向非技术人员解释代码逻辑的人。
• 局限性： 严重依赖于仓库中 README 的质量。如果你的文档写得烂，AI 生成的 Slide 基本上就是一堆废话。

如果你厌倦了在 PPT 里手动粘贴代码块，或者需要一个快速将 Repo 转化为简报的工具，这个项目绝对值得部署一套。虽然它不能替代专业的设计师，但能把一个程序员从繁琐的排版工作中解放出来。