feat(tts): 正式合成支持克隆音色 + 保存到配音库改写 assets 素材体系 + 克隆接口支持 asset_id #1556

Merged

auto-approve-bot merged 10 commits from fix/tts-clone-voice-and-save-to-assets into develop 2026-08-30 18:46:07 +08:00

Conversation 5 Commits 10 Files Changed 10

+1353 -79

10 Commits

Author	SHA1	Message	Date
xiaoxia	b3acc755ae	style: B904 — except 中 raise HTTPException 补 from None	2026-08-30 18:22:24 +08:00
xiaoxia	0454d2a97e	fix(tts): AI Review 第三轮——约束类型一致 + OSS 孤儿文件清理 + import 规范 ... 1. migration 058 改用 op.create_unique_constraint（与 model 的 UniqueConstraint 定义一致，pg_constraint+pg_index 同时注册），避免 autogenerate schema drift。 2. save-to-library：asset_repository.create 失败时删除已上传的 OSS 文件， 避免孤儿文件；补对应用例。 3. tempfile/Path import 移到模块顶部（PEP8）。	2026-08-30 17:59:27 +08:00
xiaoxia	e70939031d	fix(tts): AI Review 第二轮——migration 去重清洗 + session 回滚容错 ... 1. migration 058：create unique index 前先按 (project_id, kind) 分区 ROW_NUMBER 去重（保留 created_at 最新），防止存量重复导致建索引失败阻塞部署。 2. _find_or_create_voice_library 竞态处理：IntegrityError 后显式 rollback （立即 commit 模式下为幂等 no-op，UoW/flush 模式下必须回滚才能继续查询）， rollback 本身抛异常（session 已关闭）时容错继续重查。补对应用例。 3. voice_clones：移除 file_type 的 hasattr 防御判断（Asset 领域对象确定有该字段）。	2026-08-30 17:48:27 +08:00
xiaoxia	17748d356b	fix(tts): AI Review 阻塞项——去除竞态处理中对 repository 内部 session 的依赖 ... IntegrityError 后不再手动 getattr(repo, 'session').rollback()： SQLAlchemy commit 失败时 session 已自动回滚，直接重查已存在的库即可， 避免依赖 repository 内部实现（scoped_session/async session 下可能失效）。 同时 mypy：_find_or_create_voice_library 的 asset_library_repository 参数 改 Any 类型（port Protocol 声明 async、SQLAlchemy 实现为同步，与 upload/asset_libraries 路由既有惯例一致）。	2026-08-30 17:37:11 +08:00
CI Bot	352f2d85e1	style: auto-format with black + isort + prettier [skip ci-format-check]	2026-08-30 09:19:08 +00:00
xiaoxia	16536c6c9a	style: 修复测试 E741 模糊变量名 l → lib、移除未使用 import	2026-08-30 17:13:11 +08:00
xiaoxia	204715b155	test(tts): 补路由级单元测试满足 CI 增量覆盖率门槛 ... CI Unit Tests job 仅跑 tests/unit，原新增用例都在 tests/integration 不被统计， diff 覆盖率 15% 未达 40% 门槛。新增 3 个单元测试文件共 22 用例： - test_tts_save_to_library_assets.py：save-to-library 写 assets 链路 （成功断言 audio/ready asset、自动建库、IntegrityError 竞态兜底、 未完成 400、无音频 400、下载失败 502、无项目 400、他人 job 404） - test_tts_synthesize_clone_voice.py：synthesize 克隆音色解析 （profile UUID/显式 profile id/预置+profile 同传以克隆为准/403/400/404/预置透传） - test_voice_clone_from_asset.py：克隆接口 asset_id 分支 （成功签名 URL、两参同传 400、404、403、非音频 400、无 key 400、旧 URL 流程兼容） 本地 diff 覆盖率 92%。	2026-08-30 17:04:35 +08:00
xiaoxia	30ffd3bb89	fix(migration): 缩短 revision id 至 29 字符（alembic_version.version_num 为 varchar(32)）	2026-08-30 16:37:37 +08:00
xiaoxia	afa7fae921	fix(tts): 修复 AI Review 阻塞问题——克隆音色解析强制生效 + 素材库并发创建防护 ... 1. synthesize() 克隆音色解析修复：原逻辑仅在 voice_id == profile UUID 时才把 actual_voice_id 替换为克隆 CosyVoice id，导致 voice_id 传预置音色+显式传 voice_clone_profile_id 时仍用预置音色合成、与记录的 profile 不一致。 改为命中 profile 并校验通过后一律 actual_voice_id = resolved_profile.voice_id。 补回归用例（老测试只断言 201，未覆盖解析结果）。 2. 自动创建 voice 素材库并发竞态：新增 migration 058 给 asset_libraries 加 (project_id, kind) 唯一索引（model 同步 UniqueConstraint，staging 2137 条数据无重复可安全建索引）；创建处捕获 IntegrityError 回滚后重查， 返回抢先创建成功的库。 3. 明确 download_asset 自动识别 URL/OSS key 的注释（Review 第 1 条为误报， SharedStorageService.download_asset 对 http(s):// 前缀走 HTTP 下载）。	2026-08-30 16:32:32 +08:00
xiaoxia	539c71f5cb	feat(tts): 正式合成支持克隆音色、保存到配音库改写 assets 素材体系、克隆接口支持 asset_id ... 1. TTS synthesize() 复用 preview 的克隆音色解析逻辑：voice_id 传克隆 profile UUID 时 校验归属(403)/克隆完成状态(400 音色克隆尚未完成)，job.voice_id 存解析后的 CosyVoice voice_id，voice_clone_profile_id 记录 profile id。 2. save_tts_job_to_library 改写为新素材体系：TTS 音频持久化独立副本到 uploads/voice/tts/，创建 file_type=audio/status=ready 的 asset 挂用户 voice 素材库（无则自动创建），duration/metadata(source=tts_job) 完整记录； 返回结构保持 id/name/audio_url/duration 兼容前端；移除旧 voice_library 表写入。 3. voice clone 创建接口支持 asset_id 字段：校验素材归属与音频类型，用 asset storage_key 生成 7 天有效签名 URL 供 worker 下载，不依赖前端签名； source_audio_url 方式保留兼容。 补集成测试：synthesize 克隆音色 4 用例、save-to-library asset 断言、 clone from asset 5 用例（成功/404/403/非音频400/两参同传400）。	2026-08-30 16:12:57 +08:00