feat(#1970): 智能降重 PR2 - dedup_enabled 开关 + 6 维片段级微变换 #1975

Merged

auto-approve-bot merged 1 commits from feat/1970-dedup-micro-transforms into develop 2026-09-18 05:45:00 +08:00

Conversation 2 Commits 1 Files Changed 11

+801 -32

xiaoxia commented 2026-09-18 05:34:57 +08:00

Owner

Copy Link

Copy Source

#1970 智能剪辑流程重构 · PR2/3 智能降重增强

承接 PR1（#1974 已合入 develop）。

改动内容

1. 开关贯通：CreateGenerationTaskRequest 新增 dedup_enabled: bool = True；经 writeback_edit_plan_config 落入 plan.config（同时写入 video_index 供同批次变体区分种子）。无需 migration（JSON 字段）。
2. 纯逻辑模块 apps/worker/video_processing/micro_transform_pure.py：
   • 种子 sha256(task_id:video_index) % 10000（不用内置 hash，规避 PYTHONHASHSEED 跨进程不可复现）
   • hflip 每片段 50%、播放速度 0.971.03x、亮度/对比度/饱和度各 ±2%、BGM 起始偏移 28s
3. 渲染注入（unified_render_service 直通 + filter_complex 两路径）：
   • hflip 注入 scale 前（缩放后翻转会破坏画面定位），eq 注入 scale 后
   • 微变换速度烘焙进 ResolvedClip.playback_speed，trim 多段展开时按 config._micro_index 对齐源片段序号；音频链 atempo 自动同步，无双倍叠加
   • BGM 偏移复用 #1767 已有 audio_offset（-ss seek），用户显式配置优先
4. 门控：启用微变换时 _can_use_stream_copy 强制重编码；worker 渲染后 dedup_enabled=False 跳过 random_edge_crop（读 plan.config 失败按开启兜底），实现确定性渲染。
5. 容错：种子/plan 构建、filter 注入、offset 读取均 try/except 降级为不注入，不阻断渲染。

P1 保守项

• 字幕检测尚未实现，clip_has_text=None 时按「全部有字幕」处理 → 本 PR hflip 实际不翻转，仅保留管线；后续拿到字幕检测后改一行即可放开。

测试

• 新增 43 个：纯参数/边界/可复现/翻转率分布 23 + 渲染注入/stream copy 门控/开关 18 + writeback 2
• 适配 test_unified_render_service 既有确定性用例（FakePlan 默认 dedup_enabled=False）
• 全量 tests/unit：15701 passed, 28 skipped（503s）；black/isort/ruff 全过

影响面

默认开启，渲染后视频产生片段级确定性差异以降重；关闭后渲染链路与改造前行为一致。无 DB migration。

PR3 将在此 PR 合入后提交：assembly_mode/script_id/tts_* 等新字段 + 叙事模式。

## #1970 智能剪辑流程重构 · PR2/3 智能降重增强 承接 PR1（#1974 已合入 develop）。 ### 改动内容 1. **开关贯通**：`CreateGenerationTaskRequest` 新增 `dedup_enabled: bool = True`；经 `writeback_edit_plan_config` 落入 `plan.config`（同时写入 `video_index` 供同批次变体区分种子）。无需 migration（JSON 字段）。 2. **纯逻辑模块** `apps/worker/video_processing/micro_transform_pure.py`： - 种子 `sha256(task_id:video_index) % 10000`（不用内置 hash，规避 PYTHONHASHSEED 跨进程不可复现） - hflip 每片段 50%、播放速度 0.97~1.03x、亮度/对比度/饱和度各 ±2%、BGM 起始偏移 2~8s 3. **渲染注入**（unified_render_service 直通 + filter_complex 两路径）： - hflip 注入 scale 前（缩放后翻转会破坏画面定位），eq 注入 scale 后 - 微变换速度烘焙进 `ResolvedClip.playback_speed`，trim 多段展开时按 `config._micro_index` 对齐源片段序号；音频链 atempo 自动同步，无双倍叠加 - BGM 偏移复用 #1767 已有 `audio_offset`（-ss seek），用户显式配置优先 4. **门控**：启用微变换时 `_can_use_stream_copy` 强制重编码；worker 渲染后 `dedup_enabled=False` 跳过 `random_edge_crop`（读 plan.config 失败按开启兜底），实现确定性渲染。 5. **容错**：种子/plan 构建、filter 注入、offset 读取均 try/except 降级为不注入，不阻断渲染。 ### P1 保守项 - 字幕检测尚未实现，`clip_has_text=None` 时按「全部有字幕」处理 → **本 PR hflip 实际不翻转**，仅保留管线；后续拿到字幕检测后改一行即可放开。 ### 测试 - 新增 43 个：纯参数/边界/可复现/翻转率分布 23 + 渲染注入/stream copy 门控/开关 18 + writeback 2 - 适配 test_unified_render_service 既有确定性用例（FakePlan 默认 dedup_enabled=False） - **全量 tests/unit：15701 passed, 28 skipped（503s）**；black/isort/ruff 全过 ### 影响面 默认开启，渲染后视频产生片段级确定性差异以降重；关闭后渲染链路与改造前行为一致。无 DB migration。 PR3 将在此 PR 合入后提交：assembly_mode/script_id/tts_* 等新字段 + 叙事模式。

xiaoxia added 1 commit 2026-09-18 05:34:57 +08:00

feat(#1970): 智能降重 PR2 - dedup_enabled 开关 + 6 维片段级微变换 ... b659b750b6

- CreateGenerationTaskRequest 新增 dedup_enabled（默认 True），
  经 writeback 落入 plan.config（含 video_index 供种子区分变体）
- 新增 micro_transform_pure 纯模块：种子 sha256(task_id:video_index)%10000
  可复现；hflip(P1 保守默认不翻)/setpts 0.97~1.03/eq 亮度对比饱和 ±2%/BGM 偏移 2~8s
- unified_render_service：直通与 filter_complex 两路径注入片段级
  hflip+eq；速度烘焙进 ResolvedClip.playback_speed（trim 多段展开按
  config._micro_index 对齐），音频 atempo 自动同步；BGM 偏移复用
  现有 audio_offset(-ss seek)，用户显式配置优先
- stream copy 门控：启用微变换时强制重编码
- worker：dedup_enabled=False 时跳过 random_edge_crop（读取 plan.config，失败按开启兜底）
- 测试：新增 41 个（纯参数 23 + 渲染注入/门控 18），writeback 2 个；
  全量 tests/unit 15701 passed / 28 skipped

gitea-actions bot commented 2026-09-18 05:36:21 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot merged commit a59a6a588a into develop 2026-09-18 05:45:00 +08:00

auto-approve-bot deleted branch feat/1970-dedup-micro-transforms 2026-09-18 05:45:02 +08:00

gitea-actions bot commented 2026-09-18 05:45:38 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot frontend-dev xiaoxia

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1975