ARTICLE · 1092950

一句话到成片:我们把短剧生产线,写进了源码里

发布时间：2026-09-28 20:20:28 最近访问：2026-09-28 20:19:37

从小说改写、角色定妆、分镜拆解，到批量出片、FFmpeg 合集——整条链路可本地跑通，也可一键装成桌面端。

做过短剧的人都知道：真正耗时的不是「有没有灵感」，而是把灵感拆成可执行的镜头清单，再一张张图、一段段视频拼起来。我们把这条流水线产品化了——源码结构清晰，接口可替换，模型可自选。

01 · 这套工具在解决什么

一句话概括：用 AI Agent 串联「剧本 → 资产 → 分镜 → 视频 → 成片」，让创作者把精力放在故事本身，而不是在各个生成工具之间来回拷贝粘贴。

核心能力可以拆成四块：

AI 驱动理解

大模型解析剧本，自动抽出角色、场景、道具与分镜信息

智能视觉创作

角色定妆、场景底图由生图模型批量产出，并作为视频参考图注入

镜头级视频生成

文生视频 / 图生视频按分镜出片，失败镜头可一键重试

端到端工作流

从创意到导出成片，左侧进度条始终告诉你「现在走到哪一步」

02 · 源码怎么组织的

仓库是典型的全栈 TypeScript 单体：前端负责工作台体验，后端托管 Agent 与媒资流水线，桌面端用 Electron 把同一套后端塞进本机。

PROJECT TREE

frontend/ — Nuxt 3 + Vue 3 + TS（纯 CSS） backend/ — Hono + Drizzle + Mastra Agents └ workspace/skills/ — Agent 技能（可在线改） desktop/ — Electron 桌面壳（dmg / exe） data/ — SQLite 库 + 生成的图/视频

为什么这样切？

前端走 Nuxt SPA，文件路由 + CSS 变量，界面轻、可控性强，适合做「制片台」这类信息密度高的控制台。

后端用 Hono 扛 API，Drizzle + SQLite（WAL）省掉单独装库的门槛；Mastra 挂了 4 个专职 Agent，技能文件放在 SKILL.md，界面里还能在线改。

桌面端用 Electron 起一个 utilityProcess 跑后端，BrowserWindow 同源加载——打包后双击即用，数据落在用户目录，卸载应用不丢素材。

03 · 四个 Agent，各管一段

这是整套源码里最「像生产线」的部分：不是一个万能聊天框，而是四个职责清晰的工人。

script_rewriter

小说 → 分集标注的拍摄剧本

extractor

角色 / 场景 / 道具智能提取与去重

storyboard_breaker

剧本 → 可执行的分镜序列

prompt_generator

出图提示词 + 分镜视频提示词

模型侧也没有绑死一家：文本可接 OpenAI 兼容接口 / Gemini；图片支持 OpenAI、Gemini、火山；视频可跑 Seedance 2.0、MiniMax H3、阿里百炼 Wan 3.0。Key 和模型参数都在网页「设置」里配，不进 .env，方便换厂商。

04 · 跟着界面走一遍生产流

下面按真实工作台截图，把「从新建项目到导出成片」拆开讲。

Step 1新建项目

首页点「新建」：选定画幅（16:9 横屏 / 9:16 竖屏，创建后不可改）和视觉风格（3D、写实等）。风格会注入后续所有出图提示词，保证全片气质统一。

新建项目：画幅 + 视觉风格

项目列表：一眼看清各部剧进度

Step 2配置 AI 服务（仅首次）

设置页里有「快捷配置」：贴一个 Key，文本 / 生图 / 视频三条推荐配置一次写好。也可以按厂商手动加模板并测连通。配好后顶部引导条自动消失。

设置 → 快捷配置：一条 Key 打通三类模型

Step 3剧本台：小说变拍摄本

把原文贴进工作台，点「AI 改写」。Agent 会按集拆分，并标好场景与角色。改写过程中可换文本模型、调语气，改完再人工微调。

剧本阶段：从小说到可拍剧本

Step 4资产库：角色 / 场景 / 道具定妆

对剧本跑一遍「提取」，得到角色、场景、道具清单；再批量生参考图。这些图会在出视频时作为一致性锚点注入——人物不像「每一镜换一张脸」，关键就在这一步。

资产生产：统一参考图，锁住角色一致性

Step 5分镜拆解 + 批量出片

视频页先跑「分镜拆解」：AI 切镜头并写视频提示词。顶栏切换视频模型与分辨率；右侧可改单镜提示词，@角色名 会自动映射到参考图。点批量生成，失败任务支持一键重试。

分镜拆解：镜头序列 + 提示词可改

视频生成：批量出片、失败可重试

Step 6合集导出

勾选镜头（悬停可预览），点「开始合并」，内置 FFmpeg 拼成整集，可在线播放或下载。点「标记完成」后，左侧进度条点亮——这一集正式收工。

合并导出：FFmpeg 拼整集

分集列表：每集状态一目了然，点进去继续做

05 · 几个值得抄的工程细节

数据库零安装：better-sqlite3 + WAL，单文件落在 data 目录，首次启动自动建表。不用另起 MySQL，本机和桌面端都省心。

FFmpeg 免安装：通过 ffmpeg-static / ffprobe-static 随包携带，合集、字幕、封面帧抽取开箱即用。

媒资本地化：生成文件统一进本地素材库，列表页用 400px 缩略图和视频封面帧，点开才加载原片，页面不卡。

多端同一套后端：开发模式前后端分端口热更新；单服务模式后端直接托管前端静态资源；Docker / 桌面版再包一层——业务代码基本不用改三遍。

06 · 想跑通源码？三条路

环境只要 Node.js 20+。本地开发最常见的是前后端分开启动：

# 后端 cd backend && npm install && npm run dev # 前端 cd frontend && npm install && npm run dev # 前端 http://localhost:3013 # API http://localhost:5679/api/v1

嫌配环境？直接下桌面安装包（macOS arm64 / Intel、Windows），双击开箱；国内可用镜像加速下载。macOS 若提示「已损坏」，按安装说明去掉隔离属性即可（未签名常见现象）。

要上服务器？前端 generate 后拷到 dist，后端 npm start；或拉现成 Docker 镜像挂 volume 持久化 data 目录。Nginx 把 /static/ 反代到磁盘，大文件走 sendfile 更省。