feat(voice): emotionTTS 发音人绑定会话人格（不再全局定死一个 character）

主人 2026-10-26 逐字：「TTS 的人物选择是要绑定后端的角色的，不然会出现以后换了
别的角色(人格配置)，还是用老角色的 TTS 角色」——上一版把 character 写在面板文件
里当全局值，换人格后声音不变，是真缺陷。

配置形状（单一真源 = $DATA_DIR/config/voice-tts.json）：
  {"enabled":true,
   "personas":{"<personaId>":"<characterId>"},
   "default":"<characterId>",   // 只服务「解析不到 personaId」
   "format":"wav","timeoutSec":60}
- 旧的全局 `character` 键**废弃并被忽略**（启动 WARN 提示改用 personas）；
  Config.Normalized 不给任何角色兜底（代码里写死默认角色=病害本身）；
- configs/personas/*.yaml 不参与（塔裁定：避免启动期静态配置与面板两处漂移）；
- 零新 .env 键。

选角四条分支（Config.Resolve，纯函数、无缓存）：
  ① persona 有映射 ⇒ 用它；
  ② personaId 为空/解析不到 + 配了 default ⇒ 用 default；
  ③ personaId 为空 + 没配 default ⇒ 不合成（ErrNoCharacter，上游 0 请求）；
  ④ persona 无映射（含映射值为空）⇒ 拒绝（ErrPersonaUnmapped），
     **绝不**拿 default 或别的角色顶 —— 主人担心的病害本身。

两条既有出站口各自按当次请求解析 persona（不在 SetVoice 时算一次缓存成全局）：
- WS voice_output：用本回合的 env.PersonaID（runVoiceTurn/runVoiceTurnDirect），
  经 voiceReplySink 传给 synthesizeVoiceReply，再 WithPersonaID 交给语音面；
- POST /api/v1/audio/speech：请求体新增**可选** sessionId（纯增量），
  经 turnEnvResolver.sessionPersona 解析；省略 ⇒ 走 default 分支。

Client.Speech 改为**每次传入 character**（内部不缓存发音人）；Provider 适配同样按
ctx 的 personaId 现算。选不到发音人时**不回落既有链**（回落=用另一个声音说话），
上游拒绝(404/500)仍按既有口径回落既有链+WARN。

测试：四条分支各自可变异打红，断言打在「上游请求体里的 voice」与帧/响应字节上；
含「同一进程先后两个 persona，第二次绝不沿用第一次 voice」的回归锁，
以及两条出站口的端到端 persona 切换。四条变异（未映射回落 default / 客户端缓存
voice / REST 不看会话 / 选不到时回落底链）均已实测打红后还原。
go build ./... / go vet ./... / go test -race 全绿；真机 live 证据：
cyrene(char_84fb88a3)=254630 B、furina(char_5314489e)=213392 B。

cmd/cyrene/wire_voice_tts.go

@@ -43,7 +43,8 @@ func (a *app) voiceForGateway() gateway.VoiceService {
 	service := voicetts.NewService(client, a.voice, voicetts.WithServiceLogger(logger.WithSource(a.log, voiceTTSSource)))
 	logger.WithSource(a.log, voiceTTSSource).Info("emotionTTS voice enabled",
 		"base_url", client.RedactedBaseURL(),
-		"character", client.Character(),
+		"personas", len(cfg.Personas),
+		"default_set", cfg.Default != "",
 		"format", cfg.Format,
 		"timeout_sec", int(cfg.Timeout/time.Second),
 		"config", runtimeconfig.VoiceTTSConfigRelPath)
@@ -54,6 +55,8 @@ func (a *app) voiceForGateway() gateway.VoiceService {
 // 启用"——坏文件、缺文件、显式 false 都得出 false（并在坏文件时留一条 WARN）。
 //
 // 它**不**在这里做"缺省填什么"的裁决：默认值在 `voicetts.Config.Normalized` 一处。
+// 🔴 它也**不**给 personas/default 补任何角色：发音人只能由面板显式给出（全局定死
+// 一个 character 正是主人点名的病害）。
 func (a *app) voiceTTSConfig() (voicetts.Config, bool) {
 	log := logger.WithSource(a.log, voiceTTSSource)
 	path := runtimeconfig.DefaultVoiceTTSPath(resolveDataDir(a.cfg))
@@ -70,12 +73,19 @@ func (a *app) voiceTTSConfig() (voicetts.Config, bool) {
 			"path", runtimeconfig.VoiceTTSConfigRelPath, "hint", "set {\"enabled\": true}")
 		return voicetts.Config{}, false
 	}
+	if legacy := tuning.LegacyGlobalCharacter(); legacy != "" {
+		// 旧版的全局 character：**忽略**，但绝不静默 —— 运维需要知道换成 personas。
+		log.Warn("voice tts config: global `character` is deprecated and ignored",
+			"character", legacy, "config", runtimeconfig.VoiceTTSConfigRelPath,
+			"hint", "use {\"personas\": {\"<personaId>\": \"<characterId>\"}} so the voice follows the persona")
+	}
 	return voicetts.Config{
-		Enabled:   true,
-		BaseURL:   tuning.BaseURL,
-		Character: tuning.Character,
-		Format:    tuning.Format,
-		Timeout:   time.Duration(tuning.TimeoutSec) * time.Second,
+		Enabled:  true,
+		BaseURL:  tuning.BaseURL,
+		Personas: tuning.Personas,
+		Default:  tuning.Default,
+		Format:   tuning.Format,
+		Timeout:  time.Duration(tuning.TimeoutSec) * time.Second,
 	}, true
 }
 

cmd/cyrene/wire_voice_tts_test.go

@@ -40,21 +40,45 @@ func TestVoiceForGateway_DisabledByDefault(t *testing.T) {
 }
 
 // TestVoiceForGateway_WrapsWhenEnabled 钉住"文件启用 ⇒ 门面生效 + 配置逐项读对"。
+//
+// 🔴 它同时钉住主人 2026-10-26 那条硬要求在**组合根**上的形态：配置里读出来的是
+// `personas` 映射与 `default`，**没有**任何"全局一个 character"。
 func TestVoiceForGateway_WrapsWhenEnabled(t *testing.T) {
 	a := voiceTTSApp(t)
 	writeVoiceTTSPanel(t, a, `{"enabled":true,"baseUrl":"http://127.0.0.1:9880",
-	                           "character":"Cyrene","format":"wav","timeoutSec":45}`)
+	                           "personas":{"cyrene":"char_84fb88a3","furina":"char_5314489e"},
+	                           "default":"char_84fb88a3","format":"wav","timeoutSec":45}`)
+
+	cfg, enabled := a.voiceTTSConfig()
+	if !enabled {
+		t.Fatal("面板写了 enabled:true，但组合根报未启用")
+	}
+	if len(cfg.Personas) != 2 || cfg.Personas["furina"] != "char_5314489e" {
+		t.Fatalf("personas 没有逐项读出: %+v", cfg.Personas)
+	}
+	if cfg.Default != "char_84fb88a3" {
+		t.Fatalf("default = %q, want char_84fb88a3", cfg.Default)
+	}
 
 	got := a.voiceForGateway()
-	svc, ok := got.(*voicetts.Service)
-	if !ok {
+	if _, ok := got.(*voicetts.Service); !ok {
 		t.Fatalf("启用后应返回 *tts.Service, got %T", got)
 	}
-	if !svc.PrimaryActive() {
-		t.Fatal("面板写了 enabled:true，但这一级没启用")
+}
+
+// TestVoiceForGateway_LegacyCharacterIgnored 钉住已废弃的全局 character **不生效**：
+// 只写旧键时，映射与 default 都是空的 ⇒ 任何请求都选不到发音人（不会悄悄回退到
+// 那个全局角色，因为那正是主人担心的病害）。
+func TestVoiceForGateway_LegacyCharacterIgnored(t *testing.T) {
+	a := voiceTTSApp(t)
+	writeVoiceTTSPanel(t, a, `{"enabled":true,"character":"char_84fb88a3"}`)
+
+	cfg, enabled := a.voiceTTSConfig()
+	if !enabled {
+		t.Fatal("enabled:true 应让这一级启用")
 	}
-	if svc.Character() != "Cyrene" {
-		t.Errorf("character = %q, want Cyrene（面板值）", svc.Character())
+	if len(cfg.Personas) != 0 || cfg.Default != "" {
+		t.Fatalf("废弃的全局 character 被当成了发音人: personas=%v default=%q", cfg.Personas, cfg.Default)
 	}
 }