fix(viral-video): 预设音色ID与后端对齐（longxiaochun_v3等v3后缀）+ 取消模糊匹配兜底 #2130

Merged

xiaoxia merged 1 commits from fix/2041-preset-voice-ids into develop 2026-10-01 22:42:17 +08:00

Conversation 3 Commits 1 Files Changed 1

+34 -55

xiaoxia commented 2026-10-01 22:42:12 +08:00

Owner

Copy Link

Copy Source

排查结论

1. 前端硬编码旧ID位置

只在 PresetVoicePickerModal.tsx 的 MOCK_VOICES 兜底列表里发现旧ID硬编码：

• long-xiaochun（错误带短横线、无v3后缀）
• long-xiaoxia / long-xiaoyan / long-xiaotong / long-sanshu / long-xiaogang / long-xiaocheng / long-xiaozhi / long-yue / long-xiaodong / long-xiaoling / long-xiaoxiao-neural（12个，多数是虚构ID，与后端真实音色列表不对应）
• zh-CN-XiaoxiaoNeural 之前的 Azure TTS 兜底 ID 已在上一轮修复中清理。

ViralVideoPage.tsx 本身没有硬编码任何 preset voice_id；所有 preset 音色通过 onConfirm 回调以 Modal 返回对象的 id 为准透传。

2. 默认音色兜底

• 前端无默认音色：emptyTask.refAudio = null，用户不主动选音色的话 voice_id 不会传给后端，由后端走默认（后端默认 longxiaochun_v3，见 packages/application/cosyvoice_service.py 注释与健康检查）。
• 选了内置音色后，Modal 返回的 v.id 直接写进 refAudio.id，confirm-copy/generate-video payload 取 task.refAudio.id 作为 voice_id。

3. ID 覆盖风险

原代码 { ...v, ... } 已经是把 API 的 v 放在展开后，但模糊匹配会给 category/desc 补充信息，不覆盖 id，所以不覆盖后端 voice_id。不过匹配逻辑用 name 模糊命中（slice(1)/slice(0,2)）很脆弱，可能误匹配。

4. MOCK_VOICES 与后端对齐

对照后端 packages/domain/preset_voices.py 的 PRESET_VOICES 列表（CosyVoice v3-flash 真实可用音色），重写 MOCK_VOICES：

• 8 个音色（与后端完全一致）：longxiaochun_v3(龙小淳)/longxiaoxia_v3(龙小夏)/longsanshu_v3(龙三叔)/longyue_v3(龙悦)/longshu_v3(龙书)/longyingjing_v3(龙应静)/longshuo_v3(龙硕)/longtian_v3(龙甜)
• 删除虚构的 long-xiaoyan/long-xiaotong/long-xiaogang/long-xiaocheng/long-xiaozhi/long-xiaodong/long-xiaoling/晓晓 等 ID（后端没这些音色，提交会导致 TTS 失败）
• 描述文案与后端 PRESET_VOICES.description 对齐

5. 匹配逻辑修复

realList 映射改为按 id 精确匹配（m.id === v.id），不用 name 模糊匹配。当 API 返回真实音色列表时，id/name/gender/category/desc 全部来自 API，不被 mock 覆盖；只有当字段缺失时才用 mock 的同 ID 条目补充。

后端 ID 规范确认

后端 packages/domain/preset_voices.py 明确：

• voice_id 格式：long{pinyin}_v3，例如 longxiaochun_v3
• tags：["知性","女声","助手"] 这类中文标签
• 默认 voice_id = longxiaochun_v3（health check 与注释均确认）

验证

• tsc ✅ / vite build ✅ / prettier ✅
• 全局 grep 前端代码无 long-xiaochun/longxiaochun(旧)/zh-CN-XiaoxiaoNeural 残留

## 排查结论 ### 1. 前端硬编码旧ID位置 只在 `PresetVoicePickerModal.tsx` 的 MOCK_VOICES 兜底列表里发现旧ID硬编码： - `long-xiaochun`（错误带短横线、无v3后缀） - `long-xiaoxia` / `long-xiaoyan` / `long-xiaotong` / `long-sanshu` / `long-xiaogang` / `long-xiaocheng` / `long-xiaozhi` / `long-yue` / `long-xiaodong` / `long-xiaoling` / `long-xiaoxiao-neural`（12个，多数是虚构ID，与后端真实音色列表不对应） - `zh-CN-XiaoxiaoNeural` 之前的 Azure TTS 兜底 ID 已在上一轮修复中清理。 `ViralVideoPage.tsx` 本身没有硬编码任何 preset voice_id；所有 preset 音色通过 onConfirm 回调以 Modal 返回对象的 id 为准透传。 ### 2. 默认音色兜底 - **前端无默认音色**：`emptyTask.refAudio = null`，用户不主动选音色的话 `voice_id` 不会传给后端，由后端走默认（后端默认 `longxiaochun_v3`，见 `packages/application/cosyvoice_service.py` 注释与健康检查）。 - 选了内置音色后，Modal 返回的 `v.id` 直接写进 `refAudio.id`，confirm-copy/generate-video payload 取 `task.refAudio.id` 作为 `voice_id`。 ### 3. ID 覆盖风险 原代码 `{ ...v, ... }` 已经是把 API 的 v 放在展开后，但模糊匹配会给 category/desc 补充信息，**不覆盖 id**，所以不覆盖后端 voice_id。不过匹配逻辑用 name 模糊命中（slice(1)/slice(0,2)）很脆弱，可能误匹配。 ### 4. MOCK_VOICES 与后端对齐 对照后端 `packages/domain/preset_voices.py` 的 PRESET_VOICES 列表（CosyVoice v3-flash 真实可用音色），重写 MOCK_VOICES： - 8 个音色（与后端完全一致）：longxiaochun_v3(龙小淳)/longxiaoxia_v3(龙小夏)/longsanshu_v3(龙三叔)/longyue_v3(龙悦)/longshu_v3(龙书)/longyingjing_v3(龙应静)/longshuo_v3(龙硕)/longtian_v3(龙甜) - 删除虚构的 long-xiaoyan/long-xiaotong/long-xiaogang/long-xiaocheng/long-xiaozhi/long-xiaodong/long-xiaoling/晓晓 等 ID（后端没这些音色，提交会导致 TTS 失败） - 描述文案与后端 PRESET_VOICES.description 对齐 ### 5. 匹配逻辑修复 realList 映射改为**按 id 精确匹配**（`m.id === v.id`），不用 name 模糊匹配。当 API 返回真实音色列表时，id/name/gender/category/desc 全部来自 API，不被 mock 覆盖；只有当字段缺失时才用 mock 的同 ID 条目补充。 ## 后端 ID 规范确认 后端 packages/domain/preset_voices.py 明确： - voice_id 格式：`long{pinyin}_v3`，例如 longxiaochun_v3 - tags：["知性","女声","助手"] 这类中文标签 - 默认 voice_id = longxiaochun_v3（health check 与注释均确认） ## 验证 - tsc ✅ / vite build ✅ / prettier ✅ - 全局 grep 前端代码无 long-xiaochun/longxiaochun(旧)/zh-CN-XiaoxiaoNeural 残留

xiaoxia added 1 commit 2026-10-01 22:42:13 +08:00

fix(viral-video): 预设音色ID与后端对齐 longxiaochun_v3等v3后缀，去模糊匹配 880354e8de

xiaoxia merged commit 07069144c7 into develop 2026-10-01 22:42:17 +08:00

xiaoxia deleted branch fix/2041-preset-voice-ids 2026-10-01 22:42:23 +08:00

auto-approve-bot reviewed 2026-10-01 22:44:06 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

gitea-actions bot commented 2026-10-01 22:45:46 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

gitea-actions bot commented 2026-10-01 22:47:54 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

xiaoxia referenced this pull request 2026-10-01 23:13:33 +08:00

fix(viral-video): STEP2 generate-copy 补齐 voice_id/voice_source/video_ratio/video_model #2132

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

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

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#2130