Repository navigation
AgentSwitch v0.1.0 — 首个开源版本
AgentSwitch v0.1.0 — 首个开源版本
本地 AI Agent 模型网关:为 Claude Code / Codex(CLI / 桌面版)/ Claude Desktop 等本地 Agent 提供统一模型入口,集中管理多供应商渠道与密钥,按「逻辑模型」有序目标链做优先级故障转移,Agent 无需重启即可切换上游。
下载
| 平台 | 文件 | 说明 |
|---|---|---|
| macOS(Intel x64) | AgentSwitch.0.1.0.amd64.dmg |
已验证。Apple Silicon 可通过 Rosetta 运行(原生 arm64 包尚未验证) |
| Windows(10/11 x64) | AgentSwitch-0.1.0-windows-amd64-portable.zip |
便携版:解压后运行 AgentSwitch.exe(icon.png 需同目录);未签名,首次运行 SmartScreen 会提示;尚未实机运行验证 |
| Linux(GTK3) | 无预编译包 | 源码构建:go tool mygo build,产物含 .deb 与 install.sh |
主要特性
- 逻辑模型路由:Agent 请求
model=my-code,网关按目标链(渠道 + 模型)有序尝试;仅在响应尚未提交前切换,绝不重放已计费请求 - 三入站协议:Anthropic
/v1/messages、OpenAI Chat/v1/chat/completions、OpenAI Responses/v1/responses,与上游渠道协议自动互转 - 20 条双协议预置:14 家按量供应商 + 6 家 Coding Plan 订阅,选协议自动带出 base_url 与模型建议;支持
~/.agentswitch/presets.json用户覆盖 - 接入管理:一键写入 Claude Code / Codex / Claude Desktop 真实配置(只改受管键、写前备份、令牌变更自动刷新);Codex 支持桌面版、有序多模型与模型元数据目录
- 密钥安全:API Key 以 AES-256-GCM 加密存 SQLite,主密钥
master.key与库分离;SSRF / 私网校验;日志、错误、UI 零密钥 - 可靠性:按 ChannelID 原子冷却、请求前二次校验、半开恢复;流式中断/空闲超时向客户端发 error 事件,残缺工具参数不以空 input 下发
- 可观测性:请求历史持久化、用量与成本估算、上游余额查询、故障通知、可解释路由决策
- 零遥测上报:所有数据仅存本机
已知限制
- Windows 构建与打包已通过,尚未在 Windows 实机运行验证
- Apple Silicon 原生打包未验证
- UI 仅中文(国际化在路线图中)
- 破坏性 schema 变更走删库重建(不就地迁移)
完整变更见 CHANGELOG.md。