feat(litellm): add provider namespaces with legacy compatibility

servers/tools-pve/litellm/模型命名.md

@@ -0,0 +1,24 @@
+# 模型命名空间
+
+2026-10-27 起新增客户端命名空间，保留旧名兼容。实际型号、协议、凭据、个人热词和 SMART 均不改变；latest 不代表自动跟踪发布。
+
+| 前缀 | 含义 |
+| --- | --- |
+| zenmux/ | ZenMux 订阅直连，不跨 provider 回退 |
+| zenmux-payg/ | ZenMux PAYG，仅显式请求 |
+| openrouter/ | OpenRouter 直连 |
+| auto/ | 开源模型 ZenMux 订阅优先，故障回退 OpenRouter |
+| aistudio/ | Google AI Studio |
+| vertex/ | Google Vertex |
+| codex/ | Codex OAuth 订阅 |
+| xai/ | xAI OAuth 订阅 |
+
+常规旧别名加对应前缀。特殊转换：`gemini-flash-zenmux` → `zenmux/gemini-flash-latest`；`gemini-*-vertex` → `vertex/gemini-*-latest`；`gemini-embedding-2-studio` → `aistudio/gemini-embedding-2`；`google-rerank-default/fast` → `vertex/rerank-default/fast-latest`；`gpt-work-sol` → `codex/gpt-6-sol`；`gpt-review-5.5` → `codex/gpt-5.5`。PAYG 去掉旧 `-payg` 后缀，改加 `zenmux-payg/` 前缀。
+
+六组开源模型 `deepseek-flash-latest`、`deepseek-pro-latest`、`glm-latest`、`glm-flash-latest`、`kimi-latest`、`mimo-flash-latest` 各提供 auto/、zenmux/、openrouter/ 三种选择。旧自动回退名和旧 -openrouter 名保留。
+
+tools-pve 的个人语音名为 `aistudio/gemini-transcribe-personal`；HK 使用 `vertex/gemini-transcribe-personal`，不能互换两端 provider。HK 四款 ZenMux ASR 别名为 `zenmux/gpt-transcribe`、`zenmux/qwen-audio-3.1-asr-flash`、`zenmux/doubao-seed-asr-2.0`、`zenmux/mimo-v2.5-asr`。HK 的四个历史 Google 兼容名保留。
+
+只有凭据已就绪的路线才生成。新旧别名的 litellm_params 必须完全相同，不能把客户端前缀当作上游 provider 参数。受模型白名单限制的 virtual key 需要另行授权新名；不扩大既有 key 权限。旧名暂不删除，待所有客户端完成迁移后单独处理。
+
+修改 renderer 后，通过 Arcane Git Sync 同步，并重启对应 LiteLLM 进程使 /tmp/litellm.yaml 重建；仅同步代码不代表进程已加载。逐节点确认 /v1/models、新旧路由参数等价、fallback 配置及实际请求。