v2.9.1

BenedictKing/ccxv2.9.1Jun 17, 2026by github-actions[bot]

AI Summary

Enabled runtime timeout hot updates, introduced in-line model mapping, and completed desktop internationalization.

Key Highlights

  • Runtime timeout hot update
  • In-line model mapping editor
  • Active rate limiting sliding window algorithm
  • Desktop i18n migration

New Features

  • Runtime timeout hot update via responseHeaderTimeoutMs
  • CompactModel configuration for Responses channel
  • In-line model mapping editor for all channel types
  • Active rate limiting with sliding window
  • b64_json image response auto-conversion
  • Desktop charts alignment with Web UI
  • Kimi Coding Plan model redirection
  • Desktop i18n with vue-i18n
  • Claude Fable model support
  • Channel-level active rate limiting and auto-tracking
  • Codex/Responses layered troubleshooting diagnostics

Full Release Notes

### ✨ 新功能

- **运行时超时热更新** - 新增 `responseHeaderTimeoutMs` 渠道字段,支持运行时超时热更新,熔断器/调校台新增超时滑块
- **CompactModel 配置支持** - Responses 渠道新增压缩模型配置,支持自动选择
- **内联模型映射编辑器** - 所有渠道类型支持内联编辑模型映射,无需弹窗
- **主动限速滑动窗口算法** - 令牌桶改为滑动窗口算法,支持可配置窗口时长,自动学习上游限速默认开启
- **b64_json 图片响应自动转换** - 支持 b64_json 请求的 URL 响应自动转换
- **流式空响应可读错误文案** - 流式响应场景向客户端下发可读错误信息而非空流
- **桌面端图表功能对齐 Web 端** - 桌面端控制面板使用统计图表与 Web 端完全对齐
- **渠道活动图表背景可视化** - ChannelCard 新增活动图表背景
- **Kimi Coding Plan 模型重定向与智能排序** - Kimi 渠道实现 Coding Plan 模型重定向与智能模型排序
- **快速模式与历史图片轮次限制配置** - Web 端补全快速模式与历史图片轮次限制配置
- **桌面端 i18n 全面国际化** - 迁移到 vue-i18n + 外部 JSON 语言文件,渠道编辑、控制台、图表等全面 i18n 化
- **桌面端 MiniMax M3 / 讯飞星辰 / OpenRouter / ModelScope 渠道预设** - 新增多个渠道预设支持
- **桌面端 Codex/Responses 分层排障诊断** - 新增分层排障,按顺序检查配置一致性、渠道可用性、最近失败请求
- **驾驶舱 Override 有效期可配置** - 支持通过环境变量和前端选择器持久化配置 override 有效期(15min/30min/1h/2h/永不恢复),对话活跃时自动续期
- **Claude Fable 模型支持** - 新增 Claude Fable 系列模型映射,升级时自动补齐配置
- **渠道级主动限速与上游 rate limit 自动追踪** - 新增渠道级令牌桶限速、并发控制与 cooldown 机制,自动解析上游限速响应头
- **弹窗快捷键提示** - 所有弹窗添加 ESC 取消与 Cmd/Ctrl+Enter 确认快捷键提示
- **桌面端管理面板集成用量统计图表** - 管理面板新增用量统计图表展示

### 🐛 修复

- **临时限流不触发 Key 黑名单** - 临时限流场景不再误将 Key 加入黑名单
- **REQUEST_TIMEOUT 默认值从 300s 调整为 120s** - 调整默认请求超时为更合理的 120 秒
- **保留 web_search 工具以兼容 Codex v0.139.0+** - Responses 场景保留 web_search 工具兼容新版 Codex
- **修复重叠 tool_use 导致 Content block not found 错误** - 按 content block index 管理 tool_use 缓冲
- **Responses 认证头修复** - serviceType claude 路径正确使用 x-api-key 认证头
- **REWRITE_RESPONSE_MODEL 支持 Responses API** - Responses API 场景正确支持模型名重写
- **模型映射编辑修复** - 修复模型映射值保存失败、combobox 值规范化等问题
- **限速配置修复** - 修复 0 值显示为空、窗口时长清空后无法保存等问题
- **流式响应 stop_details 字段补齐** - 流式响应补充 stop_details 字段处理
- **过滤 compaction 流式响应中的推理内容** - Responses compaction 场景过滤推理内容,避免重复输出
- **识别 messages→responses 桥接下的上游错误** - 修复桥接场景下上游错误未被正确识别的问题
- **桌面端 Codex 排障改进** - 排障诊断改为按需触发,修复忽略 UI 选择目标模式的问题
- **桌面端 fetch 网络层错误包装** - 避免管理面板显示原始错误信息
- **Docker Watchtower 迁移至社区维护镜像** - 修复已归档官方镜像导致的 API 版本兼容性问题

### 🔧 改进

- **渠道编辑器全面重构** - 左侧导航+右侧面板布局,拆分快速添加与编辑弹窗
- **高级选项分组重构** - 创建运行期策略分组,主动限速拆分为独立分组
- **模型映射区域深度重构** - 行内可编辑、视觉回退模型行内开关驱动
- **快速添加面板重构** - 紧凑两栏布局、卡片式分块布局
- **桌面端渠道编辑创建流程重构** - 统一使用 t 多语言函数,对齐内容顺序与 WebUI
- **熔断器/调校台滑块设计重构** - 参考 Web 端样式,增强可见性和对比度
- **桌面端渠道卡片状态展示重构** - 统一交互逻辑、展开按钮与统计图表折叠优化
- **前端构建增加双层缓存** - 避免重复编译,加速构建

**Full Changelog**: https://github.com/BenedictKing/ccx/compare/v2.8.26...v2.9.1