xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 15 Pull Requests Actions 1 Packages Projects Releases 7 Wiki Activity

feat: #1767 BGM 池差异化分配，打破变体间音频指纹一致性 #1785

Merged
auto-approve-bot merged 1 commits from fix/1767-bgm-pool-diversify into develop 2026-09-08 10:12:53 +08:00
Conversation 2 Commits 1 Files Changed 4
+650 -5
xiaoxia commented 2026-09-08 10:01:28 +08:00
Owner
Copy Link
Copy Source

背景

当前批量生成时多个变体共用同一首 BGM，YouTube Content ID 音频准确率高，音频一致是查重高危信号。

方案：三层递进

策略一：BGM 池分配（核心）

  • 新增 packages/domain/bgm_pool.py：10 首 BGM 池，覆盖 upbeat/relax/tech/commerce 四种风格
  • 根据源 plan 的 BGM preset_id 推断风格，筛选同风格候选池
  • 每个变体基于 variantSeed 随机分配不同 BGM（可复现）
  • 尽量保证同一批次不重复

策略二：BGM 段落差异化（补充）

  • bgm_mixer.py 支持 audio_offset：FFmpeg -ss seek 到不同位置
  • 不同变体从同一 BGM 的不同段落开始（5s 量化，最大 30s 偏移）

策略三：BGM 音量微调

  • bgm_mixer.py 支持 volume_adjust_db：dB 转线性系数追加到滤镜链
  • ±3dB 离散步进（-3, -2, -1, 0, 1, 2, 3），不影响配音清晰度

代码改动

文件 改动
packages/domain/bgm_pool.py 🆕 BGM 池定义 + 风格匹配 + 变体分配 + 段落偏移 + 音量微调
apps/worker/video_processing/bgm_mixer.py BGMConfig 加 audio_offset/volume_adjust_db，prepare_bgm_track 支持 -ss seek 和 dB 滤镜
apps/api/app/services/edit_plan_service.py ensure_batch_variant_plans 调用 allocate_bgm_pool_for_variants，写入 plan.config["bgm"]
tests/unit/test_bgm_pool.py 🆕 31 个新单测

约束遵守

  • ✅ 不破坏现有单视频 BGM 选择逻辑（单视频不走池分配）
  • ✅ BGM 风格匹配视频内容（通过源 plan preset_id → style → mood 筛选）
  • ✅ BGM 切换不影响配音清晰度（±3dB 安全范围）
  • ✅ 分配可复现（同 seed 同结果）

测试

tests/unit/test_bgm_pool.py: 31 passed
tests/unit/test_bgm_mixer_pure.py + test_bgm_mixer.py: 全绿
全量相关测试 279 passed
## 背景 当前批量生成时多个变体共用同一首 BGM，YouTube Content ID 音频准确率高，音频一致是查重高危信号。 ## 方案：三层递进 ### 策略一：BGM 池分配（核心） - 新增 `packages/domain/bgm_pool.py`：10 首 BGM 池，覆盖 upbeat/relax/tech/commerce 四种风格 - 根据源 plan 的 BGM preset_id 推断风格，筛选同风格候选池 - 每个变体基于 `variantSeed` 随机分配不同 BGM（可复现） - 尽量保证同一批次不重复 ### 策略二：BGM 段落差异化（补充） - `bgm_mixer.py` 支持 `audio_offset`：FFmpeg `-ss` seek 到不同位置 - 不同变体从同一 BGM 的不同段落开始（5s 量化，最大 30s 偏移） ### 策略三：BGM 音量微调 - `bgm_mixer.py` 支持 `volume_adjust_db`：dB 转线性系数追加到滤镜链 - ±3dB 离散步进（-3, -2, -1, 0, 1, 2, 3），不影响配音清晰度 ## 代码改动 | 文件 | 改动 | |------|------| | `packages/domain/bgm_pool.py` | 🆕 BGM 池定义 + 风格匹配 + 变体分配 + 段落偏移 + 音量微调 | | `apps/worker/video_processing/bgm_mixer.py` | `BGMConfig` 加 `audio_offset`/`volume_adjust_db`，`prepare_bgm_track` 支持 `-ss` seek 和 dB 滤镜 | | `apps/api/app/services/edit_plan_service.py` | `ensure_batch_variant_plans` 调用 `allocate_bgm_pool_for_variants`，写入 `plan.config["bgm"]` | | `tests/unit/test_bgm_pool.py` | 🆕 31 个新单测 | ## 约束遵守 - ✅ 不破坏现有单视频 BGM 选择逻辑（单视频不走池分配） - ✅ BGM 风格匹配视频内容（通过源 plan preset_id → style → mood 筛选） - ✅ BGM 切换不影响配音清晰度（±3dB 安全范围） - ✅ 分配可复现（同 seed 同结果） ## 测试 ``` tests/unit/test_bgm_pool.py: 31 passed tests/unit/test_bgm_mixer_pure.py + test_bgm_mixer.py: 全绿 全量相关测试 279 passed ```
gitea-actions bot commented 2026-09-08 10:03:02 +08:00
Copy Link
Copy Source

🚀 预览环境已部署

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

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

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

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

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1785 | | 预览链接 | [https://pr-1785.preview.xiaoxiajianji.com](https://pr-1785.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。
xiaoxia added 1 commit 2026-09-08 10:06:45 +08:00
feat: #1767 BGM 池差异化分配，打破变体间音频指纹一致性
CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 2s
Details
CI/CD Pipeline / Check push changed paths (pull_request) Has been skipped
Details
CI/CD Pipeline / PR Build Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Dedup Check - skip PR tests when covered by push pipeline (pull_request) Successful in 16s
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / PR Build API Image (pull_request) Successful in 35s
Details
CI/CD Pipeline / Frontend Lint (pull_request) Has been skipped
Details
CI/CD Pipeline / PR Build Worker Image (pull_request) Successful in 34s
Details
CI/CD Pipeline / Frontend Unit Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Retag skipped Staging API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Retag skipped Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Retag skipped Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
Details
CI/CD Pipeline / Validate - Python (mypy + alembic) (pull_request) Successful in 1m51s
Details
CI/CD Pipeline / Integration Tests (pull_request) Successful in 1m44s
Details
CI/CD Pipeline / Unit Tests (pull_request) Successful in 1m33s
Details
Preview Deploy / Deploy Preview Environment (pull_request) Successful in 2m17s
Details
CI/CD Pipeline / Staging E2E Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / ACR Image Cleanup (pull_request) Has been skipped
Details
CI/CD Pipeline / Validate - Style (pull_request) Successful in 2m20s
Details
PR Automation / Auto Approve on CI Green (pull_request) Successful in 3m33s
Details
CI/CD Pipeline / Validate - Security (pull_request) Successful in 4m56s
Details
CI/CD Pipeline / Build Production API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Canary Release to Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / CI Gate (pull_request) Successful in 1s
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 2m26s
Details
AI Code Review / AI Code Review (pull_request) Successful in 6m35s
Details
ACR Cleanup / ACR Image Cleanup (pull_request_target) Successful in 33s
Details
Preview Cleanup / Cleanup Preview Environment (pull_request) Successful in 47s
Details
91c67f0af4 
三层递进策略：
- 策略一（核心）：10 首 BGM 池，按源 BGM 风格筛选候选，每变体基于 variantSeed 分配不同 BGM
- 策略二（补充）：段落差异化，不同变体从同一 BGM 的不同偏移位置开始播放（5s 量化，最大 30s）
- 策略三：音量微调 ±3dB 离散步进，混音比例有微小差异

代码改动：
- 新增 packages/domain/bgm_pool.py：BGM 池定义 + 风格匹配 + 变体分配 + 段落偏移 + 音量微调
- bgm_mixer.py：BGMConfig 加 audio_offset/volume_adjust_db，prepare_bgm_track 支持 -ss seek 和 dB volume 滤镜
- edit_plan_service.py：ensure_batch_variant_plans 中调用 allocate_bgm_pool_for_variants，写入 plan.config['bgm']

31 个新单测覆盖池定义/风格匹配/分配/段落偏移/音量微调/验收条件

约束：不破坏单视频 BGM 选择逻辑；BGM 风格匹配源 plan；分配可复现
xiaoxia force-pushed fix/1767-bgm-pool-diversify from a5ec3079f1 to 91c67f0af4 2026-09-08 10:06:45 +08:00 Compare
auto-approve-bot merged commit 98cf571ab3 into develop 2026-09-08 10:12:53 +08:00
auto-approve-bot deleted branch fix/1767-bgm-pool-diversify 2026-09-08 10:12:53 +08:00
gitea-actions bot commented 2026-09-08 10:13:35 +08:00
Copy Link
Copy Source

🗑️ 预览环境已清理

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

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

🗑️ **预览环境已清理** PR #1785 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 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
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1785
Delete Branch "fix/1767-bgm-pool-diversify"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?