用途：Codex Storyboard 是本地优先的多项目视频分镜工作区，用于视频制作中的分镜规划与素材生成。它支持创建视频项目、逐镜编写脚本与视觉描述，并借助 Image Generation、HyperFrames 或 Remotion 自动生成图像/视频素材，所有数据存储在本地，通过 MCP 工具访问。
主要能力：多项目分镜管理；逐镜脚本与视觉规划；素材自动生成与回填；项目级 DESIGN.md 保证视觉一致性；支持 9:16、16:9、3:4、4:3、1:1 多种画幅；本地媒体上传与预览；生成队列管理。
安装：作为 Codex 插件安装： codex plugin marketplace add Yuuhann1999/codex-storyboard codex plugin add codex-storyboard@codex-storyboard 安装后重启 Codex 或打开新会话以加载 MCP 工具。独立开发模式： git clone https://github.com/Yuuhann1999/codex-storyboard.git cd codex-storyboard npm start 访问 http://127.0.0.1:43218。
配置：插件模式默认数据目录为 ~/.codex-storyboard/，包含 projects.json 与 projects/<project-id>/（project.json、DESIGN.md、media/、generation/）。可通过环境变量 CODEX_STORYBOARD_DATA_DIR 自定义数据目录；开发模式使用仓库根目录的 data/。默认端口 43218，被占用时自动递增。
使用方式：通过 @codex-storyboard 指令操作，例如打开工作区、创建项目、增删改镜头、添加 DESIGN.md、处理生成队列。MCP 工具包括 list_storyboard_projects、create_storyboard_project、get_storyboard_project、update_storyboard_project、delete_storyboard_project、add_storyboard_shot、update_storyboard_shot、delete_storyboard_shot、get_storyboard_design、update_storyboard_design、delete_storyboard_design、get_storyboard_generation_tasks、complete_storyboard_generation_task。工作区还暴露 REST API（127.0.0.1:43218），涵盖项目、镜头、DESIGN.md 与生成队列。
适用场景：短视频（TikTok/Reels/Shorts）分镜、产品演示视频、教程类视频等需要逐镜规划与素材生成的项目。
限制：素材生成依赖 Codex 中可用的 Image Generation、HyperFrames 或 Remotion 能力；支持图片 PNG/JPEG/WebP/GIF、视频 MP4/WebM/MOV，单文件最大 100MB；生成任务可能停留在 pending 或失败，需检查能力可用性与 DESIGN.md 冲突。其余收费、价格、平台等信息暂未提供。