v2.7.12

BenedictKing/ccxv2.7.12May 21, 2026by github-actions[bot]

AI Summary

Major release introducing a Wails3 desktop shell, session scheduling dashboard, and comprehensive fixes for vision routing, caching, and Gemini compatibility.

Key Highlights

  • Launch of CCX Desktop Shell (Wails3) with system tray and service management
  • New Session Scheduling Dashboard for real-time active conversation monitoring
  • Vision capability routing to support models that handle image content
  • Enhanced Gemini channel compatibility and tool calling stability

New Features

  • CCX 桌面外壳 - Wails3 desktop app with tray support
  • Responses Compact 本地压缩 - Local compression for non-native upstreams
  • 会话调度看板 - Real-time active session monitoring
  • 会话标题持久化 - Title persistence across restarts
  • Vision 能力路由 - Dynamic routing based on image content
  • 缓存读写总统计 - Global and model cache token stats
  • 渠道统计对齐接入点统计 - Channel Key trends with 7d/30d views
  • 桌面端渠道预设下拉显示实际 Base URL

Full Release Notes

### ✨ 新功能

- **CCX 桌面外壳** - 新增 Wails3 桌面应用,支持服务启动/停止/重启、系统托盘驻留和状态监控
- **Responses Compact 本地压缩** - 非原生 Responses 上游自动本地压缩对话历史,支持流式/非流式
- **会话调度看板** - 管理界面新增 Sessions 标签页,可实时观察活跃对话并自定义渠道优先级序列
- **会话标题持久化** - 对话标题支持本地持久化,服务重启后仍保留标题和创建时间
- **Vision 能力路由** - 支持根据请求是否包含图片内容动态跳过不支持 vision 的渠道/模型
- **缓存读写总统计** - 全局和模型统计图表新增缓存 Token 读写统计展示
- **渠道统计对齐接入点统计** - 渠道 Key 趋势图新增 7d/30d 时间维度,并展示总请求/成功率/Token 汇总卡片
- **渠道预设 Token Plan 下拉显示实际 Base URL** - 桌面端渠道预设下拉选项显示实际 Base URL

### 🐛 修复

- **MiMo 流式响应只输出 thinking** - 修复 MiMo 渠道多轮对话时 thinking/reasoning_content 回传不一致导致的多种问题
- **Gemini 渠道工具调用功能修复** - 修复 tool_result 函数名错位、tool ID 不稳定、空 text part 触发 400 等多个 Gemini 兼容性问题
- **Chat 渠道透传思考回传支持** - Chat 渠道现在支持与 Messages 渠道一致的思考内容回传
- **Responses SSE keep-alive** - 为 Responses 流式代理增加 keep-alive,防止慢上游期间断连
- **空/畸形 Tool Call 自动重试** - Fuzzy 模式下空参数或非法 JSON 的工具调用自动触发重试
- **SUBSCRIPTION_NOT_FOUND 余额不足故障转移** - 识别余额不足错误并正确触发渠道切换
- **桌面外壳 Wails Runtime 422** - 升级 Wails3 消除桌面端事件订阅和 binding 调用错误
- **Windows 兼容性修复** - 修复 Windows 平台编译兼容性问题
- **Override 熔断自动清除** - 当覆盖序列中所有渠道均不可用时自动清除 override
- **Claude 协议空 Text Block 兼容** - 新增开关自动移除空 text block,兼容严格校验的上游
- **OpenAI Provider 缓存 Token 丢失** - 修复协议转换时丢弃上游缓存 token 的问题

### 🔧 改进

- **Messages 渠道模型列表兼容国内 Claude 协议入口** - 模型列表获取自动尝试多段候选 URL
- **渠道熔断状态下发前端** - 管理界面可实时显示渠道熔断状态
- **Docker 构建优化** - 使用 Go 交叉编译替代 QEMU 模拟,显著缩短 CI 构建时间

---

**Full Changelog**: https://github.com/BenedictKing/ccx/compare/v2.7.5...v2.7.12