fix: Worker 配音下载 fallback 到 voice_ids 修复预览无声 #1320

Merged

xiaoxia merged 2 commits from fix/preview-voice-ids-fallback into develop 2026-08-09 14:07:13 +08:00

Conversation 5 Commits 2 Files Changed 2

+172 -3

xiaoxia commented 2026-08-09 13:57:28 +08:00

Owner

Copy Link

Copy Source

问题

前端选择上传音频时，asset_id 放在 voice_ids 数组里，voice_library_id 为空。Worker 的 _download_all_assets() 之前只检查 voice_library_id，导致音频永远不会被下载，预览视频无声。

修复

改 apps/worker/worker_app/tasks/generation.py 中 _download_all_assets() 函数：

• 新增 voice_ids 参数
• 当 voice_library_id 为空但 voice_ids 非空时，使用 voice_ids[0] 作为音频 asset_id 下载
• 优先级：voice_library_id > voice_ids[0]
• 向后兼容：voice_ids 默认 None，不影响现有调用方

测试

新增 6 个单元测试（tests/unit/test_preview_voice_ids_fallback.py）：

• voice_library_id 优先使用
• fallback 到 voice_ids[0]
• 两者都为空时不下载
• voice_ids 为 None 时不下载
• 多元素取第一个
• 向后兼容（不传 voice_ids）

全部 104 个相关测试通过（generation_preview + preview_voice_library_id + preview_voice_ids_fallback + preview_voice_injection + confirm_generation）。

## 问题 前端选择上传音频时，asset_id 放在 `voice_ids` 数组里，`voice_library_id` 为空。Worker 的 `_download_all_assets()` 之前只检查 `voice_library_id`，导致音频永远不会被下载，预览视频无声。 ## 修复 改 `apps/worker/worker_app/tasks/generation.py` 中 `_download_all_assets()` 函数： - 新增 `voice_ids` 参数 - 当 `voice_library_id` 为空但 `voice_ids` 非空时，使用 `voice_ids[0]` 作为音频 asset_id 下载 - 优先级：`voice_library_id` > `voice_ids[0]` - 向后兼容：`voice_ids` 默认 `None`，不影响现有调用方 ## 测试 新增 6 个单元测试（`tests/unit/test_preview_voice_ids_fallback.py`）： - voice_library_id 优先使用 - fallback 到 voice_ids[0] - 两者都为空时不下载 - voice_ids 为 None 时不下载 - 多元素取第一个 - 向后兼容（不传 voice_ids） 全部 104 个相关测试通过（generation_preview + preview_voice_library_id + preview_voice_ids_fallback + preview_voice_injection + confirm_generation）。

xiaoxia added 1 commit 2026-08-09 13:57:28 +08:00

fix: Worker 配音下载 fallback 到 voice_ids 修复预览无声 ... 4d27f1ed2c

当前端选择上传音频时，asset_id 放在 voice_ids 数组里，
voice_library_id 为空。Worker 的 _download_all_assets() 之前
只检查 voice_library_id，导致音频永远不会被下载。

修复：当 voice_library_id 为空但 voice_ids 非空时，
使用 voice_ids[0] 作为音频 asset_id 进行下载。
优先级：voice_library_id > voice_ids[0]。

新增 6 个单元测试覆盖 fallback 逻辑。

gitea-actions bot commented 2026-08-09 13:58:52 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot added 1 commit 2026-08-09 13:59:53 +08:00

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

auto-approve-bot commented 2026-08-09 14:01:39 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

• 是否存在阻塞级问题：否
• 阻塞级问题数量：0 个

📊 审查概览

• 整体评价：通过
• 建议级问题数量：0 个

🔴 阻塞级问题（必须修复）

无

💡 改进建议（不阻塞合并）

无

✅ 良好实践

1. 测试覆盖全面：新增的单元测试覆盖了优先级逻辑、Fallback 逻辑、空值/None 边界条件以及向后兼容性场景，确保了代码变更的健壮性。
2. 逻辑清晰：使用 effective_voice_id 变量明确表达了意图，代码可读性高。
3. 日志完善：增加了区分来源的日志记录，便于后续排查问题。

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-09 06:01:39 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：0 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 无 ### ✅ 良好实践 1. **测试覆盖全面**：新增的单元测试覆盖了优先级逻辑、Fallback 逻辑、空值/None 边界条件以及向后兼容性场景，确保了代码变更的健壮性。 2. **逻辑清晰**：使用 `effective_voice_id` 变量明确表达了意图，代码可读性高。 3. **日志完善**：增加了区分来源的日志记录，便于后续排查问题。 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-09 06:01:39 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

auto-approve-bot approved these changes 2026-08-09 14:05:31 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-08-09 14:05:31 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

xiaoxia merged commit a75fa1cd93 into develop 2026-08-09 14:07:13 +08:00

gitea-actions bot commented 2026-08-09 14:08:11 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

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#1320