diff --git a/servers/tools-pve/litellm/README.md b/servers/tools-pve/litellm/README.md
index ad4d427..c8bf015 100644
--- a/servers/tools-pve/litellm/README.md
+++ b/servers/tools-pve/litellm/README.md
@@ -8,6 +8,8 @@ ZenMux Sonnet 5.5 原生 Messages 正常；重复请求证实写入与读取
 21,502 prompt-cache tokens。Codex/xAI 已独立授权，SDK 原生请求验证
 Luna、Sol 6.1 和 Grok 4.7 返回 OK。用户更新后的 PAYG key 原生 Claude 请求 HTTP 200。
 Google AI Studio key 模型目录 HTTP 200，使用上游提供的三个 latest 别名。
+17 条路线已加载；原客户端 key 权限已更新，Luna/Sol 的 gateway Responses SSE、
+Luna 非流式 Chat Completions、Grok/Gemini 三条 Chat 路线和 PAYG Messages 均实测 OK。
 本项目对其他模型的自动 latest 维护尚未实现。
 
 - Environment：`ff859844-8393-4f87-8caf-054df735a65d`。
@@ -55,9 +57,13 @@ Claude 客户端优先使用原生 `/v1/messages`，保留 `cache_control`、
 错误由上游返回；使用支持的 `auto` 模式，不在代理中静默改写调用者的要求。
 
 开放模型优先经 OpenRouter；首版 `models.yaml` 来自实际 provider 目录。
-`latest` 目前只是手动维护的稳定别名，没有自动追踪新版本。
+除 Google 自带 latest 映射由其上游维护外，其他 `latest` 都是本项目手动维护的稳定别名。
 Google AI Studio 使用独立 key 与模型表，已实际查询模型目录，
 不把 Google OAuth/ADC 当成 AI Studio API key。
+Google 三条模型为 gemini-flash-latest、gemini-flash-lite-latest、gemini-pro-latest。
+用户新 provider key 的权威位置是 Arcane tools-litellm Project `.env`；
+不要用 .145 首次生成的 tools-litellm.env 整体覆盖它，那份文件可能还含旧 provider 值。
+该本机文件主要用于 master key 管理与数据库凭据恢复；提供商配置必须先从 Arcane 实查。
 
 ## 密钥
 
@@ -106,7 +112,8 @@ bash oauth-login.sh xai
 OAuth 映射为 gpt-luna-latest -> gpt-6-luna、gpt-sol-latest -> gpt-6.1-sol、
 grok-latest -> grok-4.7，独立账号目录与 SDK 请求均已验证。
 Codex 路线由 `chatgpt/` 访问，优先 `/v1/responses`；
-使用消息列表形式的 input 和 stream=true，按 SSE 读取到 response.completed。
+原生 Responses 使用消息列表形式的 input 和 stream=true，按 SSE 读取到 response.completed。
+常规 OpenAI SDK 客户端也可用 /v1/chat/completions，Luna 非流式桥接已实测 OK。
 实测直接给字符串 input 会被 Codex backend 拒绝；不要把已授权误写成协议完全兼容。
 xAI 路线使用 `xai/` 与 `use_xai_oauth: true`，不能设置 XAI API key 覆盖它。
 新增 token 后需重启代理，运行时 refresh 会写回同一个持久卷。
diff --git a/servers/tools-pve/litellm/models.yaml b/servers/tools-pve/litellm/models.yaml
index 811f47a..156fa9f 100644
--- a/servers/tools-pve/litellm/models.yaml
+++ b/servers/tools-pve/litellm/models.yaml
@@ -1,4 +1,4 @@
-# latest 为本项目固定别名；不会自行追踪上游发布。
+# 除 Google 自带 latest 别名外，本项目映射不会自行追踪上游发布。
 zenmux:
   claude-sonnet-latest: anthropic/claude-sonnet-5.5
   claude-opus-latest: anthropic/claude-opus-5.5