feat(P1): 一键生成配音支持从配音素材库选用户上传的音频 #567

Merged

auto-approve-bot merged 2 commits from fix/p1-oneclick-voice-asset-selection into develop 2026-07-19 10:29:58 +08:00

Conversation 5 Commits 2 Files Changed 1

+36 -1

xiaoxia commented 2026-07-19 09:59:31 +08:00

Owner

Copy Link

Copy Source

背景

智能剪辑（一键生成）配音选择目前只有预设音色/TTS/克隆三种，缺少最常用的「选我上传的配音文件」。

方案

复用 voice_library_id 字段传配音素材库的 asset_id，worker端下载配音时：

1. 先查 asset 表取 storage_key 下载（用户上传到配音库的音频）
2. 查不到再 fallback 旧版 voice/{id}.mp3 路径（向后兼容）

前端配合

前端加「我的配音」Tab，调用素材接口（assets?kind=voice）列出配音库音频，用户选中后把asset_id填到voice_library_id即可。

## 背景 智能剪辑（一键生成）配音选择目前只有预设音色/TTS/克隆三种，缺少最常用的「选我上传的配音文件」。 ## 方案 复用 voice_library_id 字段传配音素材库的 asset_id，worker端下载配音时： 1. 先查 asset 表取 storage_key 下载（用户上传到配音库的音频） 2. 查不到再 fallback 旧版 voice/{id}.mp3 路径（向后兼容） ## 前端配合 前端加「我的配音」Tab，调用素材接口（assets?kind=voice）列出配音库音频，用户选中后把asset_id填到voice_library_id即可。

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

feat(P1): 一键生成配音支持从配音素材库选用户上传的音频 ... 88349f600d

voice_library_id字段支持传入配音素材库的asset_id：
- 先查asset表取storage_key下载（用户上传的配音）
- 查不到再fallback旧版voice/{id}.mp3路径（向后兼容）

xiaoxia added 1 commit 2026-07-19 10:24:40 +08:00

fix: isort import排序修复 b487a2b306

gitea-actions bot commented 2026-07-19 10:25:47 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot approved these changes 2026-07-19 10:27:25 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-07-19 10:27:25 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot commented 2026-07-19 10:27:27 +08:00

Collaborator

Copy Link

Copy Source

代码审查结果 - PR #567

⚠️ 问题（1个需要修改）

1. apps/worker/worker_app/tasks/generation.py 第498行：数据库连接资源未及时释放，存在连接池耗尽风险。
   • 问题描述：在数据库会话 (session) 的生命周期内（try 块中）直接调用了 download_asset。如果该下载操作涉及网络 I/O 且耗时较长，会导致数据库连接被长时间占用而不释放。在 Worker 高并发运行场景下，极易耗尽数据库连接池，导致新任务阻塞或服务崩溃。
   • 修改建议：应调整逻辑，先在 try 块中获取 asset.storage_key，确保在 finally 块中关闭 session 之后，再执行耗时的 download_asset 操作。

💡 建议（2个可选）

1. apps/worker/worker_app/tasks/generation.py 第482-486行：避免在函数内部进行模块导入。
   • 具体内容：代码在函数内部导入了 SessionLocal 和 SQLAlchemyAssetRepository。虽然这能规避循环导入问题，但会增加函数调用的微小开销，并掩盖代码结构设计问题。建议优先尝试将导入移至文件顶部；若必须在此处导入，建议添加注释说明原因（如 "Avoid circular import"）。
2. apps/worker/worker_app/tasks/generation.py 第487-506行：使用上下文管理器简化资源管理。
   • 具体内容：当前使用 try...finally...close 手动管理会话，代码稍显冗余。如果 SessionLocal 返回的对象支持上下文协议（SQLAlchemy 通常支持），推荐使用 with SessionLocal() as session: 语法，更加简洁且安全。

---

✅ 格式检查通过 | ❌ 逻辑审查需修改 | ⚠️ 建议关注性能

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-07-19 10:27:27 | 模型:}

## 代码审查结果 - PR #567 ### ⚠️ 问题（1个需要修改） 1. **apps/worker/worker_app/tasks/generation.py 第498行**：数据库连接资源未及时释放，存在连接池耗尽风险。 - **问题描述**：在数据库会话 (`session`) 的生命周期内（`try` 块中）直接调用了 `download_asset`。如果该下载操作涉及网络 I/O 且耗时较长，会导致数据库连接被长时间占用而不释放。在 Worker 高并发运行场景下，极易耗尽数据库连接池，导致新任务阻塞或服务崩溃。 - **修改建议**：应调整逻辑，先在 `try` 块中获取 `asset.storage_key`，确保在 `finally` 块中关闭 `session` 之后，再执行耗时的 `download_asset` 操作。 ### 💡 建议（2个可选） 1. **apps/worker/worker_app/tasks/generation.py 第482-486行**：避免在函数内部进行模块导入。 - **具体内容**：代码在函数内部导入了 `SessionLocal` 和 `SQLAlchemyAssetRepository`。虽然这能规避循环导入问题，但会增加函数调用的微小开销，并掩盖代码结构设计问题。建议优先尝试将导入移至文件顶部；若必须在此处导入，建议添加注释说明原因（如 "Avoid circular import"）。 2. **apps/worker/worker_app/tasks/generation.py 第487-506行**：使用上下文管理器简化资源管理。 - **具体内容**：当前使用 `try...finally...close` 手动管理会话，代码稍显冗余。如果 `SessionLocal` 返回的对象支持上下文协议（SQLAlchemy 通常支持），推荐使用 `with SessionLocal() as session:` 语法，更加简洁且安全。 --- ✅ 格式检查通过 | ❌ 逻辑审查需修改 | ⚠️ 建议关注性能 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-07-19 10:27:27 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

auto-approve-bot merged commit 222ccdc7b3 into develop 2026-07-19 10:29:58 +08:00

auto-approve-bot deleted branch fix/p1-oneclick-voice-asset-selection 2026-07-19 10:29:59 +08:00

gitea-actions bot commented 2026-07-19 10:30:19 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

🗑️ **预览环境已清理** PR #567 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 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#567