fix(#1749): 批量三连修：配音严格守卫/配音时长分配+末帧冻结/素材级去重 + variant-plans 接口 #1752

Merged

auto-approve-bot merged 20 commits from fix/batch-voice-duration-dedup-1749 into develop 2026-09-07 09:22:34 +08:00

Conversation 2 Commits 20 Files Changed 38

+2266 -636

xiaoxia commented 2026-09-07 07:17:41 +08:00

Owner

Copy Link

Copy Source

#1749 批量成片三连修

问题 A：变体配音错位（视频3错绑视频1配音）

• 新增 packages/domain/variant_voice_resolver.py：批量配音严格守卫
  • voice_library_ids 长度≠视频数 / 存在缺值 → 400，禁止静默 fallback
  • 长度 1 且 count>1 → 统一配音（与 cover_urls/titles 口径一致）
  • 空列表/None/全空白 → 未提供（不阻断）
• 正式生成、预览、variant-plans 三个入口统一走 resolver
• 清理请求体冗余 voice_ids 字段（DB 列保留，Response 只读保留，避免迁移）
• 批量块重构：变体0 一律 clone_plan_for_variant（不污染源 plan），任务循环 effective_plan_id=variant_plan_ids[task_index]

问题 B：成片截断配音 / 慢放失真

• 新增 packages/domain/voice_duration_planner.py：片段数=模板片段数定死；成片总时长=配音时长（等比分配、含逐处转场重叠、末段吸收舍入、误差<0.5s）
• edit_plan_service：apply_voice_duration_to_plan（幂等、短素材起点钳0、回写 plan.total_duration）、get_asset_durations、reselect 选片前按配音回写骨架段长
• 素材短于段长 → 末帧冻结 tpad=stop_mode=clone + 音频 apad 补静音；禁慢放、禁截配音
  • 渲染三路视频（filter_complex Step1 / 直通 / stream-copy）统一 trim=effective−freeze + tpad
  • render_audio 五路音频输出统一 atrim=effective−freeze + apad whole_dur
• 渲染期全局裁剪/慢放补偿全部删除，_align_clips_to_voice_duration 改为 ±5% 守卫日志
• render_layer_utils.estimate_total_duration 改逐处转场重叠口径（cut=0、非 cut 取该 clip 自身 transition_duration），与 planner 同口径
• 任何情况不得因素材时长报错打断用户；N=1 正式生成 enqueue 前也幂等分配配音时长

问题 C：跨视频素材重复避让失效

• variant_plan_selector.py 三轮选片重写：
  1. fresh 素材优先（批次未用过）
  2. 受控复用：0.25s 窗口扫描最优错开起点，overlap≤20% 才允许
  3. 短素材（total < clip_duration×0.8）数学上无法错开 → 禁跨变体复用
  4. 兜底尽力而为，不报错打断
• 非 main 片段同样走批次避让

新接口 POST /api/v1/generation/variant-plans

• 轻量选片：返回 plan_id + clips，不建任务/不入队/不渲染
• 与正式生成共用同一选片函数；正式生成回传 variant_plan_ids 直接复用（幂等按配音重分配）
• 配音 400 守卫同正式生成

测试

• 新增 30 例（planner 11 + resolver 10 + selector 9），重写 alignment 7 例、1294 4 例，适配 1677/1677/旧行为断言若干
• 沙箱全量：14265 passed；失败项均为沙箱环境预存在（httpx2 损坏 34 例、recency 时变分数 1 例、微信昵称环境 1 例），已用基线 bcbcb417 worktree 对照确认非本 PR 引入
• black/isort/ruff 全过；mypy 本 PR 零新增 error

Closes #1749

## #1749 批量成片三连修 ### 问题 A：变体配音错位（视频3错绑视频1配音） - 新增 `packages/domain/variant_voice_resolver.py`：批量配音严格守卫 - `voice_library_ids` 长度≠视频数 / 存在缺值 → **400**，禁止静默 fallback - 长度 1 且 count>1 → 统一配音（与 cover_urls/titles 口径一致） - 空列表/None/全空白 → 未提供（不阻断） - 正式生成、预览、variant-plans 三个入口统一走 resolver - 清理请求体冗余 `voice_ids` 字段（DB 列保留，Response 只读保留，避免迁移） - 批量块重构：变体0 一律 clone_plan_for_variant（不污染源 plan），任务循环 effective_plan_id=variant_plan_ids[task_index] ### 问题 B：成片截断配音 / 慢放失真 - 新增 `packages/domain/voice_duration_planner.py`：片段数=模板片段数定死；成片总时长=配音时长（等比分配、含逐处转场重叠、末段吸收舍入、误差<0.5s） - `edit_plan_service`：`apply_voice_duration_to_plan`（幂等、短素材起点钳0、回写 plan.total_duration）、`get_asset_durations`、reselect 选片前按配音回写骨架段长 - **素材短于段长 → 末帧冻结 `tpad=stop_mode=clone` + 音频 `apad` 补静音；禁慢放、禁截配音** - 渲染三路视频（filter_complex Step1 / 直通 / stream-copy）统一 trim=effective−freeze + tpad - render_audio 五路音频输出统一 atrim=effective−freeze + apad whole_dur - 渲染期全局裁剪/慢放补偿全部删除，`_align_clips_to_voice_duration` 改为 ±5% 守卫日志 - `render_layer_utils.estimate_total_duration` 改逐处转场重叠口径（cut=0、非 cut 取该 clip 自身 transition_duration），与 planner 同口径 - **任何情况不得因素材时长报错打断用户**；N=1 正式生成 enqueue 前也幂等分配配音时长 ### 问题 C：跨视频素材重复避让失效 - `variant_plan_selector.py` 三轮选片重写： 1. fresh 素材优先（批次未用过） 2. 受控复用：0.25s 窗口扫描最优错开起点，overlap≤20% 才允许 3. 短素材（total < clip_duration×0.8）数学上无法错开 → 禁跨变体复用 4. 兜底尽力而为，不报错打断 - 非 main 片段同样走批次避让 ### 新接口 POST /api/v1/generation/variant-plans - 轻量选片：返回 plan_id + clips，不建任务/不入队/不渲染 - 与正式生成共用同一选片函数；正式生成回传 variant_plan_ids 直接复用（幂等按配音重分配） - 配音 400 守卫同正式生成 ### 测试 - 新增 30 例（planner 11 + resolver 10 + selector 9），重写 alignment 7 例、1294 4 例，适配 1677/1677/旧行为断言若干 - 沙箱全量：14265 passed；失败项均为沙箱环境预存在（httpx2 损坏 34 例、recency 时变分数 1 例、微信昵称环境 1 例），已用基线 bcbcb417 worktree 对照确认非本 PR 引入 - black/isort/ruff 全过；mypy 本 PR 零新增 error Closes #1749

gitea-actions bot commented 2026-09-07 07:18:55 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1752
预览链接	https://pr-1752.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1752 | | 预览链接 | [https://pr-1752.preview.xiaoxiajianji.com](https://pr-1752.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia added 13 commits 2026-09-07 08:25:51 +08:00

wip(#1749): voice_duration_planner + variant_voice_resolver 纯函数（checkpoint） bd9f82550e

wip(#1749): variant_plan_selector 三轮素材级去重 + edit_plan_service 配音分配/变体plan确保（checkpoint） b0de7e9469

feat(#1749): variant-plans 轻量选片接口 + 配音严格守卫 + 批量变体 plan 重构（变体0 clone/配音时长分配） 7a4792773b

wip(#1749): 渲染侧末帧冻结（_resolve_clips freeze/tpad/apad）+ 全局慢放裁剪删除 + 总时长按转场重叠（checkpoint） 70f997faf7

wip(#1749): render_audio 四路 apad 静音补齐 + stream-copy tpad + worker 重渲传配音时长（checkpoint） 29113eaa4b

test(#1749): 重建配音分配/守卫/去重测试 + 适配 1677/1294（变体0 clone、voice_ids 移除） b76617aa78

fix(#1749): resolver 空列表/长度1归一化（统一配音口径）+ p02 trim 测试改为 freeze 新行为 ... c9fc7a8cce

- voice_library_ids 空列表/全空白视为未提供，修复 count=1 无配音误 400
- 长度 1 且 count>1 视为统一配音（与 cover_urls/titles 口径一致）
- 严格校验基于原始长度，缺值/数量不符仍 400
- test_p02_p03 trim 断言更新为新行为：trim=目标段长、tpad 末帧冻结、无慢放

test(#1749): 旧行为测试适配新口径（目标段长为准/逐处转场重叠/voice_ids 移除）+ filter_complex trim 口径统一 ... 19a6fa3d5a

- unified_render_service filter_complex Step1 trim 时长改为 effective-freeze（与直通路径同口径，tpad 补冻结）
- test_duration_compensation / render_audio_utils / render_audio_pure / 两处 render_layer_utils：min(duration,actual) 断言改为目标段长为准
- estimate_total_duration 测试：cut 零重叠、非 cut 逐处扣转场（FakeClip 加 transition_effect/duration）
- test_generation_tasks/preview：voice_ids kwarg/字段移除，配音改 voice_library_id

test(#1749): selector 落点断言改 overlap 语义 + cover 路由枚举适配新版 fastapi _IncludedRouter ... 40ce5b138f

- test_variant_plan_selector_1743：0.25s 窗口扫描落点不固定，断言改为重叠语义（≤2s/10s 段）
- test_generation_cover：递归 original_router 收集路径（新版 fastapi 延迟包装无 .path/.routes）

style(#1749): black/isort/ruff 格式化 + mypy 类型修复（dict 标注、zip strict、重试 Command 去 voice_ids） 95a274ed00

test(#1749): 集成测试补变体0 clone mock（#1749 变体0 一律 clone_plan_for_variant） e476bf462f

fix(#1749): confirm 路径补传 voice_ids 保留原值（DB 列只读口径一致） 57c1e236b6

fix(#1749): confirm 不传 voice_ids（#1749 已废弃该字段），断言改为空列表 cd5d845803

xiaoxia force-pushed fix/batch-voice-duration-dedup-1749 from a3147cdd39 to cd5d845803 2026-09-07 08:25:51 +08:00 Compare

xiaoxia added 1 commit 2026-09-07 08:35:56 +08:00

test: 修两个 CI flaky 测试（与 #1749 无关，顺带修让 CI Gate 过） ... fab03a79cf

- test_auth_bind_wechat_sync：默认昵称 '微信用户' → '小虾同学'（use case 已改，测试未同步）
- test_smart_match_noise_1743：patch datetime.now 为 NOW，避免 recency 分数随真实时间漂移导致断言失败

auto-approve-bot added 1 commit 2026-09-07 08:38:11 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 0a36f7fce4

xiaoxia added 1 commit 2026-09-07 08:53:44 +08:00

test(#1749): 补 diff coverage 单测（edit_plan_service 新方法/variant-plans 路由/preview 配音分配） 9503723e81

auto-approve-bot added 1 commit 2026-09-07 08:56:10 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 4205def388

xiaoxia added 1 commit 2026-09-07 09:01:15 +08:00

style(#1749): noqa B017 for pydantic validator exception assertion c67ce8a429

xiaoxia added 1 commit 2026-09-07 09:10:59 +08:00

test(#1749): smart_match endpoint test 注零噪声 rng（修 flaky 排序断言） 056d78ac01

auto-approve-bot added 1 commit 2026-09-07 09:13:01 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] c04a24c1be

auto-approve-bot merged commit e83a0b86f8 into develop 2026-09-07 09:22:34 +08:00

auto-approve-bot deleted branch fix/batch-voice-duration-dedup-1749 2026-09-07 09:22:35 +08:00

gitea-actions bot commented 2026-09-07 09:23:08 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1752 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1752 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1752