feat(tts): style语气风格参数全链路接入 + 语速/音量/音调透传修复 #2005

Merged

auto-approve-bot merged 2 commits from fix/tts-style-emotion into develop 2026-09-21 04:23:08 +08:00

Conversation 2 Commits 2 Files Changed 12

+350 -20

xiaoxia commented 2026-09-21 04:07:14 +08:00

Owner

Copy Link

Copy Source

背景

前端 PR#2002 已合入 develop，所有 TTS 接口现在传 style 参数（natural/sweet/excited/professional/news/livestream）。此前后端 schema 无 style 字段，前端传值被 Pydantic 忽略，风格选择不生效。

改动内容

1. style 语气风格参数（对齐前端）

• cosyvoice_service.py：新增 STYLE_INSTRUCTION_MAP、VALID_STYLES、build_style_instruction()
• 显式 style → style instruct；无 style 回退旧 emotion 逻辑（向后兼容）
• style 优先级高于 emotion
• 4 个 schema 新增 style：TTSSynthesizeRequest / TTSPreviewRequest / CreateLipsyncJobRequest / AiAvatarTtsPreviewRequest
• lipsync_jobs 表新增 style 列（migration 084）

2. 语速/音量/音调透传修复

• 修复 volume/pitch 在 start_synthesis / segment 路径丢失
• preview/synthesize/lipsync_tts 全链路透传 speed/volume/pitch

测试

• 新增 12 个 style 相关单测
• 144 个相关测试全部通过，ruff 检查通过

影响范围

• 仅 TTS / lipsync 后端，不涉及前端

## 背景 前端 PR#2002 已合入 develop，所有 TTS 接口现在传 `style` 参数（natural/sweet/excited/professional/news/livestream）。此前后端 schema 无 style 字段，前端传值被 Pydantic 忽略，风格选择不生效。 ## 改动内容 ### 1. style 语气风格参数（对齐前端） - `cosyvoice_service.py`：新增 `STYLE_INSTRUCTION_MAP`、`VALID_STYLES`、`build_style_instruction()` - 显式 style → style instruct；无 style 回退旧 emotion 逻辑（向后兼容） - style 优先级高于 emotion - 4 个 schema 新增 style：TTSSynthesizeRequest / TTSPreviewRequest / CreateLipsyncJobRequest / AiAvatarTtsPreviewRequest - `lipsync_jobs` 表新增 style 列（migration 084） ### 2. 语速/音量/音调透传修复 - 修复 volume/pitch 在 start_synthesis / segment 路径丢失 - preview/synthesize/lipsync_tts 全链路透传 speed/volume/pitch ## 测试 - 新增 12 个 style 相关单测 - 144 个相关测试全部通过，ruff 检查通过 ## 影响范围 - 仅 TTS / lipsync 后端，不涉及前端

xiaoxia added 1 commit 2026-09-21 04:07:14 +08:00

feat(tts): style语气风格参数全链路接入 + 语速/音量/音调透传修复 ... 9c6d98fff4

后端新增 style 参数（对齐前端 PR#2002）：
- 支持 6 种语气风格：natural/sweet/excited/professional/news/livestream
- cosyvoice_service 新增 STYLE_INSTRUCTION_MAP、VALID_STYLES、build_style_instruction()
- 显式 style 走 style instruct；无 style 回退旧 emotion 逻辑（向后兼容）
- style 优先级高于 emotion
- 4 个 schema（TTSSynthesize/TTSPreview/CreateLipsyncJob/AiAvatarTtsPreview）新增 style
- 数据库 lipsync_jobs 新增 style 列（migration 084）

语速/音量/音调透传修复：
- 修复 volume/pitch 在 start_synthesis/segment 路径丢失的问题
- preview/synthesize/lipsync_tts 全链路透传 speed/volume/pitch

测试：新增 12 个 style 相关单测，全部 144 个相关测试通过

gitea-actions bot commented 2026-09-21 04:10:02 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot added 1 commit 2026-09-21 04:12:23 +08:00

style: auto-format with black + isort + ruff + prettier [skip ci-format-check] cac73744a4

auto-approve-bot merged commit a9f596fca3 into develop 2026-09-21 04:23:08 +08:00

auto-approve-bot deleted branch fix/tts-style-emotion 2026-09-21 04:23:11 +08:00

gitea-actions bot commented 2026-09-21 04:30:39 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

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