Skip to content
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

  1. 备份数据库与对象存储清单;
  2. 按 schema_migrations 缺失情况执行迁移:
    • 生产若停留在 053:执行 054、067–085;
    • staging 若停留在 050:先补 051–053,再执行 054、067–`085;
    • 064–066 未使用,不需要执行;
  3. 确认以下表/字段已存在:
    • 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。
  4. 后端镜像确认包含 pillow、openpyxl、reportlab 与 fonts-noto-cjk;
  5. 启动/重启 API 与五类 worker:default、image、video、audio、batch;
  6. 配置新增环境变量(按需):
    • VOLCENGINE_ACCESS_KEY_ID / VOLCENGINE_SECRET_ACCESS_KEY(音色目录同步);
    • SMTP 相关变量(邀请注册);
    • 积分价格与额度相关变量(如使用默认值可省略)。
  7. 重新生成 OpenAPI 基线并构建前端:
    cd front
    pnpm run openapi:update
    pnpm run build
  8. 确认 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

组件要求
MySQL8.0+,utf8mb4
Redis现有 Celery broker 版本
Python3.12(最低 3.11)
Node20+(前端构建);测试建议 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.0

Upgrade 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 语音链路的同事与测试同学。