Starstruk Logo MarkStarstruk

v2.7.9

BenedictKing/ccxv2.7.9May 20, 2026by github-actions[bot]

AI Summary

Launches the CCX Desktop Assistant MVP and resolves critical issues with Gemini tool calling, subscription handling, and Wails runtime compatibility.

Key Highlights

  • Release of CCX Desktop Assistant MVP based on Wails3
  • Comprehensive fixes for Gemini tool calling (ID conflicts, state flags)
  • Automatic failover for subscription errors and malformed tool calls
  • Optimized key masking for better usability

New Features

  • CCX 桌面助手 (MVP) - Desktop app with background service control
  • Chat 渠道透传思考回传支持 - Support for returning reasoning content
  • Gemini 渠道工具调用功能修复 - Fixes for tool ID, text blocks, and signatures
  • 空/畸形 Tool Call 自动重试 - Auto-retry for invalid tool calls
  • 余额不足自动故障转移 - Failover for subscription errors
  • 密钥脱敏优化 - Improved key masking logic
  • 桌面外壳 Wails Runtime 兼容性修复 - Fixes for 422 errors

Full Release Notes

### ✨ 新功能

- **CCX 桌面助手 (MVP)** - 推出基于 Wails3 的桌面应用程序，支持 CCX 服务后台启动、停止、重启以及托盘快捷运行，内嵌状态监控与 Web 管理界面
- **Chat 渠道透传思考回传支持** - 在 Chat 渠道对齐 Messages 渠道，增加“回传 Reasoning Content”支持，可控制向客户端回传 DeepSeek 等模型思考内容

### 🐛 修复

- **Gemini 上游兼容性与工具调用（Tool Use）修复**
  - **修复多轮工具调用丢失与重复调用问题**：解决走 Gemini 上游时 MCP 与自定义工具历史在特定场景下被静默丢弃、导致上游重复发起同一调用的 Bug
  - **修复工具调用 ID 冲突**：优化 Gemini 流式响应中的工具调用 ID 生成机制，保证跨多轮对话时的唯一性，避免 Agent 复杂场景下冲突
  - **修复流式工具调用状态标志**：修正 Gemini 流式响应在 functionCall 时的 `stop_reason`，使其正确对齐 Claude Messages 规范（输出 `tool_use` 状态）
  - **修复空 text 块和 tool_result 解析报错**：解决特定 Gemini 上游因为遇到空文本 Part 或非标 tool_result 数组而返回 400 错误的问题
  - **对齐 thought_signature 参数机制**：确保 Claude→Gemini 转换时正确遵循渠道 thought_signature 注入/剔除开关，并补齐 Chat、Responses 等多渠道控制链路
- **空/畸形 Tool Call 自动重试** - 在 Fuzzy 模式下自动捕获并忽略上游返回的空参数或非法 JSON 工具调用，静默触发 Failover 自动故障转移，防止客户端中断
- **余额不足自动故障转移** - 将 `SUBSCRIPTION_NOT_FOUND` / `no active subscription found` 正确识别为余额不足，自动触发渠道黑名单与故障转移
- **密钥脱敏优化** - 修复控制台启动日志对超短密钥（长度 ≤ 4）脱敏过度（全部遮蔽）的问题，在保证安全的前提下保留首尾部分字符以便识别
- **桌面外壳 Wails Runtime 兼容性修复** - 升级内部 Wails3 与前端依赖工具链，彻底消除桌面操作中由于绑定传输导致的 422 错误

### 🔧 改进

- **代码质量重构** - 清理 `providers` 历史 lint 告警，完善 JSON 解析错误检查，提高系统整体鲁棒性

---

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