fix(voice): 废弃 YUI remap 按线路分流，海外 free 绑 yui sentinel（Codex P2）

Codex: 海外 free（lanlan.app→free_intl）用户若残留国内 StepFun YUI tone，无条件
remap 成 voice-tone yui_cn 仍是国内 preset；海外不认 voice-tone-*，非空 voice_id 会
从海外 native/default(yui) 路径 regress 到 external TTS（_resolve_session_use_tts 仅
在 lanlan.tech 把 free preset 当 native）。改前 stale id 本会被 validation 清空。

remap 改为对偶 ensure_default_yui_voice_for_free_api 的线路二分：
- 仅 core=free 才迁移；非 free 路由原样返回交清空兜底
- 海外 free（lanlan.app / _check_non_mainland 兜底）→ 品牌 sentinel "yui"
- 国内 free（lanlan.tech）→ 现役 free_voices["yui_cn"]

新增「海外绑 yui」「URL 仍 tech 但地理判海外兜底」「非 free 不迁移」三条用例。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: Hongzhi Wen

tests/unit/test_deprecated_yui_voice_migration.py

@@ -1,9 +1,11 @@
-"""废弃免费 YUI 预设音色的自动平移（PR: voice-tone-R6NtLH3Hk0 → 现役 yui_cn）。
+"""废弃免费 YUI 预设音色的自动平移（PR: voice-tone-R6NtLH3Hk0 → 现役 YUI 音色）。
 
 回归点：YUI 默认音色 ID 更替后，存量用户 characters.json 里残留的旧 tone ID
 已不在 free_voices 白名单，cleanup_invalid_voice_ids 会判 invalid 清空 → 空
 voice 落到 free/step 的 default_voice（qingchunshaonv），导致默认 YUI 用户无声
-掉档到通用女声。cleanup 在判 invalid 前先把旧值平移到现役 yui_cn 兜住。
+掉档到通用女声。cleanup 在判 invalid 前先把旧值按线路平移：国内 free → 现役
+yui_cn；海外 free → 品牌 sentinel "yui"（free_intl native），与
+ensure_default_yui_voice_for_free_api 对偶。
 """
 from __future__ import annotations
 
@@ -13,8 +15,13 @@
 OLD_YUI_VOICE_ID = "voice-tone-R6NtLH3Hk0"
 NEW_YUI_VOICE_ID = "voice-tone-RcH2svtsrw"
 
+_DOMESTIC_FREE = {"CORE_API_TYPE": "free", "CORE_URL": "wss://www.lanlan.tech/core"}
+_OVERSEAS_FREE = {"CORE_API_TYPE": "free", "CORE_URL": "wss://www.lanlan.app/core"}
+_NON_FREE = {"CORE_API_TYPE": "qwen", "CORE_URL": ""}
 
-def _make_manager(character_data: dict) -> ConfigManager:
+
+def _make_manager(character_data: dict, core_config: dict | None = None,
+                  non_mainland: bool = False) -> ConfigManager:
     mgr = object.__new__(ConfigManager)
     mgr._saved = {}
     mgr.load_characters = lambda: character_data
@@ -23,6 +30,8 @@ def _save(data):
         mgr._saved["data"] = data
 
     mgr.save_characters = _save
+    mgr.get_core_config = lambda: dict(core_config if core_config is not None else _DOMESTIC_FREE)
+    mgr._check_non_mainland = lambda: non_mainland
     return mgr
 
 
@@ -62,6 +71,38 @@ def test_cleanup_migrates_whitespace_padded_deprecated_voice(monkeypatch):
     assert mgr._saved.get("data") is character_data
 
 
+def test_cleanup_overseas_free_remaps_to_yui_sentinel(monkeypatch):
+    """海外免费（lanlan.app）下废弃 StepFun tone 应绑品牌 sentinel "yui"，
+    而非国内 voice-tone preset——否则非空 voice_id 会落进 external TTS。"""
+    _patch_free_voices(monkeypatch, {"yui_cn": NEW_YUI_VOICE_ID})
+    character_data = _yui(OLD_YUI_VOICE_ID)
+    mgr = _make_manager(character_data, core_config=_OVERSEAS_FREE)
+
+    cleaned, legacy = mgr.cleanup_invalid_voice_ids()
+
+    assert cleaned == 0
+    assert get_reserved(character_data["猫娘"]["YUI"], "voice_id", default="") == "yui"
+
+
+def test_cleanup_overseas_by_geo_remaps_to_yui_sentinel(monkeypatch):
+    """URL 仍是 lanlan.tech 但地理判海外时，靠 _check_non_mainland 兜底绑 "yui"。"""
+    _patch_free_voices(monkeypatch, {"yui_cn": NEW_YUI_VOICE_ID})
+    character_data = _yui(OLD_YUI_VOICE_ID)
+    mgr = _make_manager(character_data, core_config=_DOMESTIC_FREE, non_mainland=True)
+
+    mgr.cleanup_invalid_voice_ids()
+
+    assert get_reserved(character_data["猫娘"]["YUI"], "voice_id", default="") == "yui"
+
+
+def test_remap_non_free_route_keeps_value(monkeypatch):
+    """非 free 路由（如 qwen）下废弃 StepFun preset 用不上，不迁移、交清空兜底。"""
+    _patch_free_voices(monkeypatch, {"yui_cn": NEW_YUI_VOICE_ID})
+    mgr = _make_manager({}, core_config=_NON_FREE)
+
+    assert mgr.remap_deprecated_free_yui_voice_id(OLD_YUI_VOICE_ID) == OLD_YUI_VOICE_ID
+
+
 def test_cleanup_keeps_current_yui_voice_untouched(monkeypatch):
     _patch_free_voices(monkeypatch, {"yui_cn": NEW_YUI_VOICE_ID})
     character_data = _yui(NEW_YUI_VOICE_ID)
@@ -104,18 +145,18 @@ def test_cleanup_clears_whitespace_padded_invalid_voice(monkeypatch):
 
 
 def test_remap_requires_yui_cn_not_other_preset(monkeypatch):
-    """回归（Codex）：free_voices 缺 yui_cn、只有别的 preset 时不得借 cuteGirl
-    等当替身把废弃 YUI 串成别的音色——原样返回，交清空兜底。"""
+    """回归（Codex）：国内 free 但 free_voices 缺 yui_cn、只有别的 preset 时不得
+    借 cuteGirl 等当替身把废弃 YUI 串成别的音色——原样返回，交清空兜底。"""
     _patch_free_voices(monkeypatch, {"cuteGirl": "voice-tone-PGLiyZt65w"})
-    mgr = object.__new__(ConfigManager)
+    mgr = _make_manager({})
 
     assert mgr.remap_deprecated_free_yui_voice_id(OLD_YUI_VOICE_ID) == OLD_YUI_VOICE_ID
 
 
 def test_remap_keeps_deprecated_when_current_unresolvable(monkeypatch):
-    """现役 yui_cn 解析不出（free_voices 为空）时不乱换。"""
+    """国内 free 但现役 yui_cn 解析不出（free_voices 为空）时不乱换。"""
     _patch_free_voices(monkeypatch, {})
-    mgr = object.__new__(ConfigManager)
+    mgr = _make_manager({})
 
     assert mgr.remap_deprecated_free_yui_voice_id(OLD_YUI_VOICE_ID) == OLD_YUI_VOICE_ID
     assert mgr.remap_deprecated_free_yui_voice_id(NEW_YUI_VOICE_ID) == NEW_YUI_VOICE_ID

utils/config_manager.py

@@ -2374,18 +2374,38 @@ def is_deprecated_free_yui_voice_id(voice_id) -> bool:
         return bool(voice_id) and str(voice_id).strip() in _DEPRECATED_FREE_YUI_VOICE_IDS
 
     def remap_deprecated_free_yui_voice_id(self, voice_id):
-        """废弃的免费 YUI 预设音色 → 现役 yui_cn 值。
+        """废弃的免费 YUI 预设音色 → 现役 YUI 音色（按路由判定目标）。
 
         非废弃值原样返回（不做 strip 归一化），避免调用方把单纯的前后空白差异
         误当成「已迁移」而 continue，漏掉本轮对无效 voice_id 的清理。
 
-        目标只认 free_voices 的 yui_cn（废弃值本就是它的旧版本）；yui_cn 缺失、
-        为空、或仍落在废弃集合时同样原样返回，交既有 validate / 清空兜底——绝不
-        借用 cuteGirl 等其它 preset 当替身，那会把 YUI 串成别的音色，也不会把废弃
-        换成另一个废弃造成死循环。
+        废弃值是国内 StepFun YUI tone，只有 core=free 才该迁移，且目标按线路分流，
+        与 ensure_default_yui_voice_for_free_api 的 "yui"/yui_cn 二分对偶：
+          - 海外免费（lanlan.app → free_intl）：voice-tone-* 不是该线路 native，
+            换成另一个国内 StepFun tone 反而让非空 voice_id 落进 external TTS；改绑
+            品牌 sentinel "yui"（free_intl 的 native/default），走海外原生语音路径。
+          - 国内免费（lanlan.tech）：换成现役 free_voices["yui_cn"]。
+        非 free 路由、或现役 yui_cn 缺失/为空/仍落废弃集合时原样返回，交既有 validate
+        清空兜底——绝不借 cuteGirl 等其它 preset 当替身把 YUI 串成别的音色。
         """
         if not self.is_deprecated_free_yui_voice_id(voice_id):
             return voice_id
+        core_cfg = self.get_core_config() or {}
+        if (core_cfg.get("CORE_API_TYPE") or core_cfg.get("coreApi")) != "free":
+            return voice_id
+
+        # get_core_config() 已按非大陆把 CORE_URL 改写成 lanlan.app，URL 即可判海外；
+        # _check_non_mainland 兜底地理判定。与 ensure_default 同源。
+        core_url = str(core_cfg.get("CORE_URL") or "")
+        overseas = is_free_lanlan_app_route("free", core_url)
+        if not overseas:
+            try:
+                overseas = bool(self._check_non_mainland())
+            except Exception:
+                overseas = False
+        if overseas:
+            return "yui"
+
         from utils.api_config_loader import get_free_voices
         current = str((get_free_voices() or {}).get("yui_cn") or "").strip()
         if current and current not in _DEPRECATED_FREE_YUI_VOICE_IDS: