v2.8.21

lutzroeder/netronv2.8.21Jun 4, 2026by github-actions[bot]

AI Summary

Major update featuring a native desktop management console and a comprehensive refactor of channel and session management for improved user experience.

Key Highlights

  • Native desktop management console replacing iframe WebUI
  • Channel management refactor with quick paste mode
  • CLI options for backup directory and runtime paths
  • Session cockpit waterfall layout redesign

New Features

  • Native management console
  • Channel management refactor
  • CLI --backupdir option
  • CLI custom runtime path
  • LOG_DIR=none support
  • Channel-level request timeout config

Full Release Notes

### 🚀 新增

- **桌面端原生管理控制台** - 桌面端原生管理控制台替代 iframe WebUI,完整覆盖 i18n,管理入口统一命名为 Dashboard
- **桌面端渠道管理重构** - 添加渠道简化为快速粘贴模式(支持 Cmd/Ctrl+Enter 创建),编辑渠道弹窗对齐 WebUI 核心交互,新增预设模板、模型拉取、高级选项分组、Base URL 预览、服务类型动态排序、模型映射协议预置列表与 filter chips、API Key 必填校验
- **桌面端渠道操作增强** - 渠道卡片支持置顶置底并增加删除守卫,渠道日志弹窗重构为可展开列表并支持自动刷新,删除渠道时显示 loading 遮罩,模型重定向 target 输入框始终提供候选
- **桌面端会话驾驶舱重构** - 会话驾驶舱重构为瀑布流卡片并对齐 WebUI cockpit,能力测试对话框对齐 WebUI,能力测试多 job 并发轮询修复
- **桌面端 Codex 会话迁移** - 添加 Codex 会话迁移支持,快捷/插件模式切换对齐 WebUI
- **CLI --backupdir 选项** - 新增 `--backupdir` 选项指定配置备份目录
- **CLI 自定义运行时路径** - 支持自定义运行时路径
- **LOG_DIR=none 禁用日志文件** - 支持 `LOG_DIR=none` 环境变量禁用日志文件写入
- **渠道级请求超时配置** - 后端渠道配置新增 `requestTimeoutMs`,非流式上游请求优先使用渠道超时,未设置或为 0 时继承全局 `REQUEST_TIMEOUT`

### 🐛 修复

- **messages**: system 角色归一化对所有上游生效
- **日志 store 改用 metricsKey 分桶** - 根治删除渠道后日志串桶问题
- **模型过滤拒绝非法字符** - 模型过滤拒绝顿号等非法字符并按分隔符拆分
- **余额不足/套餐过期自动拉黑** - 补全 403 关键词自动拉黑,改为双词组合匹配覆盖更多上游变体
- **下架已停用 GPT 模型** - 从能力测试候选、模型重定向候选和预设中移除 `gpt-5.2` / `gpt-5.2-codex` / `gpt-5.3-codex`,haiku 映射改为 `gpt-5.4-mini`
- **桌面端编辑渠道大量 UI 修复** - 快捷键与底部操作栏、Esc/Enter 快捷键、窄窗口布局、高级选项平铺 Runtime/Transport 分组、Website 移入连接分组、模型卡片布局、noVisionModels 合并行级 toggle、思考强度/Text verbosity 下拉修复、popover 主题变量补全、移除冗余 Latency 列与重复快捷键提示、保存快捷键统一为 Cmd/Ctrl+Enter
- **桌面端快速粘贴优化** - Textarea 高度修正、自动应用识别结果、自动补全 name/serviceType、按钮提示显示平台对应修饰符、移除 Service Type 识别卡片
- **桌面端 Dashboard 修复** - 移除轮询可见性检查修复渠道列表不自动刷新、管理面板 Tabs 配色对齐深色主题、备用池文案对齐 WebUI、驾驶舱命名对齐并移除手动刷新、网关监控按钮改为「打开管理面板」
- **桌面端模型列表修复** - 拉取补传 key 参数修复 'No API key provided' 错误、源模型列表对齐 WebUI allSourceModelOptions、预设数据与按钮分组完全对齐 WebUI
- **桌面端移除一键配置已下线模板** - 移除 gpt-5.3/gpt-5.2 模板,haiku 改映射到 gpt-5.4-mini
- **桌面端渠道中心恢复原有 ChannelTab 界面** - 移除渠道测速按钮,补齐编辑弹窗快捷键
- **桌面端 i18n 补全** - 编辑渠道界面、编辑弹窗新增 i18n keys 等缺失翻译补全

### ♻️ 重构

- **桌面端管理入口命名统一** - 管理入口统一命名为 Dashboard,隐藏批量测速按钮,移除 Codex 分组冗余开关
- **桌面端编辑渠道布局对齐** - 请求超时从基础信息移入 Runtime 分组,抽取渠道草稿保存逻辑统一提交路径
- **渠道管理清理** - 移除未使用代码(开启 noUnusedLocals)、删除渠道编辑弹窗冗余元素

### 📝 文档

- **Docker 部署示例修正** - 修正 Docker 部署示例与实际 compose 保持一致
- **LOG_DIR=none 补充文档** - 补充 `LOG_DIR=none` 禁用日志文件文档及测试用例
- **新增 TODO 待办任务文档**

---

**Full Changelog**: https://github.com/BenedictKing/ccx/compare/v2.8.20...v2.8.21