AnyBridge：AI 智能体 BYOK 接入工作台

项目简介

AnyBridge 是一款运行在本地的 BYOK（Bring Your Own Key）模型接入与配置管理客户端，基于 Tauri v2 + Rust 开发，MIT 许可证开源。它把第三方中转站（OneAPI / NewAPI / CPA 等）、自建网关，以及 DeepSeek、Claude、GPT、Gemini、GLM、Kimi 等模型，统一接入日常使用的 AI 编程智能体：桌面 IDE、终端 CLI 与桌面客户端。

全部操作在图形界面完成：不手写 JSON、不改环境变量、不碰二进制文件，随时一键还原官方配置。目前支持 16 款智能体，另可通过本地网关接入任意外部生态。

主要功能

三种接入方式

本地代理监听 127.0.0.1:7450，只拦截聊天会话请求并转译为 OpenAI / Anthropic 格式，代码补全、文件索引、登录鉴权等流量原样放行。本地网关则统一暴露兼容端点 http://localhost:7450/v1。

核心能力

• 模型槽位映射：把客户端写死的模型槽位（如 Cursor 的 cursor-small、Windsurf 的 Claude Sonnet）映射到真正想用的模型。
• 看图备用（Vision Fallback）：纯文本模型也能处理截图，可全局或按渠道指定视觉模型。
• 专属解锁（Unlock）：补齐官方客户端协议指纹（anthropic-beta 头、Thinking 参数、会话元数据），避免 503 / 400 拒绝。
• Codex 桌面增强：通过 CDP 运行时注入把自定义模型加进下拉列表，不改二进制文件。
• 稳定性保障：故障自动切换、429 限流自动重试、并发控制、长推理超时保护、退出自动还原代理。
• 用量统计看板：请求走势、KPI 环比、输入/输出/缓存分别计价的成本明细与「请求模型 → 实际模型」链路。
• 配置漂移感知：接管期间配置被外部改动时，平台卡片会标出「被外部修改」与处数。
• 能力一键体检：连通性、模型列表、流式 SSE、工具调用、视觉多模态逐项检测。
• 渠道导入：可扫描并导入 Cherry Studio、CC Switch、Cockpit Tools 中已配置的渠道与模型，导入前可预览并自动去重。
• CPA 扩展中心：一键部署与管理本地网关套件（CLIProxyAPI + CPA Manager Plus + 插件商店）。
• 界面一键汉化：内置本地化引擎与在线词库热更新，不会误译代码与思考链。

安装与使用

下载安装

桌面安装包开箱即用，无需安装 Node.js、Python 等命令行环境。前往 GitHub Releases 下载：

• Windows：.msi 或 Setup.exe，双击按向导安装。
• macOS：.dmg，打开后将 AnyBridge 拖入「应用程序」，Apple Silicon 与 Intel 均有对应包。
• Linux：.AppImage 或 .deb；AppImage 需先授予可执行权限：

chmod +x *.AppImage

三步上手

1. 打开「供应商」页面，点击「添加供应商」，填入渠道地址与 API 密钥，可在线拉取模型列表并勾选模型，点「测试」做连通性体检。
2. 进入「智能体」页面选择目标工具：封闭式 IDE 点「启用代理接管」，配置型智能体点「切换到 AnyBridge」自动写入对应系统路径。
3. 像平时一样打开 IDE 或终端使用，请求即切到自定义模型；在任意智能体页面点「恢复原始配置」可秒级还原。

配置文件位置

写入遵循按供应商分组的结构，只维护 AnyBridge 写入的条目，用户手写内容与文件注释原样保留，写入前自动备份。

验证与迁移

• 访问 http://localhost:7450/__byok/health，返回 {"status":"ok"} 表示本地服务正常；http://localhost:7450/__byok/stats 可查看实时聚合统计。
• 配置存放于：Windows %APPDATA%\anybridge\providers.json、macOS ~/Library/Application Support/anybridge/providers.json、Linux ~/.config/anybridge/providers.json，复制到新设备对应目录即可还原。

注意事项

• 纯本地运行：没有收集用户数据的远程云端后台；API 密钥、中转站地址与对话上下文完全保存在本地磁盘。
• 账号安全：不篡改智能体客户端二进制文件，仅在本机作为环回代理工作，登录验证与遥测原样放行；关闭软件时自动复原网络环境。
• 代理模式需保持运行：Cursor、Windsurf、Devin 以及通过本地网关接入的客户端，使用期间需要 AnyBridge 处于运行状态；配置文件直写模式写完即可关闭。
• 渠道兼容性：需支持标准 OpenAI 格式或 Anthropic 格式的服务，填入 Base URL 与密钥即可生效。
• 免责声明：本项目为独立开源开发辅助工具，与 Cursor、Windsurf、Devin、OpenAI、Anthropic 等商业公司无任何官方隶属或商业背书关系。

本作品整理自 GitHub 开源项目 soulvon/AnyBridge，原作者 @soulvon，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。