uni-switch 0.5.25

uni-switch v0.5.25

本版修复 Claude 模型被无差别改成兼容别名、档位请求误选默认模型的问题，并完善旧配置升级。

更新内容

• Sonnet、Opus、Haiku、Fable 与 anthropic/claude-* 保留真实模型 ID；只为 Claude 桌面端无法识别的模型生成本地兼容路由，转发时恢复真实上游 ID。
• 带发布日期的档位请求优先匹配已启用同档模型；明确停用的模型、未知模型和失效别名返回错误，避免静默调用其他模型。Fable 未配置时优先使用已启用 Opus；非 Claude 默认模型继续承接没有对应档位的内部请求。
• 补齐 Claude CLI 的 Fable 档位、旧版名称识别及恢复；将 [1m] 转成桌面 supports1m 能力，同模型普通与 1M 变体合并，模型列表与 profile 保持一致。
• 兼容旧哈希别名和受管 profile 回读；旧映射显示“更新配置”，保留冲突确认、备份、回滚和原配置恢复。
• 对照 cc-switch v4.0.12 与 2026-10-15 main 提交 09237ebd；保持现有协议检测、八档思考菜单及上下文同步规则。

升级后生效

更新 uni-switch 后，在对应 Claude 桌面端或 CLI 页面点击“更新配置／重新应用”，然后完全退出并重新打开对应客户端、新开对话。需要 OpenAI 转 Claude 的接入请保持 uni-switch 后台运行；软件升级不会替你操作真实客户端或绕过外部配置冲突。

本地验证：前端 182 项、Rust 193 项通过（另 1 项环境辅助 ignored）；TypeScript/Vite、Windows 桌面 Clippy、QA 构建、格式与教程一致性通过。隔离真实 Claude CLI 分别通过 Messages、Responses、Chat Completions 完成流式调用，桌面 profile 回放验证正确的上游模型 ID、旧别名与日期后缀，前端运行错误为 0。验证使用合成密钥与本地模拟服务；未进行真实供应商计费请求，未声称所有 Claude Desktop 版本均经过真实会话验收。

源码与构建

• 对应源码提交：36eb2314d85623cb690aacdae01b8c1a1acf154f。
• 修复与发布 PR：#6 。
• 三平台原生构建：https://github.com/dieqiyun/uni-switch/actions/runs/38754098643 。
• 发布标签 v0.5.25、七个程序附件及完整源码 ZIP 均对应此提交；SHA256SUMS.txt 覆盖程序、源码与使用说明。

下载选择

系统	附件
Windows x64	uni-switch_0.5.25_x64-setup.exe
Windows 便携	uni-switch_0.5.25_x64-portable.zip 或 uni-switch_0.5.25_x64.exe
Linux x64	uni-switch_0.5.25_amd64.deb 或 uni-switch_0.5.25_x86_64.AppImage
macOS Intel / Apple Silicon	uni-switch_0.5.25_universal.dmg 或 uni-switch_0.5.25_universal.app.tar.gz
精确对应的完整源码	uni-switch_0.5.25_source.zip
使用说明与校验	README-zh-CN.md、SHA256SUMS.txt

许可保留 AGPL-3.0-only；三平台程序、源码归档与发布标签对应同一提交。macOS 使用 ad-hoc 签名，尚无 Apple Developer ID 公证；首次打开受阻时核对来源与 SHA256，再按系统安全设置允许打开。Windows 未新增代码签名证书。Linux AppImage 缺少 FUSE 时可使用 --appimage-extract-and-run。

不删除、替换或移动历史发布及标签。

uni-switch 0.5.24

uni-switch v0.5.24

本版修复 Claude Messages 供应商用于 Codex 时的 assistant prefill 错误，更新 ZCode、DSH、WorkBuddy 官方图标，并完善新客户端的原生地址和认证配置。

更新内容

• 修复 Codex 对话历史以助手进度或回复结束时，上游拒绝 assistant prefill 的问题。保留历史、思考签名与工具结果，按需追加 user 续接指令；未完成的工具调用要求先补齐真实结果。上下文压缩继续使用独立历史摘要逻辑。
• ZCode、DSH（DeepSeek Harness）、WorkBuddy 使用各自官网原始图标，本地打包，无需联网加载图标；修复窄窗口标签文字与图标挤压，补齐标签页可访问性关联。
• 修复原生 OpenAI 客户端使用裸站点地址时漏掉标准 /v1 的问题。保留明确填写的自定义 API 前缀与完整端点，避免重复拼接。
• ZCode / DSH 正确导出 x-api-key 认证头。WorkBuddy 当前一键配置要求 Chat Completions 与 Bearer 认证，不兼容认证在写入前提示并保留原文件。
• 保留既有八档思考菜单和上下文同步规则。

使用与兼容范围

升级后回到对应客户端页重新「一键配置」，确认保存提示后完全退出并重开客户端、新开对话；手动修改过的配置仍需确认覆盖。升级程序不会替用户重启 Codex、Claude 或其他客户端。

ZCode / DSH 使用自己的原生 SDK 直连供应商，不经过 Codex 转换桥。若原生客户端向 Messages 发送 assistant 结尾历史，拒绝 prefill 的上游仍可能报错；ZCode 的会话中 system 扩展也可能被旧网关拒绝。供应商明确支持 Chat Completions 时可选择该协议；仅支持 Messages 的供应商需要客户端或网关支持相应消息特性，不能靠更改协议名称转换接口。

本地验证：174 项前端、186 项 Rust 测试通过（另 1 项原有环境辅助 ignored）；隔离真实 uni-switch IPC 导出 78 组配置，ZCode / DSH SDK 捕获 238 次模拟请求，其中 230 次正常通过、8 次按预期复现上述兼容边界。WorkBuddy 验证 6 组配置格式，未验证其完整执行程序；不将 SDK 检查称为所有客户端完整 agent 流程或所有真实供应商的兼容保证。

对应源码提交：78bc8dec0bf3d61d1c5ac91ac24944ec4e75390d，经 PR #5 合并；v0.5.24 标签固定在该提交。

正式发布验证：GitHub Actions 三平台原生构建、Rust / Clippy、隔离启动全部成功；macOS 验证 arm64 与 x86_64 和 ad-hoc 签名。三组 build-manifest 的提交、版本与每项产物 SHA256 匹配，完整源码归档 470 个文件与标签源码匹配（PowerShell 按仓库声明转换 CRLF）。

下载选择

系统	推荐附件
Windows x64	uni-switch_0.5.24_x64-setup.exe
Windows 便携	uni-switch_0.5.24_x64-portable.zip
Linux x64	uni-switch_0.5.24_amd64.deb 或 uni-switch_0.5.24_x86_64.AppImage
macOS Intel / Apple Silicon	uni-switch_0.5.24_universal.dmg
对应完整源码	uni-switch_0.5.24_source.zip

macOS 使用 ad-hoc 签名，尚未经过 Apple Developer ID 签名与公证；首次打开受阻时先核对来源和 SHA256，再在系统「隐私与安全性」允许打开。Linux AppImage 需要可执行权限，缺少 FUSE 时可使用 --appimage-extract-and-run。Windows 当前未新增代码签名证书。

保留 AGPL-3.0-only，提供 Windows、Linux、macOS 程序、精确对应同一提交的 source.zip、README-zh-CN.md 使用说明及 SHA256SUMS.txt。不删除、替换或移动历史发布和标签。

uni-switch 0.5.23

uni-switch 0.5.23 · 2026-10-09

Claude CLI 400 修复

• 修复本地 Claude → OpenAI 转换桥拒绝 system 消息、报「Claude 消息 role 必须为 user 或 assistant」的问题。
• 保留追加指令的位置、角色、临时失效规则与逐轮思考强度，覆盖 Responses / Chat Completions、普通 / 流式回复及本地 token 计数。
• 升级后重新启动 uni-switch 和 Claude CLI，再新开对话。若渠道原生提供 Claude Messages，核对实际协议并重新应用；模型名或供应商分组不代表上游协议。

ZCode、DSH、WorkBuddy 一键配置

• 左侧选择新客户端，共用现有供应商记录一键写入原生配置。
• ZCode / DSH 支持 Messages、Chat Completions 与 Responses。WorkBuddy 使用 Chat Completions 自定义模型；重启后在 WorkBuddy 模型选择器选用，旧版目录可手动指定。
• 提供目录选择、外部变更确认、备份、恢复原配置和保存后的重启提示。

查看和编辑客户端配置

• Codex / Claude Code 在设置中打开「查看 / 编辑配置文件」，ZCode / DSH / WorkBuddy 在各自页面打开。
• 显示实际路径，主动选择文件后读取；手动编辑 JSON / TOML / YAML，格式校验与备份成功后保存，提示完全退出客户端并新开对话。
• 保留未保存草稿；外部修改、符号链接和重解析点拒绝访问或写入。多文件操作有中断恢复，手动修改后的供应商重用需确认。

下载

• Windows x64：推荐 uni-switch_0.5.23_x64-setup.exe，也提供 portable.zip 和独立 EXE。
• Linux x64：DEB / AppImage；AppImage 需要桌面环境、WebKitGTK 4.1 与可执行权限，缺少 FUSE 时使用 --appimage-extract-and-run。
• macOS Intel + Apple Silicon：通用 DMG / app 归档。
• uni-switch_0.5.23_source.zip 为与三平台程序同一提交的完整 AGPL-3.0-only 源码；另提供 README-zh-CN.md 和 SHA256SUMS.txt。

从托盘退出旧版后升级；更新不会替你修改或重启客户端。Windows 程序未使用商业代码签名；macOS 使用 ad-hoc 签名，尚未经过 Apple 公证。首次启动请核实来源与校验值。

验证范围

本地前端 174 项、Rust 180 项通过（另 1 项原有忽略项），六客户端隔离配置界面验证通过；实际 Claude Code CLI 请求在隔离中继追加官方 system 消息，旧程序复现截图 400，修复版两接口成功回复。全部使用合成密钥与本地服务，未覆盖报错用户的具体请求体或真实付费上游。

发布前通过 PR 必需检查、Windows / Linux / macOS 原生构建及隔离启动，并校验构建提交、固定附件清单与上传回读 SHA256。完整说明见 CHANGELOG.md、docs/client-config-editor.md 和 docs/claude-system-compatibility.md。

构建源码提交：f6edf9bcab997de2d03975a258af58d5987d3d4f；v0.5.23 标签与全部程序使用同一提交。

uni-switch 0.5.22

uni-switch 0.5.22 · 2026-10-09

Claude 接入修复

• 修复 Claude Code 桌面端和 CLI 把带 /v1 的接入地址重复拼成 /v1/v1/messages，出现 404 或“模型不可用”的问题。
• 仅整理写入客户端的地址，保留保存的上游地址、自定义前缀、端口、认证和模型 ID。
• 已使用旧地址的供应商显示“更新配置”。升级后选择 Claude Code 对应目标，点击“更新配置”，按提示重启客户端并新开对话。外部配置修改仍受保护。

协议与新模型能力

• 根据全部分页模型目录的接口声明识别协议；Messages 网关使用 OpenAI 格式模型列表时也能正确识别，手动协议设置优先。
• 模型资料支持手动、上游、内置和待确认状态，补充 Haiku 5.5、DeepSeek V4.1 Flash 等型号及思考参数、思考历史、每模型接口路由适配。
• 模型详情可查看能力来源和思考模式、手动调整或恢复自动。原有八档客户端菜单和上下文同步规则保持不变。
• 能力验证需明确确认，每次只发送一条受限合成请求，不发送真实会话或执行工具，不保存密钥和响应正文。验证可能由供应商计费；500 等失败保持待确认，不自动重试或永久禁用模型。
• 已加入 Ed25519 签名校验、版本防回退和离线缓存；当前生产签名源尚未配置，仍使用内置和上游资料，不宣称已启用独立在线资料更新。

下载与升级

• Windows x64：推荐 uni-switch_0.5.22_x64-setup.exe；也提供便携 ZIP 和独立 EXE。
• Linux x64：提供 DEB 和 AppImage。AppImage 需可执行权限、桌面环境及 WebKitGTK 4.1；缺少 FUSE 时可使用 --appimage-extract-and-run。
• macOS：提供 Intel + Apple Silicon 通用 DMG 和 app 归档。构建及隔离启动使用 macOS 15 Intel runner，另核对双架构及 ad-hoc 签名。
• uni-switch_0.5.22_source.zip 是与三平台构建同一提交的完整 AGPL-3.0-only 源码；使用方法和校验值见 README-zh-CN.md、SHA256SUMS.txt。
• 从托盘退出旧版再安装升级。软件内每次仍可选择 GitHub 手动下载或远程更新，安装需要确认。

Windows 程序未使用商业代码签名；macOS 使用 ad-hoc 签名，尚未经过 Apple Developer ID 签名与公证。首次打开请核对来源与校验值。Linux / macOS 请手动重启相应客户端；第三方 Gateway 的实际权限和兼容性取决于客户端版本与供应商部署。

验证

前端 166 项、Rust 161 项测试通过（另 1 项环境辅助测试忽略），完成隔离模型配置及真实 Claude Code CLI 回归：旧地址复现 404，修复后流式请求成功。发布前要求 PR 全部必需检查、Windows / Linux / macOS 原生构建及隔离启动成功，并校验固定产物清单、对应源码和上传附件 SHA256。真实付费上游没有被上述合成测试覆盖。

完整记录与操作说明见仓库的 CHANGELOG.md、docs/claude-native-base-url.md、docs/model-capabilities.md。

uni-switch 0.5.21

uni-switch v0.5.21

本版包含远程更新、切换后的新对话提醒，以及 Codex 默认模型/思考强度和配置冲突修复。

更新内容

• 切换后请新开对话：写入配置后的弹窗明确提醒，旧 Codex 会话及重启后恢复的会话可能仍使用原模型与思考强度；软件教程同时说明供应商使用记录与本地配置状态的区别。
• 每次选择更新方式：左下角更新入口提供「GitHub 手动下载」和「远程更新」，不记忆选择，不后台下载安装。远程更新显示进度、支持取消，校验大小、SHA256 与包格式；完成后仍需确认安装。
• 修复思考强度丢失：供应商未设置明确强度时，重新应用、编辑与切换会保留 Codex 已选的合法 xhigh 等强度；供应商明确设置优先。
• 显示实际全局配置差异：受管配置文件里的模型/强度不同于供应商默认时，列表显示差异并允许「重新应用」，不把默认值称为当前会话请求。
• 配置冲突可确认覆盖：点击「使用」遇到外部修改时，可取消或强制覆盖并使用。确认后先备份，保留无关设置；确认期间再次变化则要求重新确认。
• Claude 未运行时，实际写入后也显示后续启动和新对话提醒；历史配置不重复弹窗。

下载选择

系统	推荐附件
Windows x64	uni-switch_0.5.21_x64-setup.exe
Windows 便携	uni-switch_0.5.21_x64-portable.zip
Linux x64	uni-switch_0.5.21_amd64.deb 或 uni-switch_0.5.21_x86_64.AppImage
macOS Intel / Apple Silicon	uni-switch_0.5.21_universal.dmg
对应完整源码	uni-switch_0.5.21_source.zip

本次首次升级到 v0.5.21 的旧版用户，请从 GitHub 下载新版；安装本版后，后续更新可选择软件内远程下载。

远程更新的 Windows 路径会启动安装向导并退出 uni-switch；macOS 打开 DMG 后需要退出旧版并拖入 Applications；Linux 由系统安装 DEB，或按提示替换 AppImage。更新期间协议转换暂时中断，建议先结束正在进行的请求。软件不会自动修改客户端会话或替用户重启 Codex / Claude。

macOS 包采用 ad-hoc 签名，尚未经过 Apple Developer ID 签名与公证；首次打开受阻时请先核实来源与校验值，再在系统「隐私与安全性」中允许。Linux AppImage 需要可执行权限，缺少 FUSE 时可使用 --appimage-extract-and-run。

发布保留 AGPL-3.0-only，提供完整仓库源码、与三平台程序同一提交的 source.zip、README-zh-CN.md 使用教程和 SHA256SUMS.txt 校验值，不替换历史发布。构建与隔离验证成功不等于所有 Codex / Claude 版本的实机兼容验证；实际权限和上游模型映射仍取决于供应商。

uni-switch 0.5.20

uni-switch 0.5.20 · 三平台开源版

本版恢复完整开源发布，并提供 Windows、Linux 和 macOS 程序。项目采用 AGPL-3.0-only，Release 标签与三平台程序的源码提交一致。

• Windows x64：安装 EXE、独立 EXE、便携 ZIP。
• Linux x64：DEB 与 AppImage，原生 Ubuntu 22.04 runner 构建。
• macOS：通用 DMG 与 app.tar.gz，同时支持 Intel 和 Apple Silicon，最低 macOS 11。
• 更新检测按当前系统选择对应安装包；macOS / Linux 可直接打开更新、教程和官网。
• 保留 0.5.19 的 GPT 图片输入修复、逐模型能力自动匹配与手动配置、双向协议转换。
• 完整源码、锁文件、资源、教程和 GitHub Actions 原生构建脚本已公开；附件包含对应 source.zip 和 SHA256SUMS.txt。

首次配置：选择客户端 → 填 API 地址和 Key →「添加并使用」→ 重启目标客户端。图片能力在「管理模型」中设置。详细步骤见附件 README-zh-CN.md 或软件左下角「使用说明」。

Windows 推荐下载 x64-setup.exe；Linux Ubuntu / Debian 推荐 amd64.deb，AppImage 需可执行权限，FUSE 不可用时可用 --appimage-extract-and-run；macOS 打开 universal.dmg 并拖入 Applications。

macOS 使用 ad-hoc 签名，尚未经过 Apple Developer ID 签名及公证；首次打开如被阻止，请核对官方发布来源和 SHA256 后，在「系统设置 → 隐私与安全性」允许。Windows 程序也未购买代码签名证书。

三平台支持配置写入和本地协议转换；自动客户端重启与系统登录启动当前限 Windows，macOS / Linux 请手动重启。Claude 桌面第三方模型配置需实际客户端支持 Gateway。CI 验证原生构建、隔离启动及配置/转换逻辑，不代表所有真实客户端版本均经过实机验证。

完整源码与许可 · 使用教程 · 供应商赞助

uni-switch 0.5.19

uni-switch 0.5.19

修复支持图片的 GPT 在 Codex 中被错误识别为仅文本的问题，并增加逐模型能力配置。

• 模型配置新增「图片输入」及 Codex「并行工具调用」开关，显示自动匹配、上游返回、手动或待确认来源。
• 自动匹配经官方资料核实的当前 GPT / Codex、Claude、Gemini 等型号；保留老款纯文本模型例外。无法识别的自定义型号可手动开启能力。
• 手动设置优先，刷新保留设置，可恢复自动；取消不写入，确认保存后应用并提示重启。
• 启动时自动修复仍由 uni-switch 管理的旧模型目录，保留 API Key、模型选择、上下文和外部修改保护。
• 两方向协议转换保留图片内容；内置使用说明补充模型能力与图片报错处理。

升级后请完全退出并重新打开 uni-switch，按提示重启 Codex，在新会话中测试图片。 自定义型号请在「管理模型」中确认图片输入，然后保存并应用。开启能力不能让真实纯文本上游获得视觉能力。

Windows x64 推荐 uni-switch_0.5.19_x64-setup.exe；便携用户解压 uni-switch_0.5.19_x64-portable.zip 后运行。完整离线教程随程序及 README-zh-CN.md 附件提供。

本次仅发布编译程序、使用说明和 SHA256 校验，不上传新的源码。GitHub 自动生成的 Source code 是原有仓库的历史源码快照，不对应 v0.5.19 程序。

uni-switch 0.5.18

uni-switch 0.5.18

本版简化首次接入，并补充完整教程与明确的更新提醒。

• 删除「导入现有配置」按钮及其后台功能。首次接入只需 API 地址和 Key，点击「添加并使用」。
• 软件内「使用说明」提供八类可离线阅读的教程：首次配置、日常切换、模型与上下文、Fast 与思考强度、协议转换、余额、设置更新、常见问题。
• GitHub 使用教程与软件共用内容，README 增加仅列蝶祈云的供应商赞助区和详细介绍。
• 检测到新版时，左下角明确显示「发现新版本」、目标版本号和「立即更新」。重新检测或网络失败保留已知提醒，点击后查看更新说明并前往下载。
• 外部配置修改仍受到保护：撤回相应修改后再重试；不会通过导入静默接管外部变更。

完整使用教程 · 供应商赞助名单 · 源码与许可

Windows x64 推荐下载 uni-switch_0.5.18_x64-setup.exe。便携用户下载 uni-switch_0.5.18_x64-portable.zip，解压后运行 uni-switch.exe。更新前从托盘退出旧版；协议转换需要软件保持后台运行。

发布采用 AGPL-3.0-only，提供对应源码归档和 SHA256 校验值。GitHub 更新检测不自动覆盖正在运行的程序。

uni-switch 0.5.17

uni-switch 0.5.17

本次首次公开完整源码，采用 AGPL-3.0-only 开源协议。

• 左下角版本号可检查更新，启动时自动检测 GitHub 最新正式版。
• 供应商列表显示自动检测的 OpenAI / Claude 协议，并提供双向转换开关。
• 独立黑白应用标志，Claude 原版彩色 Logo，蝶祈云紫色品牌及居中官网入口。
• 模型同步移除上游已下架项，自动替换失效默认模型；失败保留原列表，取消不写入。
• 保存并应用后自动更新 Codex 模型目录，并提示重启加载最新列表。
• 设置中可查看源码和完整许可；安装包、便携包附带第三方通知。

下载

普通用户请选择 uni-switch_0.5.17_x64-setup.exe。便携版解压后运行；独立 EXE 需要已安装 WebView2。升级前从托盘退出旧版。

对应源码与许可

源码：v0.5.17 标签，或下载附件 uni-switch_0.5.17_source.zip，包含对应源码、资源、依赖锁文件与构建说明。

本项目许可为 AGPL-3.0-only，第三方依赖保留原许可。源码与程序附件均列于 SHA256SUMS.txt。

uni-switch 0.5.16

uni-switch 0.5.16 新增 GitHub 版本检测。

• 启动时自动检查最新正式版本，运行期间每六小时检查一次。
• 设置中可点击“检测更新”，查看最新版本、更新说明和上次检查时间。
• 发现新版后，底部显示下载入口；点击前往 GitHub 发布页下载。
• 网络失败、未发布版本或限流会显示具体原因，保留上次查询结果。
• 当前版本相同或更高时不提示降级；忽略草稿和预发布版本。

升级前请从系统托盘退出旧版，再安装或启动新版。安装版以 x64-setup.exe 结尾，便携版以 x64-portable.zip 结尾，解压后运行 uni-switch.exe。SHA256SUMS.txt 提供附件校验值。

本仓库仅分发已编译程序、使用说明和校验文件，不包含应用源码。请下载 Release 附件中的程序，GitHub 自动生成的 Source code 压缩包仅包含发布仓库的说明文件。