feat!: 令牌环境变量改名 QODER_ACCESS_TOKEN -> QODER_PAT

与 examples 已在用的 QODER_FORWARD_PAT / QODER_MANAGED_PAT 统一为
PAT 口径；构造参数仍是 access_token，不随环境变量改名。

Author: moonyue-w

.env.live.example

@@ -8,7 +8,7 @@ QODER_MANAGED_BASE_URL=https://api.qoder.com.cn/api/v1/cloud
 QODER_MANAGED_MODEL=
 
 # Optional fallback for either mode.
-QODER_ACCESS_TOKEN=
+QODER_PAT=
 
 # pytest live tests require explicit opt-in in the process environment:
 # QODER_RUN_LIVE=1 python -m pytest examples -m live -v

README.md

@@ -46,7 +46,7 @@ Both clients read their token from the environment. `from qca.forward import Cli
 
 | Setting | Forward | Managed |
 |---|---|---|
-| Token | `QODER_ACCESS_TOKEN` | `QODER_ACCESS_TOKEN` |
+| Token | `QODER_PAT` | `QODER_PAT` |
 | 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/` |
 

examples/common/live.py

@@ -66,9 +66,9 @@ class Config:
     def load(cls, mode: str, *, env_file: str = ".env.live", region: str | None = None, timeout: float = 300) -> Config:
         values = {**read_env(env_file), **os.environ}
         prefix = f"QODER_{mode.upper()}_"
-        token = values.get(prefix + "PAT") or values.get("QODER_ACCESS_TOKEN", "")
+        token = values.get(prefix + "PAT") or values.get("QODER_PAT", "")
         if not token:
-            raise ValueError(f"Configure {prefix}PAT or QODER_ACCESS_TOKEN")
+            raise ValueError(f"Configure {prefix}PAT or QODER_PAT")
         suffix = "forward" if mode == "forward" else "cloud"
         base = values.get(prefix + "BASE_URL") or f"https://api.qoder.com.cn/api/v1/{suffix}"
         url = httpx.URL(base)

src/qca/common/_base_client.py

@@ -54,7 +54,7 @@ def _configure(
     ) -> None:
         if not isinstance(max_retries, int) or isinstance(max_retries, bool) or max_retries < 0:
             raise ValueError("max_retries must be a non-negative integer")
-        self.access_token = access_token if access_token is not None else os.environ.get("QODER_ACCESS_TOKEN")
+        self.access_token = access_token if access_token is not None else os.environ.get("QODER_PAT")
         self.credential = credential
         self.base_url = httpx.URL(base_url or os.environ.get(self._base_url_env) or self._default_base_url)
         if self.base_url.scheme not in ("http", "https") or not self.base_url.host or self.base_url.userinfo:

tests/test_client.py

@@ -44,7 +44,7 @@ def make_client(handler, cls=Forward, **kwargs):
     "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")
+    monkeypatch.setenv("QODER_PAT", "from-env")
     monkeypatch.setenv(env, f"https://configured.test/api/v1/{suffix}")
     with cls() as client:
         assert client.access_token == "from-env"
@@ -226,7 +226,7 @@ def handle(request):
 
 
 def test_dynamic_credentials_refresh_and_explicit_headers(monkeypatch):
-    monkeypatch.delenv("QODER_ACCESS_TOKEN", raising=False)
+    monkeypatch.delenv("QODER_PAT", raising=False)
     monkeypatch.setattr("qca.common._base_client.time.sleep", lambda _: None)
 
     class Rotating: