Codex-X/CHANGELOG.md

Changelog

All notable changes to Codex-X will be documented here.

[Unreleased]

[v0.3.7] - 2026-08-02

修复 Bug

• 修复了一些 bug。

[v0.3.6] - 2026-07-31

更新

• 供应商与 OpenAI Official 切换改为热更新；切换后新建会话即可生效，不再要求重启 Codex 客户端。
• macOS 关闭主窗口后进入顶部栏驻留模式，Windows 隐藏任务栏窗口；托盘菜单仍可恢复窗口或明确退出应用。
• 新增独立的项目维护日志，记录配置写入、供应商切换、会话同步和桌面生命周期的长期约束与验证依据。

修复 Bug

• 修复官方认证被第三方供应商覆盖或清除的问题；第三方密钥仅写入当前 provider，官方 ChatGPT 登录与官方 API Key 均使用独立快照保存并可往返恢复。
• 修复编辑活动供应商会新建副本、重复导入 cc-switch 供应商产生多条相同记录，以及旧版 cc-switch 数据库缺少 category 字段时无法读取官方认证的问题。
• 修复供应商、提示词及其他配置操作并发写入时可能覆盖或破坏 config.toml 的问题；写入现在使用跨进程锁、原始快照、条件原子替换和失败回滚。
• 修复会话同步显示成功但 Codex 未实际使用同步结果的问题；只处理活动 SQLite，严格校验 SQLite 指定的 rollout 路径、文件身份和线程 ID，并兼容 codex-dev.db 与显式 sqlite_home 下的自定义数据库名。
• 修复会话列表将旧数据库或孤立 JSONL 计入活动会话、把 JSONL 记录行数误当会话数，以及同步过程中修改非活动数据库或工作目录字段的问题。

[v0.3.5] - 2026-07-28

更新

• GitHub 指令提示词现在可以直接查看和编辑本地内容；模板名称和文件名继续跟随在线目录，Markdown 内容由用户在现有提示词编辑页中维护。
• 模板内容实际修改后会标记为“本地已修改”，后续同步永久跳过该模板的远端内容，同时继续发现和下载 GitHub 新增模板；启用时优先使用用户的本地版本。
• 仅查看或保存未变化的内容不会退出 GitHub 同步；本地修改在下次启用该模板时生效。

修复 Bug

• 修复 jsDelivr @main 目录缓存旧版本时，“同步 GitHub 模板”只能看到 5 个模板、无法发现仓库中 11 个模板的问题；目录成员现在始终由 GitHub 源站确认，源站不可用时仍保留 CDN 和本地缓存回退。
• 修复当前使用中转供应商且 live auth.json 不存在时，概览页错误显示“认证文件未找到”的问题；已保存的官方认证快照现在会显示为“官方认证已保存”。

[v0.3.4] - 2026-07-28

更新

• 在线提示词库新增 3 套软件开发模板和 3 套写作辅助模板，并按照模板文件名前缀自动归入对应分类；用户手动分类仍然优先。
• 软件开发分类新增“长期维护工程师”“系统化调试与根因修复”“严格代码审查”，其中“长期维护工程师”来自项目当前实际使用的维护规范。
• 写作辅助分类新增“清晰表达与润色”“技术文档写作”“结构化长文起草”。6 套新增模板通过 GitHub 在线同步，不增加安装包体积。

修复 Bug

• 彻底隔离 OpenAI Official 与中转供应商认证：切换到中转前保存可信的官方配置快照，切回官方时恢复该快照，避免 auth.json 被中转或 cc-switch 覆盖后导致官方登录失效。
• “还原官方配置”现在只恢复独立快照，不再自动切换当前供应商；新增“新建官方配置”，可清除受污染的 live auth.json 并引导用户重新完成官方登录。
• 优化官方 auth.json 编辑器的高度、换行和长 Token 选取体验，避免内容看起来被截断或只能依赖底部横向滚动条。

[v0.3.3] - 2026-07-26

调整

• 暂时下线皮肤中心并隐藏侧边栏入口，皮肤页面、运行时实现和用户本地主题文件继续保留，后续可以通过统一功能开关重新启用。
• 升级后会自动暂停 Codex-X 此前启用的皮肤并恢复官方显示；若自动停用失败，应用会显示明确错误，不会让用户在入口隐藏后失去恢复提示。
• 内置“椎名真白·樱花画室”不再注册为随应用编译的主题，其约 1.7 MB 壁纸不再进入正式安装包；主题源文件仍保留在仓库中。

[v0.3.2] - 2026-07-25

修复 Bug

• 修复 Windows Codex 冷启动或进入新版首页、外观设置页时，皮肤运行时因只识别旧版主壳层和侧栏而错误提示“未找到经过验证的 Codex 渲染器”的问题；首次连接现在会等待页面渐进加载，并兼容渲染文档切换。
• “关闭皮肤”保持为随时可用的异常恢复入口，不再因运行状态刷新延迟、皮肤部分失效或其他操作卡住而无法点击；恢复期间仍会阻止重复提交和其他皮肤写操作。

安全

• 新版 Windows 页面检测继续要求官方进程、回环 CDP、app:// 协议以及 Codex 壳层、首页或外观设置页的明确锚点，不会向普通网页或无标记辅助页面注入皮肤。

[v0.3.1] - 2026-07-24

更新

• 皮肤中心重新设计主题画廊：直接展示真实壁纸和侧边栏、会话区、输入框、按钮等整套界面效果，单个主题不再拉伸占满整行，并移除端点、目录、theme.json 路径和主题包结构等开发者信息。
• 皮肤中心新增可管理的分类筛选并进一步压缩主题卡片密度；导出主题时改用系统“另存为”窗口选择目录和文件名。
• 支持直接从图片创建自适应主题，并可编辑主题名称、简介和界面透明度；内置主题与图片主题共用相同的编辑与预览规格。
• 主题画廊根据当前分类数量自适应 1 至 4 列，少量主题保持紧凑，多个主题充分利用可用宽度。
• 实机换肤扩展到 Windows：动态校验官方 OpenAI.Codex Store 包，安全启动仅绑定回环地址的 CDP 会话，并在 Windows 发布包中附带固定校验的 Node.js 22 运行时；不修改 WindowsApps、app.asar 或权限。
• 皮肤中心只保留“关闭皮肤”入口，移除与其重复的“恢复官方外观”按钮；底层完整恢复能力继续保留用于异常恢复。

修复 Bug

• 修复 macOS 皮肤已经注入后 Codex-X 仍长期显示“应用中”、重开后无法识别当前主题的问题；单次注入现在会明确退出，外部命令带有硬超时，并可从经过验证的 Codex 主进程恢复遗失的本机调试端口。
• 修复皮肤尚未运行时错误显示“重新应用”、刷新缺少明确反馈，以及提示词或皮肤卡片过多时页面无法继续向下滚动的问题。
• 优化普通横图在新任务首页超宽横幅中的自动焦点，避免人物头部被居中 cover 裁掉；主题包仍可通过 art.focusY 显式覆盖自动位置。
• 修复切换到中转供应商时覆盖官方 auth.json 的问题，官方登录凭据与供应商凭据现在分别保存和恢复。
• 改进 Codex Desktop 检测，兼容更多安装路径、包标识和版本输出格式，减少部分用户错误显示“未检测到 Codex”的情况。
• 修复启用皮肤后新会话输入框消失、输入框出现会话内容穿透，以及图片主题预览错误使用默认背景的问题。
• 修复浅色主题的固定白色遮罩洗淡壁纸颜色的问题；壁纸保持原图色彩，卡片和项目选择区域跟随透明度，同时为输入框保留可读性下限。

安全

• 换肤运行时只连接经过签名、进程归属和页面标记验证的官方 Codex，并将 CDP 限制在 127.0.0.1；停止注入器前会核对 PID、启动时间、Node 路径、脚本路径和端口。
• 主题导入增加 ZIP 越界、符号链接、重复文件、文件数量、图片大小和 Manifest 字段校验；运行时使用稳定快照，避免主题切换时配置与图片不一致。

开发

• 固定复用 Codex Dream Skin Studio 5fd8af532efbaa87d2d0092297fd2d45cd56574e 的 MIT 注入实现，并加入 Rust 与 Node 专项回归测试；未包含上游声明为非 MIT 授权的真人主题素材。

[v0.3.0] - 2026-07-16

更新

• 全面升级桌面界面，统一各页面布局、按钮、弹窗和 Toast，并加入深浅色模式与页面过渡动画。
• 新增应用内更新：macOS、Windows MSI 和 Linux AppImage 可直接下载、安装并重新启动；发现更新时会在侧边栏显示入口和进度。
• 完善供应商管理：删除增加二次确认，连接测试改用 /v1/models，添加或编辑时可获取并选择模型，同时简化 OpenAI Official 页面。
• 完善指令提示词管理：新增分类功能，内置两套新模板，精简模板卡片，添加或编辑后只保存、不自动启用。
• 在线提示词会在启动后后台同步并保存到本机；支持 CDN、GitHub 备用源和系统代理，离线时也能使用上次同步内容。
• 简化会话管理：统一同步到当前供应商，取消启动时自动修改，并支持查看、选择和删除内部会话。
• 优化 Skills/MCP 导入，自动排除已经导入的内容，没有新内容时不再弹出空窗口。

修复 Bug

• 修复旧提示词配置可能导致 Codex 报 expected u32，以及 Windows .codex 使用链接目录后无法正常读写的问题。
• 修复会话同步可能改写聊天内容、出现 invalid_id_prefix、重复显示会话或覆盖正在写入记录的问题。
• 修复深浅色模式下的文字、滚动条、复选框和弹窗显示异常，以及弹窗打开后背景仍能滚动的问题。
• 修复提示词缓存延迟造成的重复同步、错误更新或误删除，并修复应用内更新失败后的错误状态提示。

兼容说明

• v0.3.0 是首个支持应用内更新的版本，旧版用户需要手动安装本版本一次。
• Windows 便携版和 Linux deb/rpm 继续手动更新；Windows MSI 首次安装仍可能出现 SmartScreen 提示。

开发

• 增加更新包签名、macOS 签名与公证，并完成后端模块拆分和发布流程安全加固。

[v0.2.35] - 2026-07-13

更新

• 新增 gpt-5.6-sol-unrestricted.md 指令提示词模板，同步 GitHub 模板后即可在【指令提示词】页面启用。
• 优化第三方供应商切换：切换后新建或重新打开 Codex 会话即可使用新的中转，无需重启整个 Codex 客户端。
• 优化从 cc-switch 导入供应商的结果提示，现在会分别显示新增、更新、合并和跳过数量。

修复 Bug

• 修复相同 API 地址和 API Key 的供应商因名称、模型或其他配置不同而重复显示的问题；相同地址但不同 Key 的供应商仍会分别保留，升级后也会自动整理已有重复项。
• 修复切换到其他供应商或切回 OpenAI Official 后，原供应商可能从列表中消失的问题；切换前会自动保存当前供应商。
• 修复从 cc-switch 重复导入时可能覆盖 Codex-X 中已有供应商名称、模型或自定义配置的问题，并兼容旧版 cc-switch 数据。
• 优化会话列表：Codex 自动创建的后台子会话不再重复显示为普通会话，项目数量和会话总数更加准确。
• 优化会话编号显示，保留编号开头和结尾，减少多个会话看起来像同一个会话的情况。
• 修复检测到的供应商与本地供应商同名时，编辑保存可能因 ID 冲突覆盖另一条记录的问题。

[v0.2.34] - 2026-07-13

更新

• 会话管理新增指定会话永久删除：支持单选、多选，并在二次确认后从当前 Codex 存储中硬删除；操作不进入回收站、不创建新的删除备份，Codex-X 内无法撤销。
• “按项目路径分组”新增项目级三态勾选，可一次选中某个项目在当前列表中加载的全部会话，也支持跨多个项目批量选择；搜索状态下会同时显示当前命中数与项目会话总数。
• 重做会话列表为更克制的表格式布局，统一标题、更新时间、Provider、模型和 ID 列，降低高亮边框、彩色标签与重复装饰造成的视觉干扰。
• 移除“已选 / 需修复、选择需同步、清空选择、修复选中”等按条修复控件，保留顶部“检查会话”和“同步 / 修复”用于全量处理。
• 永久删除确认窗口会预览待删除会话，并要求确认已关闭正在使用相关会话的其他 Codex 窗口或 CLI；由所选会话派生的子会话也会一并处理。

修复 Bug

• 修复默认窗口大小下会话列表滚动条在下拉过程中消失、必须放大窗口才能继续查看的问题；列表现在使用稳定的内部滚动区域并阻止滚动穿透。
• 修复同时存在当前 state_*.sqlite 与旧版 sqlite/state_*.sqlite 时，会话总数重复统计并混入旧会话的问题；现在优先使用当前活动会话数据库。
• 修复批量删除部分失败时结果反馈不完整的问题，界面会保留未删除项并显示失败数量与原因，方便关闭占用进程后重试。

开发

• 永久删除优先调用 Codex App Server 官方 thread/delete，不可用时使用本地兼容清理，并复用跨平台 Codex 可执行文件探测与启动逻辑。
• 本地兼容清理覆盖父子会话、当前及旧版会话数据库关联记录、活动/归档 Rollout、会话索引、历史记录、Shell 快照以及日志、记忆、目标和本地目录等关联数据。
• 会话同步与删除共用维护锁，并增加 Rollout 规范路径校验与符号链接边界保护，避免并发维护或越界删除。
• 增加活动数据库优先级、父子会话与重复库清理、关联记录清理、Rollout 越界拒绝及符号链接防护测试。

[v0.2.33] - 2026-07-11

更新

• 重做【指令提示词】页面布局：当前状态、启用方式和模板列表使用统一的紧凑框架，模板来源与更新时间更容易查看。
• GitHub 提示词目录改为权威同步：自动发现并缓存新增 .md，清理远端已删除模板和历史别名缓存；离线时仍可使用上次成功同步的内容。
• GitHub examples/ 新增 海鸥3.0破甲.md，并清理不再使用的旧示例模板。

修复 Bug

• 修复首次进入提示词页或切换导航返回时，会先显示历史缓存、随后再跳到 GitHub 最新模板的问题；同一次启动中会保留已同步状态，不再重复回退旧列表。
• 修复提示词模板较多时列表溢出最外层边框的问题，外层面板现在会随完整列表正确增高。
• 修复 GitHub 同步并发、部分模板下载失败和异常目录响应可能造成缓存状态错乱或误删的问题；失败后允许重新同步。
• 修复远端模板已删除但仍在启用时，重启后可能无法识别和关闭的问题；当前生效模板会保留明确的关闭入口。
• 删除 gpt5.5-jeli.md 介绍中多余的“测试生效”文案。
• 修复 macOS Apple Silicon / Intel、Windows 和 Linux 应用图标外围出现大块白边的问题，重新生成全平台透明图标资源。

开发

• 增加 GitHub 模板动态发现、缓存去重、离线回退、过期缓存删除和异常目录保护测试，并为缓存刷新增加互斥与事务保护。
• 修正发布脚本遗漏 Cargo.lock 的问题，确保 tag 内 Rust 包版本与应用版本一致。

[v0.2.32] - 2026-07-11

更新

• 提示词页的“启用方式”新增问号说明，用户可以直接看到“保留原提示词 / 替换原提示词”对现有系统提示词和 model_instructions_file 的实际影响。
• 提示词注入页面继续沿用统一的当前状态展示，方便判断当前模板与启用方式是否一致。

修复 Bug

• 修复提示词启用方式说明不够直观的问题，减少误操作风险。

修复 Bug

• 修复相同 Base URL、API Key、模型但 TOML 内容不同的供应商可能同时显示“当前”的问题；现在优先按完整 live TOML 匹配唯一配置，并避免重复展示 detected custom 卡片。
• 修复追加提示词后禁用会误影响用户原有规则的风险；禁用只删除 Codex-X 管理的 AGENTS 区块或指令文件，用户其他内容保持不变。
• 修复并发操作在同一毫秒创建备份时可能发生临时文件名冲突的问题。
• 修复切换 Skill / MCP 开关后条目因启用状态排序而跳到列表其他位置的问题。
• 修复 macOS Overlay 标题栏无法拖动的问题：补齐 Tauri 2 的 core:window:allow-start-dragging capability，并统一顶部拖动区域样式。
• 修复 Windows 桌面应用环境中因 PATH 不完整或 codex.cmd 无法直接执行而检测不到 Codex CLI 版本的问题；新增 npm、ChatGPT、Cursor、VS Code 和常见安装目录探测。

开发

• 将 AGENTS.md 纳入 Codex-X 备份与恢复流程。
• 增加受管区块合并/卸载、GitHub 动态模板发现、完整 TOML 供应商匹配、追加/替换模式和 AGENTS 恢复测试。

[v0.2.31] - 2026-07-09

更新

• 调整 macOS Toast 展示位置：Toast 现在直接挂在窗口根层，不再被内容区域下移影响，提示位置更靠上、更自然。
• 优化 Skills ZIP 安装体验：从 ZIP 安装 Skill 时会读取 SKILL.md 里的真实 name / description，不再显示 skill-zip-时间戳 这类临时目录名。
• Skills 页面刷新时会自动识别旧版 skill-zip-* 目录，并尝试重命名为 Skill 自身名称。

修复 Bug

• 修复启用第三方供应商后，关闭并重新打开 Codex-X 不再显示“当前启用”的问题。
• 修复 Windows / Linux 上供应商编辑页无法正常下拉滚动的问题，编辑 config.toml 时不再需要用 PageDown 绕过。
• 修复 Toast 受内容容器 contain 影响导致 macOS 位置调整不生效的问题。

开发

• 增加 Skill 元数据读取与旧 ZIP Skill 目录自动修正的单元测试。

[v0.2.30] - 2026-07-09

更新

• 优化会话管理页面布局：同步状态、目标 Provider、聊天总数、已展示数量、需修复数量合并为紧凑信息栏，把更多空间留给会话列表。
• 会话管理新增“启动自动修复”开关：开启后，Codex-X 启动时会在后台检查本地会话完整性，发现未同步会自动修复，不阻塞界面。
• 优化按钮点击体验：移除容易造成 WebView 闪烁/掉帧的水波纹、位移和 filter 效果，点击反馈更轻、更稳。

修复 Bug

• 修复同名供应商可能同时显示为“当前启用”的问题；Codex-X 现在会记录最后启用的供应商 ID，避免第三方 live Provider 都是 custom 时出现双亮。
• 修复新增同名供应商时 ID 冲突的问题；新建供应商会自动生成唯一 ID。
• 修复提示词管理中同名/同文件名 md 可能同时显示为启用的问题；新增或导入提示词会自动生成唯一文件名，当前状态按实际启用文件精确匹配。
• 修复会话管理中会话选择反馈不明显的问题；已选数量和可修复数量会实时展示。

体验

• 进一步降低供应商、提示词、TOML、会话管理等页面滚动时的闪烁和低帧率感。

[v0.2.29] - 2026-07-07

更新

• 优化 Toast 提示样式：改为窗口顶部居中的产品化通知卡片，减少遮挡右上角操作按钮。
• Provider 连接测试文案改为简洁结果：成功显示“连接正常（耗时）”，失败显示 HTTP 状态与耗时。
• 第三方供应商编辑页支持保存 TOML 模板；点击“保存”只保存配置，点击“启用”时才写入 Codex live config。
• 技能和 MCP 页面“导入已有”改为先展示预览确认弹窗，列出将导入的 Skills / MCP，用户确认后才执行导入。

修复 Bug

• 修复 Codex 第三方 API auth 写入错误：auth.json 现在写入 Codex 实际识别的 auth_mode = "apikey"，避免桌面端回到登录页。
• 修复官方认证编辑页打开时会静默加载 cc-switch 旧 token，导致新登录账号 token 显示不更新的问题；现在默认读取 live ~/.codex/auth.json，并提供“刷新当前 auth.json”。
• 修复切换到 OpenAI Official 时可能覆盖当前 live auth.json 的问题，避免把旧账号登录态写回。
• 修复 Provider 测试把 HTTP 403 误判为“连接正常”的问题；现在只有 2xx 状态会显示成功。
• 修复从 cc-switch 导入 Provider 时同名同 URL 供应商可能产生重复卡片的问题。
• 修复 SQLite 轻量迁移重复执行时 duplicate column name: toml_config 导致启动报错的问题。

开发

• 增加 Provider/auth 相关单元测试，覆盖第三方切换、官方 auth 保留、403 判定和 cc-switch 导入串台场景。

[v0.2.28] - 2026-07-07

• 修复从 cc-switch 导入 Codex Provider 时可能把供应商名称、base_url 与 API Key 串台的问题。
• 导入 cc-switch Provider 时改为先扫描所有 [model_providers.<id>] section，再按 provider row id 精确匹配，避免使用过期的 model_provider active 值。
• 兼容 cc-switch legacy custom provider 模板，同时保留 experimental_bearer_token 兜底。
• 增加复现 Sky2api / MagicAI 交叉配置的单元测试，防止 Provider 切换再次出现“看起来切了但实际没切对”的问题。

[v0.2.27] - 2026-07-07

• 优化【指令提示词】页面为 Skills/MCP 风格的简洁列表：左侧显示模板名称与说明，右侧使用开启/关闭切换；自定义/导入的 md 提示词增加编辑与删除图标。
• 优化【供应商】页面操作区：移除“官方配置 / 本地保存 / gpt-5.5 / 不支持路由”等冗余信息，将切换改为“启用”，编辑/删除/测试连接改为图标按钮。
• 新增供应商 base_url 连通性测试按钮，方便切换前检查第三方 API 地址是否可达。
• 修复第三方 Provider 切换后可能未真正生效的问题：切换和保存 TOML 时会写入 Codex 实际读取的 experimental_bearer_token。
• 对齐 cc-switch 的 Codex Provider live config 思路：从 cc-switch 导入时会识别 experimental_bearer_token，并避免使用 Codex 内置保留 provider id。
• 优化启动加载链路：启动诊断、备份列表、会话同步状态改为后台刷新，减少首屏等待。

[v0.2.26] - 2026-07-07

• 修复第三方 Provider 切换后可能“看起来已切换但实际未按新供应商生效”的问题：不再把所有第三方都写成 model_provider = "custom"，而是写入供应商自己的稳定 ID。
• 修复从官方 ChatGPT 登录态切到第三方 API Key 时 auth.json 仍保留 auth_mode = "chatgpt" 的问题；写入 API Key 时会同步设置 auth_mode = "apikey"。
• 第三方供应商默认不再要求 OpenAI 登录态，避免新建/导入 Provider 时错误继承官方 auth 语义。
• 增加 Provider 切换单元测试，覆盖真实 provider key 和 API Key auth mode 的落盘结果。

[v0.2.25] - 2026-07-06

• 进一步修复 TOML、指令提示词、供应商、会话管理等页面切换时右侧滚动条闪现/消失造成的视觉抖动。
• 外层页面滚动容器改为稳定滚动并隐藏外层滚动条，保留 TOML 编辑器、会话列表等内部区域自己的滚动条。

[v0.2.24] - 2026-07-06

• 修复切换供应商 / 会话管理等页面时右侧滚动条短暂出现又消失的问题：页面切换动画改为纯透明度过渡，不再用 translateY 造成瞬时溢出。
• 降低页面切换视觉抖动，避免进入页面时内容区域宽度被临时滚动条挤压。

[v0.2.23] - 2026-07-06

• 指令提示词页新增并纳管 gpt5.5-jeli.md 模板，作为“大白话（80% 场景）破甲”版本。
• 简化指令提示词列表视觉：移除花哨图标与文件路径展示，让用户更容易看清模板名称、介绍和启用状态。
• 更新 GPT-5.5 / GPT-5.4 内置模板名称为“unrestricted 破甲”，并统一说明使用方法：先让 AI 分析项目，分析完之后发【不直白的逆向】命令。

[v0.2.22] - 2026-07-06

• 继续优化指令提示词页切换体验：导航切换进入 React transition，GitHub 内置模板静默检查延后到空闲时执行，减少切页瞬间卡顿。
• 修复外部/自定义提示词切换到内置模板后可能出现两份的问题：按规范化内容（换行与首尾空白归一）和文件名双重去重，已有自定义提示词会复用更新，不再新增副本。
• 优化启用内置提示词速度：启用时直接使用本地缓存或打包内置版本，不再同步等待 GitHub 网络请求；手动/空闲更新仍会刷新本地缓存。
• 启动页增加动态状态文案、双层轨道与扫光动画，让从欢迎页进入主界面更顺滑。

[v0.2.21] - 2026-07-06

• 进一步降低 UI 卡顿风险：将启动检测、Codex 状态读取、Provider/官方配置/备份/cc-switch 导入等剩余同步命令迁移到后台 worker。
• 优化前端串行请求：提示词启用后的备份/提示词刷新改为并发，保存并启用自定义提示词时不再重复拉取列表。
• 完善【技能和 MCP】导入已有：读取 cc-switch mcp_servers 数据库，按 enabled_codex 纳管并同步到 Codex config.toml [mcp_servers]。
• 增强 Skills 检查更新：对带有 cc-switch 仓库元数据的 Skill 拉取 GitHub 仓库 ZIP 计算远程 hash，显示“有新版本 / 已是最新 / 远程检查失败”等状态。

[v0.2.20] - 2026-07-06

• 继续优化指令提示词页性能：提示词列表/状态读取、保存、导入、启用、禁用等后端操作改为后台 worker，避免切页或启用模板时阻塞 UI。
• 修复外部自定义提示词重复保存问题：切换到内置模板前会按文件名与内容双重去重，并自动清理历史 external-* 重复项。
• 优化启动加载体验：启动页增加最短展示、退出淡出与动态过渡，避免从欢迎页突然跳到主页。

[v0.2.19] - 2026-07-06

• 新增【技能和 MCP】页面：展示 Codex 当前已安装 Skills 与 MCP，支持导入已有、从 ZIP 安装 Skill、启用/禁用 Skill、启用/禁用 MCP。
• MCP 管理会读写 ~/.codex/config.toml 的 [mcp_servers]，禁用后保留到 Codex-X SQLite，后续可一键重新启用。
• Skills 管理会扫描 ~/.codex/skills，并可从 ~/.agents/skills、~/.cc-switch/skills 导入到 Codex；禁用后移动到 Codex-X 禁用目录，避免直接删除。
• 优化多个潜在卡顿点：指令提示词 GitHub 检查改为延迟后台执行，远程拉取、会话扫描/同步、Skills/MCP 扫描均放入后台 blocking worker。
• 修复外部自定义提示词切换到内置提示词后重复出现的问题，并自动清理同名 external-* 重复项。
• 增加页面切换过渡、启动页动态光效和首次启动向导退出动画，降低页面突然跳转感。

[v0.2.18] - 2026-07-05

• 指令提示词内置模板支持从 GitHub examples/ 实时检查更新，并缓存到本地；启用内置模板时优先使用 GitHub 最新版本，离线时自动回退本地缓存或打包内置版本。
• 指令提示词页面新增“更新内置模板”状态与来源展示，可看到模板来自 GitHub 最新、本地缓存或打包内置。
• 继续保留导入 .md 提示词、外部提示词自动记忆、会话管理交互优化和 API Key 可见切换等体验改进。

[v0.2.17] - 2026-07-04

• 修复 macOS Intel Release 构建 runner：从已不可用/长时间排队的 macos-13 切换为 macos-15-intel。
• 继续保留 macOS Apple Silicon / macOS Intel / Windows MSI / Windows portable ZIP / Linux deb/rpm 多平台产物。

[v0.2.16] - 2026-07-04

• Release 新增 macOS Intel 构建，Intel Mac 用户可下载 x64 DMG。
• macOS Release 现在同时提供 Apple Silicon 与 Intel 两种 DMG。
• Windows Release 新增 portable ZIP，包含可直接运行的 Codex-X.exe，无需 MSI 安装。
• 发布流程支持上传 .zip portable 产物，并更新 README 下载说明。

[v0.2.15] - 2026-07-04

• 会话管理页移除 CODEX_HOME 与 Provider Sync 备份位置展示，页面信息更简洁。
• 优化 Windows 打开下载页体验：后端改为后台线程 spawn 浏览器，不再等待 cmd /C start，避免 WebView 卡顿 2-3 秒。
• 统一所有外部链接按钮走异步打开逻辑，打开项目主页、反馈页、下载页都不会阻塞界面。
• 修复 macOS 顶部 toast 被 Overlay 标题栏遮挡的问题，toast 自动下移到标题栏安全区下方。

[v0.2.14] - 2026-07-04

• 修复 macOS Overlay 标题栏遮挡内容的问题，为红黄绿窗口按钮预留完整安全区。
• 调整侧边栏、内容区、Provider/TOML/指令提示词/会话管理页高度计算，避免顶部内容被标题栏压住。
• 加高 macOS 顶部拖拽区域并保持深色渐变，窗口顶部继续和应用色系统一。

[v0.2.13] - 2026-07-04

• macOS 窗口标题栏改为深色融合样式，避免顶部出现系统白色标题条。
• 会话管理页面移除多余外层玻璃边框，统一为完整内容容器。
• 优化会话列表边界与滚动区域，避免列表像卡在外层框外面。

[v0.2.12] - 2026-07-04

• Windows MSI 安装器回退为默认简洁样式，移除上一版过重的自定义安装界面图。
• 【会话管理】页面新增会话列表，展示标题、Provider、模型、工作目录、更新时间、归档/需同步状态。
• 会话扫描会从 Codex 本地 SQLite threads 表读取最近会话，方便用户直接判断哪些历史 thread 需要同步修复。

[v0.2.11] - 2026-07-04

• 调整首次启动自动检查更新体验：不再弹出居中的强提醒窗口。
• 自动检测到新版本时仅显示轻量 toast，并保留概览页顶部“发现新版本”提示条。
• 只有用户在【关于】页面主动点击“检查更新”时，检测到新版本才弹出“现在下载 / 稍后”窗口。

[v0.2.10] - 2026-07-04

• 修复 Release 发布任务上传 Linux 产物时误把 deb/、rpm/ 目录当作资产上传的问题。
• 发布任务现在只收集 .dmg / .msi / .deb / .rpm 文件并统一上传。
• 补齐稳定的三平台 Release 自动发布流程。

[v0.2.9] - 2026-07-04

• 修复 GitHub Actions Release 发布流程：不再由三平台矩阵并发创建 Release，改为先上传构建产物，再由单独发布任务统一创建/更新 Release。
• 修复 Resource not accessible by integration 导致 Release 创建失败的问题。
• Release 仍会从 CHANGELOG.md 自动读取当前 tag 的更新日志，并上传 macOS / Windows / Linux 安装包。

[v0.2.8] - 2026-07-04

• 更新页进一步产品化：去掉资源/仓库调试信息，将“有更新”改为更明显的绿色标签。
• 概览页顶部新增轻量“发现新版本”提示条，可直接打开 Releases 页面。
• 新增【会话管理】页面：检查 Codex 本地 sessions / archived_sessions 与 SQLite threads 是否和当前 Provider 同步。
• 新增一键 Provider Sync / 修复历史会话：写入前备份到 ~/.codex/backups_state/provider-sync/，并保留最近 5 份备份。

[v0.2.7] - 2026-07-04

• 简化更新检查页展示。
• “打开下载页”改为打开 GitHub Releases 页面。
• 更新弹窗保持简洁，仅提示版本差异。
• 首次启动自动检查更新并弹窗提醒。

[v0.2.5] - 2026-07-04

• Windows 版双击启动不再额外弹出终端窗口。
• 改进 Windows MSI 安装器品牌展示与图标。
• About 页面外部链接改为系统默认浏览器打开。
• Release 流程加入 Rust cache，后续构建更快。

[v0.2.4] - 2026-07-04

• 美化 Windows MSI 安装器横幅与对话图。
• Windows 安装包加入应用图标。

[v0.2.3] - 2026-07-04

• 修复 macOS DMG 中应用图标缺失问题。
• 补充 macOS 安装说明。
• Release 流程加入基础缓存优化。

[v0.2.2] - 2026-07-04

• macOS / Linux / Windows 首次三平台 Release。
• Linux 产物改为 deb / rpm，避免 AppImage 图标问题。

[v0.2.1] - 2026-07-04

• 首次加入应用图标与 GitHub Release 自动发布。