本项目遵循 Keep a Changelog 的记录方式，并使用语义化版本号。
- Codex 官方 OAuth 登录后，ChatGPT Desktop 写回的默认模型不再阻止切换到未指定模型的第三方渠道；空模型现在会明确清除旧的模型覆盖。
- Codex 第三方渠道改用
OPENAI_API_KEY环境变量认证，不再复用刚完成的 ChatGPT OAuth；Windows、macOS 与 WSL2 会自动同步当前渠道，并在切回官方账号时清除第三方变量。
- 将 GitHub Actions 的 Intel macOS runner 从已淘汰的
macos-13迁移至macos-15-intel，Apple Silicon runner 和 macOS 构建 runner 迁移至macos-15，恢复四平台自动发布流水线。
- 修正 macOS 原生 runner 中 WSL2 模拟安装测试的 Grok 登录断言：仅在真实 Linux 内核上要求
--device-auth，macOS 则验证标准grok login。
- 在 Unix 安装器合约测试失败时，将末尾测试输出同时写入 GitHub Actions 错误注释，便于无需下载私有日志即可定位 macOS / WSL2 runner 问题。
- 将安装器、Unix 打包器和原生安装测试中的 GNU 专用
dirname --/grep --参数改为 macOS BSD 工具兼容写法。
- 使 Codex、Pi、Grok Build 的官方登录测试夹具按运行平台生成
.cmd或可执行 shell 脚本，保证 Linux、macOS Intel 与 macOS Apple Silicon runner 可以完成原生测试后再构建发布包。
- 发布改由 GitHub Actions 的 tag 工作流完成：先执行 Windows、Linux、macOS Intel、macOS Apple Silicon 测试，再分别在 Windows、macOS、Linux runner 构建三个 ZIP 并创建 Release。
- Windows 打包脚本可选择单个平台；新增 Unix 原生打包脚本，供 macOS 与 WSL2 包的对应 runner 使用。
v0.4.0为本地打包的首次公开发布；v0.4.1起的 Release 使用自动化验证与构建流程。
- Pi：支持官方订阅登录（进入 Pi 后执行
/login）及第三方渠道；第三方 provider 写入~/.pi/agent/models.json，当前选择写入settings.json。 - Grok Build：支持
grok login官方登录及第三方渠道；第三方模型写入~/.grok/config.toml，支持responses、chat_completions、messages后端。 - Web UI、TUI 和 CLI 均可在 Codex、Claude、Pi、Grok Build 四个工具之间切换渠道。
- Pi / Grok 的切换前备份、失败回滚、macOS / WSL2 配置目录和 Windows
.cmd启动器兼容处理。
- WSL2 上的 Grok 官方登录自动使用设备授权；Pi 官方登录保持 Pi 自身的交互式
/login流程。
- macOS（Intel / Apple Silicon）和 WSL2 的
install.sh安装器。 - WSL2 的独立 Linux 配置模式与共享 Windows Desktop 配置模式。
- macOS Intel、Apple Silicon、Windows 和 WSL2 的自动化安装及渠道切换验证。
- 独立的 Windows、macOS、WSL2 分发包，避免跨平台误装。
- Windows 对
.cmd、.bat、.ps1Codex CLI 启动器的兼容处理。
- 切回 Codex 官方账号时，清理残留的第三方 provider、模型覆盖、第三方 Base URL 与 API Key 配置。
- 官方登录先切换至官方渠道，再启动浏览器登录流程。
- 修复 Windows 上直接调用 npm 生成的
codex.cmd时无法启动默认浏览器登录的问题。 - macOS 安装时根据当前 shell 更新
~/.zshrc或~/.bashrc，不再固定修改.bashrc。
- 修复官方 Codex 配置中 provider 选择残留导致的
Model provider "custom" not found。
- 初始 Windows 版渠道管理、Web UI、终端界面、备份与 WSL 渠道导入功能。