Releases: xiaocoss/quotio-desktop
Quotio v0.5.6
v0.5.6 - 2026-06-30
重要修复:顺序故障转移的优先级此前一直没真正生效。
修复
- 顺序故障转移现在真的会按你排的顺序用号。此前 Quotio 把账号优先级写到了 auth 文件的错误位置(嵌套字段),CLIProxyAPI 实际读的是文件顶层的
priority字段——结果优先级被代理完全忽略,它退回按文件名字母序选号,所以无论你怎么拖拽排序,流量都恒定落在某个固定账号上、切不到你的 #1。现已写到正确位置,排序即时生效(无需重启代理),装新版后会自动迁移现有账号文件。
安装包见下方附件:Windows .msi / -setup.exe · macOS .dmg(通用包,未签名;首次在「系统设置 → 隐私与安全性」放行)· Linux .AppImage / .deb。
本版安装包已内置代理核心与 Kiro/插件,装完即用,首次运行无需联网下载核心。
Quotio v0.5.5
v0.5.5 - 2026-06-30
这一版让顺序故障转移更名副其实:你的 #1 偶发抽风不再被长时间打入冷宫,且能一眼看清此刻真正在扛流量的是哪个号。
改进
- 顺序故障转移更「黏住」你的 #1:该模式现在让代理关闭冷却——高优先级号偶发 5xx / 限流时只临时绕过这一次请求,不再被惩罚性冷却(原本越叠越久、最长锁死 30 分钟);一恢复立刻用回你的 #1,不会让流量长期落在低优先级号上。(切进 / 出该模式会自动重启一次代理来生效,约 2-3 秒;不影响你在设置里手动调的冷却开关。)
- 「主用」跟着真正在服务的号走:额度页 / 服务商页的主用高亮与「主用:xxx」文案,现在标注的是此刻真正在扛流量的账号(按优先级取第一个健康可用的号),而不是固定显示优先级最高的号;圆圈序号 ①②③ 仍是你排的优先级顺序。
安装包见下方附件:Windows .msi / -setup.exe · macOS .dmg(通用包,未签名;首次在「系统设置 → 隐私与安全性」放行)· Linux .AppImage / .deb。
本版安装包已内置代理核心与 Kiro/插件,装完即用,首次运行无需联网下载核心。
Quotio v0.5.4
v0.5.4 - 2026-06-30
这一版打磨账号 UX:重新授权时看清/复制是哪个账号,额度页也能直接看到故障转移顺序。
新增
- 重新授权弹窗显示当前账号:点账号的「重新授权」时,弹窗顶部直接标出正在重授的账号(点击展开完整邮箱),并提供一键复制——去浏览器登录时不再认错号。
- 额度页按调度顺序排 + 圆圈序号:开启智能调度 / 顺序故障转移后,额度页账号卡片按请求顺序排列(主用在最前),并打上与服务商页一致的圆圈数字徽章(①=当前主用、描边=候补、虚线=暂不可用本轮跳过)。关闭调度时保持原序、无徽章。
安装包见下方附件:Windows .msi / -setup.exe · macOS .dmg(通用包,未签名;首次在「系统设置 → 隐私与安全性」放行)· Linux .AppImage / .deb。
本版安装包已内置代理核心与 Kiro/插件,装完即用,首次运行无需联网下载核心。
Quotio v0.5.3
v0.5.3 - 2026-06-29
这一版新增顺序故障转移调度模式:按你排好的账号顺序请求,当前号坏了由代理无感切到下一个,客户端不再先收到一次错误。
新增
- 顺序故障转移(账号调度新模式):额度页「账号调度」开关改为「关闭 / 智能调度 / 顺序故障转移」三选一。顺序故障转移不像智能调度那样只留一个号在池子里,而是让所有健康账号都在线,并把你在服务商页排好的顺序写成代理优先级——代理按序用号,当前号失败(鉴权失效 / 额度耗尽)时自动顺延到下一个、不把错误返回给客户端,做到请求层面的无缝衔接。两种调度模式都支持服务商页的顺序徽章与手动拖拽排序。
说明
- 顺序故障转移需要 CLIProxyAPI ≥ 7.2.x;切到该模式会自动让代理按账号顺序用号,切回其它模式还原默认路由。
- 「主用」徽章按代理实际会先用的号标注(上游抖动导致主号暂时查不到额度时也不会误标);健康隔离依旧生效,连续失败的号会被隔离、不参与顺延,恢复后自动归队。
安装包见下方附件:Windows .msi / -setup.exe · macOS .dmg(通用包,未签名;首次在「系统设置 → 隐私与安全性」放行)· Linux .AppImage / .deb。
本版安装包已内置代理核心与 Kiro/插件,装完即用,首次运行无需联网下载核心。
Quotio v0.5.2
v0.5.2 - 2026-06-29
这一版主打账号「请求顺序」可视化 + 手动排序,并把上一版的健康隔离与智能调度继续打磨。
新增
- 账号请求顺序徽章 + 手动优先级:开启智能调度后,服务商页每个账号行打上圆圈数字徽章,标出被请求 / 选用的先后(①=当前激活、描边=候补、虚线半透明=暂不可用本轮跳过)。可用拖拽手柄或 ↑ / ↓ / 置顶按钮手动排序,一键「重置为自动顺序」。手动优先级是硬偏好——排好后激活号立刻按你的顺序走,坏了才落到下一个。
改进
- 健康隔离区分原因:鉴权失效的号才提示「需重新授权」;额度耗尽的号改标「额度耗尽 · 待刷新」、不再误导你去重新授权(等窗口刷新自动恢复)。
- 智能调度切号更快更准:当前号遇鉴权失败(401/403)第一次就切、不等防抖;其余失败(5xx / 网络抖动)连续 3 次才切,防上游抖动空切。后台每 ~30s 主动探一次当前目标号:token 过期可刷新的提前刷新、真坏掉的提前切,把「闲置一段后首个请求」的报错也省掉。
修复
- 非-Codex 账号(Claude / Copilot 等)健康恢复后不再永久卡在隔离:探测成功但暂无用量窗口的健康号不再被丢弃,能被对账确证健康、解除隔离。
- 账号文件改为原子写,避免与代理热重载抢读时读到半截内容损坏凭据。
安装包见下方附件:Windows .msi / -setup.exe · macOS .dmg(通用包,未签名;首次在「系统设置 → 隐私与安全性」放行)· Linux .AppImage / .deb。
本版安装包已内置代理核心与 Kiro/插件,装完即用,首次运行无需联网下载核心。
Quotio v0.5.1
v0.5.1 - 2026-06-28
这一版聚焦账号「健康隔离」:鉴权失效 / 被强制 403 的账号会被自动移出路由池,代理不再反复打到一个要重新登录的号上。
修复
- 关了智能调度时,遇到需重新授权(403)的账号也会自动切走:此前健康隔离只在调度开启的分支里生效,关掉智能调度后,代理会一直把请求打到一个已失效、需重新登录的账号上。现在健康对账无条件先行,鉴权失效 /
auth_failed的账号无论调度开关都会被隔离,额度恢复后自动放回。 - 手动「启用」账号不再被残留标记悄悄回滚:之前账号若带着调度待命标记,手动启用后下一轮会被重新禁用,看着像点了没用。现在启用会一并清掉待命 / 健康隔离标记(绑定登录的账号仍保持禁用)。
- 用户手动禁用的健康账号不再被自动重新启用:历史遗留的自动复原逻辑会无视用户意图把禁用号重新打开;现已移除,禁用状态以用户操作为准(历史裸禁用号需手动再启用一次)。
- 账号文件改为原子写:写隔离 / 启用标记时先写临时文件再整体替换,避免与代理热重载抢读时读到半截内容、损坏账号凭据。
安装包见下方附件:Windows .msi / -setup.exe · macOS .dmg(通用包,未签名;首次在「系统设置 → 隐私与安全性」放行)· Linux .AppImage / .deb。
本版安装包已内置代理核心与 Kiro/插件,装完即用,首次运行无需联网下载核心。
Quotio v0.5.0
v0.5.0 - 2026-06-27
这一版是稳定性 / 安全性集中大修 + 体验打磨,含一次对整个代码库的系统排查与逐项修复。
新增
- 悬浮窗(托盘额度面板) 仿 CodexBar:常驻置顶、点托盘图标切换显隐、长按窗口任意处即可拖动移位。
- 额度刷新进度条:手动刷新额度时,右下角改为确定性进度条「正在加载额度 X / N」,多账号也能看着一格格涨满,不再干转圈、看着像卡死。
- 更新失败可重试:自动更新的检查 / 安装失败后,弹窗新增「重试」入口(有待装更新则重试安装,否则重新检查)。
- 设备码登录遵守服务器返回的轮询间隔与
slow_down退避,避免被限流误判。
改进
- 窗口控件(左上角交通灯)打磨更精致:细内描边让浅底上边界清晰、悬停轻微放大、配色更柔和。
- 安全加固:启用内容安全策略(CSP),收紧脚本 / 样式 / 连接来源;含管理密钥与 API key 的配置、OAuth token、
~/.codex/auth.json等凭据文件在 Unix 上收紧到0600;capabilities权限按实际所需收窄;下载的代理核心二进制增加 SHA256 完整性校验。 - OAuth 更稳:所有出站请求加连接 / 读取超时(网络半开不再永久卡住登录线程);token 交换遇上游瞬时 5xx / 断连改为让前端在有效期内重试,而非一次抖动就把登录钉死。
- 写上游代理地址失败不再裸报「管理接口返回 HTTP 400」:版本不支持该运行时端点时静默降级(设置已存进
config.yaml、代理热重载会生效),地址不可达 / 无效时给出清晰提示。 - 透明无边框窗口在 macOS 上真正透明(修四角白直角)。
修复
- 核心锁中毒不再砖化整个 UI:某个持锁线程一旦 panic,过去会让所有命令永久失败、界面卡死;现在统一自动恢复并清除毒化标记。
- 多账号刷新不再冻 UI:把若干同步命令里的阻塞健康探测移出主线程。
- 日志「请求」tab 的删除:此前点删除毫无反应(它清的是另一份「代理日志」,而非你看到的请求记录)。现在真正清空请求历史,并改为 app 内二次确认 + 显示真实条数,避免误删全部用量历史(它与仪表盘数据同源)。
- 仪表盘:并发刷新时旧结果不再覆盖新结果、查询失败有明确反馈、自动刷新定时器不再被每次筛选打断。
- 第三方自定义服务商绑定密钥不再误报「密钥未绑 Codex」。
- 悬浮窗:浅色主题下不再透出桌面深色;拖动时不再被误判为失焦而自动隐藏。
- 其它:token 计数溢出保护、用量记录去重不再误删不同请求、agent 备份恢复增加路径校验防穿越等。
安装包见下方附件:Windows .msi / -setup.exe · macOS .dmg(通用包,未签名;首次在「系统设置 → 隐私与安全性」放行)· Linux .AppImage / .deb。
本版安装包已内置代理核心与 Kiro/插件,装完即用,首次运行无需联网下载核心。
Quotio v0.4.8
v0.4.8 - 2026-06-23
新增
- 账号导入兼容
accounts-export.json格式({ accounts: [{ token, refreshToken, email, accountId, … }] }):自动把每个账号的扁平驼峰令牌转换成 CLIProxyAPI codex 账号(token→access、refreshToken→refresh、accountId→account_id),按codex-<邮箱>.json落地、支持一个文件多账号。该格式不带id_token,导入时写空串占位,CLIProxyAPI 首次请求会用refresh_token续期补全。
改进
- 「API 密钥」页防呆警告:给密钥绑定了服务商、但运行环境缺少
quotio-key-router插件时,弹横幅提示「绑定不会生效,代理仍按全局轮询命中所有池」。此前是悄无声息——看着绑了 Codex,请求却可能被轮询到别的池(用户实测踩坑)。 - 安装包资源打包改为显式映射(
bundle.resources不再用../回溯):避免 Tauri 把..转义成_up_/…导致内置 CLIProxyAPI 核心 / key-router 插件定位失败、首次运行误联网下载核心。让「装完即用、不联网」在 macOS 上也真正兑现(本机 Windows 已实锤资源从_up_/…改落到resources/proxy/…)。 - 加固管理 API 与 Cloudflare 隧道流程:管理接口端点 URL 构造更稳(支持 HTTPS / 路径拼接);cloudflared 下载、解包(
.tgz)、赋可执行更健壮;端口占用的进程检测与按端口杀进程更可靠。
修复
- 发版 CI:macOS / Linux 的 key-router 插件改为下载失败即报错(此前静默降级
rm,可能悄悄出一个不带插件、「按 key 路由」失效的包)。
安装包见下方附件:Windows .msi / -setup.exe · macOS .dmg(通用包,未签名;首次在「系统设置 → 隐私与安全性」放行)· Linux .AppImage / .deb。
本版安装包已内置代理核心与 Kiro/插件,装完即用,首次运行无需联网下载核心。
Quotio v0.4.7
v0.4.7 - 2026-06-22
改进
- 启动方案行加回「编辑」按钮(在
启动和删除之间):点开把该方案预填进表单,改完「保存方案」就按 id 更新那一条,不必删了重建。
修复
- 修复停止 / 切换 Codex 后,上一套方案的 codex 进程没被杀掉、还拿着旧 key 在发请求:此前「关 Codex」只按
Codex.exe杀桌面应用 —— 用「终端」方案起的 codex(原生 CLI 二进制名可能带平台后缀、或是 node 起的)根本杀不掉,而终端又是用wt开的、记下的 pid 是个转瞬即逝的启动器并不可靠。结果切方案后旧 codex 还活着,日志里一直冒上一套方案的请求(典型:停了卫龙换成 codex,日志还在请求卫龙、会话卡思考)。现在改为按codex*进程名 + node 命令行一并收掉,停止 / 切换 / 启动自愈都生效。
安装包见下方附件:Windows .msi / -setup.exe · macOS .dmg(通用包,未签名;首次在「系统设置 → 隐私与安全性」放行)· Linux .AppImage / .deb。
本版安装包已内置代理核心与 Kiro/插件,装完即用,首次运行无需联网下载核心。
Quotio v0.4.6
v0.4.6 - 2026-06-22
修复
- 优化应用内「检查更新」的端点容错:可用镜像
ghfast.top提到首位、新增备用镜像gh.ddlc.top、原始github.com直链移到末位。此前首选是github.com直链(墙内必失败),唯一镜像偶发 SSL 连接被重置时整个检查就报错(error sending request);现在任一镜像被重置还有兜底,少踩「要点几次才成」的坑。
安装包见下方附件:Windows .msi / -setup.exe · macOS .dmg(通用包,未签名;首次在「系统设置 → 隐私与安全性」放行)· Linux .AppImage / .deb。
本版安装包已内置代理核心与 Kiro/插件,装完即用,首次运行无需联网下载核心。