v0.2.1 — 可观测与安全收口

v0.2.1 — 可观测与安全收口

新增

• 请求历史增强：时间范围筛选（全部 / 今天 / 24 小时 / 7 天）、CSV 导出、诊断包 zip 导出（历史 JSON+CSV、当前日志、脱敏渠道与逻辑模型清单），导出菜单三入口
• 额度阈值告警：本地渠道配额使用率 ≥80% / ≥100% 时按渠道各提醒一次（24 小时去重）
• 导出口令加密：配置导出可选密码加密（PBKDF2-SHA256 60 万轮 + AES-256-GCM），导入时输入口令解密预览；明文 v1 包继续兼容
• 应用接入确认框：应用 / 重新应用前列出目标文件与受管键变更摘要（敏感值遮蔽），先示后写

改进

• 冷却到期半开探测可见——渠道卡 / 逻辑模型卡区分「冷却」与「恢复中（待探测）」
• 复制渠道可选同时复制 API Key（默认不复制，走确认框）
• Claude Code 设置页：项目本地层候选路径手动切换；Skills 扫描错误（目录不可读 / 清单损坏）上浮警告；读文件与合并预览异步化不卡 UI；插件开关三态（跟随下层 / 启用 / 停用）；项目选择器搜索 + 最近使用置顶

修复

• 重启后请求历史为空（历史区改用持久化数据源）

未验证声明

• Windows 产物由交叉编译与 CI 产出，尚未在 Windows 实机运行验证
• 真实 Agent（Claude Code / Codex）smoke 与系统通知实机验证为发布后待办

v0.2.0

v0.2.0 — Claude Code 配置中心与接入页重排

新增

• Claude Code 配置中心：侧栏独立页分层管理 Claude Code settings（用户级/项目级/企业托管），表单 / 严格 JSON / 合并预览三视图；权限、环境变量、状态栏、MCP 与插件、Skills、记忆一屏可改，保存前备份、只 patch 变更键、外部修改冲突确认
• 接入页重排：摘要卡 + 配置列表（行上「更多」菜单）+ 编辑子页；主模型 / 回退模型 / 角色映射全部下拉选择，显示名随模型自动填充、可手改（主模型/回退链归接入管理，写入 settings.json 并在设置页自动只读）
• 浏览器式缩放：Cmd/Ctrl + = / - / 0 全局缩放（0.5×–3×）
• 主题化菜单（PopoverMenuButton）、SearchField 搜索框、托盘菜单图标

修复

• 「权限无法设置」：接入文档误粘的 permissions 顶层键导致设置区全部权限字段被锁死且应用时覆盖设置页修改——已清理存量数据并在入口拒绝设置页领域键
• 表单缺键字段改为直接可编辑（去掉「覆盖」按钮门槛）
• 缺键字段「下层：」继承提示自指、选中态白底白字不可见、失焦主操作褪灰等实测问题

其他

• 升级 mygo v0.6.2 → v0.8.3（工具链 go 1.27.3）
• Claude 全局配置下线（环境变量并入 Claude Code 设置页管理）
• Windows 便携 exe（安装包由 CI 生成）；Linux 提供 deb / tar.gz / install.sh / PKGBUILD

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。