v1.1.0 发布说明
v1.1.0 发布说明
2026年10月25日·DyeingTime Team
v1.1.0 是 DyeingTime 从内部 beta 收敛后的第一个正式版本,发布标签为 v1.1,覆盖 v2-internal-beta.6 至 v2-internal-beta.27 共 24 个提交。
本版本的核心变化是把 V2 工作台从“可用”推进到“可完整生产”:资源 CRUD、解析确认/撤销、分镜规划、资产图片、视频批次与 H3 提示词在同一条链路上闭环;旧版项目制作页面正式退役。
Highlights
- V2 工作台成为唯一入口:剧集、角色、场景、道具、服装统一 CRUD;旧项目制作页退役,历史深链接安全重定向到 V2。
- 剧本解析形成闭环:确认时按已接受的场次节拍自动补齐正式场次,确认后可撤销;撤销基于快照和引用校验,不做半删。
- 分镜规划可控:支持取消、修改目标时长/节奏后重建;候选保存后重新校验阻塞项;镜头语言改为中文下拉,结构化字段成为 H3 Prompt 的权威来源。
- 资产图片批量生成:四类资产支持多选、全选缺图批量出候选,项目级图片并发可调。
- 视频批次异步化:创建批次立即返回,后台逐镜准备;单镜失败不再拖垮整批,并自动补齐参考图绑定。
- H3 音色参考修正:有
<Audio N>时不再把声音描述拼进台词;视频 worker 真实并发提升到 4。
Added
V2 工作台与资源
- 剧集完整 CRUD:新建、查看、改名、删除与刷新持久化。
- 角色、场景、道具、服装完整 CRUD:新建、编辑、删除、候选图、版本、角色音色与身份锁定。
- 资产删除同步清理版本、候选图、提示词审核稿、镜头资产版本,并停用镜头参考绑定;历史快照、视频与审核记录保留。
- 旧项目制作页面组件删除;历史深链接安全重定向到 V2。
- 删除源码与构建产物中的「去旧版创建」「旧版编辑」「返回旧版」入口。
剧本解析
- 确认解析结果时写入
script_parse_runs.undo_snapshot,保存确认前原文、摘要、文档版本、候选状态、新建资产/关联/别名前值。 - 新增
POST /api/v1/studio/script-parse-runs/{run_id}/undo,审核面板在can_undo=true时显示「撤销确认」。 - 撤销前校验人工修改与下游引用;任一不满足返回 409,不做半删。
- 解析确认按已接受的
scene_beats自动补齐scene_groups,同序号场次复用,重复确认幂等。 - 自动创建的场次写入撤销快照,撤销解析时一并删除。
分镜规划
- 新增
POST /api/v1/studio/shot-plans/{draft_id}/cancel,支持队列中撤下与执行中安全点停止。 - 目标总时长与节奏始终可编辑,支持按新参数重新规划。
- 镜头编辑的景别、角度、运镜改为中文下拉,提交值保持英文枚举;历史未知值原样保留。
- 补全 H3 Renderer 对
BIRD_EYE、DUTCH、OVER_SHOULDER、DOLLY_IN/OUT、CRANE、STEADICAM、ZOOM_IN/OUT的映射。
资产图片
- 新增
POST /api/v1/studio/projects/{project_id}/assets/{asset_type}/candidates/generate-batch。 - 资产列表支持多选、全选当前、全选缺图与一键生成选中图片;每项默认生成 1 张候选。
- 新增项目级
image_concurrency(1–16,默认 2),批量图片由独立image_batchcoordinator 按上限入队。 - 资产列表新增候选缩略图、候选数量与待选用数量,生成中状态自动轮询。
视频与参考图
- 新增
POST /api/v1/studio/shots/{shot_id}/reference-bindings/from-asset。 - 视频批次创建立即返回,
video_batchcoordinator 在后台逐镜构建 preview、快照与 staging 子任务。 - 批次项展示失败镜头与原因;「重试失败」会重新准备无
task_id的失败项。 _prepare_batch_items在缺少启用绑定时调用auto_recommend,从分镜已确认资产/场景自动补图,同时尊重人工删除/停用。- 新增
backend/scripts/check_runtime_dependencies.py,发布前校验生产运行时依赖可导入。
Changed
- 角色身份锁定不再是前置条件:分镜规划、候选应用与视频准备度不再要求锁定;锁定保留为保护身份字段与正面图不被覆盖的手段。
- 结构化镜头语言优先:
camera_shot/angle/movement为权威来源,描述文本不能覆盖;Renderer 会写入 camera language 锁定句。 - H3 音色参考行为:台词已绑定
<Audio N>时清空文字声音描述;无音频参考时,voice profile 必须位于<d>之前。 - 图片候选默认数量:单资产生成由 2 张改为 1 张;批量生成会跳过已有已选用图、pending 候选或待选用成功候选的资产。
- 视频批次语义:
POST /video-batches只创建骨架与 queued items,准备与执行转为后台;客户端需要轮询批次/批次项状态。 - 视频 worker 并发:
dyeingtime-celery-video提升到--concurrency=4;图片 worker 为 6,新增batch队列 worker(并发 1)。 - 候选失败提示:前端统一转换为中文可读原因(额度、鉴权、限流、超时、5xx),同一视角已有成功图时隐藏旧失败。
- 解析候选时序:新增/更新候选后显式 refresh,避免
created_at/updated_at懒加载触发MissingGreenlet。
Fixed
- 修复资产图片任务把
purpose="asset_identity_candidate"写入契约外枚举,导致任务在 10% 立即失败。 - 修复候选「重新生成」透传大写
view_angle导致 422。 - 修复批量图片生成成功后候选图在资产列表不可见、全局道具重复出现、角色列表混入其它项目角色。
- 修复 402 等供应商错误把 pydantic/HTTP 原文直接展示给用户,以及历史失败与新成功候选并列展示。
- 修复分镜候选保存后仍按旧
issues显示阻塞,以及草稿覆盖率统计不刷新。 - 修复
character_unlocked/unknown_scene_group只说明现象、不给出下一步操作。 - 修复场次建议接口对已存在手工场次重复导入的风险。
- 修复视频任务已成功、批次仍停在
running且批次项回到queued的协调器脏读问题(每轮session.expire_all())。 - 修复有音色参考时 H3 把中文声音描述当成台词续读。
- 修复生产环境
langchain-openai只在 dev 组、uv sync --no-dev后缺失文本模型依赖。 - 修复生产健康巡检仍探测
:8000,统一改为 Python API 的:8002。 - 修复剧集入口展示、配置项校验反馈与历史越界镜头时长提示。
Breaking Changes
- 旧页面退役:旧版项目/章节/分镜制作页面已删除,历史深链接会重定向到 V2;依赖旧路由的书签或脚本需要更新。
/api/v1路径与既有响应字段未删除,OpenAPI 仅新增 4 个端点。 - 角色锁定语义收窄:不再阻塞分镜规划、候选应用与视频准备度;原先依赖“未锁定即阻塞”的外部流程需要调整。
- 镜头语言优先级:结构化字段与描述冲突时,Prompt 以结构化字段为准,系统不会自动改写描述文本。
- 音色描述不再朗读:有音频参考时,文字声音描述不再进入 Prompt;需要声音描述生效时请移除音频参考。
- 图片候选数量与跳过规则:单资产默认 1 张;批量生成会跳过已有候选或待选用成功候选的资产。
- 视频批次异步返回:创建成功后批次处于 queued/running 仅表示后台正在准备或执行,不能立即假设所有镜头已准备完成。
- 版本与标签:代码版本统一为
1.1.0,发布标签为v1.1;v2-internal-beta.*仅保留为历史版本与回滚点。
Known Issues
- H3 + DeepSeek 思考模式:LangChain 强制
tool_choice时可能返回一次 400(Thinking mode does not support this tool_choice),当前 Agent 会自动降级为纯 JSON 输出。 - 旧分镜草稿不回填场次:场次自动补齐前生成的草稿,候选
scene_group_id仍为空,需要重新发起一次分镜规划。 - 自动补参考图依赖已确认资产:分镜没有已确认资产/场景时,批次项会失败并保留具体原因,不会生成空参考。
- 描述与结构化镜头语言冲突:系统只在 Prompt 中锁定结构化字段,不会反向修改描述文本,仍需人工保持一致。
- 供应商额度不足:PIX 等供应商返回 402 时按失败处理,不会自动重试;充值后需手动「重新生成」。
Migration Guide
拉取标签并创建 release 目录(与现有 release 一致,使用 git worktree):
cd /home/ubuntu/dyeingtime-backup-1792519841 git fetch --tags git worktree add /srv/dyeingtime/releases/v1.1 v1.1执行发布脚本;脚本会备份数据库、构建前端、创建生产 venv、应用迁移、安装 systemd unit、切换
current并重启服务:sudo /srv/dyeingtime/releases/v1.1/deploy/scripts/deploy_release.sh \ /srv/dyeingtime/releases/v1.1新增迁移均为加列,可重复执行:
051-add-shot-duration-preference.sql:projects.shot_duration_preference_enabled052-add-script-parse-undo-snapshot.sql:script_parse_runs.undo_snapshot053-add-project-image-concurrency.sql:projects.image_concurrency
确认
batch队列 worker 已启动;旧部署若未包含dyeingtime-celery-batch.service,需要先安装 unit。
Rollback Notes
sudo /srv/dyeingtime/releases/v1.1/deploy/scripts/rollback_release.sh- 回滚会把
current切回previous(发布前通常为v2-internal-beta.26/.27)并重启 API、Celery、Nginx。 - 迁移 051–053 都是可空列或带默认值的加列,旧代码会忽略;无需立即删列。
undo_snapshot中可能已有确认快照,删列会丢失撤销能力,回滚代码时不要删列。- 回滚不会回滚数据库数据;确认类操作的回退仍应使用「撤销确认」而非数据库回滚。
Compatibility Matrix
| 项目 | 要求 |
|---|---|
| API | /api/v1 路径与既有响应字段保持兼容;新增 4 个端点 |
| 数据库 | MySQL 8;迁移 051、052、053 可重复执行 |
| 后端运行时 | Python >= 3.11;生产使用 uv sync --frozen --no-dev |
| 前端构建 | Node 18 / 22;pnpm install --frozen-lockfile && pnpm run build |
| 队列 | default、image、video、batch 四类 Celery worker |
| 视频生成 | MiniMax H3;video worker 并发 4,单批并发仍受项目/批次设置限制 |
Validation Commands
# 后端全量测试(v1.1 基线:727 passed)
cd backend && .venv/bin/python -m pytest tests -q
# 前端类型检查、构建与 OpenAPI 契约
cd front && pnpm exec tsc --noEmit && pnpm run build && pnpm run openapi:check
# 服务与版本
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"])'
# 期望输出:1.1.0Upgrade Checklist
- 确认无运行中的视频生成任务(发布脚本会拒绝带任务发布)。
- 完成数据库备份并确认 offsite 上传成功。
- 从
v1.1创建 release 目录,确认backend/与front/完整。 - 执行
deploy_release.sh,确认迁移 051–053 逐条应用。 - 确认
dyeingtime-celery-batch、dyeingtime-celery-image、dyeingtime-celery-video均为 active。 - 校验
/health、/api/v1/ready与 OpenAPIinfo.version=1.1.0。 - 走一遍冒烟:创建剧集 → 解析确认 → 应用分镜 → 批量图片 → 视频批次。
References
Notes for Contributors
- 版本号单一来源为
backend/app/__init__.py的__version__,FastAPI 直接读取;仍需同步backend/pyproject.toml、backend/uv.lock、front/package.json。 - 修改 API 后必须执行
pnpm run openapi:update,并确认契约只做兼容性新增。 - 新增发布说明统一放在
site/content/blog,保持「Highlights → Added/Changed/Fixed → Breaking Changes → …」的章节顺序。
Acknowledgements
感谢参与内部 beta 验收的成员,以及在生产环境完成真实解析、图片与视频链路验证的同事。