开源漫剧 Agent · 一键产出爆款
官网 · 下载 · 教程
QQ 交流群：1075312237
项目简介
MediaGo Drama 是一个面向漫剧生产的本地 Agent 工作台。它把原文、剧本、角色、场景、道具、分镜和生成素材组织成一个持续演进的创作项目，让 Agent 可以在同一份项目上下文中完成分析、改写、整理和生成任务。
产品围绕“原文 → 剧本 → 设定 → 分镜 → 素材 → 视频”的流程构建。创作者可以在任意阶段查看和编辑文档，也可以继续让 Agent 读取已有内容并推进后续工作。
为什么采用文档驱动
MediaGo Drama 不只保存最终生成的图片和视频，也保存这些结果所依据的创作内容：
- 上下文集中管理：原文、剧情、角色、场景、道具和分镜共同组成项目事实来源。
- 创作过程可读可改：中间产物以可读文档保存，创作者可以直接检查、修改和归档。
- 设定能够持续复用：角色外观、场景规则、关键道具和视觉要求可以跨章节、跨分镜继续使用。
- 文档直接进入生成流程：已确认的角色、场景和分镜可以继续用于图片与视频生成。
- 方法可以沉淀：有效的写作规则、画风要求和提示词模板可以整理为 Skills，供后续项目继续使用。
界面与演示
以下界面来自《太虚》漫剧项目，展示了同一个项目从内容整理、Agent 协作到分镜视频生成的工作方式。
项目概览
项目概览集中展示角色、场景、道具、分镜和生成素材。每项内容都可以继续打开、编辑或进入生成流程。
创作文档
角色、场景、道具与分镜以结构化文档保存在项目中。文档既是创作者可以检查的生产资料，也是 Agent 执行后续任务时使用的上下文。
Agent 工作台
Agent 会结合当前项目文档和对应 Skill，执行角色提取、场景整理、剧本改写、分镜拆解等任务。执行过程和结果都保留在项目工作区中。
分镜与视频生成
分镜文档中的镜头组可以直接进入视频工作区，统一查看已经生成的镜头、待生成任务和对应结果。
创作流程
从原文到成片
| 阶段 |
项目产物 |
后续用途 |
| 1. 导入原文 |
小说、故事梗概或已有剧本 |
建立整个项目的内容基础 |
| 2. 解析剧情 |
事件顺序、人物关系、场景切换和关键道具 |
形成结构化的故事上下文 |
| 3. 改写剧本 |
分场剧本、动作描写和对白 |
明确戏剧节奏、人物动机和场景内容 |
| 4. 建立角色 |
外观、服饰、身份和识别特征 |
为跨镜头生成提供稳定的视觉要求 |
| 5. 建立场景与道具 |
环境设定、关键物件和生成提示词 |
构建可反复使用的世界观资产 |
| 6. 拆解分镜 |
主体、动作、运镜、光影、台词和时长 |
转换为可执行的图片与视频任务 |
| 7. 生成素材 |
角色图、场景图、道具图和镜头参考图 |
为分镜视频提供视觉素材 |
| 8. 生成视频 |
分镜视频、分集预览和生成历史 |
汇总镜头并检查整集效果 |
各阶段产生的项目文档
项目文档不是一次性的生成结果。原文提供事实，剧本明确戏剧表达，角色、场景和道具建立视觉约束，分镜再把这些内容组织成可以执行的镜头任务。后续阶段可以直接引用前面的文档，修改后的内容也会继续成为项目的一部分。
核心能力
文档驱动的本地创作工程
- 以 Markdown 等本地文件保存项目文档，方便阅读、搜索、编辑和归档。
- 在同一个项目中组织原文、剧本、角色、场景、道具和分镜。
- 让创作内容同时服务于人工编辑、Agent 任务和媒体生成。
- 支持基于已有项目文档继续创作，不必重新整理全部设定。
面向项目的 Agent 工作台
- Agent 可以读取当前项目和指定文档，并在项目上下文中执行任务。
- 支持为剧本、角色、场景、道具和分镜任务装载对应 Skills。
- 长任务的计划、执行过程、工具调用和文档修改可以在工作台中查看。
- 使用原生 Codex app-server，支持流式对话、工具调用、审批与会话续接。
结构化的角色、场景、道具和分镜
| 资产 |
主要内容 |
| 剧本 |
场景标题、动作描写、对白和戏剧推进 |
| 角色 |
外观、身份气质、服饰道具和跨镜头识别特征 |
| 场景 |
环境、构图、光影、材质和生图提示词 |
| 道具 |
剧情功能、外观材质、使用关系和连续性标记 |
| 分镜 |
主体、动作、场景、运镜、光影、台词和时长 |
图片、视频与素材管理
- 围绕项目中的角色、场景、道具和分镜生成图片与视频。
- 支持参考素材、生成规格、模型选择和批量生成设置。
- 生成结果进入项目素材和历史记录，便于筛选、回看和再次引用。
- 分镜视频可以进入分集预览，集中检查不同镜头的生成结果。
Skills 与提示词模板
剧本、角色、场景、道具和分镜等创作规则以 Skill 文件管理。内置规则可以直接使用，也可以根据题材、画风和制作规范进行调整。
| Skill |
作用 |
screenplay-writer |
把小说叙述改写成分场剧本、动作与对白 |
character-writer |
提取可成像的角色设定与跨镜头识别特征 |
scene-writer |
生成可复用的场景设定与生图提示词 |
prop-writer |
梳理关键道具的剧情功能、视觉细节和连续性 |
storyboard-writer |
把小说或剧本拆解成面向视频模型的镜头组 |
novel-writer |
撰写、续写、改写和润色小说正文 |
image-generation |
组织图片生成参数、参考图和生成任务 |
video-generation |
组织视频生成参数、首帧参考和生成任务 |
项目还提供角色概念图、多视图、场景氛围图、场景四视图和电影感镜头等提示词模板，并内置真人写实、2D 动漫、3DCG 动漫和 Q 版等风格预设。
模型路由
图片、视频和文本生成使用统一的模型目录与参数系统。模型能力与具体执行渠道分开管理，可以根据生成效果、成本和可用性选择不同路线，同时让创作文档和分镜任务保持一致。
快速开始
当前版本主要面向本地开发和工作流体验。
本项目使用 One CLI 统一管理 Go、React 和 Electron 工作区的工具版本、开发、构建与测试任务。通过 one dev 即可同时启动本地服务端和 Electron 桌面端。源码与安装包见 One CLI 开源仓库。
环境要求
| 工具 |
建议版本 |
说明 |
| One CLI |
0.1.24+ |
工作区识别与统一任务入口 |
| Node.js |
24.14.1 |
前端与脚本运行环境 |
| pnpm |
11.9.0 |
JavaScript 包管理工具 |
| Go |
1.25.3 |
本地服务端运行环境 |
| go-task |
3.51.1 |
保留的项目原生任务 |
工作区采用 one.manifest.toml v2，工具版本和任务配置在根目录 mise.toml 中维护。
安装 One CLI
macOS / Linux：
curl -fsSL https://1cli.dev/install.sh | bash
Windows PowerShell：
irm https://1cli.dev/install.ps1 | iex
也可以从 One CLI Releases 下载 CLI 或 One Desktop。安装后，在本项目根目录信任工作区配置：
one mise trust
通过 One 执行任务时，会按配置准备工具与依赖。
安装依赖
one run install-deps
启动服务端和桌面端
在工作区根目录运行：
one dev
该命令先准备工具、编译后端，再启动前端和 Electron。Electron 持有本次后端进程，等待它就绪后打开窗口；后端自动分配可用端口，前端优先使用 31420，占用时自动换端口。实际地址会显示为 [desktop] server: ... 和 [desktop] renderer: ...。关闭桌面程序或按 Ctrl+C 会停止本次开发实例；首次准备工具和编译时可能需要稍等。
浏览器开发使用 one run dev:web，同时启动服务端与浏览器前端。也可分别运行 one run dev:server 和 one run dev:desktop，默认通过 8080 连接，桌面任务最多等待服务端 5 分钟。修改服务端或相关 Go 模块后，重启开发任务以重新编译。重新运行前请先停止旧开发任务，避免重复使用同一个开发工作区。
开源版数据目录
| 用途 |
默认目录 |
| 开发工作区 |
~/mediago-drama-oss-dev/workspace |
| 开发版 Electron 用户数据 |
~/mediago-drama-oss-dev/electron |
| 安装版工作区 |
<系统应用数据目录>/mediago-drama-oss/workspace |
| 安装版 Electron 用户数据 |
<系统应用数据目录>/mediago-drama-oss/electron |
Windows 的系统应用数据目录为 %APPDATA%，macOS 为 ~/Library/Application Support，Linux 遵循 XDG_CONFIG_HOME（默认 ~/.config）。数据库、日志和素材库随工作区保存；Electron 会话缓存保存在其用户数据目录下的 session 中。
开源版首次启动会在新目录初始化空库，旧的 mediago-drama 和 mediago-drama-dev 目录保留，不会自动复制旧数据库。需要恢复旧项目时，先备份，再将项目复制到新位置导入，避免两个版本同时写入同一个项目目录。
独立服务端和开发环境可通过 YAML 的 workspace_dir 或进程环境变量 MEDIAGO_WORKSPACE_DIR 指定工作区，环境变量优先。安装版 Electron 固定使用自身的开源版工作区。工作区初始化失败时，服务端会输出数据库路径并退出，停止启动后台 watcher。
本地技能包与用量统计
开源版支持直接导入普通 v1 .mgpack，查看内容、复制为本地技能包后编辑，再导出分享。
内置默认包和导入快照保持只读；旧版已经安装的技能包继续使用本地快照并保留来源信息。
加密 v2 技能包不受支持，开源版无需连接 MediaGo 商城或下载私有授权运行时。
“用量统计”按项目、模型、能力、供应商和时间展示调用次数与 Token 使用量。
历史任务和 Token 数据继续保留；界面与接口不再提供金额估算或账单。
源码中已移除 TalkingData 埋点。Codex、即梦、LibTV 和第三方 API 的登录与接入保持可用。
创建第一个漫剧项目
- 启动 MediaGo Drama，新建一个项目。
- 导入小说、故事梗概或已有剧本，建立项目原文。
- 在 Agent 工作台中选择对应 Skill，生成或整理剧本、角色、场景和道具。
- 检查并调整项目文档，再将剧本拆解为分镜。
- 为角色、场景和分镜生成参考图，并从分镜进入视频生成工作区。
- 在分集预览中查看已生成镜头和整体效果。
开发指南
本地开发
根目录负责统一编排前端工作台、Go 服务端和 Electron 桌面端。完成依赖安装后，可以按照快速开始中的方式运行开发环境。
One 工作区
| 项目名 |
路径 |
工具链 |
workspace |
apps/workspace |
Node.js / React / Electron |
server |
services/server |
Go |
core |
packages/core |
Go |
instructions |
packages/instructions |
Go |
jianyingdraft |
packages/jianyingdraft |
Go |
mcp |
packages/mcp |
Go |
tools |
packages/tools |
Go |
vendor |
packages/vendor |
Go |
one run --list # 查看根任务与子项目任务
one dev # 同时启动服务端与 Electron 桌面端
one run dev:web # 启动服务端与浏览器前端
one run build -p workspace # 只构建前端
one run build -p server # 构建前端、同步静态资源，再构建服务端
one run test -p core # 测试指定 Go 模块
one run check:scripts # 测试 Electron 发布脚本
one run build:desktop # 完整准备资源并打包 Electron
子项目任务从原有 package.json 和 Taskfile.yml 同步；新增或修改任务后运行 one init mise。根 mise.toml 保留了桌面打包、开发环境和资源同步的定制编排。原有 pnpm 与 task 命令仍可使用，发布 CI 继续复用 Taskfile。
应用版本保存在 apps/workspace/package.json，发布脚本只更新该文件。TOML manifest 只登记工作区和项目，不再保存旧版的 buildVersion、templateId、dotenv 和 OSS 配置。运行时继续使用应用现有配置和进程环境变量；需要连接 Infisical 时另行通过 one env bind 配置。
提交检查沿用已有的 Husky、lint-staged 和 commitlint。one init hooks 只支持自动迁移默认 Husky 钩子，本仓库的自定义检查继续保留。
构建与检查
提交代码前执行完整构建和检查：
one build
one check
测试
新增或修改功能时，请在对应模块补充测试，并运行工作区测试：
one test
模块开发文档
项目状态与路线图
当前已经具备的能力
MediaGo Drama 目前处于持续迭代阶段，已经具备本地项目管理、创作文档编辑、Agent 协作、Skills 与提示词模板、素材管理，以及图片、视频和文本生成工作区。
后续发展方向
项目的长期目标是让 Agent 7×24 小时持续推进漫剧生产。后续将继续完善任务编排、质量检查、成本控制、批量生产和桌面端使用体验，让从内容整理到成片输出的流程更加完整。
常见问题
当前版本应该如何体验？
当前版本以本地开发和工作流体验为主。安装环境与依赖后，同时启动服务端和 Electron 桌面端即可使用。
Agent 可以生成哪些内容？
Agent 可以围绕项目原文生成或整理剧本、角色、场景、道具和分镜文档，并继续基于这些文档组织图片与视频生成任务。
如何调整剧本规则、画风或提示词？
可以在 Skills 和提示词模板中调整对应规则。不同题材或制作规范可以使用不同的 Skill 与模板组合。
修改服务端代码后为什么没有生效？
修改服务端或相关 Go 模块后，需要运行 one run build:server 更新本地二进制，再重新启动开发环境。
参与贡献
提交 Issue
如果发现问题或有功能建议，欢迎在 GitHub Issues 中提交。请尽量附上复现步骤、运行环境和相关截图或日志。
开发与 Pull Request
- Fork 仓库并创建独立分支。
- 按照现有目录约定和代码风格完成修改。
- 为新增或修改的行为补充测试。
- 运行
one check 和 one test。
- 提交 Pull Request，并说明改动目的、实现范围和验证结果。
开源与商业边界
本仓库中的自有源码采用 Apache License 2.0。MediaGo 官方发行版可能同时包含本仓库之外的专有组件，并接入账户、商城、托管、支付、授权等独立商业服务。
这些商业组件与服务不属于本仓库开源许可证的授权范围，也不会改变 Apache-2.0 已经授予的权利。详细说明请参阅《MediaGo 商业功能与服务说明》。
许可证
本仓库自有源码采用 Apache License 2.0。在遵守许可证条款的前提下，可以使用、修改和分发本仓库中的开源代码，也可以用于商业用途。第三方依赖仍分别遵循其原始许可证。
开源版隔离与 Codex
桌面版的应用标识为 team.torchstellar.mediagodrama.oss，显示名为 MediaGo Drama OSS。
正式版数据存放在系统 appData 下的 mediago-drama-oss/；开发数据在 ~/mediago-drama-oss-dev/。
各自包含 workspace/ 和 electron/，与商业版独立。打包桌面端使用系统分配的本地端口，页面只连接本次启动的服务。
智能体仅使用打包的 Codex 0.163.0 app-server，通过双向 stdio JSON-RPC 处理流式消息、工具调用、审批、用户提问和中断。
在「设置 → Codex 接入」登录 ChatGPT，或配置支持 Responses API 的 Codex 中转服务。
开源版需要单独登录；账号与 Codex 会话保存在 <workspace>/.mediago-drama/runtime/agents/codex/account-home/。
中转配置使用独立的 relay-home/，切换中转不会覆盖 ChatGPT 登录文件。
升级会保留已有项目、聊天记录和工具历史。旧协议的会话标识不会作为 Codex thread ID 使用；第一次续聊会根据历史摘要创建新线程，此后原生续接。
one dev # 同时启动 server 和 desktop
one exec -p vendor -- task prepare # 准备原生 Codex CLI
实现与验证说明见 Codex app-server 迁移记录。
评论