feat(managed)!: 环境变量改名 QODER_BASE_URL -> QODER_MANAGED_BASE_URL

原名没有 mode 前缀，与 Forward 侧的 QODER_FORWARD_BASE_URL 不对称，
也和 .env.live.example 里已在用的 QODER_MANAGED_BASE_URL 不一致。
改名后 examples 的 prefix + BASE_URL 查找即可覆盖，去掉多余兜底。

Author: moonyue-w

README.md

@@ -47,7 +47,7 @@ Both clients read their token from the environment. `from qca.forward import Cli
 | Setting | Forward | Managed |
 |---|---|---|
 | Token | `QODER_ACCESS_TOKEN` | `QODER_ACCESS_TOKEN` |
-| Base URL | `QODER_FORWARD_BASE_URL` | `QODER_BASE_URL` |
+| Base URL | `QODER_FORWARD_BASE_URL` | `QODER_MANAGED_BASE_URL` |
 | Default base URL | `https://api.qoder.com/api/v1/forward/` | `https://api.qoder.com/api/v1/cloud/` |
 
 Explicit arguments take precedence over environment variables. The clients never read `.env` files; only the examples load `.env.live`. Other regions, including China, have to be configured explicitly:

examples/common/live.py

@@ -70,11 +70,7 @@ def load(cls, mode: str, *, env_file: str = ".env.live", region: str | None = No
         if not token:
             raise ValueError(f"Configure {prefix}PAT or QODER_ACCESS_TOKEN")
         suffix = "forward" if mode == "forward" else "cloud"
-        base = (
-            values.get(prefix + "BASE_URL")
-            or (values.get("QODER_BASE_URL") if mode == "managed" else None)
-            or f"https://api.qoder.com.cn/api/v1/{suffix}"
-        )
+        base = values.get(prefix + "BASE_URL") or f"https://api.qoder.com.cn/api/v1/{suffix}"
         url = httpx.URL(base)
         if (
             url.scheme != "https"

src/qca/managed/_client.py

@@ -19,7 +19,7 @@
 
 class Managed(SyncAPIClient):
     _default_base_url = "https://api.qoder.com/api/v1/cloud/"
-    _base_url_env = "QODER_BASE_URL"
+    _base_url_env = "QODER_MANAGED_BASE_URL"
 
     @cached_property
     def agents(self) -> Agents:
@@ -68,7 +68,7 @@ def models(self) -> Models:
 
 class AsyncManaged(AsyncAPIClient):
     _default_base_url = "https://api.qoder.com/api/v1/cloud/"
-    _base_url_env = "QODER_BASE_URL"
+    _base_url_env = "QODER_MANAGED_BASE_URL"
 
     @cached_property
     def agents(self) -> AsyncAgents:

tests/test_client.py

@@ -41,7 +41,7 @@ def make_client(handler, cls=Forward, **kwargs):
 
 
 @pytest.mark.parametrize(
-    "cls,env,suffix", [(Forward, "QODER_FORWARD_BASE_URL", "forward"), (Managed, "QODER_BASE_URL", "cloud")]
+    "cls,env,suffix", [(Forward, "QODER_FORWARD_BASE_URL", "forward"), (Managed, "QODER_MANAGED_BASE_URL", "cloud")]
 )
 def test_environment_defaults_and_explicit_precedence(monkeypatch, cls, env, suffix):
     monkeypatch.setenv("QODER_ACCESS_TOKEN", "from-env")