English | 简体中文
StoryBoarding 面向短剧编剧、导演和小型内容团队，把故事开发、分镜设计、AI 视频与配音生产、审片采用、字幕和成片交付放在同一个工程里。平台强调可追踪的制作闭环：每个镜头、任务、候选素材、采用版本和交付文件都有明确归属，而不是只生成一批无法继续制作的图片或提示词。
在线体验：storyboarding.caifu.social · 💬 交流进群
- 从故事梗概或长文本建立短剧工程，组织多集结构、钩子、断点和爽点。
- 维护文学母本、节拍和分镜之间的关联，支持局部修改与同步。
- 建立角色视觉 DNA、声学 DNA、场景空间锚点和关键道具状态。
- 以 9:16 竖屏短剧为主要场景，同时支持 16:9 等工程画幅。
- 按集管理镜头、景别、机位、运镜、时长、对白和画面提示词。
- 为镜头绑定角色、场景和道具，减少跨镜、跨集的人物与物件漂移。
- 支持镜头锁定、局部重绘、故事板网格、节拍流、时间轴和顺场表。
- 可导出多模型视频提示词、导演分镜表和制片通告数据。
- 以影院模式连续预演单集或多集分镜。
- 检查镜头完整度、角色声学资料、场景、道具、时长与连续性风险。
- 通过生产看板查看待生成、生成中、待审、退回和已采用状态。
- 视频候选与音频候选分开统计，避免配音素材被误算为视频成片。
- 导出分镜长图、CSV 场记表、多模型提示词和工程 ZIP。
- 从生产看板提交视频任务、轮询状态、回收 R2 素材、审片并采用候选。
- 创建和切换剪辑版本，交付完整 MP4、分集 MP4、完整/分集 SRT 和清单。
- 移动端保留四阶段导航，生产看板采用上下分区，方便手机复核和采用素材。
平台将模型能力作为可配置的生产供应商，而不是写死在页面中的演示功能。
- 视频：MiniMax H3、BytePlus Seedance 2.x 与旧 Hailuo 分别走真实供应商协议；支持原生音视频、参考音频驱动和后期配音。
- Speech/TTS：设置页可配置 OpenRouter
speech模型、默认女声、男声和旁白声线；生产看板会继承这些配置，也允许单条对白覆盖。 - 声音版本：生成结果作为 Audio Take 保存，可试听、采用、退回和回切；采用后的版本可重新合入最终 MP4。
- 口型验收：有可见对白的真实视频必须标记口型已通过才能合并成片；单纯把 TTS 混入 MP4 不视为口型同步。
- 成本：只有供应商返回真实费用时才记录金额；缺少账单数据时显示“成本不完整”，不会把未知费用当成零成本。
模型能力、适用镜头与外部配音取舍见 原生音视频与外部配音调研。
线上工程《第二把钥匙 · 三集制作验收版》用于验证真实生产链路：
| 项目 | 当前结果 |
|---|---|
| 剧集结构 | 3 集，每集 8 镜、48 秒；全片 144 秒 |
| 工程画幅 | 9:16，仪表盘、工作台与交付页一致 |
| 结构化资产 | 2 个角色、2 个场景、5 个关键道具；24 镜均绑定角色与场景 |
| 真实视频 | EP01 SHOT01 完成 MiniMax 生成、R2 回收和采用 |
| 配音 | 生产看板中有 23 个 Audio Take；已验证 OpenRouter 中文 TTS 生成、R2 回收、试听和采用 |
| 当前交付 | v1.2-current-voice：完整 MP4、3 个分集 MP4、4 个 SRT 和交付清单 |
| 媒体规格 | 完整 MP4 为 720×1280、H.264 + AAC，并包含 mov_text 字幕轨 |
这是一套低成本技术样片。只有 EP01 SHOT01 是真实 AI 视频，其余 23 镜使用明确标注的技术卡，用于验证剧集结构、配音、字幕、剪辑、版本和交付链路，不代表完整视觉成片质量。
完整验收记录见 真实站点完整闭环 QA 和 三集样片验收方案。
- 登录用户的工程存储在 Cloudflare D1，视频、音频、字幕和交付文件存储在 R2。
- 项目、镜头、角色、场景和道具接口执行登录与工程所有权校验。
- 用户模型密钥以 AES-256-GCM 加密保存，读取设置时仅返回掩码与是否已配置。
- R2 媒体接口支持 HTTP Range，可用于浏览器播放、拖动和断点读取。
- 生产任务记录供应商任务 ID、状态、模型、参数、候选 Take 和采用结果。
| 层级 | 技术 | 用途 |
|---|---|---|
| Web | Next.js 14、React 18、Tailwind CSS | 响应式导演工作台与生产看板 |
| 状态 | Zustand | 工程、剧集、镜头、认证和阶段状态 |
| API | Hono on Cloudflare Workers | 认证、项目、生成任务、生产与交付接口 |
| 数据 | Cloudflare D1、Drizzle ORM | 多租户工程数据、任务和版本记录 |
| 媒体 | Cloudflare R2 | 分镜、视频、音频、字幕和交付文件 |
| 模型 | OpenRouter、MiniMax、可配置图像/视频供应商 | 剧本分析、生图、视频和 Speech/TTS |
要求 Node.js 22+。
# 安装依赖
cd backend && npm install
cd ../frontend && npm install
# 终端 1：启动 Worker
cd backend && npm run dev
# 终端 2：启动前端
cd frontend && npm run dev默认地址：
- 前端：http://localhost:3000
- Worker：http://localhost:8787
# 前端回归测试与生产构建
cd frontend
npm test
npm run build
# 后端类型检查
cd ../backend
npx tsc --noEmit当前回归套件覆盖多集顺序、镜头字段保留、说话者解析、Speech 声线继承、生成任务并发保护、成本语义和交付数据规范化。真实供应商可用性、生成质量和实际扣费仍需在部署环境中验收。
仓库的 GitHub Actions 会按路径变化部署 Cloudflare Pages 和 Workers。手动部署可使用：
# 后端
cd backend
npm run deploy
# 前端静态构建
cd ../frontend
npm run build首次部署还需要创建并绑定 D1 数据库、R2 Bucket，并配置 Worker/Pages 环境变量和密钥。不要把模型 API Key、JWT 密钥或 Cloudflare 凭据提交到仓库。
欢迎短剧编剧、影视导演、AIGC 创作者以及开发者交流使用心得、探讨工作流定制或提出功能建议：
微信扫码添加作者好友（永林）
添加好友请备注：StoryBoarding 或 短剧，将邀请您进入官方创作者与技术交流群