Codex Storyboard

Codex Storyboard 是一个面向短视频和自媒体创作的本地分镜工具，以插件形式集成在 Codex 环境中。它将视频脚本撰写、分镜表管理以及素材生成整合在一个工作流中，支持通过自然语言指令创建项目并自动生成对应的图片及视频素材。

核心功能

该工具主要解决了从创意到视觉素材落地的中间环节，其核心能力包括：

• 一键项目创建：用户只需描述视频主题、平台（如抖音、YouTube）、时长和风格，Codex 即可自动生成包含镜头划分、台词、画面描述、A-ROLL/B-ROLL 分配及预计时长的完整分镜表。
• 本地可视化工作台：插件内置了一个本地运行的 Web 界面（通常位于 http://127.0.0.1:43218），用户可以在其中直观地查看和管理分镜表格，无需手动处理文件路径或 API 调用。
• 自动化素材生成与回填：支持调用 Image Generation、HyperFrames 或 Remotion 等工具生成分镜所需的图片或视频片段。生成完成后，素材会自动回填至对应的分镜单元格中，实现闭环。
• 视觉规范统一 (DESIGN.md)：支持为每个项目导入一个 Markdown 格式的视觉规范文件，用于约束生成素材的色彩、构图、字体和运动语言，确保成片风格的一致性。
• 多格式与多项目管理：支持 9:16、16:9、3:4 等多种画面比例，并提供项目的增删改查功能。所有数据默认保存在本地，保障隐私与数据安全。

快速上手

1. 安装插件

确保本机已安装 Node.js 18 或更高版本，并在支持插件的 Codex 环境中执行：

codex plugin marketplace add Yuuhann1999/codex-storyboard
codex plugin add codex-storyboard@codex-storyboard

安装后建议重启 Codex 或开启新对话以加载 MCP 工具。

2. 启动工作台

在 Codex 对话框中输入：
@codex-storyboard 打开 Codex 分镜台。
点击返回的本地链接即可在侧边栏或浏览器中访问工作台。

3. 创建项目

输入自然语言指令，例如：
@codex-storyboard 创建一个 9:16 的短视频分镜项目，主题是“Codex 侧边栏的 5 种用法”，风格干净、节奏快，适合抖音。
刷新工作台即可看到生成的分镜表。

4. 生成素材

在工作台中选中需要生成的镜头，或在 Codex 中指令：
@codex-storyboard 处理 Codex 分镜台里所有待生成素材。
系统将根据分镜描述自动调用相应的生成工具，并将结果填入表格。

适用场景

• 短视频创作者：快速将创意转化为可视化的分镜脚本，减少手动绘制或寻找参考图的时间。
• 自媒体运营：批量生产具有统一视觉风格的视频素材，提高内容产出效率。
• 本地化工作流偏好者：希望所有项目数据、脚本和素材均保留在本地，不依赖云端存储的用户。

注意事项

• 依赖环境：素材生成功能依赖于当前 Codex 环境中是否已启用 Image Generation、HyperFrames 或 Remotion 等相关能力。
• 会话刷新：若安装插件后未检测到相关 MCP 工具（如 create_storyboard_project），请尝试重启 Codex 或开启新对话。
• 视觉冲突处理：当分镜中的具体描述与 DESIGN.md 中的通用规范冲突时，系统优先遵循分镜中的具体要求。

Codex Storyboard 通过降低分镜制作和素材生成的门槛，为本地视频创作提供了一套结构化的解决方案。