Skip to content

AgentSwitch v0.1.0 — 首个开源版本

Choose a tag to compare

@Tomato-black Tomato-black released this 05 Nov 14:14
· 100 commits to master since this release

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。