多协议互通与严格语义
提供 /v1/chat/completions、/v1/completions、/v1/embeddings、/v1/messages 与 /v1beta/models/*,跨供应商转换保留工具调用与签名回放校验,无法表达的约束在生成前拒绝。
能做到什么程度(已实现能力)
/v1/chat/completions、/v1/completions、/v1/embeddings、/v1/models)、Anthropic /v1/messages 与 Gemini /v1beta/models/*,跨协议保留工具严格度与签名思考回放元数据。ADMIN_PASSWORD、apiKeys、上游密钥与 MODELBRIDGE_STATE_TOKEN 严格隔离;Node 24 SQLite(WAL)状态服务与 Cloudflare AppConfigStore DO 各守单一权威,支持 upstream:<id>:<model> 精准路由。16 MiB、Makers 1 MiB、ESA 4 次 fetch);validateProviderBaseUrl 强制公网 HTTPS 防私网探测。明确不能做什么(非目标与硬限制)
/v1/responses、完整图像/音频生成编辑,Gemini :countTokens 固定返回 501;不做跨供应商精确 token 计量。cloudflare-model-map.json(65 条)与控制台 Neurons 计数仅作展示与发现(非硬配额拦截);超时及 5xx 绝不触发多账号重试防重复计费。Makers 请求体硬上限为 1 MiB。仓库根目录运行需要 Node.js 24+,主网关与状态服务不依赖第三方 npm 包:
# 1. 运行静态语法检查与全部模拟回归测试
pnpm run check
node --test tests/*.test.mjs
# 2. 生成六套多平台独立部署目录(dist/)
node tools/build-platforms.mjs
# 3. 本地启动自建 SQLite 状态服务(默认 127.0.0.1:8788)
MODELBRIDGE_STATE_TOKEN="$(openssl rand -hex 32)" pnpm run start:state按照读者需求快速跳转
createGateway 适配层;