fix(config): agent URL 按线路路由（国内 lanlan.app / 国际 www.lanlan.app） (#1491)

* fix(config): agent URL 按线路路由（国内 lanlan.app / 国际 www.lanlan.app）

原本 agent URL 无条件把 lanlan.tech 改写为 lanlan.app，国内外都落到
www.lanlan.app。改为抽出 _normalize_agent_url：统一 tech→app 后，国际
保留 www 前缀，国内剥掉 www 走就近节点；GeoIP 不确定时按国内处理，与
_adjust_free_api_url 口径一致。不含 lanlan 域的自定义 URL 原样返回。

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

* docs(config): 注释 _normalize_agent_url 的 GeoIP 异常降级语义

回应 code-quality 对空 except 的提醒：补充注释说明探测异常时保留国际
形态作为安全默认，行为不变但可追踪。

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

* test(config): 补 bare host 用例固化 agent URL 不补 www 契约

回应 CodeRabbit nitpick：bare lanlan.tech 输入（仅可能来自自定义 URL）
两区都落到 bare lanlan.app，显式记录尊重用户 host、不强加 www 的行为。

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

* refactor(config): agent URL 改写改为按 host 判定，不做字符串级 replace

回应 Codex/CodeRabbit：原裸 replace('www.lanlan.app','lanlan.app') 会
误改 path/query 里出现的同名子串（如自定义代理的 upstream 参数），且比
同文件 _adjust_free_api_url 锚定 /tts 的 www-strip 更松。改为 urlparse
后仅当 host 恰为 lanlan.tech/www.lanlan.tech/lanlan.app/www.lanlan.app
时重写 netloc，其余域一律原样透传，保留端口。

新增用例：query/path 含 lanlan 字样的自定义代理不被改写、evil-lanlan.app
后缀不命中、端口保留。

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

* fix(config): agent URL 按组件重建 netloc，不动 userinfo

回应 Codex/CodeRabbit：原 netloc.replace(hostname,...) 在 netloc 含
user:pass@ 且凭证里出现 host 同名串时会先替到 userinfo（改坏凭证、host
没动），大小写不一致时也替不到。改为按 username/password/port 组件重建
netloc，host 用规范化后的小写值直接拼，两类场景都稳。

新增用例：user:pass@（凭证含 host 同名串）只改 host。

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

* fix(config): agent URL 端口非法时原样返回，不拖垮 config 加载

回应 Codex P2：urlparse 不校验端口，.port 访问才对 :abc / 越界端口抛
ValueError。该访问在 GeoIP try 之外，会让 get_core_config() 整体崩溃
（旧字符串 replace 不会）。给 .port 访问加 ValueError guard，非法端口
原样返回交给下游处理。

新增用例：端口非数字 / 越界 → passthrough。

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

* fix(config): agent URL 保留空但存在的 userinfo 分量

回应 Codex P2：截断式 if parsed.username/password 把空字符串当缺失，
会丢掉 https://:token@host 的整个 :token@（bearer 式代理常用），改坏
认证语义。改用 is not None 区分「分量为空但存在」与「不存在」。

新增用例：:token@（空用户名）/ user:@（空密码）均原样保留。

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

* fix(config): agent URL 保留显式 :0 端口

回应 Codex P2：port 三元用 if parsed.port 截断，端口 0 合法但 falsy，
会把显式 :0 丢成默认端口。与 userinfo 同类，改用 is not None。

新增用例：:0 端口保留。

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

* revert(config): agent URL 改回简单字符串替换，去掉过度工程化的 urlparse

lanlan.tech / lanlan.app 是项目自有域名，AGENT_MODEL_URL 要么是写死的
free 默认，要么是用户自填的非 lanlan 服务 URL。bot review 提的内嵌凭证 /
:0 端口 / :abc 畸形端口 / query 里带 lanlan 字样等场景对这两个域名根本
不会出现，为它们引入 urlparse + netloc 组件重建属于过度工程化。

回到两行 replace（helper 仅为两个调用点复用区域逻辑），测试同步精简。

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

* docs(config): 给 _normalize_agent_url 的 except 补降级语义注释

revert 时误删了解释注释。空 except 零注释本身不好（与 bot 提不提无关）：
补一句说明仅 _check_non_mainland 可能抛、探测失败时保留国际形态。

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

---------

Co-authored-by: Hongzhi Wen <cartabio.coder1@gmail.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: 3 people

tests/unit/test_api_config_manager.py

@@ -625,6 +625,49 @@ def test_agent_uses_dedicated_fields_but_not_custom_when_toggle_off(self, config
             'Agent URL should have lanlan.app normalization applied'
 
 
+# ---------------------------------------------------------------------------
+# 7b. Agent URL region routing: 国内 lanlan.app / 国际 www.lanlan.app
+# ---------------------------------------------------------------------------
+class TestAgentUrlRegionRouting:
+
+    @pytest.mark.unit
+    @pytest.mark.parametrize(
+        ('non_mainland', 'url_in', 'expected'),
+        [
+            # 国际：保留 www 前缀
+            (True, 'https://www.lanlan.tech/text/v1', 'https://www.lanlan.app/text/v1'),
+            # 国内：剥掉 www
+            (False, 'https://www.lanlan.tech/text/v1', 'https://lanlan.app/text/v1'),
+            # GeoIP 不确定（按国内处理）：同样剥 www
+            (None, 'https://www.lanlan.tech/text/v1', 'https://lanlan.app/text/v1'),
+            # 已经是 www.lanlan.app 的国内输入：仍剥 www（幂等）
+            (False, 'https://www.lanlan.app/text/v1', 'https://lanlan.app/text/v1'),
+            # 国际下 www.lanlan.app 保持不变
+            (True, 'https://www.lanlan.app/text/v1', 'https://www.lanlan.app/text/v1'),
+            # bare host 输入（无 www，仅可能来自自定义 URL）：尊重原样，不补 www，
+            # 两区都落到 bare lanlan.app（仅做 tech→app）
+            (True, 'https://lanlan.tech/text/v1', 'https://lanlan.app/text/v1'),
+            (False, 'https://lanlan.tech/text/v1', 'https://lanlan.app/text/v1'),
+        ],
+    )
+    def test_normalize_agent_url_by_region(self, config_manager, non_mainland, url_in, expected):
+        config_manager._check_non_mainland = lambda: non_mainland
+        assert config_manager._normalize_agent_url(url_in) == expected
+
+    @pytest.mark.unit
+    @pytest.mark.parametrize('non_mainland', [True, False, None])
+    def test_normalize_agent_url_custom_url_untouched(self, config_manager, non_mainland):
+        """不含 lanlan 域的自定义 URL 原样返回，不受线路影响。"""
+        config_manager._check_non_mainland = lambda: non_mainland
+        custom = 'https://api.openai.com/v1'
+        assert config_manager._normalize_agent_url(custom) == custom
+
+    @pytest.mark.unit
+    def test_normalize_agent_url_non_string_passthrough(self, config_manager):
+        config_manager._check_non_mainland = lambda: True
+        assert config_manager._normalize_agent_url(None) is None
+
+
 # ---------------------------------------------------------------------------
 # 8. MiniMax / Qwen voice clone key resolution
 # ---------------------------------------------------------------------------

utils/config_manager.py

@@ -2971,6 +2971,26 @@ def _adjust_free_api_url(self, url: str, is_free: bool) -> str:
 
         return url
 
+    def _normalize_agent_url(self, url: str) -> str:
+        """Agent 模型始终走 lanlan.app（国际 API），统一 lanlan.tech → lanlan.app；
+        国际保留 www（www.lanlan.app），国内剥掉 www（lanlan.app）走就近节点。
+
+        lanlan.tech / lanlan.app 是项目自有域名，AGENT_MODEL_URL 要么是写死的
+        free 默认（https://www.lanlan.tech/text/v1），要么是用户自填的其它服务
+        URL（不含这两个域，replace 自然 no-op），所以直接字符串替换即可。
+        """
+        if not isinstance(url, str):
+            return url
+        url = url.replace('lanlan.tech', 'lanlan.app')
+        try:
+            if not self._check_non_mainland():
+                url = url.replace('www.lanlan.app', 'lanlan.app')
+        except Exception:
+            # 仅 _check_non_mainland 可能抛（GeoIP 探测）。探测失败时不剥 www，
+            # 保留国际形态作安全默认；线路探测不该阻断 URL 推导。
+            pass
+        return url
+
     @staticmethod
     def _derive_livestream_url(original_url: str, prefix: str) -> str:
         """从 livestream server_prefix 派生 lanlan.tech URL 的等价地址。
@@ -3280,7 +3300,7 @@ def _fb(provider: str) -> str:
         # agent api 默认跟随辅助 API 的 agent_model，缺失时回退到 VISION_MODEL
         config['AGENT_MODEL'] = config.get('AGENT_MODEL') or config.get('VISION_MODEL', '')
         config['AGENT_MODEL_URL'] = config.get('AGENT_MODEL_URL') or config.get('VISION_MODEL_URL', '') or config.get('OPENROUTER_URL', '')
-        config['AGENT_MODEL_URL'] = config['AGENT_MODEL_URL'].replace('lanlan.tech', 'lanlan.app') # TODO: 先放这里
+        config['AGENT_MODEL_URL'] = self._normalize_agent_url(config['AGENT_MODEL_URL'])
 
         key_field = assist_api_key_fields.get(assist_api_value)
         derived_key = ''
@@ -3463,7 +3483,7 @@ def _resolve_follow_model_url(prefix: str, provider: str) -> str:
 
         # Agent model always uses international API regardless of region
         if isinstance(config.get('AGENT_MODEL_URL'), str):
-            config['AGENT_MODEL_URL'] = config['AGENT_MODEL_URL'].replace('lanlan.tech', 'lanlan.app')
+            config['AGENT_MODEL_URL'] = self._normalize_agent_url(config['AGENT_MODEL_URL'])
 
         return config