flexgate 0.7.0__tar.gz → 0.9.0__tar.gz

{flexgate-0.7.0 → flexgate-0.9.0}/CLAUDE.md

@@ -22,6 +22,7 @@ flexgate service install                    # install + enable + start systemd u
 flexgate service {install|start|stop|restart|reload|status|uninstall}
 flexgate run                                # foreground/debug only
 flexgate status                             # providers, fallback chains, per-key usage, active routes
+flexgate usage [--force]                    # per-key usage/quota only; --force rechecks cached failures
 flexgate log                                # service journal (-f follow, -r route lines only)
 
 # Config
@@ -91,7 +92,7 @@ OpenAI-style client → POST /v1/images/generations
 | `config.py` | Pydantic-like dataclasses (`GatewayConfig`, `ProviderConfig`, `RouteConfig`, `ScheduleEntry`), YAML load/save, `TIER_PATTERNS` regex map, `is_placeholder_key` |
 | `router.py` | `resolve(config, model)` — schedule-first then default routes, first regex match wins; model aliases normalized before matching |
 | `proxy.py` | `handle_request()` — httpx async proxy, per-key fallback retry loop, SSE streaming + JSON pass-through |
-| `usage.py` | `flexgate status` usage queries — per-platform adapters (MiniMax coding_plan API, Kimi Code usages API, z.ai quota API, LiteLLM `/key/info`) plus a minimal chat probe fallback |
+| `usage.py` | `flexgate status` usage queries — per-platform adapters (MiniMax coding_plan API, Kimi Code usages API, z.ai quota API, zhipu team quota API, LiteLLM `/key/info`) plus a minimal chat probe fallback |
 | `server.py` | Starlette app creation, `POST /v1/messages` + `POST /v1/images/{generations,edits}` endpoints, `SIGUSR1` lifespan reload |
 | `images.py` | OpenAI Images API → MiniMax `/v1/image_generation` translation (`image-01`, size→width/height clamped to 512–2048 mult of 8, `data.image_base64[]`→`data[].b64_json`); edits endpoint returns 501; unknown image model names get 501 `model_not_supported` |
 | `fallback.py` | Catch-all route: merged Anthropic/OpenAI-shaped JSON errors for every unserved path — 404 `route_not_found` (lists valid routes), 405 `method_not_allowed`, 501 `endpoint_not_supported` per recognized API family with an actionable reason |
@@ -110,8 +111,8 @@ OpenAI-style client → POST /v1/images/generations
 - **Model alias normalization** (`router.py`): before matching, bare aliases (`sonnet`/`opus`/`haiku`/`default`, case-insensitive, optional `[plan]` suffix) map to `claude-<tier>` prefixes (`default` → sonnet, Claude Code's default tier), and legacy numbered names (`claude-3-7-sonnet-latest`) reduce to their tier prefix; everything else passes through unchanged, so custom patterns and the catch-all behave exactly as before.
 - **Model resolution & `available_models` fallback**: A route may omit `model`; `router.resolve()` then falls back to the provider's first `available_models` entry, so `model_override` handed to the proxy is always a concrete name. `config._parse_routes` rejects routes that omit `model` on a provider with no `available_models` — so adding a provider without models requires an explicit `model` on every route using it.
 - **Proxy rewrite contract** (`proxy.py`): the upstream request gets the provider's `x-api-key` plus a fixed header set, and the JSON `model` field is rewritten only when the route set an override. Streaming responses are forwarded as raw bytes (`aiter_bytes`), never parsed.
-- **Key fallback** (`proxy.py`): a provider's `api_keys` list holds one or more keys for the same upstream (entries are key strings or `{key, note}` mappings; `note` is a free-form label shown by `flexgate status` and in fallback logs). Multiple accounts on one upstream — e.g. several MiniMax subscriptions — belong in ONE provider, not separate ones. Each *route* has an active-key pointer (`active_key` in YAML, 1-based; `RouteConfig.key_index` 0-based, default first key): requests on that route start from the pointed key, and on a retryable failure (HTTP 401/402/403/429/500/502/503/529, connect error, or timeout) the next key is tried and the pointer advances with it (in memory only, wrapping around — it is not written back to the file); every key is tried at most once and a full circle of failures returns the last error. The pointer is set interactively via `flexgate config edit` → "api keys" (pick a route, with live per-key usage) or by editing the route's `active_key` directly. `resolve()` (`router.py`) returns the matched `RouteConfig` so the proxy can read/advance its pointer. Streaming requests can only fall back before the upstream returns 200. `_regular_proxy`/`_stream_proxy` return `(response, retryable)`; `handle_request` owns the loop and returns the last error when all keys fail. The legacy `api_key` + `fallback_keys` schema is still parsed (`config._parse_api_keys`); migration v3 → v4 rewrites it to `api_keys`. `ProviderConfig.api_key` remains as a first-key property (getter/setter) for the settings import code.
-- **Usage inspection** (`usage.py`): `flexgate status` maps `base_url` to a platform adapter (`_ADAPTERS`): MiniMax → `{origin}/v1/api/openplatform/coding_plan/remains` (only the "general" text-model quota entry is used; its counts are usually 0/0, so usage is read from the `*_remaining_percent` fields), Kimi Code → `{base}/v1/usages` (undocumented, same endpoint as the CLI's `/usage`; reports weekly quota, 5-hour window and parallel limit), z.ai/bigmodel → `{origin}/api/monitor/usage/quota/limit` (undocumented but used by z.ai's own plugin), USTC/LiteLLM → `{origin}/key/info`. Hosts in `_PROBE_ONLY_MARKERS` (e.g. xiaomimimo.com — no key-based usage API) and unknown platforms get the minimal chat probe: `POST /v1/messages` with input `"hi"`, `max_tokens=128`. A failed adapter call also degrades to the probe.
+- **Key fallback** (`proxy.py`): a provider's `api_keys` list holds one or more keys for the same upstream (entries are key strings or `{key, note}` mappings — plus optional `organization`/`project` on zhipu team keys, used only by the usage check; `note` is a free-form label shown by `flexgate status` and in fallback logs). Multiple accounts on one upstream — e.g. several MiniMax subscriptions — belong in ONE provider, not separate ones. Each *route* has an active-key pointer (`active_key` in YAML, 1-based; `RouteConfig.key_index` 0-based, default first key): requests on that route start from the pointed key, and on a retryable failure (HTTP 401/402/403/429/500/502/503/529, connect error, or timeout) the next key is tried and the pointer advances with it (in memory only, wrapping around — it is not written back to the file); every key is tried at most once and a full circle of failures returns the last error. The pointer is set interactively via `flexgate config edit` → "api keys" (pick a route, with live per-key usage) or by editing the route's `active_key` directly. `resolve()` (`router.py`) returns the matched `RouteConfig` so the proxy can read/advance its pointer. Streaming requests can only fall back before the upstream returns 200. `_regular_proxy`/`_stream_proxy` return `(response, retryable)`; `handle_request` owns the loop and returns the last error when all keys fail. The legacy `api_key` + `fallback_keys` schema is still parsed (`config._parse_api_keys`); migration v3 → v4 rewrites it to `api_keys`. `ProviderConfig.api_key` remains as a first-key property (getter/setter) for the settings import code.
+- **Usage inspection** (`usage.py`): `flexgate status` maps `base_url` to a platform adapter (`_ADAPTERS`): MiniMax → `{origin}/v1/api/openplatform/coding_plan/remains` (only the "general" text-model quota entry is used; its counts are usually 0/0, so usage is read from the `*_remaining_percent` fields), Kimi Code → `{base}/v1/usages` (undocumented, same endpoint as the CLI's `/usage`; reports weekly quota, 5-hour window and parallel limit), z.ai → `{origin}/api/monitor/usage/quota/limit` (undocumented but used by z.ai's own plugin; personal coding plans only), bigmodel.cn → the same endpoint with `?type=2` plus `bigmodel-organization`/`bigmodel-project` headers read from the key entry's `organization`/`project` fields (team plans; also fetches the team subscription detail for plan name/expiry — a key entry without both fields gets no adapter at all and goes straight to the probe, with a hint line), USTC/LiteLLM → `{origin}/key/info`. Hosts in `_PROBE_ONLY_MARKERS` (e.g. xiaomimimo.com — no key-based usage API) and unknown platforms get the minimal chat probe: `POST /v1/messages` with input `"hi"`, `max_tokens=128`. A failed adapter call also degrades to the probe. Any key whose usage query errored — a hard failure (adapter AND probe), or an adapter error merely recovered by the probe — is recorded in `~/.flexgate/usage-cache.json` (sha256 fingerprint, never key material; entry keeps the `ok` flag and output lines) and skipped by later `status`/`usage` runs, shown as `cached (… ago)` / `cached failure (… ago)` with a hint; `flexgate usage --force` rechecks them and a clean success clears the entry. Placeholder keys are never cached.
 - **Multimodal degradation**: `MULTIMODAL_MODELS` (currently `{"MiniMax-M3", "glm-4.6v"}`) is the allowlist. Requests carrying image blocks aimed at any other model have images stripped and a `[flexgate]` text note injected into both the outgoing request and the returned response, so non-multimodal backends don't 4xx.
 - **Schedule-based overrides**: Optional time windows (e.g. 22:00-06:00) override default routes. Overnight wrap is supported.
 - **Service-first lifecycle**: `flexgate.service` is the sole persistent runtime. systemd owns restart, boot startup, logs, and process state.

{flexgate-0.7.0 → flexgate-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: flexgate
-Version: 0.7.0
+Version: 0.9.0
 Summary: Flexible local API gateway for Claude Code — route models to different providers
 Project-URL: Homepage, https://github.com/Agony5757/flexible-gateway
 Project-URL: Repository, https://github.com/Agony5757/flexible-gateway
@@ -89,6 +89,7 @@ systemd **用户服务**是 Linux 上唯一推荐的持久化运行方式，负
 ```bash
 flexgate service install             # 安装、启用并立即启动
 flexgate service install --no-start  # 仅安装并启用，不立即启动
+flexgate service install --no-claude-settings  # 跳过修改 ~/.claude/settings.json 的交互询问
 flexgate service start               # 启动；自动修复旧格式或失效的 unit
 flexgate service stop                # 停止
 flexgate service restart             # 重启
@@ -113,7 +114,7 @@ flexgate service uninstall           # 停止、禁用并删除 unit
 ```bash
 flexgate --version               # 打印版本号（service status / 裸 flexgate 也会显示）
 flexgate doctor                  # 只读体检：Python、PyPI 新版、配置 schema、端口、systemd、Claude settings、上游连通性
-flexgate doctor --offline        # 跳过 PyPI 检查
+flexgate doctor --offline        # 跳过全部网络检查（PyPI 新版检查 + 上游探测）
 flexgate update                  # 一键升级：pip/pipx/uv 升级包 + 迁移配置 schema + 热重载服务
 flexgate update --check          # 只报告将要做什么，不改动
 flexgate update --config-only    # 只迁移配置，不升级包
@@ -170,6 +171,7 @@ flexgate status --no-usage       # 跳过用量查询，只看配置
 flexgate status --usage-timeout 30
 flexgate usage                   # 只看每个 key 的用量/额度（不打印配置和路由）
 flexgate usage --usage-timeout 30
+flexgate usage --force           # 重查上次失败的 key（默认跳过，读缓存）
 ```
 
 `flexgate status` 展示当前配置中的所有 provider、每个 provider 的 key 及
@@ -190,6 +192,24 @@ fallback 链、当前生效的路由，并逐一查询**每个 key** 的用量/
 如果某平台的专用接口调用失败，flexgate 会自动退化为 minimal probe 再试一次。
 用量查询接口多为平台内部接口，可能随时变动；查询结果仅供参考。
 
+**查询失败缓存**：用量查询中报错的 key（彻底失败，或专用接口报错但 probe
+证明 key 仍可用，例如智谱的按量付费 key）会记入
+`~/.flexgate/usage-cache.json`（只存 key 指纹，不存明文），此后 `status` /
+`usage` 默认跳过这些 key 并显示缓存错误与提示（`cached failure`）；
+`flexgate usage --force` 强制重查并更新缓存，干净成功后自动恢复实时查询。
+
+### HTTP API（图像生成与结构化错误）
+
+除 `POST /v1/messages` 外，网关还提供 OpenAI 兼容的图像生成端点
+`POST /v1/images/generations`：自动发现配置中的 MiniMax provider，把请求
+翻译为 MiniMax `image-01` 文生图（模型名提示如 `gpt-image`/`dall-e` 均可，
+`size` 钳制到 512–2048 的 8 倍数，响应为 `data[].b64_json`）。
+`/v1/images/edits` 固定返回 501（上游仅支持文生图）。
+
+所有未支持的路径（如 `/v1/chat/completions`、`/v1/embeddings`、`count_tokens`）
+返回 Anthropic/OpenAI 双兼容的结构化 JSON 错误（404/405/501），而不是裸
+404。详见[HTTP API 文档](https://agony5757.github.io/flexible-gateway/api.html)。
+
 ### 前台调试
 
 `run` 是独立的顶层调试命令，不属于持久化服务模式：
@@ -244,16 +264,19 @@ flexgate config set haiku MiniMax-M3
 
 ```text
 Flexgate config  —  ~/.flexgate/config.yaml
-↑/↓ move · Enter edit tier · s save · q quit
+↑/↓ move · Enter edit · s save · q quit
 
 ▶ opus      ustc / deepseek-v4-pro
   sonnet    ustc / deepseek-v4-pro
   haiku     ustc / deepseek-v4-pro
+  fallback  ustc / deepseek-v4-pro
+  api keys  select the active key per route
 
 ○ no unsaved changes
 ```
 
-- 方向键选中某个 tier（opus/sonnet/haiku），回车进入：先从候选 **provider** 列表选择，再从该 provider 的候选 **model** 列表选择。
+- 方向键选中某个 tier（opus/sonnet/haiku）或 `fallback`（兜底路由 `.*`，未命中任何 tier 的请求走它），回车进入：先从候选 **provider** 列表选择，再从该 provider 的候选 **model** 列表选择。
+- 选中 `api keys` 回车进入：先选一条**路由**，再选它的 **active key**；key 列表会实时查询每个 key 的用量/有效性（与 `flexgate status` 相同），并标注当前 active 的 key。
 - model 列表包含：`available_models` 中的各个模型、「使用 provider 默认（首个可用模型，不写死 model）」、以及「自定义模型…」（手动输入）。
 - 按 `s` 保存（并向运行中的网关发送 SIGUSR1 热重载，**无需重启即生效**），按 `q` 退出（有未保存改动时会询问 "Config changed — activate now?"：选 Yes 立即保存并热重载生效，选 No 放弃改动）；子菜单中按 `Esc`/`←` 返回上一级。
 - 需要交互式终端（TTY）；非交互场景请改用 `flexgate config set`。
@@ -286,6 +309,7 @@ API_TIMEOUT_MS、三个 `ANTHROPIC_DEFAULT_*_MODEL`），settings.json 中的
 | `~/.flexgate/config.yaml` | 主配置文件 |
 | `~/.flexgate/service-state.json` | 最近一次成功启动所应用的 config 路径与 endpoint |
 | `~/.flexgate/update-check.json` | PyPI 新版本检查的缓存（24h 有效期） |
+| `~/.flexgate/usage-cache.json` | 用量查询失败缓存（key 指纹 + 错误文本；`usage --force` 重查后更新） |
 | `~/.config/systemd/user/flexgate.service` | 唯一的持久化服务 unit |
 | systemd journal | 服务日志（`flexgate log`，即 `journalctl --user -u flexgate`） |
 
@@ -313,6 +337,13 @@ providers:
       - key: "your-minimax-api-key-2"
         note: "备用账号"
       - "your-minimax-api-key-3"   # 纯字符串写法（无备注）
+  zhipu-team:
+    base_url: "https://open.bigmodel.cn/api/anthropic"
+    api_keys:
+      - key: "your-zhipu-team-api-key"
+        note: "队友名"
+        organization: "org-XXXXXXXX"  # 智谱团队版 key：组织/项目 ID
+        project: "proj_XXXXXXXX"      # （flexgate usage 查团队套餐额度用）
 
 claude_settings:
   default_opus_model: "claude-opus-4-7"
@@ -337,6 +368,7 @@ routes:                          # 从上到下匹配，首个命中生效
   - pattern: "^claude-sonnet"
     provider: minimax
     model: "MiniMax-M3"
+    active_key: 2               # 可选：该路由从 minimax 的第 2 个 key 开始用（1 起始，默认 1）
   - pattern: "^claude-haiku"
     provider: minimax
     model: "MiniMax-M3"
@@ -351,12 +383,13 @@ routes:                          # 从上到下匹配，首个命中生效
 |------|------|
 | `server.host/port` | 网关监听地址 |
 | `providers.<name>.base_url` | Provider 的 API 地址 |
-| `providers.<name>.api_keys` | API key 列表（一个或多个，互为 fallback）；每项为 key 字符串或 `{key, note}`，`note` 是存在配置里的备注 |
+| `providers.<name>.api_keys` | API key 列表（一个或多个，互为 fallback）；每项为 key 字符串或 `{key, note}`（`note` 是备注）。智谱团队版 key 还可加 `organization`/`project`（团队组织/项目 ID），供 `flexgate usage` 查询团队套餐额度 |
 | `providers.<name>.available_models` | 该 provider 的可用模型列表，首个条目作为路由省略 `model` 时的回退模型 |
 | `claude_settings.*` | 写入 settings.json 的模型和超时配置 |
-| `routes[].pattern` | 正则匹配请求中的 model 字段 |
+| `routes[].pattern` | 正则匹配请求中的 model 字段（匹配前归一化裸别名 `sonnet`/`opus`/`haiku`/`default` 与旧编号名） |
 | `routes[].provider` | 路由到的 provider 名称 |
 | `routes[].model` | 可选，替换发给 provider 的模型名 |
+| `routes[].active_key` | 可选，1 起始的 provider api_keys 序号，该路由的请求从哪个 key 开始（默认 1，即第一个 key） |
 | `schedule[].name` | 定时规则名称 |
 | `schedule[].start/end` | 时间窗口（HH:MM 格式，支持跨夜如 22:00-06:00） |
 | `schedule[].routes` | 该时间窗口内生效的路由（格式同 `routes`） |
@@ -368,7 +401,13 @@ routes:                          # 从上到下匹配，首个命中生效
 `{key, note}` 加一个存在配置里的备注（`flexgate status` 和 fallback 日志
 都会显示 note，方便分辨是哪个账号的 key）：
 
-- 请求先走第一个 key；失败时按列表顺序自动重试后续 key，直到某个 key
+- 每条路由有一个「当前 key」指针（路由上的 `active_key`，默认指向
+  provider 的第一个 key）：该路由的请求从指针指向的 key 开始；key 失败
+  时自动换用下一个 key（循环一圈），指针也随之自动前进——后续请求直接
+  从能用的 key 开始。**所有 key 轮换一圈都失败时，请求返回最后一次的
+  错误**。指针的运行时前进只存在于网关进程内存中，不写回配置文件；
+  可通过 `flexgate config edit` → "api keys" 交互切换。
+- 请求先走 active key；失败时按列表顺序自动重试后续 key，直到某个 key
   成功或返回不可重试的错误。
 - 触发切换的条件：HTTP **401 / 402 / 403 / 429 / 500 / 502 / 503 / 529**
   （key 失效、余额/额度耗尽、限流、平台过载）以及连接错误、超时。
@@ -378,6 +417,10 @@ routes:                          # 从上到下匹配，首个命中生效
 - 每次切换都会在服务日志中留下记录（key 只显示前后各 4 位）。
 - 用 `flexgate status` 可以查看每个 provider 的 fallback 链和每个 key 的
   实时用量。
+- 智谱 GLM Coding Plan **团队版** key 在条目上配 `organization`/`project`
+  （团队组织/项目 ID）后，`flexgate status`/`usage` 会用团队版接口查询
+  套餐名、有效期和 5 小时/每周积分窗口；未配置这两个字段的 key 只做
+  连通性探测。
 - 旧版 `api_key` + `fallback_keys` 写法仍然兼容，`flexgate update` 会
   自动迁移为 `api_keys` 列表（config_version 3 → 4）。
 

{flexgate-0.7.0 → flexgate-0.9.0}/README.md

@@ -72,6 +72,7 @@ systemd **用户服务**是 Linux 上唯一推荐的持久化运行方式，负
 ```bash
 flexgate service install             # 安装、启用并立即启动
 flexgate service install --no-start  # 仅安装并启用，不立即启动
+flexgate service install --no-claude-settings  # 跳过修改 ~/.claude/settings.json 的交互询问
 flexgate service start               # 启动；自动修复旧格式或失效的 unit
 flexgate service stop                # 停止
 flexgate service restart             # 重启
@@ -96,7 +97,7 @@ flexgate service uninstall           # 停止、禁用并删除 unit
 ```bash
 flexgate --version               # 打印版本号（service status / 裸 flexgate 也会显示）
 flexgate doctor                  # 只读体检：Python、PyPI 新版、配置 schema、端口、systemd、Claude settings、上游连通性
-flexgate doctor --offline        # 跳过 PyPI 检查
+flexgate doctor --offline        # 跳过全部网络检查（PyPI 新版检查 + 上游探测）
 flexgate update                  # 一键升级：pip/pipx/uv 升级包 + 迁移配置 schema + 热重载服务
 flexgate update --check          # 只报告将要做什么，不改动
 flexgate update --config-only    # 只迁移配置，不升级包
@@ -153,6 +154,7 @@ flexgate status --no-usage       # 跳过用量查询，只看配置
 flexgate status --usage-timeout 30
 flexgate usage                   # 只看每个 key 的用量/额度（不打印配置和路由）
 flexgate usage --usage-timeout 30
+flexgate usage --force           # 重查上次失败的 key（默认跳过，读缓存）
 ```
 
 `flexgate status` 展示当前配置中的所有 provider、每个 provider 的 key 及
@@ -173,6 +175,24 @@ fallback 链、当前生效的路由，并逐一查询**每个 key** 的用量/
 如果某平台的专用接口调用失败，flexgate 会自动退化为 minimal probe 再试一次。
 用量查询接口多为平台内部接口，可能随时变动；查询结果仅供参考。
 
+**查询失败缓存**：用量查询中报错的 key（彻底失败，或专用接口报错但 probe
+证明 key 仍可用，例如智谱的按量付费 key）会记入
+`~/.flexgate/usage-cache.json`（只存 key 指纹，不存明文），此后 `status` /
+`usage` 默认跳过这些 key 并显示缓存错误与提示（`cached failure`）；
+`flexgate usage --force` 强制重查并更新缓存，干净成功后自动恢复实时查询。
+
+### HTTP API（图像生成与结构化错误）
+
+除 `POST /v1/messages` 外，网关还提供 OpenAI 兼容的图像生成端点
+`POST /v1/images/generations`：自动发现配置中的 MiniMax provider，把请求
+翻译为 MiniMax `image-01` 文生图（模型名提示如 `gpt-image`/`dall-e` 均可，
+`size` 钳制到 512–2048 的 8 倍数，响应为 `data[].b64_json`）。
+`/v1/images/edits` 固定返回 501（上游仅支持文生图）。
+
+所有未支持的路径（如 `/v1/chat/completions`、`/v1/embeddings`、`count_tokens`）
+返回 Anthropic/OpenAI 双兼容的结构化 JSON 错误（404/405/501），而不是裸
+404。详见[HTTP API 文档](https://agony5757.github.io/flexible-gateway/api.html)。
+
 ### 前台调试
 
 `run` 是独立的顶层调试命令，不属于持久化服务模式：
@@ -227,16 +247,19 @@ flexgate config set haiku MiniMax-M3
 
 ```text
 Flexgate config  —  ~/.flexgate/config.yaml
-↑/↓ move · Enter edit tier · s save · q quit
+↑/↓ move · Enter edit · s save · q quit
 
 ▶ opus      ustc / deepseek-v4-pro
   sonnet    ustc / deepseek-v4-pro
   haiku     ustc / deepseek-v4-pro
+  fallback  ustc / deepseek-v4-pro
+  api keys  select the active key per route
 
 ○ no unsaved changes
 ```
 
-- 方向键选中某个 tier（opus/sonnet/haiku），回车进入：先从候选 **provider** 列表选择，再从该 provider 的候选 **model** 列表选择。
+- 方向键选中某个 tier（opus/sonnet/haiku）或 `fallback`（兜底路由 `.*`，未命中任何 tier 的请求走它），回车进入：先从候选 **provider** 列表选择，再从该 provider 的候选 **model** 列表选择。
+- 选中 `api keys` 回车进入：先选一条**路由**，再选它的 **active key**；key 列表会实时查询每个 key 的用量/有效性（与 `flexgate status` 相同），并标注当前 active 的 key。
 - model 列表包含：`available_models` 中的各个模型、「使用 provider 默认（首个可用模型，不写死 model）」、以及「自定义模型…」（手动输入）。
 - 按 `s` 保存（并向运行中的网关发送 SIGUSR1 热重载，**无需重启即生效**），按 `q` 退出（有未保存改动时会询问 "Config changed — activate now?"：选 Yes 立即保存并热重载生效，选 No 放弃改动）；子菜单中按 `Esc`/`←` 返回上一级。
 - 需要交互式终端（TTY）；非交互场景请改用 `flexgate config set`。
@@ -269,6 +292,7 @@ API_TIMEOUT_MS、三个 `ANTHROPIC_DEFAULT_*_MODEL`），settings.json 中的
 | `~/.flexgate/config.yaml` | 主配置文件 |
 | `~/.flexgate/service-state.json` | 最近一次成功启动所应用的 config 路径与 endpoint |
 | `~/.flexgate/update-check.json` | PyPI 新版本检查的缓存（24h 有效期） |
+| `~/.flexgate/usage-cache.json` | 用量查询失败缓存（key 指纹 + 错误文本；`usage --force` 重查后更新） |
 | `~/.config/systemd/user/flexgate.service` | 唯一的持久化服务 unit |
 | systemd journal | 服务日志（`flexgate log`，即 `journalctl --user -u flexgate`） |
 
@@ -296,6 +320,13 @@ providers:
       - key: "your-minimax-api-key-2"
         note: "备用账号"
       - "your-minimax-api-key-3"   # 纯字符串写法（无备注）
+  zhipu-team:
+    base_url: "https://open.bigmodel.cn/api/anthropic"
+    api_keys:
+      - key: "your-zhipu-team-api-key"
+        note: "队友名"
+        organization: "org-XXXXXXXX"  # 智谱团队版 key：组织/项目 ID
+        project: "proj_XXXXXXXX"      # （flexgate usage 查团队套餐额度用）
 
 claude_settings:
   default_opus_model: "claude-opus-4-7"
@@ -320,6 +351,7 @@ routes:                          # 从上到下匹配，首个命中生效
   - pattern: "^claude-sonnet"
     provider: minimax
     model: "MiniMax-M3"
+    active_key: 2               # 可选：该路由从 minimax 的第 2 个 key 开始用（1 起始，默认 1）
   - pattern: "^claude-haiku"
     provider: minimax
     model: "MiniMax-M3"
@@ -334,12 +366,13 @@ routes:                          # 从上到下匹配，首个命中生效
 |------|------|
 | `server.host/port` | 网关监听地址 |
 | `providers.<name>.base_url` | Provider 的 API 地址 |
-| `providers.<name>.api_keys` | API key 列表（一个或多个，互为 fallback）；每项为 key 字符串或 `{key, note}`，`note` 是存在配置里的备注 |
+| `providers.<name>.api_keys` | API key 列表（一个或多个，互为 fallback）；每项为 key 字符串或 `{key, note}`（`note` 是备注）。智谱团队版 key 还可加 `organization`/`project`（团队组织/项目 ID），供 `flexgate usage` 查询团队套餐额度 |
 | `providers.<name>.available_models` | 该 provider 的可用模型列表，首个条目作为路由省略 `model` 时的回退模型 |
 | `claude_settings.*` | 写入 settings.json 的模型和超时配置 |
-| `routes[].pattern` | 正则匹配请求中的 model 字段 |
+| `routes[].pattern` | 正则匹配请求中的 model 字段（匹配前归一化裸别名 `sonnet`/`opus`/`haiku`/`default` 与旧编号名） |
 | `routes[].provider` | 路由到的 provider 名称 |
 | `routes[].model` | 可选，替换发给 provider 的模型名 |
+| `routes[].active_key` | 可选，1 起始的 provider api_keys 序号，该路由的请求从哪个 key 开始（默认 1，即第一个 key） |
 | `schedule[].name` | 定时规则名称 |
 | `schedule[].start/end` | 时间窗口（HH:MM 格式，支持跨夜如 22:00-06:00） |
 | `schedule[].routes` | 该时间窗口内生效的路由（格式同 `routes`） |
@@ -351,7 +384,13 @@ routes:                          # 从上到下匹配，首个命中生效
 `{key, note}` 加一个存在配置里的备注（`flexgate status` 和 fallback 日志
 都会显示 note，方便分辨是哪个账号的 key）：
 
-- 请求先走第一个 key；失败时按列表顺序自动重试后续 key，直到某个 key
+- 每条路由有一个「当前 key」指针（路由上的 `active_key`，默认指向
+  provider 的第一个 key）：该路由的请求从指针指向的 key 开始；key 失败
+  时自动换用下一个 key（循环一圈），指针也随之自动前进——后续请求直接
+  从能用的 key 开始。**所有 key 轮换一圈都失败时，请求返回最后一次的
+  错误**。指针的运行时前进只存在于网关进程内存中，不写回配置文件；
+  可通过 `flexgate config edit` → "api keys" 交互切换。
+- 请求先走 active key；失败时按列表顺序自动重试后续 key，直到某个 key
   成功或返回不可重试的错误。
 - 触发切换的条件：HTTP **401 / 402 / 403 / 429 / 500 / 502 / 503 / 529**
   （key 失效、余额/额度耗尽、限流、平台过载）以及连接错误、超时。
@@ -361,6 +400,10 @@ routes:                          # 从上到下匹配，首个命中生效
 - 每次切换都会在服务日志中留下记录（key 只显示前后各 4 位）。
 - 用 `flexgate status` 可以查看每个 provider 的 fallback 链和每个 key 的
   实时用量。
+- 智谱 GLM Coding Plan **团队版** key 在条目上配 `organization`/`project`
+  （团队组织/项目 ID）后，`flexgate status`/`usage` 会用团队版接口查询
+  套餐名、有效期和 5 小时/每周积分窗口；未配置这两个字段的 key 只做
+  连通性探测。
 - 旧版 `api_key` + `fallback_keys` 写法仍然兼容，`flexgate update` 会
   自动迁移为 `api_keys` 列表（config_version 3 → 4）。
 

{flexgate-0.7.0 → flexgate-0.9.0}/config.yaml.template

@@ -8,6 +8,9 @@ server:
 # 日志都会显示）。某个 key 遇到 401/402/403/429/5xx/529 或连接错误（如额度
 # 用尽、平台过载）时，按顺序自动切换到下一个 key 重试。同一上游的多个账号
 # 应这样配置，而不是拆成多个 provider。
+# 智谱 GLM Coding Plan 团队版 key 还需在 key 条目上配置 organization 和
+# project（团队组织/项目 ID，从团队用量页的浏览器请求头里一次性获取）；
+# flexgate usage 依赖这两个字段查询团队套餐额度，未配置则只做连通性探测。
 providers:
   minimax:
     base_url: "https://api.minimaxi.com/anthropic"
@@ -26,6 +29,15 @@ providers:
     available_models:
       - "glm-5.3"      # 路由省略 model 时的回退模型
       - "glm-4.6v"
+  zhipu-team:
+    base_url: "https://open.bigmodel.cn/api/anthropic"
+    api_keys:
+      - key: "your-zhipu-team-api-key"
+        note: "队友名"
+        organization: "org-XXXXXXXX"    # 智谱团队版：组织 ID
+        project: "proj_XXXXXXXX"        # 智谱团队版：项目 ID
+    available_models:
+      - "glm-5.3"
   xiaomi:
     base_url: "https://token-plan-cn.xiaomimimo.com/anthropic"
     api_keys:

flexgate-0.9.0/docs/api.md

@@ -0,0 +1,66 @@
+# HTTP API
+
+Flexgate 在本地监听（默认 `127.0.0.1:8765`）提供以下端点：
+
+| 端点 | 说明 |
+|------|------|
+| `POST /v1/messages` | Anthropic Messages API 代理（核心端点） |
+| `POST /v1/images/generations` | OpenAI 兼容图像生成（转 MiniMax `image-01`） |
+| `POST /v1/images/edits` | 固定返回 501（上游仅支持文生图） |
+| 其他路径 | 结构化 JSON 错误（404 / 405 / 501，见下文） |
+
+## POST /v1/messages
+
+标准的 Anthropic Messages 格式代理。请求体中的 `model` 字段用于路由：
+
+- **模型别名归一化**：匹配路由前，裸别名（`sonnet` / `opus` / `haiku` /
+  `default`，大小写不敏感，可带 `[plan]` 后缀）映射为对应的
+  `claude-<tier>` 前缀（`default` → sonnet）；旧编号名
+  （如 `claude-3-7-sonnet-latest`）归约为 tier 前缀；其余名称原样匹配。
+- 命中路由后，仅当路由显式配置了 `model` 时才改写上游请求的 model 字段；
+  认证头替换为该 provider 当前 active key 的 `x-api-key`。
+- 流式（SSE）响应按原始字节透传，不做解析；非流式 JSON 原样转发。
+- key 级 fallback：可重试错误按 `api_keys` 顺序切换（详见
+  [配置文件](configuration.md#key-fallback)）。
+- **多模态降级**：请求携带图片块且目标模型不在多模态允许列表
+  （`MULTIMODAL_MODELS`，当前为 `MiniMax-M3`、`glm-4.6v`）中时，图片会被
+  剥离，并在请求与响应中注入 `[flexgate]` 文本说明，避免非多模态上游报 4xx。
+
+## POST /v1/images/generations
+
+OpenAI Images API 兼容端点，让 OpenAI 风格的客户端无需任何额外配置即可
+通过网关生成图片：
+
+- **上游自动发现**：使用配置中 `base_url` 指向 MiniMax
+  （`api.minimaxi.com` / `api.minimax.io`）的 provider 及其 key，无需单独
+  配置图像 provider。
+- **模型名映射**：请求中的 `model` 含已知图像模型提示（`gpt-image`、
+  `dall-e`、`image-01`、`seedream`、`flux`、`sdxl`、`stable-diffusion`、
+  `minimax` 等）即接受并映射为 MiniMax 的 `image-01`；无法识别的模型名
+  返回 501 `model_not_supported`。
+- **尺寸**：`size: "WxH"` 映射为 width/height，各边钳制到 512–2048 并取
+  8 的倍数；无法解析的 size 忽略（用上游默认值）。
+- **prompt** 超过 1500 字符会被截断。
+- **响应**：MiniMax 返回的 `data.image_base64[]`（JPEG）原样转发为 OpenAI
+  风格的 `data[].b64_json`，不引入转码依赖。
+
+## POST /v1/images/edits
+
+固定返回 501：MiniMax `image-01` 仅支持文生图，没有通用的图像编辑 /
+inpainting 能力。
+
+## 未支持端点的结构化错误
+
+所有未匹配的请求都不会得到裸 404，而是返回 Anthropic / OpenAI 双兼容
+的 JSON 错误体，客户端可以据此判断"端口错了"还是"网关不支持该能力"：
+
+```json
+{"type": "error", "error": {"type": "...", "message": "...", "code": "..."}}
+```
+
+| 状态码 | code | 触发条件 |
+|--------|------|----------|
+| 404 | `route_not_found` | 完全未知的路径；message 中列出全部有效路由 |
+| 405 | `method_not_allowed` | 路径有效但 HTTP 方法不对 |
+| 501 | `endpoint_not_supported` | 识别出的 API 家族但网关不服务（`/v1/chat/completions`、`/v1/responses`、`/v1/messages/count_tokens`、`/v1/embeddings` 等），message 给出可操作的建议 |
+| 501 | `capability_not_supported` / `model_not_supported` | 有效路由上不支持的操作或模型名（由所属模块返回） |

{flexgate-0.7.0 → flexgate-0.9.0}/docs/cli.md

@@ -19,6 +19,7 @@ systemd **用户服务**是 Linux 上唯一推荐的持久化运行方式，负
 ```bash
 flexgate service install             # 安装、启用并立即启动
 flexgate service install --no-start  # 仅安装并启用，不立即启动
+flexgate service install --no-claude-settings  # 跳过修改 ~/.claude/settings.json 的交互询问
 flexgate service start               # 启动；自动修复旧格式或失效的 unit
 flexgate service stop                # 停止
 flexgate service restart             # 重启
@@ -55,9 +56,13 @@ flexgate status --no-usage       # 跳过用量查询，只看配置
 flexgate status --usage-timeout 30
 flexgate usage                   # 只看每个 key 的用量/额度（不打印配置和路由）
 flexgate usage --usage-timeout 30
+flexgate usage --force           # 重查上次失败的 key（默认跳过，读缓存）
 ```
 
-各平台的用量查询适配器详见[用量查询](usage.md)。
+查询失败的 key 会被缓存并在此后的 `status` / `usage` 中默认跳过
+（显示为 `cached failure` 并附带提示），`--force` 强制重新查询；
+详见[用量查询](usage.md)。各平台的用量查询适配器同样见
+[用量查询](usage.md)。
 
 ## 查看日志（log）
 

{flexgate-0.7.0 → flexgate-0.9.0}/docs/conf.py

@@ -29,6 +29,9 @@ myst_enable_extensions = [
     "linkify",
 ]
 
+# Allow cross-document links to implicit heading anchors (e.g. configuration.md#key-fallback)
+myst_heading_anchors = 3
+
 source_suffix = {".md": "markdown"}
 templates_path = ["_templates"]
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]

{flexgate-0.7.0 → flexgate-0.9.0}/docs/configuration.md

@@ -7,6 +7,7 @@
 | `~/.flexgate/config.yaml` | 主配置文件 |
 | `~/.flexgate/service-state.json` | 最近一次成功启动所应用的 config 路径与 endpoint |
 | `~/.flexgate/update-check.json` | PyPI 新版本检查的缓存（24h 有效期） |
+| `~/.flexgate/usage-cache.json` | 用量查询失败缓存（key 指纹 + 错误文本；`usage --force` 重查后更新，见[用量查询](usage.md)） |
 | `~/.config/systemd/user/flexgate.service` | 唯一的持久化服务 unit |
 | systemd journal | 服务日志（`flexgate log`，即 `journalctl --user -u flexgate`） |
 
@@ -36,6 +37,13 @@ providers:
       - key: "your-minimax-api-key-2"
         note: "备用账号"
       - "your-minimax-api-key-3"   # 纯字符串写法（无备注）
+  zhipu-team:
+    base_url: "https://open.bigmodel.cn/api/anthropic"
+    api_keys:
+      - key: "your-zhipu-team-api-key"
+        note: "队友名"
+        organization: "org-XXXXXXXX"  # 智谱团队版 key：组织/项目 ID
+        project: "proj_XXXXXXXX"      # （flexgate usage 查团队套餐额度用）
 
 claude_settings:
   default_opus_model: "claude-opus-4-7"
@@ -75,7 +83,7 @@ routes:                          # 从上到下匹配，首个命中生效
 |------|------|
 | `server.host/port` | 网关监听地址 |
 | `providers.<name>.base_url` | Provider 的 API 地址 |
-| `providers.<name>.api_keys` | API key 列表（一个或多个，互为 fallback）；每项为 key 字符串或 `{key, note}`，`note` 是存在配置里的备注 |
+| `providers.<name>.api_keys` | API key 列表（一个或多个，互为 fallback）；每项为 key 字符串或 `{key, note}`（`note` 是备注）。智谱团队版 key 还可加 `organization`/`project`（团队组织/项目 ID），供 `flexgate usage` 查询团队套餐额度 |
 | `providers.<name>.available_models` | 该 provider 的可用模型列表，首个条目作为路由省略 `model` 时的回退模型 |
 | `claude_settings.*` | 写入 settings.json 的模型和超时配置 |
 | `routes[].pattern` | 正则匹配请求中的 model 字段 |
@@ -108,6 +116,10 @@ routes:                          # 从上到下匹配，首个命中生效
   当前使用的 key 和每个 key 的实时用量；在 `flexgate config edit` 交互
   界面的「api keys」入口可以按路由查看各 key 的实时用量/有效性并切换
   active key。
+- 智谱 GLM Coding Plan **团队版** key 在条目上配 `organization`/`project`
+  （团队组织/项目 ID）后，`flexgate status`/`usage` 会用团队版接口查询
+  套餐名、有效期和 5 小时/每周积分窗口；未配置这两个字段的 key 只做
+  连通性探测（团队 key 不适用个人版查询接口）。
 - 旧版 `api_key` + `fallback_keys` 写法仍然兼容，`flexgate update` 会
   自动迁移为 `api_keys` 列表（config_version 3 → 4）；路由上的
   `active_key` 字段在 config_version 5 引入，旧配置的每条路由默认指向

{flexgate-0.7.0 → flexgate-0.9.0}/docs/development.md

@@ -9,8 +9,11 @@
 | `flexgate/config.py` | dataclass 配置模型（`GatewayConfig`、`ProviderConfig`、`RouteConfig` 等），YAML 加载/保存，`is_placeholder_key` |
 | `flexgate/router.py` | `resolve(config, model)` — 先定时路由后默认路由，首个正则命中生效；匹配前归一化模型别名（`sonnet`/`claude-3-7-sonnet-latest` → `^claude-<tier>`） |
 | `flexgate/proxy.py` | `handle_request()` — httpx 异步代理，per-key fallback 重试，SSE 流式 + JSON 透传；记录每个请求由哪把 key 服务 |
-| `flexgate/usage.py` | `flexgate status` / `flexgate usage` 的用量查询 — 各平台适配器 + minimal chat probe 兜底 |
-| `flexgate/server.py` | Starlette 应用，`POST /v1/messages` 端点，SIGUSR1 热重载 |
+| `flexgate/usage.py` | `flexgate status` / `flexgate usage` 的用量查询 — 各平台适配器 + minimal chat probe 兜底 + 查询失败缓存（`usage --force` 强制重查） |
+| `flexgate/server.py` | Starlette 应用，`POST /v1/messages` + `POST /v1/images/{generations,edits}` 端点，SIGUSR1 热重载 |
+| `flexgate/images.py` | OpenAI Images API → MiniMax `/v1/image_generation` 翻译（模型名映射、size 钳制、`b64_json` 透传；edits 返回 501） |
+| `flexgate/fallback.py` | 兜底路由：所有未服务路径返回 Anthropic/OpenAI 双兼容的结构化 JSON 错误（404 `route_not_found` / 405 / 501 `endpoint_not_supported`） |
+| `flexgate/main.py` | 启动引导：加载配置 → 创建 app → 跑 uvicorn |
 | `flexgate/service.py` | systemd 用户服务的安装/启停/重载/状态（持久化运行的唯一入口）；journal 日志查看 |
 | `flexgate/healthcheck.py` | 上游连通性探测（`POST /v1/messages`，`max_tokens=1`），由 `doctor` 调用（`flexgate check` 为弃用别名） |
 | `flexgate/settings.py` | config.yaml ↔ `~/.claude/settings.json` 双向桥接（apply 非破坏性：只改托管 env 键） |

{flexgate-0.7.0 → flexgate-0.9.0}/docs/index.md

@@ -23,12 +23,17 @@ Claude Code → localhost:8765 → opus  → z.ai (glm-5.1)
 
 ## 特性一览
 
-- **按 model 路由**：正则匹配请求中的 model 字段，首个命中生效，支持兜底路由
+- **按 model 路由**：正则匹配请求中的 model 字段，首个命中生效，支持兜底路由；
+  裸别名（`sonnet`/`opus`/`haiku`）与旧编号名自动归一化
 - **定时路由**：按时间窗口自动切换路由（支持跨夜，如 22:00-06:00）
 - **多 key fallback**：同一上游配置多个 key，遇到 401/402/403/429/5xx/529
   或连接错误时自动切换到下一个 key
+- **多模态降级**：非多模态模型的请求自动剥离图片块并注入说明，避免上游 4xx
+- **OpenAI 兼容图像生成**：`POST /v1/images/generations` 自动转 MiniMax
+  `image-01`，详见 [HTTP API](api.md)
 - **用量查询**：`flexgate status` / `flexgate usage` 按平台适配器查询每个
-  key 的实时额度（MiniMax、Kimi Code、z.ai、LiteLLM 等）
+  key 的实时额度（MiniMax、Kimi Code、z.ai、LiteLLM 等）；查询失败的 key
+  自动缓存跳过，`usage --force` 强制重查
 - **Claude Code settings 管理**：import / apply 双向同步
 - **配置同步**：`flexgate sync` 通过 confsync 服务器加密同步配置
 - **自愈升级**：`flexgate doctor` 体检、`flexgate update` 一键升级并迁移配置
@@ -40,6 +45,7 @@ Claude Code → localhost:8765 → opus  → z.ai (glm-5.1)
 
 quickstart
 configuration
+api
 cli
 usage
 development

flexgate-0.9.0/docs/usage.md

@@ -0,0 +1,77 @@
+# 用量查询
+
+`flexgate status` 和 `flexgate usage` 会逐一查询**每个 key** 的用量/额度。
+各平台的查询方式差异很大（有的平台根本没有可用的接口），flexgate 按
+`base_url` 自动选择适配器：
+
+| 平台 | 查询方式 | 说明 |
+|------|----------|------|
+| MiniMax（api.minimaxi.com / api.minimax.io） | `GET /v1/api/openplatform/coding_plan/remains`（Bearer 认证，复用 provider key） | 官方 token plan 接口，返回 5 小时窗口和周窗口的**剩余**次数（注意响应里 `*_usage_count` 字段实际是剩余量） |
+| Kimi Code（api.kimi.com） | `GET {base}/v1/usages`（Bearer 认证，复用 provider key） | 未公开文档、与 Kimi Code CLI `/usage` 相同的接口，返回周配额、5 小时滚动窗口剩余量和并发上限 |
+| z.ai 个人版（api.z.ai） | `GET /api/monitor/usage/quota/limit`（Authorization 直接带 key） | 未公开文档、但 z.ai 官方 coding 插件在用的接口，返回各窗口已用百分比与重置时间。**仅对 GLM Coding Plan 个人订阅有效**：按量付费 key 会返回"当前用户不存在coding plan"并退化为 probe |
+| 智谱团队版（open.bigmodel.cn） | `GET /api/monitor/usage/quota/limit?type=2`，带 `bigmodel-organization`/`bigmodel-project` 头（取自 key 条目的 `organization`/`project` 字段） | 同一 monitor 接口的团队版变体，返回 5 小时/每周窗口的积分用量（绝对值 + 百分比 + 重置时间）；另查 `querySubscribeDetail` 显示套餐名与有效期。**key 条目未配 `organization`/`project` 时不查询**，退化为 probe（团队 key 不适用个人版接口） |
+| USTC（api.llm.ustc.edu.cn，LiteLLM） | `GET /key/info`（Bearer 认证） | LiteLLM proxy 自带的 key 信息接口，返回 spend / max_budget / 限速等 |
+| 小米 MiMo（token-plan-cn.xiaomimimo.com） | **无 key 可用的官方接口**（控制台内部接口需要浏览器 cookie，不采用） | 退化为 minimal probe |
+| 其他/未知平台 | minimal chat probe | 发一条输入 `"hi"`、`max_tokens=128` 的最小 `/v1/messages` 请求，验证 key 是否还能正常服务（会消耗极少量额度） |
+
+如果某平台的专用接口调用失败，flexgate 会自动退化为 minimal probe 再试
+一次。
+
+:::{caution}
+用量查询接口多为平台内部接口，可能随时变动；查询结果仅供参考。
+:::
+
+## 查询失败缓存与 `--force`
+
+用量查询中**报错的 key**（彻底失败，或专用接口报错但 probe 证明 key 仍
+可用）会记录到 `~/.flexgate/usage-cache.json`（只存 key 的 sha256 指纹和
+结果文本，不存 key 明文），此后 `flexgate status` / `flexgate usage`
+默认**跳过**这些 key——不再发起任何网络请求，直接显示缓存的错误和一行
+提示：
+
+```text
+Usage (timeout 15s per key)
+  2 key(s) skipped — last check failed (recheck with: flexgate usage --force)
+  zai
+    ✓ key #1 (9f2c***abCD)  cached (15s ago)
+        z.ai quota API (unofficial) failed (platform error: 当前用户不存在coding plan); probe: key can serve glm-5.3
+        recheck with: flexgate usage --force
+  ustc
+    ✗ key #1 (sk-G***jJYg)  cached failure (8s ago)
+        LiteLLM /key/info failed (ConnectError: ); probe: ConnectError:
+        recheck with: flexgate usage --force
+```
+
+- 跳过的 key 按**上次结果**显示状态：key 仍可用的显示暗色 ✓ +
+  `cached (… ago)`，彻底失败的显示暗色 ✗ + `cached failure (… ago)`。
+- `flexgate usage --force` 忽略缓存、重新查询所有 key 并更新缓存；
+  重查干净成功（无任何报错）的 key 会自动清除缓存条目，恢复默认实时查询。
+- 占位符 key（未填写的默认值）不会进入缓存。
+
+## 输出示例
+
+```text
+Usage (timeout 15s per key):
+  minimax:
+    ✓ key #1 (sk-c***abcd) [main]  MiniMax coding_plan API
+        MiniMax-M3: 5h window remaining 450/450 (reset 08-24 00:00); weekly remaining 900/900 (reset 08-24 00:00)
+  kimi:
+    ✓ key #1 (sk-k***66N6) [ywj]  Kimi Code usages API (unofficial)
+        plan: advanced
+        weekly remaining 63/100 (reset 08-28 22:17)
+        5h window remaining 74/100 (reset 08-23 14:17)
+        parallel limit: 30
+  zhipu-team:
+    ✓ key #2 (ddb6***oZoj) [zhangsiyi]  zhipu team quota API (unofficial)
+        plan: 团队套餐高级版 (until 2026-10-14, auto-renew off)
+        5h window: used 264/35000 credits (1%), reset 09-25 14:00
+        weekly window: used 93043/155000 credits (60%), reset 09-28 16:17
+```
+
+## 新增平台适配器
+
+适配器登记在 `flexgate/usage.py` 的 `_ADAPTERS` 列表中：每条是
+`(url 子串, 适配器协程, 方法标签)`，首个命中生效。bigmodel.cn 的团队版
+适配器额外要求 key 条目上配置 `organization`/`project`，否则视为无适配
+接口。已知没有 key 可用接口的平台放入 `_PROBE_ONLY_MARKERS`，直接走
+probe，避免浪费一次失败的 HTTP 请求。

{flexgate-0.7.0 → flexgate-0.9.0}/flexgate/__init__.py

@@ -1,3 +1,3 @@
 """Flexgate — Flexible API Gateway for Claude Code."""
 
-__version__ = "0.7.0"
+__version__ = "0.9.0"