v2.8.20

Nutlope/llamacoderv2.8.20Jun 1, 2026by github-actions[bot]

AI Summary

This release enhances the desktop Codex Agent with dual-mode support and improves configuration management with multi-editor support. It also introduces a new user guide for the WebUI and allows custom API key usage for OpenAI direct connections.

Key Highlights

Desktop Codex Agent supports shortcut/plugin dual modes
Config files support opening in multiple editors
Channel center prioritizes configured API Keys
WebUI includes new user onboarding guide
OpenAI direct connection supports custom API Key

New Features

Desktop Codex Agent dual mode (shortcut/plugin)
Multi-editor support for desktop config files
Channel center optimization (API Key priority)
Codex channel template auto-review redirect
WebUI new user guidance
OpenAI direct connect custom API Key toggle

Full Release Notes

### ✨ 新功能

- **桌面端 Codex Agent 支持快捷/插件双模式** - 可在更轻量的代理接入和支持插件的原生接入之间切换，并在需要迁移会话时提示用户
- **桌面端配置文件支持多编辑器打开** - 在存在多个编辑器时，可直接选择要使用的编辑器
- **渠道中心优化常用渠道展示** - 已配置 API Key 的渠道优先展示，便于快速选择
- **Codex 渠道模板新增自动评审重定向** - 新增 codex-auto-review 相关重定向能力
- **WebUI 新增新用户指引** - 帮助首次使用者更快理解渠道配置流程
- **OpenAI 直连支持自带 API Key 开关** - 可明确选择是否使用自己的 OpenAI API Key

### 🐛 修复

- **修复浏览器直达 WebUI 参数残留问题** - 移除不应出现在浏览器直达场景中的桌面端参数
- **修复默认语言选择逻辑** - 默认改为中文，并支持根据浏览器语言自动检测
- **修复渠道置顶后顺序异常** - 渠道置顶后会保持预期排序
- **修复 Codex 认证配置不一致问题** - Codex 配置写入、展示和插件模式认证行为保持一致
- **修复渠道排序优先级失效问题** - 渠道 priority 会优先生效，已配置 Key 状态仅作为兜底排序因素
- **修复 Linux 桌面端数据目录位置** - Linux 下改用符合 XDG 规范的数据目录
- **修复配置预览脱敏不准确问题** - 密钥脱敏改为字段级处理，避免误掩码普通配置项或漏报短密钥变更
- **修复 OpenAI 直连 API Key 校验与残留问题** - 关闭自带 Key 时清空旧值，开启时必须输入 Key

### 🔧 改进

- **移除左上角 Logo 的 GitHub 跳转** - 减少误点击跳转
- **配置预览文件标签展示增删行数** - 更直观查看配置变化规模
- **更新桌面安装文档** - 补充 Windows Store 与 Homebrew 安装说明
- **完善排障指南** - 增加各入口快速验证命令和代理/TUN 相关排查建议

---

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