coding-proxy 0.2.4a5__tar.gz → 0.3.0a2__tar.gz

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 ## [Unreleased]
 
+- feat(server): 默认监听端口 `8046` → `3392`，避免与常见企业端口段冲突；BREAKING: 已将端口固化进客户端 `ANTHROPIC_BASE_URL` / SDK `base_url` / 监控看板 URL 的用户需同步更新，或显式通过 `--port 8046` / `server.port: 8046` 回退到旧值；
+- feat(native-api): 原生 API 透传三家 provider (`openai` / `gemini` / `anthropic`) `enabled` 默认由 `false` → `true` 开箱即用；`config.default.yaml` 顶层追加 `native_api:` 实体配置块（首次启动自动拷贝至 `~/.coding-proxy/config.yaml`，用户直接编辑 `base_url` 即可将上游切换至第三方代理）；同时新增 `NATIVE_OPENAI_BASE_URL` / `NATIVE_GEMINI_BASE_URL` / `NATIVE_ANTHROPIC_BASE_URL` 三枚环境变量覆写通道（空串/纯空白视作未设置），三级优先级 **env > yaml > 内置默认** 由 `NativeApiConfig._apply_env_overrides` `@model_validator(mode="after")` 统一注入；BREAKING: 升级后 `/api/{openai,gemini,anthropic}/**` 默认暴露，proxy 仍不保管凭据（`Authorization` / `x-api-key` / `?key=` 均由客户端透传），如需关闭显式设置 `native_api.<provider>.enabled: false`；
+- feat(native-api): 新增 `/api/{openai,gemini,anthropic}/**` 原生 LLM API 全量 catch-all 透传通道——客户端只需改 SDK `base_url` 即可复用 proxy 链路访问 OpenAI / Gemini / Anthropic 官方 API，认证完全透传不保管凭据；核心由 `NativeProxyHandler` + `OperationClassifier` + `NativeUsageExtractor` Registry 三件套组成，与既有 `/v1/messages` Claude Code 链路正交共存、零回归；首版覆盖 chat / completions / responses / embeddings / audio / image / count_tokens / moderations / cachedContents / messages / batches 等全量端点；
+- feat(usage): `usage_log` 新增 `client_category` / `operation` / `endpoint` / `extra_usage_json` 四列（全部 `DEFAULT`、幂等迁移），区分 Claude Code 场景（`'cc'`）与原生 API 场景（`'api'`），承载规范化操作名与非规范 token 字段（reasoning / audio / thoughts / server_tool_use 等）；`query_usage` 支持按新列过滤，`_PERIOD_SQL` 聚合追加 `client_category, operation` 维度；
+- feat(usage-parser): `parse_usage_from_chunk` 扩展识别 Gemini SSE `usageMetadata.*`（promptTokenCount / candidatesTokenCount / cachedContentTokenCount / thoughtsTokenCount / toolUsePromptTokenCount），新增 `gemini_usage_metadata` evidence kind，既有 Anthropic/OpenAI 分支行为零变更；
+- refactor(vendor-channels): 彻底收敛跨供应商兼容性逻辑——删除 `server/request_normalizer.py` 入口通用规范化层，将 `srvtoolu_*` ID 重写、`server_tool_use_delta` 私有块剥离全部迁入源→目标绑定通道（`prepare_zhipu_to_anthropic`、`prepare_zhipu_to_copilot`）；新增 `infer_source_vendor_from_body` 内容感知源推断，在无会话状态的首次请求场景下兜底识别源供应商；`_RouteExecutor._determine_source_vendor` 扩充为三级优先级（failed_tier → session_state → body inference），确保未注册转换对不触发任何清洗；
+- refactor(count-tokens): `/v1/messages/count_tokens` 端点移除无条件 `strip_thinking_blocks` 过度防御，改为基于 `infer_source_vendor_from_body` + `get_transition_channel` 的按需通道清洗，语义与 `/v1/messages` 对齐；
 - fix(request-normalizer): 重设计 zhipu→anthropic 跨供应商 tool_use/tool_result 配对修复——以单遍自包含 `enforce_anthropic_tool_pairing` 替代原有多步串联管线（剥离→重定位→孤儿修复），消除步骤间隐式依赖导致的孤儿 tool_use 漏修问题，彻底根治 `tool_use ids were found without tool_result blocks` 400 异常;
 - refactor(vendor-channels): 将供应商转换通道从「目标 vendor 专属」重构为「源→目标绑定」模型——注册表键从 `target_vendor` 改为 `(source, target)` 二元组，通道函数从 `prepare_for_X` 重命名为 `prepare_X_to_Y`，触发逻辑从 `_needs_vendor_channel` 替换为 `_determine_source_vendor`（基于请求内 `failed_tier_name` 和会话历史推断源 vendor），未注册的转换对（如 anthropic→zhipu）不触发任何通道;
 - feat(vendor-channels): 新增 zhipu→anthropic、zhipu→copilot、copilot→zhipu 三条源→目标绑定转换通道，在跨供应商故障转移时自动清理源 vendor 产物（thinking 块、cache_control 字段、thinking 参数、tool_use/tool_result 配对），消除 `likely format incompatibility (400 + tool_results)` 错误;

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coding-proxy
-Version: 0.2.4a5
+Version: 0.3.0a2
 Summary: A High-Availability, Transparent, and Smart Multi-Vendor Proxy for Claude Code. Support Claude Plans, GitHub Copilot, Google Antigravity, ZAI/GLM, MiniMax, Qwen, Xiaomi, Kimi, Doubao...
 Project-URL: Source Code, https://github.com/ThreeFish-AI/coding-proxy
 Project-URL: User Guide, https://github.com/ThreeFish-AI/coding-proxy/blob/master/docs/user-guide.md
@@ -57,7 +57,7 @@ When you're deeply immersed in your coding "zone" with **Claude Code** (or any A
 ## 🌟 Core Features
 
 <div align="center">
-    <img src="assets/dashboard-v0.2.3.png">
+    <img src="assets/dashboard-v0.2.4.png">
 </div>
 
 - **⛓️ N-tier Chained Failover**: Autonomous descending sequence, supporting Claude's official plans, as well as Coding Plans from GitHub Copilot, Google Antigravity, Z AI, MiniMax, Alibaba Qwen, Xiaomi, Kimi, Doubao, etc.
@@ -97,9 +97,9 @@ uv run coding-proxy start
 # INFO:     Started server process [1403]
 # INFO:     Waiting for application startup.
 # ...
-# INFO:     coding-proxy started: host=127.0.0.1 port=8046
+# INFO:     coding-proxy started: host=127.0.0.1 port=3392
 # INFO:     Application startup complete.
-# INFO:     Uvicorn running on http://127.0.0.1:8046 (Press CTRL+C to quit)
+# INFO:     Uvicorn running on http://127.0.0.1:3392 (Press CTRL+C to quit)
 ```
 
 ### 4. Seamless Claude Code Integration
@@ -107,7 +107,7 @@ uv run coding-proxy start
 Open a fresh terminal tab and route your traffic through coding-proxy before firing up Claude Code:
 
 ```bash
-export ANTHROPIC_BASE_URL=http://127.0.0.1:8046
+export ANTHROPIC_BASE_URL=http://127.0.0.1:3392
 
 # Enjoy blissful, silky-smooth, and uninterrupted coding nirvana:
 claude
@@ -119,13 +119,13 @@ claude
 
 `coding-proxy` comes equipped with a badass suite of CLI tools to help you boss around your proxy state.
 
-| Command  | Description                                                                                                                                        | Example Usage                                 |
-| :------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------- |
-| `start`  | **Fire up the proxy server.** Supports custom ports and configuration paths.                                                                       | `coding-proxy start -p 8080 -c ~/config.yaml` |
+| Command  | Description                                                                                                                                          | Example Usage                                 |
+| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------- |
+| `start`  | **Fire up the proxy server.** Supports custom ports and configuration paths.                                                                         | `coding-proxy start -p 8080 -c ~/config.yaml` |
 | `auth`   | **Manage OAuth credentials.** Sub-commands: `login` (browser OAuth), `status` (token validity), `reauth` (re-authenticate), `logout` (clear tokens). | `coding-proxy auth login -p github`           |
-| `status` | **Check proxy health.** Shows circuit breaker states (OPEN/CLOSED) and quota status across all tiers.                                              | `coding-proxy status`                         |
-| `usage`  | **Token Stats Dashboard.** Stalks every single token consumed, failovers triggered, and latency across day/vendor/model dimensions.                | `coding-proxy usage -d 7 -v anthropic`        |
-| `reset`  | **The emergency flush button.** Force-reset all circuit breakers and quotas instantly when you've confirmed the main vendor is back from the dead. | `coding-proxy reset`                          |
+| `status` | **Check proxy health.** Shows circuit breaker states (OPEN/CLOSED) and quota status across all tiers.                                                | `coding-proxy status`                         |
+| `usage`  | **Token Stats Dashboard.** Stalks every single token consumed, failovers triggered, and latency across day/vendor/model dimensions.                  | `coding-proxy usage -d 7 -v anthropic`        |
+| `reset`  | **The emergency flush button.** Force-reset all circuit breakers and quotas instantly when you've confirmed the main vendor is back from the dead.   | `coding-proxy reset`                          |
 
 ---
 

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/README.md

@@ -30,7 +30,7 @@ When you're deeply immersed in your coding "zone" with **Claude Code** (or any A
 ## 🌟 Core Features
 
 <div align="center">
-    <img src="assets/dashboard-v0.2.3.png">
+    <img src="assets/dashboard-v0.2.4.png">
 </div>
 
 - **⛓️ N-tier Chained Failover**: Autonomous descending sequence, supporting Claude's official plans, as well as Coding Plans from GitHub Copilot, Google Antigravity, Z AI, MiniMax, Alibaba Qwen, Xiaomi, Kimi, Doubao, etc.
@@ -70,9 +70,9 @@ uv run coding-proxy start
 # INFO:     Started server process [1403]
 # INFO:     Waiting for application startup.
 # ...
-# INFO:     coding-proxy started: host=127.0.0.1 port=8046
+# INFO:     coding-proxy started: host=127.0.0.1 port=3392
 # INFO:     Application startup complete.
-# INFO:     Uvicorn running on http://127.0.0.1:8046 (Press CTRL+C to quit)
+# INFO:     Uvicorn running on http://127.0.0.1:3392 (Press CTRL+C to quit)
 ```
 
 ### 4. Seamless Claude Code Integration
@@ -80,7 +80,7 @@ uv run coding-proxy start
 Open a fresh terminal tab and route your traffic through coding-proxy before firing up Claude Code:
 
 ```bash
-export ANTHROPIC_BASE_URL=http://127.0.0.1:8046
+export ANTHROPIC_BASE_URL=http://127.0.0.1:3392
 
 # Enjoy blissful, silky-smooth, and uninterrupted coding nirvana:
 claude
@@ -92,13 +92,13 @@ claude
 
 `coding-proxy` comes equipped with a badass suite of CLI tools to help you boss around your proxy state.
 
-| Command  | Description                                                                                                                                        | Example Usage                                 |
-| :------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------- |
-| `start`  | **Fire up the proxy server.** Supports custom ports and configuration paths.                                                                       | `coding-proxy start -p 8080 -c ~/config.yaml` |
+| Command  | Description                                                                                                                                          | Example Usage                                 |
+| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------- |
+| `start`  | **Fire up the proxy server.** Supports custom ports and configuration paths.                                                                         | `coding-proxy start -p 8080 -c ~/config.yaml` |
 | `auth`   | **Manage OAuth credentials.** Sub-commands: `login` (browser OAuth), `status` (token validity), `reauth` (re-authenticate), `logout` (clear tokens). | `coding-proxy auth login -p github`           |
-| `status` | **Check proxy health.** Shows circuit breaker states (OPEN/CLOSED) and quota status across all tiers.                                              | `coding-proxy status`                         |
-| `usage`  | **Token Stats Dashboard.** Stalks every single token consumed, failovers triggered, and latency across day/vendor/model dimensions.                | `coding-proxy usage -d 7 -v anthropic`        |
-| `reset`  | **The emergency flush button.** Force-reset all circuit breakers and quotas instantly when you've confirmed the main vendor is back from the dead. | `coding-proxy reset`                          |
+| `status` | **Check proxy health.** Shows circuit breaker states (OPEN/CLOSED) and quota status across all tiers.                                                | `coding-proxy status`                         |
+| `usage`  | **Token Stats Dashboard.** Stalks every single token consumed, failovers triggered, and latency across day/vendor/model dimensions.                  | `coding-proxy usage -d 7 -v anthropic`        |
+| `reset`  | **The emergency flush button.** Force-reset all circuit breakers and quotas instantly when you've confirmed the main vendor is back from the dead.   | `coding-proxy reset`                          |
 
 ---
 

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/docs/arch/config-reference.md

@@ -49,7 +49,7 @@ flowchart TD
 | 字段   | 类型 | 默认值        | 说明     |
 | ------ | ---- | ------------- | -------- |
 | `host` | str  | `"127.0.0.1"` | 监听地址 |
-| `port` | int  | `8046`        | 监听端口 |
+| `port` | int  | `3392`        | 监听端口 |
 
 ### 3.2 DatabaseConfig
 
@@ -257,3 +257,54 @@ tiers: [anthropic, copilot, zhipu]  # 显式优先级（可选）
 2. `zhipu` 字段名 → `fallback`
 3. 若无 `vendors` 字段，从 legacy flat 字段自动生成 vendors 列表
 4. 迁移时发出 INFO 日志建议迁移至新格式
+
+---
+
+## 10. native_api — 原生 API 透传配置
+
+> **定义位置**：[`native_api/config.py`](../../src/coding/proxy/native_api/config.py)
+>
+> **端点**：`/api/{openai,gemini,anthropic}/**` catch-all 透传通道；认证头由客户端自带，proxy 不保管凭据。
+
+### 10.1 NativeApiConfig 顶层字段
+
+| 字段          | 类型                   | 默认值                                 | 说明                                      |
+| ------------- | ---------------------- | -------------------------------------- | ----------------------------------------- |
+| `openai`      | `NativeProviderConfig` | 内置官方 URL，`enabled=true`           | OpenAI chat / responses / embeddings 等   |
+| `gemini`      | `NativeProviderConfig` | 内置官方 URL，`enabled=true`           | Gemini generateContent / embedContent 等  |
+| `anthropic`   | `NativeProviderConfig` | 内置官方 URL，`enabled=true`           | Anthropic messages / count_tokens / batches |
+
+### 10.2 NativeProviderConfig 字段
+
+| 字段                  | 类型 | 默认值              | 说明                                                                  |
+| --------------------- | ---- | ------------------- | --------------------------------------------------------------------- |
+| `enabled`             | bool | `true`              | 是否启用该 provider 的原生透传端点（默认启用，开箱即用）              |
+| `base_url`            | str  | 见下方内置默认      | 上游 API base_url（纯域名前缀，不含 `/v1`）                           |
+| `timeout_ms`          | int  | `300000`            | 单次请求超时（毫秒），LLM 大模型建议 ≥ 120s                           |
+| `connect_timeout_ms`  | int  | `15000`             | 连接建立超时（毫秒）                                                  |
+
+### 10.3 内置默认 `base_url`
+
+| Provider     | 内置默认                                              |
+| ------------ | ----------------------------------------------------- |
+| `openai`     | `https://api.openai.com`                              |
+| `gemini`     | `https://generativelanguage.googleapis.com`           |
+| `anthropic`  | `https://api.anthropic.com`                           |
+
+### 10.4 `base_url` 三级覆写优先级
+
+由 `NativeApiConfig._apply_env_overrides` `@model_validator(mode="after")` 注入：
+
+```text
+env var（运行时） > YAML 显式字段（部署时） > Pydantic 内置默认（兜底）
+```
+
+| 环境变量                     | 覆写目标                  |
+| ---------------------------- | ------------------------- |
+| `NATIVE_OPENAI_BASE_URL`     | `openai.base_url`         |
+| `NATIVE_GEMINI_BASE_URL`     | `gemini.base_url`         |
+| `NATIVE_ANTHROPIC_BASE_URL`  | `anthropic.base_url`      |
+
+空串或纯空白视作未设置，保留上一层值（避免"未设置 env → 空串覆盖内置默认"陷阱）。
+
+> `ANTHROPIC_BASE_URL`（client → proxy，Claude Code 使用）与 `NATIVE_ANTHROPIC_BASE_URL`（proxy → upstream，原生透传使用）方向正交，勿混用。参见 [用户指引 § 4.7 native_api](../user-guide.md#47-native_api--原生-api-透传)。

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/docs/arch/testing.md

@@ -65,6 +65,7 @@
 | `test_convert_sse.py`              | Gemini SSE→Anthropic SSE 流适配（单/多 chunk、各 finishReason、边界情况） |
 | `test_copilot_convert_request.py`  | Anthropic→OpenAI 请求格式转换                                             |
 | `test_copilot_convert_response.py` | OpenAI→Anthropic 响应格式转换                                             |
+| `test_vendor_channels.py`          | 源→目标通道：zhipu/copilot 兼容性清洗、tool_use 配对、内容感知源推断      |
 
 ### 2.5 数据模型（model）
 
@@ -95,7 +96,6 @@
 | 测试文件                     | 覆盖范围                                                |
 | ---------------------------- | ------------------------------------------------------- |
 | `test_app_routes.py`         | FastAPI 路由端点测试                                    |
-| `test_request_normalizer.py` | 请求标准化：私有块清洗、tool_use_id 重写、fatal_reasons |
 | `test_cli_usage.py`          | CLI 用量查询命令                                        |
 | `test_banner.py`             | CLI Banner 显示                                         |
 | `test_logging_dual_write.py` | 日志双写机制                                            |

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/docs/framework.md

@@ -69,7 +69,6 @@ graph TD
         App["<code>app.py</code><br/>应用工厂 + lifespan"]
         Routes["<code>routes.py</code><br/>路由注册"]
         Factory["<code>factory.py</code><br/>Vendor/Tier 构建工厂"]
-        Normalizer["<code>request_normalizer.py</code><br/>请求标准化"]
         Dashboard["<code>dashboard.py</code><br/>状态面板"]
     end
 
@@ -179,15 +178,8 @@ graph TD
 ```mermaid
 flowchart TD
     Client["Client POST /v1/messages"] --> Server["server.routes.messages()"]
-
-    subgraph Normalize ["请求标准化"]
-        Body["body = await request.json()"]
-        Norm["normalize_anthropic_request(body)<br/>清洗私有块 + 重写 tool_use_id"]
-        Body --> Norm
-    end
-
-    Server --> Normalize
-    Norm --> RouteType{"stream?"}
+    Server --> Body["body = await request.json()"]
+    Body --> RouteType{"stream?"}
 
     RouteType -- "true" --> StreamRoute["route_stream()"]
     RouteType -- "false" --> MsgRoute["route_message()"]
@@ -401,7 +393,6 @@ flowchart TD
 | [`app.py`](../src/coding/proxy/server/app.py)                               | FastAPI 应用工厂 `create_app()` + `lifespan` 生命周期管理 |
 | [`factory.py`](../src/coding/proxy/server/factory.py)                       | Vendor/Tier 构建工厂 + 凭证解析                           |
 | [`routes.py`](../src/coding/proxy/server/routes.py)                         | 路由端点按职责分组注册                                    |
-| [`request_normalizer.py`](../src/coding/proxy/server/request_normalizer.py) | 入站请求标准化（清洗供应商私有块）                        |
 | [`responses.py`](../src/coding/proxy/server/responses.py)                   | 响应辅助工具（JSON error / stream error 构建）            |
 | [`dashboard.py`](../src/coding/proxy/server/dashboard.py)                   | 状态面板（Web Dashboard）                                 |
 

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/docs/guide/api-reference.md

@@ -31,7 +31,7 @@
 根路径连通性探针。Claude Code 在建立连接前发送 `HEAD /` 作为健康检查，代理返回 HTTP 200 空响应。
 
 ```bash
-curl -I http://127.0.0.1:8046/
+curl -I http://127.0.0.1:3392/
 # HTTP/1.1 200 OK
 ```
 
@@ -189,7 +189,7 @@ curl -I http://127.0.0.1:8046/
 Token 计数 API 透传。支持所有提供 Anthropic 兼容端点的供应商。
 
 ```bash
-curl -X POST http://127.0.0.1:8046/v1/messages/count_tokens \
+curl -X POST http://127.0.0.1:3392/v1/messages/count_tokens \
   -H "Content-Type: application/json" \
   -H "anthropic-version: 2023-06-01" \
   -d '{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"Hello"}]}'
@@ -206,7 +206,7 @@ curl -X POST http://127.0.0.1:8046/v1/messages/count_tokens \
 健康检查。
 
 ```bash
-curl http://127.0.0.1:8046/health
+curl http://127.0.0.1:3392/health
 # {"status":"ok"}
 ```
 
@@ -215,7 +215,7 @@ curl http://127.0.0.1:8046/health
 查询所有层级的熔断器、配额守卫、周级配额守卫、Rate Limit 及诊断信息。
 
 ```bash
-curl http://127.0.0.1:8046/api/status
+curl http://127.0.0.1:3392/api/status
 ```
 
 **返回示例**：
@@ -258,15 +258,15 @@ curl http://127.0.0.1:8046/api/status
 
 ```bash
 # 仅重置（向后兼容）
-curl -X POST http://127.0.0.1:8046/api/reset
+curl -X POST http://127.0.0.1:3392/api/reset
 
 # 重置 + 提升 anthropic 到最高优先级
-curl -X POST http://127.0.0.1:8046/api/reset \
+curl -X POST http://127.0.0.1:3392/api/reset \
   -H "Content-Type: application/json" \
   -d '{"vendors": ["anthropic"]}'
 
 # 重置 + 替换整条链路顺序
-curl -X POST http://127.0.0.1:8046/api/reset \
+curl -X POST http://127.0.0.1:3392/api/reset \
   -H "Content-Type: application/json" \
   -d '{"vendors": ["zhipu", "anthropic", "copilot"]}'
 ```
@@ -282,7 +282,7 @@ curl -X POST http://127.0.0.1:8046/api/reset \
 返回 Copilot 认证与交换链路的脱敏诊断信息。
 
 ```bash
-curl http://127.0.0.1:8046/api/copilot/diagnostics
+curl http://127.0.0.1:3392/api/copilot/diagnostics
 ```
 
 若 Copilot 供应商未启用，返回 404。
@@ -292,7 +292,7 @@ curl http://127.0.0.1:8046/api/copilot/diagnostics
 按需探测当前 Copilot 会话可见的模型列表。
 
 ```bash
-curl http://127.0.0.1:8046/api/copilot/models
+curl http://127.0.0.1:3392/api/copilot/models
 ```
 
 需要有效的 Copilot 凭证；凭证无效时返回 503。
@@ -302,7 +302,7 @@ curl http://127.0.0.1:8046/api/copilot/models
 查询运行时重认证状态。
 
 ```bash
-curl http://127.0.0.1:8046/api/reauth/status
+curl http://127.0.0.1:3392/api/reauth/status
 ```
 
 ## 10. POST /api/reauth/{provider}
@@ -310,7 +310,7 @@ curl http://127.0.0.1:8046/api/reauth/status
 手动触发指定 provider 的运行时重认证。
 
 ```bash
-curl -X POST http://127.0.0.1:8046/api/reauth/github
+curl -X POST http://127.0.0.1:3392/api/reauth/github
 # HTTP/1.1 202 Accepted
 # {"status":"reauth requested"}
 ```
@@ -330,7 +330,7 @@ curl -X POST http://127.0.0.1:8046/api/reauth/github
 返回 Dashboard HTML 页面。
 
 ```bash
-curl http://127.0.0.1:8046/dashboard
+curl http://127.0.0.1:3392/dashboard
 ```
 
 ### 11.2 GET /api/dashboard/summary
@@ -338,7 +338,7 @@ curl http://127.0.0.1:8046/dashboard
 返回 Dashboard 汇总数据（今日 + 所选区间）。
 
 ```bash
-curl "http://127.0.0.1:8046/api/dashboard/summary?days=7"
+curl "http://127.0.0.1:3392/api/dashboard/summary?days=7"
 ```
 
 | 参数   | 类型 | 默认值 | 说明             |
@@ -352,7 +352,7 @@ curl "http://127.0.0.1:8046/api/dashboard/summary?days=7"
 返回按天分组的时序数据（用于图表绘制）。
 
 ```bash
-curl "http://127.0.0.1:8046/api/dashboard/timeline?days=30"
+curl "http://127.0.0.1:3392/api/dashboard/timeline?days=30"
 ```
 
 | 参数   | 类型 | 默认值 | 说明             |

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/docs/guide/cli-reference.md

@@ -39,7 +39,7 @@ coding-proxy start
 coding-proxy start -p 9000 -c ~/my-config.yaml
 
 # 自定义监听地址和端口
-coding-proxy start --host 0.0.0.0 --port 8046
+coding-proxy start --host 0.0.0.0 --port 3392
 ```
 
 > 若启用了 Copilot 或 Antigravity 供应商但未配置凭证，启动时会自动触发 OAuth 浏览器登录流程。
@@ -54,7 +54,7 @@ coding-proxy status [OPTIONS]
 
 | 参数     | 缩写 | 说明                      |
 | -------- | ---- | ------------------------- |
-| `--port` | `-p` | 代理服务端口（默认 8046） |
+| `--port` | `-p` | 代理服务端口（默认 3392） |
 
 **输出示例**：
 
@@ -143,7 +143,7 @@ coding-proxy reset [OPTIONS]
 
 | 参数       | 缩写 | 说明                                            |
 | ---------- | ---- | ----------------------------------------------- |
-| `--port`   | `-p` | 代理服务端口（默认 8046）                       |
+| `--port`   | `-p` | 代理服务端口（默认 3392）                       |
 | `--vendor` | `-v` | 提升/重排序 vendor 优先级（单个或逗号分隔多个） |
 
 **重排序语义**：
@@ -211,7 +211,7 @@ coding-proxy auth reauth PROVIDER [OPTIONS]
 | 参数       | 缩写 | 说明                                       |
 | ---------- | ---- | ------------------------------------------ |
 | `PROVIDER` | —    | provider 名称（必填）：`github` / `google` |
-| `--port`   | `-p` | 代理服务端口（默认 8046）                  |
+| `--port`   | `-p` | 代理服务端口（默认 3392）                  |
 
 **示例**：
 

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/docs/guide/dashboard.md

@@ -7,7 +7,7 @@ coding-proxy 内置 Web 可视化看板，提供流量、用量、故障转移
 启动代理后，浏览器访问：
 
 ```
-http://127.0.0.1:8046/dashboard
+http://127.0.0.1:3392/dashboard
 ```
 
 ## 功能概览

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/docs/guide/monitoring.md

@@ -67,17 +67,17 @@ coding-proxy usage --db /path/to/usage.db
 
 ```bash
 # 基础检查
-curl http://127.0.0.1:8046/health
+curl http://127.0.0.1:3392/health
 
 # 详细状态（所有层级的熔断器、配额守卫、Rate Limit、诊断信息）
-curl http://127.0.0.1:8046/api/status
+curl http://127.0.0.1:3392/api/status
 ```
 
 > 端点详情参见 [API 参考](./api-reference.md)。
 
 ## 4. Dashboard 监控
 
-浏览器访问 `http://127.0.0.1:8046/dashboard` 查看 Web 可视化看板。详见 [Dashboard 文档](./dashboard.md)。
+浏览器访问 `http://127.0.0.1:3392/dashboard` 查看 Web 可视化看板。详见 [Dashboard 文档](./dashboard.md)。
 
 ## 5. 数据库维护
 
@@ -138,7 +138,7 @@ coding-proxy reset -v anthropic
 coding-proxy auth reauth github
 
 # API
-curl -X POST http://127.0.0.1:8046/api/reauth/github
+curl -X POST http://127.0.0.1:3392/api/reauth/github
 ```
 
 重认证请求发出后（HTTP 202），在浏览器中完成授权即可，无需重启。
@@ -150,7 +150,7 @@ curl -X POST http://127.0.0.1:8046/api/reauth/github
 **端口占用**：
 
 ```bash
-lsof -i :8046
+lsof -i :3392
 coding-proxy start --port 8080
 ```
 
@@ -161,7 +161,7 @@ coding-proxy start --port 8080
 ### 8.2 Claude Code 无法连接代理
 
 1. 确认代理正在运行：`coding-proxy status`
-2. 确认环境变量：`echo $ANTHROPIC_BASE_URL`（应为 `http://127.0.0.1:8046`）
+2. 确认环境变量：`echo $ANTHROPIC_BASE_URL`（应为 `http://127.0.0.1:3392`）
 3. 确认端口一致
 
 ### 8.3 频繁触发故障转移
@@ -185,10 +185,10 @@ coding-proxy start --port 8080
 
 ```bash
 # 查看诊断信息
-curl http://127.0.0.1:8046/api/copilot/diagnostics
+curl http://127.0.0.1:3392/api/copilot/diagnostics
 
 # 探查可用模型
-curl http://127.0.0.1:8046/api/copilot/models
+curl http://127.0.0.1:3392/api/copilot/models
 
 # 重认证
 coding-proxy auth reauth github

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/docs/guide/quickstart.md

@@ -59,7 +59,7 @@ coding-proxy start --config /path/to/config.yaml
 INFO:     Started server process [75773]
 INFO:     Waiting for application startup.
 INFO:     Application startup complete.
-INFO:     Uvicorn running on http://127.0.0.1:8046 (Press CTRL+C to quit)
+INFO:     Uvicorn running on http://127.0.0.1:3392 (Press CTRL+C to quit)
 ```
 
 > 若启用了 Copilot 或 Antigravity 供应商但未配置凭证，启动时会自动触发 OAuth 浏览器登录。
@@ -68,7 +68,7 @@ INFO:     Uvicorn running on http://127.0.0.1:8046 (Press CTRL+C to quit)
 
 ```bash
 # 健康检查
-curl http://127.0.0.1:8046/health
+curl http://127.0.0.1:3392/health
 # 期望返回: {"status":"ok"}
 
 # 查看代理状态
@@ -80,7 +80,7 @@ coding-proxy status
 将 Claude Code 的 API 端点指向 coding-proxy：
 
 ```bash
-export ANTHROPIC_BASE_URL=http://127.0.0.1:8046
+export ANTHROPIC_BASE_URL=http://127.0.0.1:3392
 ```
 
 Claude Code 使用的 OAuth token 会被代理透传到 Anthropic API，无需额外配置认证信息。
@@ -100,4 +100,4 @@ Claude Code 使用的 OAuth token 会被代理透传到 Anthropic API，无需
 4. **定期查看用量**：[`coding-proxy usage`](./cli-reference.md#3-coding-proxy-usage)
 5. **按需手动干预**：[`coding-proxy reset`](./cli-reference.md#4-coding-proxy-reset) 强制切回最高优先级供应商
 6. **运行时重认证**：[`coding-proxy auth reauth`](./cli-reference.md#7-coding-proxy-auth-reauth) 无需重启即可刷新凭证
-7. **查看可视化看板**：浏览器访问 `http://127.0.0.1:8046/dashboard`
+7. **查看可视化看板**：浏览器访问 `http://127.0.0.1:3392/dashboard`

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/docs/user-guide.md

@@ -17,6 +17,7 @@
     - [4.4 环境变量引用](#44-环境变量引用)
     - [4.5 auth — OAuth 登录配置](#45-auth--oauth-登录配置)
     - [4.6 server / database / logging](#46-server--database--logging)
+    - [4.7 native_api — 原生 API 透传](#47-native_api--原生-api-透传)
   - [5. 日常操作速查](#5-日常操作速查)
   - [附录：术语对照表](#附录术语对照表)
 
@@ -118,10 +119,10 @@ cp config.default.yaml config.yaml
 coding-proxy start
 
 # 4. 配置 Claude Code
-export ANTHROPIC_BASE_URL=http://127.0.0.1:8046
+export ANTHROPIC_BASE_URL=http://127.0.0.1:3392
 
 # 5. 验证
-curl http://127.0.0.1:8046/health
+curl http://127.0.0.1:3392/health
 ```
 
 ---
@@ -194,7 +195,7 @@ auth:
 ```yaml
 server:
   host: "127.0.0.1"    # 设为 "0.0.0.0" 接受外部连接
-  port: 8046
+  port: 3392
 
 database:
   path: "~/.coding-proxy/usage.db"
@@ -208,6 +209,50 @@ logging:
 
 > 完整字段定义参见 [配置字段参考](./arch/config-reference.md#3-服务器配置)。
 
+### 4.7 native_api — 原生 API 透传
+
+`coding-proxy` 在 Claude Code 主链路 (`/v1/messages`) 之外，额外暴露 `/api/{openai,gemini,anthropic}/**` catch-all 透传通道，供直接调用 OpenAI / Gemini / Anthropic 官方 API 的客户端复用 proxy（认证头 `Authorization` / `x-api-key` / `?key=` 全部由客户端透传，proxy 不保管凭据）。
+
+```yaml
+native_api:
+  openai:
+    enabled: true                          # 默认开箱即用
+    base_url: "https://api.openai.com"     # 或填入自选第三方代理
+    timeout_ms: 300000
+    connect_timeout_ms: 15000
+  gemini:
+    enabled: true
+    base_url: "https://generativelanguage.googleapis.com"
+  anthropic:
+    enabled: true
+    base_url: "https://api.anthropic.com"
+```
+
+**上游 `base_url` 三级优先级**（env > yaml > 内置默认）由 `NativeApiConfig._apply_env_overrides` `@model_validator(mode="after")` 统一注入，空串/纯空白视作未设置：
+
+| 变量名 | 方向（谁 → 谁） | 典型值 | 备注 |
+| --- | --- | --- | --- |
+| `ANTHROPIC_BASE_URL` | client → proxy | `http://127.0.0.1:3392` | Claude Code 等客户端指向本 proxy |
+| `NATIVE_OPENAI_BASE_URL` | proxy → upstream | `https://api.openai.com` 或自选代理 | 覆写 OpenAI 上游 |
+| `NATIVE_GEMINI_BASE_URL` | proxy → upstream | `https://generativelanguage.googleapis.com` 或自选代理 | 覆写 Gemini 上游 |
+| `NATIVE_ANTHROPIC_BASE_URL` | proxy → upstream | `https://api.anthropic.com` 或自选代理 | 覆写原生 Anthropic 上游 |
+
+> `ANTHROPIC_BASE_URL` 与 `NATIVE_ANTHROPIC_BASE_URL` **方向正交**：前者是**客户端指向 proxy**（client → proxy），后者是 **proxy 指向上游**（proxy → upstream）。`NATIVE_` 前缀用于彻底切分两者语义。
+
+**客户端用法示例**：
+
+```bash
+# 1. 将 OpenAI SDK base_url 指向本 proxy
+export OPENAI_BASE_URL="http://127.0.0.1:3392/api/openai/v1"
+
+# 2. 或直接 curl
+curl http://127.0.0.1:3392/api/openai/v1/chat/completions \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"ping"}]}'
+```
+
+如需禁用某家 provider，将对应 `enabled` 改为 `false` 即可。完整字段定义参见 [配置字段参考 — NativeApiConfig](./arch/config-reference.md#10-native_api--原生-api-透传配置)。
+
 ---
 
 ## 5. 日常操作速查
@@ -224,7 +269,7 @@ logging:
 | GitHub 登录 | `coding-proxy auth login -p github`          |
 | 重认证      | `coding-proxy auth reauth github`            |
 | 查看凭证    | `coding-proxy auth status`                   |
-| Dashboard   | 浏览器访问 `http://127.0.0.1:8046/dashboard` |
+| Dashboard   | 浏览器访问 `http://127.0.0.1:3392/dashboard` |
 
 > 完整命令选项参见 [CLI 命令参考](./guide/cli-reference.md)。
 

{coding_proxy-0.2.4a5 → coding_proxy-0.3.0a2}/docs/zh-CN/README.md

@@ -30,7 +30,7 @@
 ## 🌟 核心特性 (Core Features)
 
 <div align="center">
-    <img src="../../assets/dashboard-v0.2.3.png">
+    <img src="../../assets/dashboard-v0.2.4.png">
 </div>
 
 - **⛓️ N-tier 链式故障转移 (Failover)**：自主降序序列，支持 Claude 官方 Plans，以及 GitHub Copilot、Google Antigravity、智谱、MiniMax、阿里千问、小米、Kimi、豆包等的 Coding Plan。
@@ -70,9 +70,9 @@ uv run coding-proxy start
 # INFO:     Started server process [1403]
 # INFO:     Waiting for application startup.
 # ...
-# INFO:     coding-proxy started: host=127.0.0.1 port=8046
+# INFO:     coding-proxy started: host=127.0.0.1 port=3392
 # INFO:     Application startup complete.
-# INFO:     Uvicorn running on http://127.0.0.1:8046 (Press CTRL+C to quit)
+# INFO:     Uvicorn running on http://127.0.0.1:3392 (Press CTRL+C to quit)
 ```
 
 ### 4. 一键接入 Claude Code
@@ -80,7 +80,7 @@ uv run coding-proxy start
 打开一个新的终端标签页，启动 Claude Code 前将流量指向 coding-proxy：
 
 ```bash
-export ANTHROPIC_BASE_URL=http://127.0.0.1:8046
+export ANTHROPIC_BASE_URL=http://127.0.0.1:3392
 
 # 享受如丝般顺滑、永不断连的编程心流：
 claude
@@ -92,13 +92,13 @@ claude
 
 `coding-proxy` 附带了强大的 CLI 工具套件，帮助您全面掌控代理状态。
 
-| 指令     | 说明                                                                              | 示例用法                                      |
-| :------- | :-------------------------------------------------------------------------------- | :-------------------------------------------- |
-| `start`  | **启动代理服务器**。支持自定义端口与配置路径。                                    | `coding-proxy start -p 8080 -c ~/config.yaml` |
+| 指令     | 说明                                                                                                                            | 示例用法                                      |
+| :------- | :------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------- |
+| `start`  | **启动代理服务器**。支持自定义端口与配置路径。                                                                                  | `coding-proxy start -p 8080 -c ~/config.yaml` |
 | `auth`   | **管理 OAuth 登录凭证**。子命令：`login`（浏览器 OAuth 登录）、`status`（令牌状态）、`reauth`（重认证）、`logout`（清除令牌）。 | `coding-proxy auth login -p github`           |
-| `status` | **查看代理健康状态**。展示各层级熔断器（OPEN/CLOSED）与配额状态。                 | `coding-proxy status`                         |
-| `usage`  | **Token 统计看板**。按天/供应商/模型维度追踪每一次的 Token 消耗、故障转移及耗时。 | `coding-proxy usage -d 7 -v anthropic`        |
-| `reset`  | **强制一键重置**。人工确认主供应商恢复可用后，立刻初始化所有熔断器和配额状态。    | `coding-proxy reset`                          |
+| `status` | **查看代理健康状态**。展示各层级熔断器（OPEN/CLOSED）与配额状态。                                                               | `coding-proxy status`                         |
+| `usage`  | **Token 统计看板**。按天/供应商/模型维度追踪每一次的 Token 消耗、故障转移及耗时。                                               | `coding-proxy usage -d 7 -v anthropic`        |
+| `reset`  | **强制一键重置**。人工确认主供应商恢复可用后，立刻初始化所有熔断器和配额状态。                                                  | `coding-proxy reset`                          |
 
 ---