Skip to content
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_batch coordinator 按上限入队。
  • 资产列表新增候选缩略图、候选数量与待选用数量,生成中状态自动轮询。

视频与参考图

  • 新增 POST /api/v1/studio/shots/{shot_id}/reference-bindings/from-asset。
  • 视频批次创建立即返回,video_batch coordinator 在后台逐镜构建 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

  1. 拉取标签并创建 release 目录(与现有 release 一致,使用 git worktree):

    cd /home/ubuntu/dyeingtime-backup-1792519841
    git fetch --tags
    git worktree add /srv/dyeingtime/releases/v1.1 v1.1
  2. 执行发布脚本;脚本会备份数据库、构建前端、创建生产 venv、应用迁移、安装 systemd unit、切换 current 并重启服务:

    sudo /srv/dyeingtime/releases/v1.1/deploy/scripts/deploy_release.sh \
      /srv/dyeingtime/releases/v1.1
  3. 新增迁移均为加列,可重复执行:

    • 051-add-shot-duration-preference.sql:projects.shot_duration_preference_enabled
    • 052-add-script-parse-undo-snapshot.sql:script_parse_runs.undo_snapshot
    • 053-add-project-image-concurrency.sql:projects.image_concurrency
  4. 确认 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.0

Upgrade 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 与 OpenAPI info.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 验收的成员,以及在生产环境完成真实解析、图片与视频链路验证的同事。