SwitchX v0.2.0

下载

请选择与你的系统和处理器架构对应的安装包。

平台	架构	下载
macOS	Apple Silicon (ARM64)
macOS	Intel (x64)
Windows	ARM64
Windows	x64
Linux	ARM64
Linux	x64
Arch Linux / Omarchy	x64

校验文件：SHA256SUMS。各安装包的 .sha256 文件也可在下方 Assets 中下载。

更新日志

Added

• GitHub Release 新增按平台和架构排列的下载表格，包含安装包徽章按钮与 SHA-256 校验入口；发布时根据已校验的产物清单自动生成当前版本的下载链接。

• Arch Linux / Omarchy x86_64 新增原生 pacman 包及 make arch-package 本地构建入口，安装桌面入口、图标与固定路径的凭据程序；标签发布在 Arch 容器构建和验证，统一校验版本、来源与 SHA-256。

• 项目采用 MIT 许可证，所有平台发布包附带项目许可证和第三方图标许可。

• Linux x64 与 ARM64 新增 AppImage 发布包和 make appimage 本地打包入口，包含桌面入口、应用图标及依赖；发布流程校验包内元数据与 SHA-256，凭据程序使用持久的 AppImage 文件路径，支持重启后继续由 Codex 调用。

• 添加或编辑模型时可设置自定义 User-Agent（含常用预设）及本地路由 Header / Body 覆盖，支持批量应用、JSON 高亮与即时校验；请求定制卡片采用平滑展开和标签切换动画，并遵循减少动态效果设置。配置按模型保存，仅在发布后的本地路由生效，备用上游独立配置，认证与路由关键字段不可覆盖。

• API 连接编辑器新增「请求定制」卡片，可为连接下的所有模型设置默认 User-Agent 与 Header / Body 覆盖；模型自己的设置在其上合并并优先生效，同样仅在本地路由生效。展开卡片时取代配置预览，收起后恢复。

• 活动页新增清空全部请求记录入口、居中确认卡片和清空反馈，提供逐条退场、耗时图收拢与空状态渐入动画，并遵循减少动态效果偏好。

• 新增「用量」页：按今天、近 24 小时、近 7 / 14 / 30 / 90 天或全部查看 Token、缓存命中率、请求数与估算费用，趋势图可在 Token、费用、请求间切换；按连接与按模型排行可直接点选筛选，另有活跃时段热力图和可展开的明细列表，侧栏显示今日用量。

• 用量页的时间范围选择器支持精确到分钟的自定义范围：日历上依次点选开始与结束日期，悬停即预览范围，也可逐段键入或用方向键调整年月日时分；结束时间可跟随当前时刻，开始晚于结束时给出提示并暂不应用。趋势按范围长短自动按小时、天、周或月分段，汇总下方显示实际起止时间；面板展开、月份切换与端点选中带有过渡动画，并遵循减少动态效果偏好。

• 经 SwitchX 路由的请求实时记录上游返回的用量；直连、原生 Codex 登录与其他提供方的用量从 Codex 会话日志增量导入，按响应 ID 去重，只读取 Token 数、模型与时间。

• 数字滚动、缓存环、构成色带、柱形波浪生长与悬停提示平滑跟随，并遵循动画开关与系统减少动态效果偏好。

• 「数据来源」抽屉可关闭会话日志扫描、立即同步或在备份数据库后重新导入；「定价」抽屉按模型填写每百万 Token 的美元或人民币价格，未定价的模型排在最前。

• 活动页的请求条目显示 Token 用量，展开后可查看输入、缓存、输出与推理明细。

Changed

• 移除订阅账号改为居中确认卡片：以账号与 SwitchX 之间的连线示意移除，悬停确认按钮时预演断开、确认后完成断开；逐条说明将清除的凭据、是否一并删除 Codex 登录文件，被连接引用时列出关联连接并禁止移除；遵循减少动态效果偏好。
• 「准备启用模型」由居中弹窗改为右侧侧边栏；检查详情按运行环境、模型映射、受管变更、账号绑定与注意事项分组展示，展开时分段渐入、映射连线依次点亮并自动滚动跟随，模型较多时可折叠其余映射，并遵循减少动态效果偏好。
• macOS 发布包由 zip 改为 DMG 磁盘映像，打开后将 SwitchX 拖到「应用程序」即可安装；应用仍为 ad-hoc 签名，首次打开需在系统设置中允许。

Fixed

• 通用配置编辑器的 config.toml 卡片边框不再被代码区和头尾栏的背景盖住，左右边与圆角完整显示，聚焦时的品牌色描边同样贯穿整圈。
• 请求定制禁止覆盖 Azure 风格的 api-key 认证头，大小写变体同样受保护，防止绕过供应商密钥输入流程。
• macOS 上直接从磁盘映像或系统临时隔离位置（App Translocation）运行 SwitchX 时，不再把推出映像或重启后失效的程序路径写入 Codex 凭据配置；直连和 API 路由会拒绝应用，并提示将 SwitchX 拖到「应用程序」后重新打开。
• 添加 API 连接时，在模型目录获取模型后返回连接设置，「默认模型 ID」仍可从下拉中选择获取结果，未填写时自动选用目录首个模型或获取结果首项；未设置默认模型时保存会提示到连接设置填写，不再误报模型 ID 字符无效。
• 系统辅助功能处于活动状态时（如 VoiceOver 或读取窗口内容的应用），用量页滚动不再明显掉帧：每条明细作为一个可展开的列表项朗读完整信息，折叠时不再挂载详情内容。

SwitchX v0.1.0

Added

• 添加连接时可获取、查看和编辑模型目录，支持切换保留草稿，并将连接与目录一并保存。
• 管理 Responses API 连接、ChatGPT 与 Grok 订阅账号及额度。
• 连接页支持一键检查所有连接凭据，复用各卡片的检查流程并独立显示进度和结果。
• 统一模型目录，按唯一显示名称路由，支持直连与备用 API 上游。
• 预览 Codex 配置、记录受管改动并恢复，查看不含正文与凭据的请求记录。
• 支持浅色与深色主题、搜索模型、批量添加模型以及 macOS 菜单栏。
• 设置页采用分区卡片，新增主题缩略预览、交互动效演示和可展开的配置恢复区，并适配减少动态效果偏好。
• 全局按钮统一采用柔和扫光动效，覆盖图标、导航及自定义操作按钮，并遵循动画开关与系统减少动态效果偏好。
• 启用确认改为居中面板，突出模型数量、可读默认模型与配置影响，检查明细可展开；新增分层入场、检查环与完成反馈动画，并适配减少动态效果。
• 默认模型及检查明细统一展示模型名称，名称重复提示也使用显示名称，避免显示内部路由模型 ID。
• 启用检查与应用配置提供独立等待状态，新增呼吸圆点、流光骨架条和检查结果过渡，并适配减少动态效果。
• 统一应用与 UI crate 的版本号，提供 switchx --version 和发版准备命令。
• 侧栏底部显示应用版本号，并随工作区版本自动更新。
• 推送、PR 与发版前置检查均在 GitHub 托管 Linux x64 runner 上自动检查和测试；版本发布时构建 macOS、Windows、Linux 的 x64 与 ARM64 包。
• 推送版本标签后自动创建 GitHub Release，附上 changelog、六个平台包和 SHA-256 校验文件。

Fixed

• 修正 Windows 平台分支的 Clippy 警告，以及测试对本机 Codex 和固定 Python 路径的依赖，使六个平台的 CI 可在干净环境中运行。
• 修正四个示例探针中同类的 Windows Clippy 警告，保留 Unix 临时目录的私有权限。
• 思考等级选择器测试按可访问性标签点击实际控件，避免字体改变弹窗位置时点击错误；元素调试信息仅用于测试构建。
• 修正仅在 Unix 运行的直连集成测试的导入作用域，避免 Windows 的未使用导入阻止 CI。
• 账号存储锁在操作结束时显式解锁，避免克隆或继承的文件句柄造成占用误报。
• 测试清理临时文件前释放 SQLite 连接，并固定 TOML 测试样例的 LF 换行符，修正 Windows CI 的文件占用和文本比较失败。