coding-proxy 0.3.0a1__tar.gz → 0.3.0a2__tar.gz

{coding_proxy-0.3.0a1 → coding_proxy-0.3.0a2}/CHANGELOG.md

@@ -4,6 +4,8 @@
 
 ## [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 分支行为零变更；

{coding_proxy-0.3.0a1 → coding_proxy-0.3.0a2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coding-proxy
-Version: 0.3.0a1
+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
@@ -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

{coding_proxy-0.3.0a1 → coding_proxy-0.3.0a2}/README.md

@@ -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

{coding_proxy-0.3.0a1 → 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.3.0a1 → 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.3.0a1 → 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.3.0a1 → 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.3.0a1 → 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.3.0a1 → 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.3.0a1 → 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.3.0a1 → coding_proxy-0.3.0a2}/docs/zh-CN/README.md

@@ -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

{coding_proxy-0.3.0a1 → coding_proxy-0.3.0a2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "coding-proxy"
-version = "0.3.0a1"
+version = "0.3.0a2"
 description = "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..."
 readme = "README.md"
 requires-python = ">=3.12"

{coding_proxy-0.3.0a1 → coding_proxy-0.3.0a2}/src/coding/proxy/cli/__init__.py

@@ -121,7 +121,7 @@ def start(
 
 @app.command()
 def status(
-    port: int = typer.Option(8046, "--port", "-p", help="代理服务端口"),
+    port: int = typer.Option(3392, "--port", "-p", help="代理服务端口"),
 ) -> None:
     """查看代理状态和当前活跃供应商."""
     import httpx
@@ -215,7 +215,7 @@ async def _run_usage(
 
 @app.command()
 def reset(
-    port: int = typer.Option(8046, "--port", "-p", help="代理服务端口"),
+    port: int = typer.Option(3392, "--port", "-p", help="代理服务端口"),
     vendor: str | None = typer.Option(
         None,
         "--vendor",

{coding_proxy-0.3.0a1 → coding_proxy-0.3.0a2}/src/coding/proxy/cli/auth_commands.py

@@ -114,7 +114,7 @@ def auth_status() -> None:
 @app.command("reauth")
 def auth_reauth(
     provider: str = typer.Argument(..., help="provider 名称 (github/google)"),
-    port: int = typer.Option(8046, "--port", "-p", help="代理服务端口"),
+    port: int = typer.Option(3392, "--port", "-p", help="代理服务端口"),
 ) -> None:
     """触发运行中代理的 OAuth 重认证."""
     import httpx as _httpx

{coding_proxy-0.3.0a1 → coding_proxy-0.3.0a2}/src/coding/proxy/cli/banner.py

@@ -22,7 +22,7 @@ if TYPE_CHECKING:
 from .. import __version__
 
 
-def build_banner(host: str = "127.0.0.1", port: int = 8046) -> Panel:
+def build_banner(host: str = "127.0.0.1", port: int = 3392) -> Panel:
     """构建品牌横幅 Panel.
 
     Args:
@@ -48,7 +48,7 @@ def build_banner(host: str = "127.0.0.1", port: int = 8046) -> Panel:
     return Panel(brand_text, border_style="cyan", padding=(1, 2), expand=False)
 
 
-def print_banner(console: Console, host: str = "127.0.0.1", port: int = 8046) -> None:
+def print_banner(console: Console, host: str = "127.0.0.1", port: int = 3392) -> None:
     """通过指定 Console 打印品牌横幅.
 
     Args:

{coding_proxy-0.3.0a1 → coding_proxy-0.3.0a2}/src/coding/proxy/config/config.default.yaml

@@ -4,7 +4,7 @@
 
 server:
   host: "127.0.0.1"
-  port: 8046
+  port: 3392
 
 logging:
   level: "INFO"
@@ -522,3 +522,35 @@ auth:
   # google_client_id: ""
   # google_client_secret: ""
   token_store_path: "~/.coding-proxy/tokens.json"
+
+# === 原生 API 透传（/api/{openai,gemini,anthropic}/**）===
+#
+# 三家 provider 默认 enabled=true（开箱即用）。
+# 客户端将 SDK base_url 改为 http://127.0.0.1:3392/api/{openai,gemini,anthropic}
+# 即可直接触达官方上游；认证（Authorization / x-api-key / ?key=）由客户端自带，
+# proxy 不保管凭据。
+#
+# 将 base_url 指向第三方代理的两种方式（优先级：env > yaml > 内置默认）：
+#   方式 A（推荐部署/容器场景）：设置环境变量
+#     NATIVE_OPENAI_BASE_URL     / NATIVE_GEMINI_BASE_URL     / NATIVE_ANTHROPIC_BASE_URL
+#   方式 B（推荐本地开发/团队共享）：直接编辑下方 base_url 字段
+#
+# 如需禁用某家 provider，将对应 enabled 改为 false 即可。
+# base_url 字段的值与 Pydantic 内置默认保持一致（由 tests/test_native_api_base_url_override.py
+# 的 test_default_config_yaml_matches_pydantic_builtin 守护双写同步）。
+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"
+    timeout_ms: 300000
+    connect_timeout_ms: 15000
+  anthropic:
+    enabled: true
+    base_url: "https://api.anthropic.com"
+    timeout_ms: 300000
+    connect_timeout_ms: 15000

{coding_proxy-0.3.0a1 → coding_proxy-0.3.0a2}/src/coding/proxy/config/server.py

@@ -7,7 +7,7 @@ from pydantic import BaseModel
 
 class ServerConfig(BaseModel):
     host: str = "127.0.0.1"
-    port: int = 8046
+    port: int = 3392
 
 
 class DatabaseConfig(BaseModel):