Преглед изворни кода

docs(tts): 记方言指令控制链路到文档

- tts-aliyun-voice.md: 新增「方言指令控制」章节,含支持方式表/API 格式/项目内映射/全链路图
- tts-overview.md: 决策表下加方言指令提示,链接到详细文档
MyFramework User пре 1 месец
родитељ
комит
711c81b39b
2 измењених фајлова са 28 додато и 0 уклоњено
  1. 24 0
      docs/tts-aliyun-voice.md
  2. 4 0
      docs/tts-overview.md

+ 24 - 0
docs/tts-aliyun-voice.md

@@ -264,6 +264,30 @@ if (params.pitch !== 0) instructions.push(`音调${params.pitch > 0 ? '较高' :
 - **优先用声音特征描述(性别 + 年龄 + 音调)**,避免纯情绪词("治愈的"),后者难以稳定生成
 - **不要混用语言**,指令要全中文(系统音色)或全英文/全日文(复刻音色)
 - **自定义音色的指令自由度更高**,可以实验长 prompt,但要测听感
+
+### 🔑 方言指令控制(2026-07 实测验证)
+
+`cosyvoice-v3-flash` + `longanhuan_v3`(主力音色)支持 `instruction` 字段控制方言。**旧代码曾禁用**(注释 "#tts-cosyvoice-428: 不接受 instruction"),但新版已修复。
+
+| 类型 | 代表音色 | 方式 |
+|------|---------|------|
+| 系统音色 | `longshange_v3` | 原生支持,无需指令 |
+| 系统音色 | `longanhuan_v3` | `instruction` 字段指定方言 |
+| 声音复刻 | 任意 | `instruction` 写 "请用 XX 话表达。" |
+| 声音设计 | v3.5 系 | ❌ 暂不支持方言 |
+
+格式是**单数 `instruction` 字符串**(不是 `instructions` 数组):
+
+```json
+{ "input": { "voice": "longanhuan_v3", "instruction": "请用河南话表达。" } }
+```
+
+项目内全链路(commit `ed0f9532`):
+```
+用户选 zh-HEN → pickTtsVendor() → voice=longanhuan_v3, dialectInstruction="请用河南话表达。"
+→ processTtsTask → VoiceParams → aliyun.provider.ts → CosyVoice API → 方言输出
+```
+
 ## Qwen-TTS 音色清单(完整,官方页面抓取)
 
 > 数据来源:[阿里云 Qwen-TTS 音色列表](https://help.aliyun.com/zh/model-studio/qwen-tts-voice-list),2026-07 用 playwright 渲染抓取。共 48 个音色。

+ 4 - 0
docs/tts-overview.md

@@ -50,6 +50,10 @@
 | 英语专业朗读 | bailian | qwen3-tts-instruct-flash | `詹妮弗`(美式电影质感) |
 | 自定义独特声音 | bailian | cosyvoice-v3.5-plus | 用户描述创建 |
 
+> **🔑 方言控制**: `longanhuan_v3` 支持通过 `instruction` 字段输出 9 种方言(东北/粤/川/鲁/豫/湘/陕/皖/闽)。
+> 代码全链路已贯通: `pickTtsVendor → dialectInstruction → aliyun.provider.ts → CosyVoice API`。
+> 详见 [`docs/tts-aliyun-voice.md` §方言指令控制](tts-aliyun-voice.md#-方言指令控制2026-07-实测验证)
+
 ---
 
 ## 📊 关键数据(从官方文档抓取)