v2.0.0 发布说明
v2.0.0 发布说明
2026年11月20日·DyeingTime Team
v2.0.0 是 DyeingTime 进入 V2 工作台后的第一个大版本。它把此前分散在 release/v1.2 候选与内部 beta 中的能力收敛为一条完整生产链路:剧本 → 分镜表 → 角色/场景/道具/服装 → 逐镜故事板 → 图片/视频/配音 → 审核与导出。发布标签为 v2.0.0,代码版本为 2.0.0。
Highlights
- 分镜表成为主入口:生成、场次大纲、候选审核、素材汇总、单镜开拍门禁、AI 审核、CSV/Excel/PDF 导出都在同一页完成。
- 角色设定板:12 面板角色母版,支持分面板合成与一次性整板两种模式,可绑定造型版本与抽卡参考图。
- 逐镜故事板:每个镜头独立生成 1/2/3 格故事板,支持批量、AI 改提示词、基于当前图重绘;采纳后作为该镜头的
storyboard参考图。 - 整集可视化故事板:6/9/12 格 16:9 大板,支持选镜、逐镜裁切预览与多次抽卡。
- 自由生成:首尾帧、全能参考、批量生成、素材上传与模板复制。
- 教学工作台:作业、提交、教师评审、模板库、成员进度与我的账户。
- 积分与多租户:组织/工作区、个人积分账本、图片 3 积分/张、视频 10 积分/秒、管理员免计费、审计日志与最小运营后台。
- 语音与 H3 契约:火山豆包语音、旁白音色独立绑定、屏幕文字不配音、同文语音参考保护、H3 @/运镜/视线契约与导演风格卡。
- 图片批量生成可靠性:修复旧快照、1 小时任务上限、worker 重启失联三类卡死问题,并增加心跳与看门狗自动恢复。
Added
分镜表与镜头准备
- 新增
storyboard服务与页面,覆盖分镜表生成、场次大纲编辑、行内场次调整、候选保留/忽略、确认生成、素材汇总与单镜门禁。 - 分镜表支持完整列、角色卡参考图回退、素材参考图、审核校验、CSV 导出,以及带缩略图的 Excel/PDF 导出。
- 新增分镜表 AI 审核助手、提示词问题分级与
@资产插入入口。 - 新增角色造型计划:按场次自动分配服装,审核后写回分镜与镜头。
- 新增视线目标编辑、音频队列与问题修复建议。
角色设定板与造型
character_sheets/character_sheet_panels支持 12 面板角色设定板,包含 5 个全身视图、6 个头部研究、电影感肖像、身高标尺与 Production Notes。- 支持「分面板合成」与「一次性整板」两种生成模式。
- 设定板可绑定造型版本与抽卡参考图;面板可单独重抽,采纳后成为当前母版。
- 角色造型支持单个/批量抽候选、单个/批量生成设定板;素材清单展示各造型的设定板缩略图与候选数量。
- 项目级开关
auto_use_latest_candidate控制视频参考是否自动使用造型版本的最新成功候选,默认关闭。 - 风格圣经新增英文提示词包;资产图与一次性设定板优先使用英文风格包,分面板设定板保持中文。
可视化故事板
- 整集 16:9 故事板支持 6/9/12 格、黑白铅笔/墨线/彩色、多次抽卡与显式采纳。
- 整集故事板支持镜头勾选、逐镜网格裁切预览与 AI 审核助手入口。
- 新增逐镜故事板独立页面
/projects/:projectId/storyboards/:chapterId,按场次分组、按镜号排列。 - 单镜故事板支持 1/2/3 格、16:9/9:16、角色设定板/造型图/场景图/上一镜参考、镜号/动作箭头/运镜箭头/台词摘要。
- 支持跨场次多选镜头批量生成,每个镜头每次 1/2/4 张候选。
- 候选采纳后写入
shot_reference_bindings,reference_role=storyboard,占一张镜头参考图名额,视频生成按frame处理。 - 新增项目级故事板总览页面,跨剧集查看已采纳的逐镜故事板。
- AI 助手支持两条路径:改生成前提示词,以及基于当前故事板图局部重绘。
自由生成
- 新增自由生成工作台:首尾帧、全能参考、批量生成、素材上传与模板复制。
- 自由生成支持
@素材编号与插入引用;仅在全能参考模式下生效。 - 图片生成前增加余额预检查,避免「创建成功但执行时因积分不足失败」。
教学工作台
- 新增教学工作台:作业创建、学生提交、教师评审、模板库、成员进度报表与我的账户。
- 教学模板库支持条目预览、筛选与视频预览。
- 教学工作台按工作选择可用项目,文案统一为「工作」与「成员」。
积分、组织与运营后台
- 新增组织、工作区类型与个人积分账本模型。
- 图片按 3 积分/张、视频按 10 积分/秒预扣,任务成功结算、失败/取消释放。
- 平台管理员生成免计费,积分账户返回管理员免计费标记。
- 新增个人积分账本、操作日志查询与最小运营后台(组织、成员、邀请码、积分调整)。
- 新增邀请码 + 邮箱验证的两阶段注册流程;邀请码在邮箱验证通过后才原子消费。
- 项目管理、任务中心与账户页补充管理员入口与组织上下文。
语音与视频提示词
- 接入火山引擎豆包语音,新增音色目录同步脚本与音色选择器。
- 旁白音色可独立绑定;屏幕文字不再生成配音素材。
- 新增同文语音参考保护、自动音色样本与 ARC 运镜。
- H3 v2 正向提示词、导演风格卡、
@参考语法、运镜契约与结构化视线目标落地。 - 新增 H3 与旧模板 3 镜 A/B 测试记录与阶段自测清单。
稳定性与运维
- 图片批量协调器改为「短执行 + 交棒」,每轮新事务读取子任务,避免 MySQL 旧快照与 Celery 1 小时上限。
- 异步任务每 15 秒刷新心跳;失联的
running子任务自动重置回pending。 - Celery worker 启动时与运行期间运行看门狗,自动重新调度僵死的
image_batch协调器。 - 逐镜故事板、整集故事板的多图批量复用同一协调器,遵守项目
image_concurrency。 - 本地 compose worker 显式消费
celery,batch,image,video,audio全部队列。 - 新增
backend/scripts/reconcile_image_batches.py,用于手动修复历史卡住的批量任务。
Changed
- 分镜表取代剧集页旧 AI 分镜规划入口,成为分镜生成、审核与开拍门禁的唯一入口。
- 分镜页恢复独立纵向滚动容器,并补充返回剧集与工作台入口。
- 资产描述/名称中的出处标注统一清理;资产图不再出现人物(服装/场景/道具),服装图继承项目风格。
- 视频参考可选择「自动使用最新造型候选」;默认仍为手动采纳。
- 项目概述可配置
image_concurrency(1–16,默认 2),批量图片按该上限逐步入队。 shot.status只表示信息提取确认状态;运行时状态统一由任务系统与 runtime summary 表达。- 版本号统一为
2.0.0;FastAPI、OpenAPI、前端 generated client 与页面页脚保持一致。
Fixed
- 修复图片批量生成长期停在
running:协调器旧快照、1 小时超时、worker 重启后子任务失联。 - 修复服装/场景/道具资产图按类型生成、服装图出现人物、未继承项目风格的问题。
- 修复角色造型读取懒加载导致的 500。
- 修复采纳设定板后
is_current不正确、刷新回退到未采纳板的问题。 - 修复英文 Production Notes 长句断词、后四分之三全身背景漂移、头部研究换行与细节标注压住身高标尺。
- 修复分镜候选确认弹窗只给笼统提示、无法定位具体阻塞行的问题。
- 修复素材批量通过按钮缺少加载态、分镜页滚动容器与标题定位问题。
- 修复视频批量协调器的旧快照读取问题。
- 修复提示
@引用在非全能参考模式下误生效。 - 修复默认组织中文名称编码与迁移乱码。
Breaking Changes
- 版本号从
1.1.0升至2.0.0;正式标签为v2.0.0,不再使用v1.2候选标签。 - 新增数据库迁移与 Celery
batch队列;部署必须同时启动 batch worker,否则图片批量协调器不会执行。 - 分镜表成为主入口,剧集页旧 AI 分镜规划入口已移除。
- 批量图片任务改为项目级并发窗口;单张手动生成仍立即入队。
- 新增组织/积分/邀请注册相关表与接口;旧账号会归入默认组织与默认工作区。
Deprecations
v1.2.0候选发布说明保留为历史草稿,不再作为对外版本。- 剧集页旧 AI 分镜规划入口与
ShotPlanWorkspace旧交互退役。 v2-internal-beta.*仅保留为历史版本与回滚点。
Security
- 生成任务 payload 仍不写入供应商 API Key;执行期按
provider_id解析。 - 邀请码只在邮箱验证通过后原子消费;注册邮件链接带有效期与重发冷却。
- 积分预扣、结算与释放都绑定任务 ID,重复执行不会重复扣费。
- AI 提示词建议与资产 AI 填写只返回建议,不自动写库、不自动发起付费生成。
- 审计日志覆盖组织、成员、邀请码、积分与关键写操作;写日志失败不影响业务响应。
- 批量看门狗只重新调度任务,不删除历史任务与已生成文件。
Known Issues
- 逐镜故事板的 2–3 格动作条目前只完成提示词与生成链路,尚未像单格一样做大规模成图对比;建议先各跑一组再定默认值。
- AI 故事板与分镜审核结果仍是草稿,需要人工确认;不会自动采纳或自动开拍。
- 英文风格包优先用于资产图与一次性设定板;分面板设定板仍使用中文说明。
- 图片批量看门狗会恢复失联任务,但不会无限重试供应商侧的真实失败;失败候选仍需人工重抽。
- 教学工作台为第一版,权限粒度以「教师/学生/成员」为主,尚未覆盖院系级隔离。
- 邀请注册依赖 SMTP 配置;未配置 SMTP 的环境只能使用管理员创建账号。
- 火山语音目录同步需要账号级只读 AK/SK;未配置时仍可使用手工音色 ID。
Migration Guide
- 备份数据库与对象存储清单;
- 按
schema_migrations缺失情况执行迁移:- 生产若停留在
053:执行054、067–085; - staging 若停留在
050:先补051–053,再执行054、067–`085; 064–066未使用,不需要执行;
- 生产若停留在
- 确认以下表/字段已存在:
organizations、organization_members、credit_accounts、credit_reservations、credit_ledger、credit_prices;teaching_*、generation_templates;storyboard_*、shot_storyboards、shot_storyboard_candidates;characters新增身高/职业/性格等字段、character_sheets、character_sheet_panels;projects.auto_use_latest_candidate、风格快照prompt_pack_en。
- 后端镜像确认包含
pillow、openpyxl、reportlab与fonts-noto-cjk; - 启动/重启 API 与五类 worker:
default、image、video、audio、batch; - 配置新增环境变量(按需):
VOLCENGINE_ACCESS_KEY_ID/VOLCENGINE_SECRET_ACCESS_KEY(音色目录同步);- SMTP 相关变量(邀请注册);
- 积分价格与额度相关变量(如使用默认值可省略)。
- 重新生成 OpenAPI 基线并构建前端:
cd front pnpm run openapi:update pnpm run build - 确认 OpenAPI
info.version与页面页脚均为2.0.0。
Rollback Notes
- 回滚应用代码后,新增表/字段不影响旧逻辑;旧版本不会读取新表。
- 如需彻底回滚,可删除
storyboard_*、shot_storyboards、shot_storyboard_candidates、teaching_*、credit_*、organizations等新增表;删除前先确认无业务数据依赖。 - 已生成的图片、视频、故事板与设定板文件保留在对象存储,不随代码回滚删除。
- 回滚后如需恢复
image_batch旧行为,必须同时回滚 API 与所有 worker,避免新旧协调器混跑。 - 正式标签回滚点:
v1.1;发布前快照:archive/pre-v2.0-20261120。
Compatibility Matrix
| 组件 | 要求 |
|---|---|
| MySQL | 8.0+,utf8mb4 |
| Redis | 现有 Celery broker 版本 |
| Python | 3.12(最低 3.11) |
| Node | 20+(前端构建);测试建议 22 |
| 图片模型 | 支持 9:16 / 1:1 / 3:4 / 16:9 输出 |
| 文本模型 | 分镜、AI 审核、资产填写使用;可缺省但对应按钮会失败 |
| 语音 | 火山引擎豆包语音;未配置时保留原有音频链路 |
| 视频 | MiniMax H3;video worker 并发上限 4 |
| 队列 | default、image、video、audio、batch 五类 worker |
Validation Commands
# 后端全量测试(v2.0.0:863 passed)
cd backend
uv run pytest tests -q
# OpenAPI 契约(后端产出 vs 前端基线)
cd ../front
pnpm run openapi:check
# 前端类型检查、单测与构建
pnpm run typecheck
pnpm run test
pnpm run build
# 服务与版本
curl -fsS http://127.0.0.1:8002/health
curl -fsS https://tim.run.place/api/v1/ready
curl -fsS https://tim.run.place/openapi.json \
| python3 -c 'import sys,json;print(json.load(sys.stdin)["info"]["version"])'
# 期望输出:2.0.0Upgrade Checklist
- 数据库备份完成,并确认 offsite 上传成功
-
054、067–085迁移执行并验证幂等 -
pillow/openpyxl/reportlab/fonts-noto-cjk已进入镜像 -
default、image、video、audio、batch五类 worker 均为 active - 分镜表生成、候选确认、素材汇总、单镜门禁验证
- 角色设定板分面板合成与一次性整板各验证一次
- 逐镜故事板单格与 2–3 格各生成一组并采纳一次
- 图片批量生成至少跑 4 张,确认并发窗口与完成状态
- 自由生成首尾帧/全能参考各验证一次
- 教学工作台作业提交与教师评审验证
- 积分预扣、结算、失败释放与管理员免计费验证
- 邀请注册(如启用)完成一次邮箱验证闭环
- OpenAPI 契约与前端 generated client 同步
- 回滚步骤演练
References
Notes for Contributors
- 版本号单一来源为
backend/app/__init__.py的__version__;仍需同步backend/pyproject.toml、backend/uv.lock、front/package.json与front/openapi.json。 - 修改 API 后必须执行
pnpm run openapi:update,并确认契约只做兼容性新增。 - 批量图片任务必须走
image_batch协调器,不要在路由层直接循环入队。 - 新增异步任务时必须确认 worker 入口已刷新提示词、写回心跳并处理取消。
- 分镜编辑页继续保持「准备」定位,分镜工作室继续保持「生成」定位。
- 发布说明中的迁移区间与验证命令必须与实际代码同步。
Acknowledgements
感谢参与 V2 工作台、分镜表、角色设定板、逐镜故事板、自由生成、教学工作台、积分体系与 H3 语音链路的同事与测试同学。