🌉 LiuAIbridge

一个轻量级、安全、带 UI 的 AI API 边缘网关。

部署在 Cloudflare Workers 上，旨在解决国内开发者直连访问 Google Gemini, OpenAI, Anthropic 等 API 的痛点。

✨ 特性

• 国内直连：无需本地代理，通过 Cloudflare 全球加速。
• 可视化后台：内置 /admin 仪表盘，图形化管理各平台 API Key。
• 多模型支持：统一转发 Google、OpenAI、Anthropic 请求。
• 协议分层：上游分别走 Google / Anthropic / OpenAI 官方原生或官方兼容端；下游可选用 OpenAI 形态的 POST .../v1/chat/completions（Gemini 由网关转原生 Gemini；Claude 由 Anthropic 官方 OpenAI 兼容层处理），与 原生路径（如 /google/v1beta/...、/anthropic/v1/messages）通过路径区分、可同时保留。
• 统一 OpenAI 形态入口：/compat/openai/google/...、/compat/openai/anthropic/... 与 /google/...、/anthropic/... 等价，便于下游固定 Base URL。
• 安全加固：API Key 存储于 KV 空间，请求采用 Header 鉴权（X-Bridge-Token 或 Authorization: Bearer 桥接令牌）。
• 流式传输：Gemini（OpenAI 形态）由网关转换 SSE；Claude（OpenAI 形态）与 OpenAI 直连为上游 SSE 透传。

🚀 快速开始

1. 部署：

   wrangler kv namespace create LIU_BRIDGE_KV
   wrangler secret put ADMIN_TOKEN
   wrangler secret put BRIDGE_TOKEN
   wrangler deploy

2. 管理：访问 你的域名/admin 配置 API Keys。

3. 调用（桥接令牌：X-Bridge-Token 或 Authorization: Bearer，值为 BRIDGE_TOKEN）：

   用途	Base / 示例
   OpenAI 官方 API	https://你的域名/openai/v1/...
   Gemini 原生	https://你的域名/google/v1beta/models/...
   Gemini OpenAI 形态（网关 → Gemini 原生）	POST https://你的域名/google/v1/chat/completions
   Claude 原生	POST https://你的域名/anthropic/v1/messages
   Claude OpenAI 形态（网关 → Anthropic 官方 OpenAI 兼容 /v1/chat/completions）	POST https://你的域名/anthropic/v1/chat/completions
   固定 compat 前缀（与上一行等价，仅路径改写）	POST https://你的域名/compat/openai/google/v1/chat/completions、.../compat/openai/anthropic/v1/chat/completions

   说明：当前跨厂商兼容以 /v1/chat/completions（非流式 + SSE 流式）为主；/v1/responses 未接入。能力边界以 各上游实际支持 及官方 OpenAI 兼容文档为准（Claude 侧兼容层 limitations 见 Anthropic OpenAI SDK compatibility）。

🛠️ 本地开发与调试 (Local Development)

在正式部署到 Cloudflare 之前，建议先在本地环境验证配置。

1. 准备环境

确保你已安装了 Node.js (推荐 LTS 版本)。

# 安装项目依赖
npm install

2. 配置本地环境变量

在项目根目录下创建一个名为 .dev.vars 的文件（Wrangler 会自动读取它作为本地 Secret）：

ADMIN_TOKEN=your_admin_password_123
BRIDGE_TOKEN=your_bridge_token_456

3. 启动本地服务器

运行以下命令启动模拟环境：

npx wrangler dev

启动成功后，控制台会显示 Ready on http://localhost:8788。

4. 初始化本地数据

由于本地环境使用模拟的 KV 存储，你需要先进入后台配置 API Key：

1. 在浏览器访问：http://localhost:8788/admin。
2. 输入你在 .dev.vars 中设置的 ADMIN_TOKEN。
3. 点击 “添加新 Key”，填入你的 Gemini/OpenAI 密钥。
4. 数据将保存到本地 .wrangler 文件夹中。

5. 测试接口

你可以使用项目自带的 test.py 或 curl 进行验证：

PowerShell 示例：

curl.exe -X POST "http://localhost:8788/google/v1beta/models/gemini-1.5-flash:generateContent" `
  -H "Content-Type: application/json" `
  -H "X-Bridge-Token: your_bridge_token_456" `
  -d '{"contents": [{"parts":[{"text": "你好"}]}]}'

6. 注意事项

• 网络环境：在本地调试时，Worker 运行在你自己的机器上。因此，你的电脑必须能够正常访问 Google 或 OpenAI 的 API 地址（即需要开启全局代理），否则会返回 502 Bad Gateway。
• 部署后：一旦使用 wrangler deploy 发布，Worker 将运行在 Cloudflare 节点，届时无需本地代理即可实现国内直连。