Skillget

codex-storyboard

mcp
Guvenlik Denetimi
Uyari
Health Gecti
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 20 GitHub stars
Code Uyari
  • process.env — Environment variable access in plugins/codex-storyboard/mcp/server.mjs
  • network request — Outbound network request in plugins/codex-storyboard/mcp/server.mjs
  • network request — Outbound network request in public/app.js
  • process.env — Environment variable access in server.mjs
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

本地多项目 Codex 视频分镜工作台，支持图片/视频生成任务、HyperFrames 与 Remotion 自动回填。Local multi-project storyboard workspace for Codex.

README.md

Codex Storyboard / Codex 分镜台

Codex 里的本地视频分镜工作台：一句话创建项目，自动生成脚本、素材并回填分镜表。

License: MIT
Codex Plugin
MCP
Node.js
Local First

快速安装 · 界面展示 · 使用流程 · 插件工作流 · DESIGN.md 视觉规范 · 隐私说明

这是什么？

Codex Storyboard 是一个运行在本地的视频分镜台。

你可以让 Codex 直接创建一个完整的视频项目：写好镜头、台词、画面描述、A-ROLL / B-ROLL、素材类型、时长和生成方式。随后 Codex 可以继续调用 Image Generation、HyperFrames 或 Remotion 生成图片 / 视频素材，并把结果自动回填到对应镜头。

可以把它理解成：

Codex 里的视频脚本 + 分镜表 + 素材生成工作台。

普通使用者不需要理解 MCP、本地 API 或文件路径。你只需要告诉 Codex 想做什么视频，打开本地分镜台查看和调整即可。

界面展示

Codex 对话与分镜台联动

Codex Storyboard 与 Codex 对话联动

多项目管理

Codex Storyboard 项目管理

新建项目与画面比例

Codex Storyboard 新建项目

分镜工作台

Codex Storyboard 分镜工作台

素材生成与回填

Codex Storyboard 素材生成回填

核心能力

能力 说明
多项目管理 新建、重命名、打开和删除不同视频项目。
Codex 一键建项目 通过 MCP 直接写入项目和分镜，不需要控制浏览器。
分镜表格 管理镜头类型、媒体类型、时长、台词文案、画面描述、生成方式、素材预览和备注。
素材生成队列 支持单镜头生成和批量生成，生成完成后自动回填。
多种生成方式 按镜头选择手动素材、Image Generation、HyperFrames 或 Remotion。
本地素材上传 手动上传图片 / 视频，支持放大预览和替换。
项目级 DESIGN.md 每个项目可选导入视觉规范，用于统一图片和视频素材风格。
多画面比例 支持 9:16、16:9、3:4、4:3、1:1。
本地优先 项目、脚本和素材默认保存在本机。

快速开始

需要 Node.js 18 或更高版本。

git clone https://github.com/Yuuhann1999/codex-storyboard.git
cd codex-storyboard
npm start

打开：

http://127.0.0.1:43218

首次启动会自动创建本地数据目录：

data/
  projects.json
  projects/
    <project-id>/
      project.json
      DESIGN.md
      media/
      generation/

DESIGN.md 是可选文件。没有导入视觉规范的项目不会创建它。

安装 Codex 插件

仓库自带 codex-storyboard 插件和 Marketplace 配置。

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

安装后重启 Codex，或新开一个对话，然后输入：

@codex-storyboard 创建一个 9:16 的“AI 工具使用技巧”短视频分镜项目，直接写入 Codex 分镜台。

处理素材生成队列：

@codex-storyboard 处理 Codex 分镜台里所有待生成素材。

Image Generation、HyperFrames 和 Remotion 是否可用，取决于当前 Codex 环境中是否已经启用对应能力或插件。

使用流程

flowchart LR
  A["告诉 Codex<br/>你要做什么视频"] --> B["Codex 生成脚本<br/>并创建分镜项目"]
  B --> C["打开本地<br/>Codex 分镜台"]
  C --> D["人工检查<br/>台词、画面和时长"]
  D --> E["单镜头或批量<br/>加入生成队列"]
  E --> F["Image Generation<br/>HyperFrames / Remotion"]
  F --> G["素材自动回填<br/>到对应镜头"]
  G --> D

一分钟日常使用：

  1. 在 Codex 里说清楚视频主题、时长、风格和目标平台。
  2. 让 @codex-storyboard 创建项目。
  3. 打开本地分镜台，检查台词、画面描述和镜头时长。
  4. 需要统一视觉风格时，导入项目级 DESIGN.md。
  5. 点击单个镜头的“生成素材”，或使用“批量生成”。
  6. Codex 处理队列后，图片 / 视频素材会自动回填到分镜表。

常用提示词

@codex-storyboard 创建一个 9:16 的短视频分镜项目，主题是“Codex 侧边栏的 5 种用法”，风格干净、节奏快，适合抖音。

@codex-storyboard 帮我把这个项目补成 8 个镜头，每个镜头都写出台词、画面描述、时长和生成方式。

@codex-storyboard 处理所有待生成素材。优先生成 Image Generation 图片，再生成 HyperFrames 和 Remotion 视频。

@codex-storyboard 查看当前有哪些分镜项目，帮我找到标题里包含“AI 工具”的项目。

DESIGN.md 视觉规范

新建项目时可以选择导入一个 Markdown 文件作为视觉规范。进入项目后，也可以通过右上角“视觉规范”菜单查看、替换或移除。

导入后，文件统一保存为：

data/projects/<project-id>/DESIGN.md

生成素材时：

  • 分镜里的“画面描述 / 生成提示词”决定当前镜头具体内容。
  • DESIGN.md 统一约束视觉风格、色彩、构图、字体、质感和运动语言。
  • 当前镜头的明确要求与通用规范冲突时，以当前镜头要求为准。
  • HyperFrames 和 Remotion 的工程及中间文件保存在项目对应的 generation/ 目录。

Codex 插件工作流

插件通过 MCP 调用分镜台本地 API，不直接写 data/，也不使用浏览器自动化。

支持：

  • 列出项目，并按标题查找。
  • 读取单个项目和完整镜头。
  • 一次创建项目、全部镜头和可选 DESIGN.md。
  • 修改项目名称、比例和指定镜头。
  • 追加或删除镜头。
  • 替换或移除 DESIGN.md。
  • 读取待处理生成任务。
  • 将生成完成的图片 / 视频回填到正确镜头。
  • 永久删除项目及其本地素材。

为了减少 Token 消耗，创建工具默认只返回项目摘要，不会把完整脚本文案在工具结果中重复输出。

手动安装本地插件

如果你在修改插件源码，可以把当前仓库注册为本地 Marketplace：

codex plugin marketplace add .
codex plugin add codex-storyboard@codex-storyboard

插件源码位于：

plugins/codex-storyboard/
├── .codex-plugin/plugin.json
├── .mcp.json
├── mcp/server.mjs
├── scripts/start-mcp.sh
└── skills/
    ├── manage-storyboard-projects/SKILL.md
    └── process-storyboard-tasks/SKILL.md

本地素材

“手动素材”镜头支持：

  • 点击空素材框上传。
  • 使用“本地上传”按钮上传。
  • 点击已有素材放大查看。
  • 在 Lightbox 中重新上传替换。

支持格式：

  • 图片：PNG、JPEG、WebP、GIF
  • 视频：MP4、WebM、MOV
  • 单文件最大 100MB

项目结构

.
├── .agents/plugins/marketplace.json
├── plugins/codex-storyboard/
├── public/
├── docs/assets/
├── server.mjs
├── package.json
└── README.md

网页使用原生 HTML、CSS 和 JavaScript。本地服务使用 Node.js 标准库，没有运行时 npm 依赖。

开发

npm run check

验证插件：

python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py \
  plugins/codex-storyboard

主要本地 API：

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

隐私说明

  • 分镜项目、脚本和素材默认保存在本地 data/。
  • 仓库不会自动上传项目数据。
  • 本地服务默认运行在 127.0.0.1:43218。
  • 使用第三方生成能力时，提示词和输入素材可能受对应服务的隐私条款约束。

License

MIT

Yorumlar (0)

Sonuc bulunamadi