codex-storyboard — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited codex-storyboard (Plugin) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<p align="center"> <img src="docs/assets/codex-storyboard-cover.png" alt="Codex Storyboard 顶部主视觉" width="900"> </p>
<h1 align="center">Codex Storyboard / Codex 分镜台</h1>
<p align="center"> 安装插件后，Codex 可以直接启动本地分镜台、创建视频项目、生成图片/视频素材，并自动回填到分镜表。 </p>
<p align="center"> <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT"></a> <img src="https://img.shields.io/badge/Codex-Plugin-111827" alt="Codex Plugin"> <img src="https://img.shields.io/badge/MCP-Ready-0ea5e9" alt="MCP Ready"> <img src="https://img.shields.io/badge/Node.js-18%2B-339933" alt="Node.js 18+"> <img src="https://img.shields.io/badge/Local--first-Yes-blue" alt="Local first"> </p>
<p align="center"> <a href="#快速开始">快速开始</a> · <a href="#使用流程">使用流程</a> · <a href="#界面展示">界面展示</a> · <a href="#核心能力">核心能力</a> · <a href="#designmd-视觉规范">DESIGN.md</a> · <a href="#开发">开发</a> · <a href="#隐私说明">隐私说明</a> </p>
Codex Storyboard 是一个面向短视频和自媒体创作的本地分镜工作台。
你可以直接让 Codex 创建一个完整视频项目：镜头、台词、画面描述、A-ROLL / B-ROLL、时长、素材类型和生成方式都会写进本地分镜表。之后 Codex 还可以继续调用 Image Generation、HyperFrames 或 Remotion 生成图片 / 视频素材，并把结果回填到对应镜头。
可以把它理解成：
Codex 里的视频脚本 + 分镜表 + 素材生成台。普通用户不需要理解 MCP、本地 API 或文件路径。安装插件后，说一句“打开分镜台”或“帮我创建一个分镜项目”就能开始。
需要：
codex plugin marketplace add Yuuhann1999/codex-storyboard
codex plugin add codex-storyboard@codex-storyboard安装后重启 Codex，或新开一个对话，让插件和 MCP 工具重新加载。
在 Codex 中输入：
@codex-storyboard 打开 Codex 分镜台。插件会自动启动内置本地工作台，并返回类似这样的链接：
http://127.0.0.1:43218点击链接即可在 Codex 侧边栏打开。
@codex-storyboard 创建一个 9:16 的短视频分镜项目，主题是“Codex 侧边栏的 5 种用法”，风格干净、节奏快，适合抖音。项目创建后，打开分镜台刷新即可看到完整项目和镜头表。
在分镜台里点击单个镜头的“生成素材”，或点击“批量生成”。然后让 Codex 处理队列：
@codex-storyboard 处理 Codex 分镜台里所有待生成素材。Image Generation、HyperFrames 和 Remotion 是否可用，取决于当前 Codex 环境中是否已启用对应能力或插件。
flowchart LR
A["告诉 Codex<br/>视频主题和要求"] --> B["Codex 创建<br/>本地分镜项目"]
B --> C["打开 Codex 分镜台<br/>检查脚本和镜头"]
C --> D["导入 DESIGN.md<br/>统一视觉风格"]
D --> E["单镜头或批量<br/>加入生成队列"]
E --> F["Codex 生成图片/视频<br/>Image Generation / HyperFrames / Remotion"]
F --> G["素材自动回填<br/>到对应镜头"]
G --> C一分钟日常用法：
@codex-storyboard 创建项目。DESIGN.md。Codex Storyboard 与 Codex 对话联动
Codex Storyboard 项目管理
Codex Storyboard 新建项目
Codex Storyboard 分镜工作台
Codex Storyboard 素材生成回填
| 能力 | 说明 |
|---|---|
| 插件自带工作台 | 安装 Codex 插件后可直接启动本地分镜台，不需要单独 clone 项目。 |
| 多项目管理 | 新建、重命名、打开和删除不同视频项目。 |
| Codex 一键建项目 | 通过 MCP 直接写入项目和分镜，不需要控制浏览器。 |
| 分镜表格 | 管理镜头类型、媒体类型、时长、台词文案、画面描述、生成方式、素材预览和备注。 |
| 素材生成队列 | 支持单镜头生成和批量生成，生成完成后自动回填。 |
| 多种生成方式 | 按镜头选择手动素材、Image Generation、HyperFrames 或 Remotion。 |
| 本地素材上传 | 手动上传图片 / 视频，支持放大预览、替换和删除。 |
| 项目级 DESIGN.md | 每个项目可选导入视觉规范，用于统一图片和视频素材风格。 |
| 多画面比例 | 支持 9:16、16:9、3:4、4:3、1:1。 |
| 本地优先 | 项目、脚本和素材默认保存在本机。 |
打开分镜台：
@codex-storyboard 打开 Codex 分镜台。创建项目：
@codex-storyboard 创建一个 9:16 的“AI 工具使用技巧”短视频分镜项目，直接写入 Codex 分镜台。补充分镜：
@codex-storyboard 帮我把这个项目补成 8 个镜头，每个镜头都写出台词、画面描述、时长和生成方式。生成素材：
@codex-storyboard 处理所有待生成素材。优先生成 Image Generation 图片，再生成 HyperFrames 和 Remotion 视频。查找项目：
@codex-storyboard 查看当前有哪些分镜项目，帮我找到标题里包含“AI 工具”的项目。新建项目时可以选择导入一个 Markdown 文件作为视觉规范。进入项目后，也可以通过右上角“视觉规范”菜单查看、替换或移除。
导入后，文件统一保存为：
<数据目录>/projects/<project-id>/DESIGN.md生成素材时：
DESIGN.md 统一约束视觉风格、色彩、构图、字体、质感和运动语言。generation/ 目录。插件模式默认数据目录：
~/.codex-storyboard/
projects.json
projects/
<project-id>/
project.json
DESIGN.md
media/
generation/开发模式 npm start 默认使用仓库内：
data/可以用环境变量自定义插件数据目录：
CODEX_STORYBOARD_DATA_DIR=/path/to/data插件通过 MCP 启动内置本地工作台，并调用本地 API。它不直接写项目 JSON，也不使用浏览器自动化强行打开页面。
支持：
DESIGN.md。DESIGN.md。为了减少 Token 消耗，创建工具默认只返回项目摘要，不会把完整脚本文案在工具结果中重复输出。
“手动素材”镜头支持：
支持格式：
如果你要修改工作台源码，可以 clone 仓库后直接启动根目录项目：
git clone https://github.com/Yuuhann1999/codex-storyboard.git
cd codex-storyboard
npm start打开：
http://127.0.0.1:43218开发检查：
npm run check验证插件：
python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py \
plugins/codex-storyboard本地调试插件：
codex plugin marketplace add .
codex plugin add codex-storyboard@codex-storyboard插件源码结构：
plugins/codex-storyboard/
├── .codex-plugin/plugin.json
├── .mcp.json
├── app/
│ ├── server.mjs
│ └── public/
├── mcp/server.mjs
├── scripts/start-mcp.sh
└── skills/
├── manage-storyboard-projects/SKILL.md
└── process-storyboard-tasks/SKILL.md项目结构：
.
├── .agents/plugins/marketplace.json
├── plugins/codex-storyboard/
├── public/
├── docs/assets/
├── server.mjs
├── package.json
└── README.md网页使用原生 HTML、CSS 和 JavaScript。本地服务使用 Node.js 标准库，没有运行时 npm 依赖。
主要本地 API：
GET /api/health
GET /api/projects
POST /api/projects
GET /api/projects/:projectId
PATCH /api/projects/:projectId
DELETE /api/projects/:projectId
GET /api/projects/:projectId/design
POST /api/projects/:projectId/design
DELETE /api/projects/:projectId/design
POST /api/projects/:projectId/shots
PATCH /api/projects/:projectId/shots/:shotId
DELETE /api/projects/:projectId/shots/:shotId
POST /api/projects/:projectId/shots/:shotId/media
GET /api/generation/tasks
POST /api/generation/tasks
POST /api/generation/tasks/:taskId/claim
POST /api/generation/tasks/:taskId/complete
POST /api/generation/tasks/:taskId/fail~/.codex-storyboard/。npm start 默认使用仓库内 data/。127.0.0.1，优先使用端口 43218。~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.