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

fix: AI数字人克隆音色试听传 profile UUID 而非 voice_id #1817

Open
xiaoxia wants to merge 2 commits from fix/ai-avatar-clone-preview-tts into develop
pull from: fix/ai-avatar-clone-preview-tts
merge into: xiaoxia:develop
Conversation 4 Commits 2 Files Changed 1
+54 -15
xiaoxia commented 2026-09-09 10:52:57 +08:00
Owner
Copy Link
Copy Source

问题

PR #1815 修复了克隆音色试听走 TTS 合成，但线上验证发现系统预设能听、用户克隆音色仍无声。

根因

后端 /tts/preview 用传入的 voice_id 字段去查 VoiceCloneProfile：

  • 命中 profile → 取 profile.voice_id（CosyVoice 模型 ID）合成
  • 未命中 → 当预设音色直链（但 clone 的 preview_url 为空，静默返回）

后端 _clone_profile_to_unified_response 返回：

  • id = profile.id（profile UUID）
  • voice_clone_profile_id = profile.id（profile UUID）
  • voice_id = profile.voice_id（CosyVoice 模型 ID，克隆未完成时为空）

前端 clone 分支此前传的是 voice.voice_id || voice.id：

  • voice.voice_id 为空 → 走 voice.id（恰好也是 profile UUID，但依赖隐式等价）
  • 某些场景 voice.voice_id 非空（模型 ID）→ 当 profile UUID 查不到 → 静默失败

修复

clone 分支 targetId 统一改用 voice.voice_clone_profile_id || voice.id，与后端期望完全对齐。系统预设音色保持直链播放不变。

## 问题 PR #1815 修复了克隆音色试听走 TTS 合成，但线上验证发现**系统预设能听、用户克隆音色仍无声**。 ## 根因 后端 `/tts/preview` 用传入的 `voice_id` 字段去查 `VoiceCloneProfile`： - 命中 profile → 取 `profile.voice_id`（CosyVoice 模型 ID）合成 - 未命中 → 当预设音色直链（但 clone 的 preview_url 为空，静默返回） 后端 `_clone_profile_to_unified_response` 返回： - `id = profile.id`（profile UUID） - `voice_clone_profile_id = profile.id`（profile UUID） - `voice_id = profile.voice_id`（CosyVoice 模型 ID，克隆未完成时为空） 前端 clone 分支此前传的是 `voice.voice_id || voice.id`： - `voice.voice_id` 为空 → 走 `voice.id`（恰好也是 profile UUID，但依赖隐式等价） - 某些场景 `voice.voice_id` 非空（模型 ID）→ 当 profile UUID 查不到 → 静默失败 ## 修复 clone 分支 targetId 统一改用 `voice.voice_clone_profile_id || voice.id`，与后端期望完全对齐。系统预设音色保持直链播放不变。
xiaoxia added 1 commit 2026-09-09 10:52:58 +08:00
fix: AI数字人「我的音色」克隆音色试听改用 TTS 合成
ACR Cleanup / ACR Image Cleanup (pull_request_target) Successful in 5s
Details
Preview Cleanup / Cleanup Preview Environment (pull_request) Successful in 25s
Details
CI/CD Pipeline / Check push changed paths (pull_request) Has been skipped
Details
CI/CD Pipeline / Dedup Check - skip PR tests when covered by push pipeline (pull_request) Successful in 2s
Details
CI/CD Pipeline / Check if frontend-only change (pull_request) Successful in 2s
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 / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Unit Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / PR Build API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / PR Build Worker Image (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 Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Retag skipped Staging Web Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Deploy Staging (Watchtower auto-deploy) (pull_request) Has been skipped
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 / PR Build Web Image (pull_request) Successful in 1m27s
Details
CI/CD Pipeline / Frontend Unit Tests (pull_request) Successful in 1m29s
Details
Preview Deploy / Deploy Preview Environment (pull_request) Successful in 1m33s
Details
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 1m45s
Details
PR Automation / Auto Approve on CI Green (pull_request) Successful in 1m55s
Details
CI/CD Pipeline / Validate - Python (mypy + alembic) (pull_request) Successful in 1m58s
Details
CI/CD Pipeline / Validate - Style (pull_request) Successful in 2m13s
Details
CI/CD Pipeline / Validate - Security (pull_request) Has been cancelled
Details
CI/CD Pipeline / Build Production API Image (pull_request) Has been cancelled
Details
CI/CD Pipeline / Build Production Web Image (pull_request) Has been cancelled
Details
CI/CD Pipeline / Build Production Worker Image (pull_request) Has been cancelled
Details
CI/CD Pipeline / Deploy Production (pull_request) Has been cancelled
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been cancelled
Details
CI/CD Pipeline / Canary Release to Production (pull_request) Has been cancelled
Details
CI/CD Pipeline / CI Gate (pull_request) Has been cancelled
Details
AI Code Review / AI Code Review (pull_request) Has been cancelled
Details
PR Automation / Auto Merge on CI Green + Approved (pull_request) Has been cancelled
Details
b716d3c34f 
配音库克隆音色能听到，数字人页面听不到，根因：
配音库 useAudioPlayer 的 playVoice() 是调 POST /tts/preview
现合成示例文案拿到 audio_url 再播放（clone 的 preview_url/
audio_url 都为空）；数字人面板还停留在直接用 preview_url
直链播放，所以 clone 音色静默返回。

修复：
- 克隆音色走 previewTts（与配音库一致）+ 按 voiceId 内存缓存，
  同一音色二次试听不重复合成
- 系统预设音色保持原 preview_url/audio_url 直链播放，不改
- 抽取公共 playAudioUrl，保留原 onended/onerror/play().catch
  错误提示（含「该音色暂无试听音频」兜底）

不动：播放按钮 disabled/title 逻辑、音色列表布局、其他面板。
gitea-actions bot commented 2026-09-09 10:54:30 +08:00
Copy Link
Copy Source

🚀 预览环境已部署

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

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

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

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

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1817 | | 预览链接 | [https://pr-1817.preview.xiaoxiajianji.com](https://pr-1817.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。
auto-approve-bot approved these changes 2026-09-09 10:54:53 +08:00
auto-approve-bot left a comment
Collaborator
Copy Link
Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。
auto-approve-bot approved these changes 2026-09-09 10:54:53 +08:00
auto-approve-bot left a comment
Collaborator
Copy Link
Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。
xiaoxia added 1 commit 2026-09-09 10:55:30 +08:00
fix: AI数字人克隆音色试听传 profile UUID 而非 voice_id
CI/CD Pipeline / Check push changed paths (pull_request) Has been skipped
Details
CI/CD Pipeline / Dedup Check - skip PR tests when covered by push pipeline (pull_request) Successful in 2s
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 / Check if frontend-only change (pull_request) Successful in 2s
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Unit Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / PR Build API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / PR Build Worker Image (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 / Staging E2E Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / ACR Image Cleanup (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Frontend Unit Tests (pull_request) Successful in 1m27s
Details
CI/CD Pipeline / PR Build Web Image (pull_request) Successful in 1m29s
Details
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 1m58s
Details
Preview Deploy / Deploy Preview Environment (pull_request) Successful in 2m8s
Details
CI/CD Pipeline / Validate - Python (mypy + alembic) (pull_request) Successful in 2m8s
Details
PR Automation / Auto Approve on CI Green (pull_request) Successful in 2m14s
Details
CI/CD Pipeline / Validate - Style (pull_request) Successful in 2m25s
Details
AI Code Review / AI Code Review (pull_request) Successful in 6m23s
Details
CI/CD Pipeline / Validate - Security (pull_request) Successful in 7m12s
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 / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Canary Release to Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / CI Gate (pull_request) Successful in 3s
Details
PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 8m5s
Details
f04ddde4d5 
根因：后端 /tts/preview 用传入的 voice_id 去查 VoiceCloneProfile，
期望前端传 profile UUID（voice_clone_profile_id 或 clone.id）。
此前 clone 分支传了 voice_id（CosyVoice 模型 ID），
后端查不到 profile 静默返回，用户点播放无反应。

修复：clone 分支 targetId 改用 voice.voice_clone_profile_id || voice.id。
auto-approve-bot commented 2026-09-09 11:05:51 +08:00
Collaborator
Copy Link
Copy Source

Auto merge skipped after multiple 405 errors: PR may have conflicts or unresolved checks. Please review manually. This is not a CI failure.

Auto merge skipped after multiple 405 errors: PR may have conflicts or unresolved checks. Please review manually. This is not a CI failure.
Some checks are pending
CI/CD Pipeline / Check push changed paths (pull_request) Has been skipped
Details
CI/CD Pipeline / Dedup Check - skip PR tests when covered by push pipeline (pull_request) Successful in 2s
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 / Check if frontend-only change (pull_request) Successful in 2s
Details
CI/CD Pipeline / Build Staging Worker Image (pull_request) Has been skipped
Details
CI/CD Pipeline / Unit Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / PR Build API Image (pull_request) Has been skipped
Details
CI/CD Pipeline / PR Build Worker Image (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 / Staging E2E Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / ACR Image Cleanup (pull_request) Has been skipped
Details
CI/CD Pipeline / Staging API Integration Tests (pull_request) Has been skipped
Details
CI/CD Pipeline / Frontend Unit Tests (pull_request) Successful in 1m27s
Details
CI/CD Pipeline / PR Build Web Image (pull_request) Successful in 1m29s
Details
CI/CD Pipeline / Frontend Lint (pull_request) Successful in 1m58s
Details
Preview Deploy / Deploy Preview Environment (pull_request) Successful in 2m8s
Details
CI/CD Pipeline / Validate - Python (mypy + alembic) (pull_request) Successful in 2m8s
Details
PR Automation / Auto Approve on CI Green (pull_request) Successful in 2m14s
Details
CI/CD Pipeline / Validate - Style (pull_request) Successful in 2m25s
Details
AI Code Review / AI Code Review (pull_request) Successful in 6m23s
Details
CI/CD Pipeline / Validate - Security (pull_request) Successful in 7m12s
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 / Deploy Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Canary Release to Production (pull_request) Has been skipped
Details
CI/CD Pipeline / Production Browser E2E (pull_request) Has been skipped
Details
CI/CD Pipeline / CI Gate (pull_request) Successful in 3s
Details
PR Automation / Auto Merge on CI Green + Approved (pull_request) Successful in 8m5s
Details
This pull request has changes conflicting with the target branch.
  • apps/web/src/pages/ai-avatar/components/PanelVoiceSelector.tsx
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin fix/ai-avatar-clone-preview-tts:fix/ai-avatar-clone-preview-tts
git checkout fix/ai-avatar-clone-preview-tts
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 frontend-dev xiaoxia
No Assignees
3 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1817
Delete Branch "fix/ai-avatar-clone-preview-tts"

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?