Codex-X/CHANGELOG.md

更新日志

记录 Codex-X 的新功能、体验改进和问题修复。

[v0.3.24] - 2026-10-01

• 会话管理新增工作文件夹侧栏、文件夹与会话置顶，并使用虚拟列表减少大量会话的渲染开销。

• 会话日志改为流式读取和磁盘快照处理，大日志及超长单条记录也能同步；读取、写入或复查失败时明确报错并执行安全回滚，避免日志、数据库索引与同步状态不一致。

• 修复文件夹路径大小写混淆导致显示错误会话、置顶联动和缓存串用的问题，按实际文件系统身份区分目录或合并同目录别名。

• 置顶按 Codex 配置目录分别保存，文件夹暂时不可读或重建后按原始路径保留置顶。旧 PR 预览版的 v1 置顶缓存不自动迁移，需重新置顶。

• 修复 Windows 下会话索引原子替换被文件句柄阻止的问题。

[v0.3.22] - 2026-09-30

• 修复第三方模型被错误识别为“仅文本”而无法输入图片的问题，并自动升级旧版生成的模型目录。需供应商模型本身支持图片，更新菜单后重启 Codex 生效。
• 供应商卡片支持上下拖动排序并自动保存，重启后保留顺序；也可聚焦左侧手柄后使用上下箭头移动。
• 在供应商卡片显示已选模型名称，设置映射别名时同时保留真实模型 ID。
• 补充 Ultra 思考强度的 Codex 设置提示，并修复旧模型目录遗漏图片或完整思考强度的问题。

[v0.3.21] - 2026-09-23

• 优化 Windows 在线更新，缩短安装等待；旧版可自动迁移，正常更新无需重启电脑，账号和配置保留。

[v0.3.20] - 2026-09-18

• 新增「设置 → 路由与故障转移」：可管理本地路由、安排供应商优先顺序，并在服务异常时自动切换；支持调整超时和重试参数，官方登录也可使用本地路由。
• 修复添加或切换第三方供应商时，MCP、桌面设置等配置丢失的问题。
• 修复内部任务被误同步，以及回退后的正常会话被误报异常的问题。

[v0.3.18] - 2026-09-17

• 第三方模型映射后可在 Codex 中选择推理等级，并修复 DeepSeek 每次发送消息先报错、重试后才能使用的问题。
• 新增后台配置检查：发现可能导致 Codex 无法使用的问题时提醒你，可选择修复，也可稍后到「设置 → 通用设置」处理。修复前会自动备份。
• 会话支持导出为 Markdown，多选会话可打包下载；MCP 和 Skills 支持 ZIP 导出、重新导入，取消 Skills ZIP 的 20 MB 大小限制。
• 修复「导入已有」弹窗的暗色显示、无效 MCP 重复出现，以及大日志记录被用量统计跳过的问题。

[v0.3.17] - 2026-09-09

新增与优化

• 官方账号支持查看剩余额度、重置时间和可用重置次数，列表中显示邮箱、套餐和登录状态。
• 新增 DeepSeek、MiniMax、小米 MiMo 等主流厂商预设和模型映射，方便在 Codex 中使用第三方模型，并保留已有配置。

问题修复

• 修复编辑正在使用的供应商时保存报错、切换后出现重复供应商，以及部分第三方连接认证失败的问题。
• 修复用量统计切换日期范围时页面闪白的问题。

[v0.3.16] - 2026-09-09

新功能

• 支持保存多个官方 Codex 账号，并为每个账号起不同的名字，方便切换使用。
• 官方账号和第三方供应商都支持一键复制，点击后直接生成副本。
• 新增“开启 1M 上下文窗口”选项，可按需勾选使用（需要模型支持）。
• 设置页新增“用量统计”，可以查看 Token 用量、每日趋势、模型分布和最近 10 个会话，并按日期、模型筛选。
• AI 后台子任务的用量合并到主对话，聊天列表只显示主会话。最近会话显示聊天标题或项目名，更容易找到。

体验改进

• 提示词页面的标题统一为蓝色，设置页的标签切换加入过渡动画。

问题修复

• 修复同步 GitHub 提示词模板时，供应商按钮暂时无法使用的问题。
• 修复切换供应商后，原有的 CC Switch 供应商从列表消失的问题。

[v0.3.15] - 2026-08-20

问题修复

• 修复 Windows 点击“重启 Codex”后只隐藏窗口、未真正退出，以及再次重启时报错的问题。

[v0.3.14] - 2026-08-20

更新

• MCP 和 Skills 支持添加自定义备注，方便区分用途。
• 供应商支持复制，同一 API 平台可以保存多个模型或多份配置，副本放在列表末尾。
• 简化供应商列表，不再重复显示模型信息。
• 设置页新增“重启 Codex”按钮，支持 macOS 和 Windows。

问题修复

• 修复相同供应商配置被覆盖，以及复制当前供应商后丢失启用状态的问题。
• 修复 Codex 自动创建的子代理会话被错误标记为“待同步”的问题。

[v0.3.13] - 2026-08-18

问题修复

• 已归档的会话不再被标记为“待同步”，切换供应商时会继续保持归档状态。

[v0.3.12] - 2026-08-11

更新

• 提升使用流畅度，修复部分问题。

[v0.3.11] - 2026-08-11

更新

• 提升使用流畅度，修复部分问题。

[v0.3.10] - 2026-08-11

更新

• 提升使用流畅度，修复部分问题。

[v0.3.9] - 2026-08-11

更新

• 提升使用流畅度，修复部分问题。

[v0.3.8] - 2026-08-03

问题修复

• 修复部分使用问题。

[v0.3.7] - 2026-08-02

问题修复

• 修复部分使用问题。

[v0.3.6] - 2026-07-31

更新

• 官方登录与第三方供应商切换后，新建会话即可使用，无需重启 Codex。
• 关闭主窗口后，软件会留在 macOS 菜单栏或 Windows 托盘中，可从菜单恢复窗口或退出。

问题修复

• 修复切换第三方供应商时丢失官方登录或官方 API Key 的问题，现在切回官方时可以恢复。
• 修复编辑当前供应商时意外新增副本、重复导入 cc-switch 产生重复项的问题，并兼容旧版 cc-switch 的官方登录导入。
• 修复同时操作供应商、提示词或其他设置时，配置被覆盖或损坏的问题。
• 修复会话同步提示成功却未生效的问题，并改善对自定义会话存储位置的支持。
• 修复旧记录被重复计入会话数量，以及同步时误改旧会话或项目位置的问题。

[v0.3.5] - 2026-07-28

更新

• GitHub 提示词模板可以直接查看和编辑内容，名称和文件名仍跟随在线版本。
• 编辑后的模板会标记为“本地已修改”，后续同步不会覆盖你的修改，新模板仍会正常下载；修改在下次启用模板时生效。
• 仅查看模板或保存未改动的内容，不会影响后续在线更新。

问题修复

• 修复同步 GitHub 模板时只能看到 5 个、无法获取完整 11 个模板的问题；网络异常时仍可使用已有缓存。
• 修复使用第三方供应商时，概览页误报未找到官方登录信息的问题。

[v0.3.4] - 2026-07-28

更新

• 在线模板库新增 6 套提示词，点击同步 GitHub 模板即可获取，不增加安装包体积。
• 软件开发新增“长期维护工程师”“系统化调试与根因修复”“严格代码审查”。
• 写作辅助新增“清晰表达与润色”“技术文档写作”“结构化长文起草”。新模板会自动分类，仍保留用户手动设置的分类。

问题修复

• 修复切换第三方供应商或从 cc-switch 导入后，官方登录信息被覆盖、需要重新登录的问题。
• “还原官方配置”不再自动切换当前供应商；新增“新建官方配置”，方便清除异常认证后重新登录。
• 调整官方认证编辑框，长内容可以换行显示，更方便查看和选择。

[v0.3.3] - 2026-07-26

调整

• 暂时下线皮肤中心，隐藏侧边栏入口，保留用户已保存的本地主题文件。
• 升级后会自动关闭此前启用的皮肤，恢复 Codex 官方外观；若恢复失败，会显示原因。
• 安装包不再附带“椎名真白·樱花画室”主题壁纸，减小下载体积。

[v0.3.2] - 2026-07-25

问题修复

• 修复 Windows 启动 Codex 或进入新版首页、外观设置时，皮肤功能错误提示无法识别 Codex 的问题。
• 皮肤出现异常时仍可点击“关闭皮肤”，恢复过程中会避免重复操作。

安全改进

• 皮肤功能仅用于已识别的官方 Codex 窗口，不会应用到普通网页。

[v0.3.1] - 2026-07-24

更新

• 重新设计皮肤中心，可直接预览壁纸、侧边栏、会话区和输入框的整体效果，主题卡片更紧凑。
• 支持主题分类筛选，卡片会根据数量自动调整为 1 至 4 列；导出主题可使用系统“另存为”窗口。
• 支持从图片创建主题，并修改名称、简介和界面透明度。
• 皮肤功能支持 Windows 官方商店版 Codex，无需修改 Codex 安装文件。
• 合并重复的恢复按钮，统一使用“关闭皮肤”。

问题修复

• 修复 macOS 应用皮肤后一直显示“应用中”，以及重开软件后无法识别当前主题的问题。
• 修复皮肤按钮状态错误、刷新缺少反馈，以及提示词或主题较多时无法继续向下滚动的问题。
• 优化横图壁纸的裁剪，减少人物头部被切掉的情况。
• 修复切换第三方供应商时覆盖官方登录信息的问题。
• 改善 Codex 安装检测，减少已安装却显示“未检测到 Codex”的情况。
• 修复启用皮肤后输入框消失、聊天内容透过输入框，以及图片主题预览显示错误背景的问题。
• 修复浅色主题下壁纸颜色发白的问题，并改善透明度调整和输入框文字的清晰度。

安全与来源

• 加强官方 Codex 识别、主题导入和切换检查。
• 换肤功能使用 Codex Dream Skin Studio 的 MIT 授权代码，未包含其非 MIT 授权的真人主题素材。

[v0.3.0] - 2026-07-16

更新

• 全面更新界面，统一页面、按钮、弹窗和通知样式，加入深浅色模式与页面切换动画。
• 新增应用内更新，macOS、Windows MSI 和 Linux AppImage 用户可直接下载、安装并重启；侧边栏会显示更新入口和进度。
• 改进供应商连接测试，删除前增加确认，添加或编辑时可以获取并选择模型，官方登录页面更简洁。
• 提示词新增分类和两套内置模板，卡片更简洁；添加或编辑后只保存，需要时再手动启用。
• 启动后会在后台同步在线模板，网络异常时尝试备用下载来源；模板会保存到本机，离线时仍能使用，支持系统代理。
• 会话统一同步到当前供应商，不再在启动时自动修改；支持查看、选择和删除内部会话。
• 导入 Skills / MCP 时会跳过已有内容，没有新内容时不再弹出空窗口。

问题修复

• 修复部分旧提示词配置导致 Codex 报错，以及 Windows 将配置文件夹链接到其他位置后无法读写的问题。
• 修复会话同步报错、会话重复显示，以及聊天记录被误改或覆盖的问题。
• 修复深浅色模式下部分文字和控件显示异常，以及打开弹窗后背景仍能滚动的问题。
• 修复提示词重复同步、错误更新或误删除，以及应用更新失败后提示不准确的问题。
• 完善安装包和更新的安全检查。

兼容说明

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

[v0.2.35] - 2026-07-13

• 新增 gpt-5.6-sol-unrestricted.md 提示词模板，同步 GitHub 模板后即可启用。
• 切换第三方供应商后，新建或重新打开 Codex 会话即可使用新供应商，无需重启整个 Codex 客户端。
• 自动整理 API 地址和密钥均相同的重复供应商；同一地址使用不同密钥的供应商仍分别保留。
• 修复切换供应商或切回官方登录后，原供应商可能消失的问题。
• 从 cc-switch 导入时，会显示新增、更新、合并和跳过数量；重复导入不再覆盖已有名称、模型和自定义配置，并兼容旧版 cc-switch 数据。
• 会话列表不再重复展示 Codex 自动创建的后台子会话，项目和会话数量更准确；会话编号保留首尾，方便区分。
• 修复编辑同名供应商时可能覆盖另一条记录的问题。

[v0.2.34] - 2026-07-13

• 会话管理支持单选或多选后永久删除，所选会话派生的子会话也会一并删除。删除不进入回收站、不创建新的备份，在 Codex-X 中无法撤销。
• 删除前可预览待删除会话，并需确认已关闭其他正在使用这些会话的 Codex 窗口或命令行进程。
• 支持按项目勾选当前已加载的会话，也可跨项目批量选择；搜索时同时显示匹配数量和项目会话总数。
• 会话列表改为紧凑表格，标题、更新时间、供应商、模型和编号更清晰。检查与修复统一使用顶部的“检查会话”和“同步 / 修复”。
• 修复默认窗口大小下会话列表无法继续向下滚动的问题。
• 修复升级 Codex 后可能重复统计会话、混入旧会话的问题。
• 批量删除部分失败时，会保留未删除项并显示失败数量和原因，方便处理后重试。

[v0.2.33] - 2026-07-11

• 重新整理【指令提示词】页面，当前状态、启用方式、模板来源和更新时间更清晰，并简化模板说明。
• 同步 GitHub 时会自动添加新模板、移除已删除模板；离线时仍可使用上次成功同步的内容。
• 新增 海鸥3.0破甲.md 示例模板，清理不再使用的旧示例。
• 修复返回提示词页面时列表先显示旧内容再跳到新内容，以及模板较多时列表超出边框的问题。
• 修复同步或下载失败时模板列表可能出错、误删的问题，失败后可重新同步；正在使用的模板即使已从 GitHub 删除，重启后仍可正常关闭。
• 修复 macOS、Windows 和 Linux 应用图标外围出现大块白边的问题。

[v0.2.32] - 2026-07-11

• 提示词“启用方式”增加说明，方便了解“保留原提示词”和“替换原提示词”的区别，并核对当前启用状态。
• 修复配置相近的多个供应商可能同时显示“当前启用”、重复显示供应商卡片的问题。
• 关闭追加的提示词时会保留用户原有规则，自定义规则也支持备份和恢复。
• 修复多项操作同时备份时可能失败的问题。
• 修复切换 Skill 或 MCP 开关后，条目跳到列表其他位置的问题。
• 修复 macOS 窗口顶部无法拖动的问题，并改善 Windows 上 Codex 版本的识别。

[v0.2.31] - 2026-07-09

• 调整 macOS 顶部通知的位置，避免提示随页面内容下移。
• 从 ZIP 安装 Skill 后显示其实际名称和说明；刷新时会尝试修正旧版安装留下的临时名称。
• 修复启用第三方供应商后，重新打开 Codex-X 不再显示“当前启用”的问题。
• 修复 Windows 和 Linux 供应商编辑页无法正常向下滚动的问题。

[v0.2.30] - 2026-07-09

• 精简会话管理顶部信息栏，为会话列表留出更多空间；选择会话时实时显示已选数量和可修复数量。
• 新增“启动自动修复”开关，开启后会在启动时后台检查会话，并自动修复未同步的会话，不影响界面操作。
• 减少按钮点击和页面滚动时的闪烁、卡顿。
• 修复同名供应商可能同时显示“当前启用”，以及新增同名供应商发生冲突的问题。
• 修复同名提示词可能同时显示为启用的问题。

[v0.2.29] - 2026-07-07

• 通知改为顶部居中显示，减少对右上角按钮的遮挡；供应商连接测试结果更简洁，显示连接状态和耗时。
• 第三方供应商支持保存配置模板：“保存”只保存配置，点击“启用”后才应用到 Codex。
• Skills 和 MCP 的“导入已有”增加预览，确认列表后才执行导入。
• 修复切换第三方供应商后 Codex 可能回到登录页的问题。
• 官方认证编辑页默认读取当前登录信息，并提供“刷新当前 auth.json”；修复切回官方登录时可能恢复成旧账号的问题。
• 修复连接测试将“访问被拒绝”误报为连接正常，以及从 cc-switch 导入时出现重复供应商卡片的问题。
• 修复部分用户升级后无法启动的问题。

[v0.2.28] - 2026-07-07

• 修复从 cc-switch 导入供应商时，名称、API 地址和密钥可能相互混淆的问题，避免启用后实际使用了其他供应商。
• 改善旧版 cc-switch 供应商配置的导入兼容性。

[v0.2.27] - 2026-07-07

• 提示词页面改为简洁列表，名称和说明更清晰，右侧可直接开关；自定义和导入的提示词支持编辑、删除。
• 精简供应商操作区，将“切换”改为“启用”，编辑、删除和连接测试改为图标按钮。
• 新增供应商连接测试，方便启用前检查第三方 API 地址是否可用。
• 修复第三方供应商切换后可能未真正生效的问题，并改善从 cc-switch 导入配置的兼容性。
• 减少启动等待，检查、备份列表和会话状态在后台加载。

[v0.2.26] - 2026-07-07

• 修复第三方供应商显示已切换、实际却未生效的问题。
• 修复从官方登录切换到第三方 API 密钥后，仍沿用官方登录方式的问题。
• 新增或导入第三方供应商时，默认不再要求 OpenAI 官方登录。

[v0.2.25] - 2026-07-06

• 进一步减少切换配置、提示词、供应商和会话页面时，滚动条闪现造成的抖动；编辑器和会话列表仍保留各自的滚动条。

[v0.2.24] - 2026-07-06

• 修复切换供应商、会话管理等页面时滚动条短暂闪现、内容宽度跳动的问题，页面切换更平稳。

[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

• 减少进入提示词页面时的卡顿；GitHub 模板检查延后到空闲时进行。
• 启用内置提示词时直接使用本地已有内容，无需等待网络；手动同步或空闲检查后会更新模板。
• 修复从自定义提示词切换到内置模板时可能产生重复项的问题，已有相同提示词会直接更新。
• 优化启动页状态提示和过渡动画，进入主界面更顺畅。

[v0.2.21] - 2026-07-06

• 减少启动、供应商操作、备份和导入时的卡顿，并加快提示词保存、启用后的刷新。
• “导入已有”支持从 cc-switch 导入已为 Codex 启用的 MCP，并应用到 Codex。
• 来自 cc-switch 且保留仓库信息的 Skill 可检查 GitHub 更新，显示“有新版本”“已是最新”或“远程检查失败”。

[v0.2.20] - 2026-07-06

• 改善提示词页面响应速度，减少切换页面、保存、导入和开关模板时的卡顿。
• 修复从自定义提示词切换到内置模板后重复保存的问题，并自动整理已有的此类重复项。
• 优化启动页展示和退出动画，避免突然跳到主页。

[v0.2.19] - 2026-07-06

• 新增【技能和 MCP】页面，可查看已安装内容、导入已有配置、从 ZIP 安装 Skill，以及启用或禁用 Skill 和 MCP。
• 禁用 Skill 或 MCP 后仍保留原有内容，可随时重新启用；支持导入本机已有的 Skill 和 cc-switch 中的技能。
• 减少 GitHub 模板检查、会话检查与同步、Skills 和 MCP 加载时的卡顿。
• 修复从自定义提示词切换到内置模板后出现重复项的问题，并自动整理已有的同名重复项。
• 优化页面切换、启动页和首次启动向导的过渡动画。

[v0.2.18] - 2026-07-05

• 内置提示词支持从 GitHub 检查更新，启用时优先使用最新模板；离线时可使用本地缓存或随应用提供的模板。
• 提示词页面新增更新状态和模板来源提示。

[v0.2.17] - 2026-07-04

• 修复 Intel Mac 安装包发布失败或长时间等待的问题。

[v0.2.16] - 2026-07-04

• 新增 Intel Mac 版 DMG，macOS 用户可按芯片类型选择 Intel 或 Apple Silicon 安装包。
• 新增 Windows 免安装 ZIP，解压后即可运行，无需安装 MSI。

[v0.2.15] - 2026-07-04

• 精简会话管理页面，移除不常用的配置和备份位置说明。
• 修复 Windows 打开下载页、项目主页等外部链接时界面短暂卡顿的问题。
• 修复 macOS 顶部提示消息被标题栏遮挡的问题。

[v0.2.14] - 2026-07-04

• 修复 macOS 标题栏和窗口按钮遮挡页面内容的问题。
• 增大窗口顶部拖拽区域，并统一深色外观。

[v0.2.13] - 2026-07-04

• macOS 标题栏改为与应用一致的深色样式。
• 简化会话管理页面边框，改善列表布局和滚动体验。

[v0.2.12] - 2026-07-04

• Windows MSI 恢复简洁的安装界面。
• 会话管理新增历史会话列表，可查看标题、供应商、模型、工作目录、更新时间，以及归档和待同步状态。

[v0.2.11] - 2026-07-04

• 启动时发现新版本改为轻量提示，概览页仍保留更新提示条。
• 仅在“关于”页面主动检查更新并发现新版本时，弹出“现在下载 / 稍后”窗口。

[v0.2.10] - 2026-07-04

• 修复 Linux 安装包上传失败的问题，完善 macOS、Windows 和 Linux 安装包发布。

[v0.2.9] - 2026-07-04

• 修复 GitHub 版本发布失败的问题。

[v0.2.8] - 2026-07-04

• 简化更新页面，使用醒目的绿色标签标示新版本；概览页新增可直接打开下载页的更新提示条。
• 新增“会话管理”页面，可检查历史会话是否与当前供应商匹配，并一键同步修复。
• 修复会话前自动备份，保留最近 5 份备份。

[v0.2.7] - 2026-07-04

• 简化更新页面和弹窗，“打开下载页”直接前往 GitHub 版本下载页面。
• 首次启动自动检查更新，发现新版本时弹窗提醒。

[v0.2.5] - 2026-07-04

• 修复 Windows 双击启动时额外弹出终端窗口的问题。
• 改善 Windows MSI 安装界面的应用名称和图标展示。
• “关于”页面的外部链接使用系统默认浏览器打开。

[v0.2.4] - 2026-07-04

• 美化 Windows MSI 安装界面，并为安装包加入应用图标。

[v0.2.3] - 2026-07-04

• 修复 macOS DMG 中应用图标缺失的问题，并补充安装说明。

[v0.2.2] - 2026-07-04

• 首次提供 macOS、Linux 和 Windows 三个平台的安装包。
• Linux 改为提供 DEB 和 RPM 安装包。

[v0.2.1] - 2026-07-04

• 首次加入应用图标，并通过 GitHub 提供版本下载。