Repository navigation
Releases
Releases · gzers/opencodex-desktop
OpenCodeX Desktop v0.2.23
- 用户数据统一放入当前用户的
~/.codex-desktop：desktop/保存管理器数据，opencodex/home/保存 OpenCodex 配置与运行状态。程序及固定 Node/npm/Bun 放在安装目录的runtime/，与用户数据分开。 - 同一用户保留单实例，不同 Windows 账户使用独立配置、凭据与 IPC；代理端口仍由整机共享，占用时提示冲突，不接管其他用户的服务。
- 安装配置页增加 OpenCodex 服务端口设置：自动检查空闲端口并保存具体端口，也可指定端口；运行中修改在下次启动生效，重启前确认。端口、目录和程序信息按采用原型统一展示。
- 启停操作在后台执行，启动等待实际身份与就绪核验；停止通过官方接口完成客户端还原并核对实例退出。启动失败区分端口冲突、权限和其它原因，可从通知前往设置或重试。
- 修复 Windows 规范长路径与普通盘符路径在服务运行记录和身份核对中的不一致，保持不同用户实例隔离；启动、停止失败保留可定位阶段的脱敏诊断。
- Windows 新安装默认使用当前用户的
%LOCALAPPDATA%\Programs\OpenCodeX Desktop。旧版 MSI 为机器级安装，切换到本版用户级 MSI 前，请先卸载旧管理器并保留配置，再安装新版；不要将这一步视为配置自动迁移。 - 本版不扫描旧目录、不自动迁移配置。升级前请自行保留旧 OpenCodex 配置 JSON；需要恢复渠道时，在新版中明确选择文件读取，按模型模版形成草稿，核对后保存。旧目录与备份保留。
- 模型模版改用模型族、数字版本与名称条件组合匹配，支持版本数字位置的点号与连字符等价及名称前后位置；读取现有渠道自动匹配到草稿，人工模型覆盖单独保留，正式保存才写入。移除渠道层默认协议，协议按模型来源、模版及明确覆盖解析。
- 渠道名称保存后用于实际运行配置与 Codex 模型目录展示，支持中文、空格和斜杠；内部身份及原始模型 ID 保持稳定。新增渠道两步向导、复制与连接编辑按采用原型统一。
- WebDAV 改用实际文件内容、摘要及提交关系核对，不依赖 ETag；来源下拉允许明确选择上传或下载。同内容不重复写入，并发分支保留，读取失败与损坏不当作空目录，结果未知时可查看并核对原操作。
- WebDAV 使用新格式，所有参与设备需先升级。请核实本机完整配置并保留备份，再由用户清空原远端同步目录内的旧文件，重新预览上传；本版不会自动清空远端或兼容旧同步格式。
- 文件导入、导出、同步与恢复统一记住范围及凭据选择；首次读取范围全选，之后新增对象不自动勾选。恢复备份使对象回到本机原本不存在的状态时，取消这些对象的同步勾选，云端文件保留；可手动重新选择下载。导出沿日期目录生成独立配置包；可查看真实输出目录、原操作结果及按范围备份恢复记录。
- 随应用提供完整离线运行包及固定依赖，维护修订为 2.97.0-desktop023.lifecycle.3，基于上游 2.97.0，非上游正式发行。修订包 SHA256：
ec14baaee354c6729d1d2545ab9165d207b14a3a4239f354662163087eeb0739。安装异常保留原目录，并提供明确来源核对与受控恢复。 - macOS 使用独立的“OpenCodeX Desktop”安装文件夹，请将整个文件夹复制到
~/Applications。系统安装包仍为未公证/未做系统发行签名的测试构建，更新制品及维护运行包使用原更新签名校验。既有 RDP 硬件性能例外保留，不作绝对帧率达标承诺。
安装
- macOS（Apple Silicon）：下载 .dmg，将其中整个“OpenCodeX Desktop”文件夹复制到 ~/Applications，再打开文件夹中的应用；请勿只复制 .app 或从磁盘映像运行。
- Windows（x64）：下载
*-setup.exe（NSIS）安装包。 - 均为未签名测试包：macOS 首次打开如被 Gatekeeper 拦截，右键 →「打开」；Windows SmartScreen 可能提示，选择「仍要运行」。
OpenCodeX Desktop v0.2.22
- 修复新设备首次WebDAV同步范围初始化，先读取完整云端目录再首次全选；已有范围与后续新增对象不自动扩选。
- 修复空目录首次发布的强ETag读回与确认，避免把发布后短暂缺失响应头误判为服务不支持；保留条件写入与版本变化保护。
- 已配置的WebDAV连接在启动时只读检测线上版本，分别展示读取中、无快照、失败与已读取；修复连接地址和同步目录缺少分隔符。
- 修复Windows共用玻璃表面的磨砂和可读实底回退，以及面板首次加载、切源重开和浮层关闭后的恢复；修复macOS面板导航未就绪时的崩溃。
- 渠道只需填写唯一名称，底层运行键由系统管理；移除模型获取和节点检测的私网准入开关，保留真实网络与认证错误提示。
- 保存后重启区分已保存配置、运行服务不可达和重启结果，失败可沿原通知重试；补齐完整预发布运行包版本识别，避免离线安装误报版本不符。
- 随本版提供本项目维护的运行包 2.97.0-post021.ownerquery.2，修复Windows客户端归属查询超时及渠道改名后发现基线时间漂移。它基于上游2.97.0，保留独立版本号，非上游正式发行。
- 需要上述运行包修复的用户：升级桌面管理器后，还需下载本页的
opencodex-2.97.0-post021.ownerquery.2.tgz，在安装OpenCodex中选择“导入离线包”，核对版本与来源并明确安装，再按提示重启。仅升级管理器不会替换已安装运行包；“联网安装”仍获取上游官方包。 - 运行包SHA256：
bba03ba0cf02c7bcd1895f63c670cb4a2f4b5272657145e45701b20d5e0f1957；同页提供签名与维护清单。升级前可保留旧版安装包和配置备份；回退请按原版本安装包恢复，不覆盖本版配置备份。 - 已接受该共享GPU/RDP验收机的绝对帧率硬件例外，原超预算结果保留；本版不作60fps或性能达标承诺。系统安装包仍为未公证/未做系统发行签名的测试构建，更新制品及维护运行包使用更新签名校验。
安装
- macOS（Apple Silicon）：下载
.dmg，拖入「应用程序」。 - Windows（x64）：下载
*-setup.exe（NSIS）安装包。 - 均为未签名测试包：macOS 首次打开如被 Gatekeeper 拦截，右键 →「打开」；Windows SmartScreen 可能提示，选择「仍要运行」。
维护运行包的安装与更新
- 下载本页 opencodex-2.97.0-post021.ownerquery.2.tgz，在“安装 OpenCodex → 导入离线包”中核对完整版本并确认安装。
- 安装后重启 OpenCodex 服务，使服务使用新运行包；再按需重启 Codex 客户端。
- 管理器升级不自动替换已安装运行包。联网安装及“官方面板”更新继续使用 npm 上游；当前官方 2.97.0 会显示为比本维护修订更新，执行会换回未含本次补丁的上游包。在上游吸收修复前，请保留维护归档并继续用离线来源管理。
这是本项目维护的独立修订，不是上游正式发行。运行包、签名、SHA256及维护清单随本版本提供。
OpenCodeX Desktop v0.2.21
- 保存成功通知保留8秒自动收起，取消自动聚焦重启按钮；主动交互与重启确认期间暂停，关闭确认后继续倒计时，到期不自动重启。
- 渠道名称与运行标识可一起修改，保存时更新当前模型路由、默认选择、顺序及凭据引用，保存后提示重启 Codex 生效；兼容 macOS 与 Windows 标准 npm 安装的客户端入口。
- WebDAV 按所选已保存内容的可靠保存时间判断来源，本机较新上传、云端较新下载；内容一致不更新，时间未知或同刻异内容时停止更新并说明原因。传输不抬高内容时间，确认前变化仍会阻止旧计划写入。
- 渠道列表移除节点下拉列，操作列“检测”打开居中公共弹窗；节点检测、停止与选择分开，节点选择只修改草稿，收紧渠道列宽并取消节点常驻高亮。
- 概览如实区分 WebDAV 已配置未检测与最近检测结果；观察绑定已保存连接及凭据修订，未保存的连接测试不会污染当前状态。
- 没有导入连接候选时隐藏空入口；读取失败可重试，有候选时显示用途和数量，明确确认后才启用。
- 统一管理器弹窗右上角关闭入口，查看型移除底部重复关闭及空操作栏；键盘、遮罩与取消遵循同一退出规则，关闭进度观察与取消任务分别处理。
- 配置包使用新版保存版本格式，可继续读取旧包；接收新包的设备须升级至0.2.21。旧内容没有可靠保存时间时会明确停止自动取新，升级、复制或重新打包不会将旧内容伪装成新版。
安装
- macOS（Apple Silicon）：下载
.dmg，拖入「应用程序」。 - Windows（x64）：下载
*-setup.exe（NSIS）安装包。 - 均为未签名测试包：macOS 首次打开如被 Gatekeeper 拦截，右键 →「打开」；Windows SmartScreen 可能提示，选择「仍要运行」。
OpenCodeX Desktop v0.2.20
- 按维护原型补齐文件与 WebDAV 同步页：移除逐次人工复核、范围预设和重复确认；搜索、表头选择、凭据子项、对象详情及两栏滚动统一。
- 文件导出默认不加密，手动开启后保护已预览的冻结内容；重试沿原配置包和保存目录，打开目录指向实际导出位置。
- 普通导入和下载确认后直接更新已保存配置，并保留、重基准未保存编辑；原操作中断可核对回执后继续。
- 更新前备份覆盖所选渠道、模版、偏好与扩展资源，重试复用原备份；可在数据与备份中按范围恢复，保护后续独立修改。
- 文件与 WebDAV 各自记住范围和凭据选择；新设备首次成功读取云端目录时全选当时的对象，之后新增对象默认不勾选。节点、凭据与账户按身份绑定，设备运行设置和当前连接保持本机值。
- WebDAV 内容加密与连接密码分开，保护口令由本机安全存储保留；按共同内容基线判断来源，预览后源内容或云端版本改变时停止旧计划写入。
- 概览原位打开共享同步窗口，通知可查看持久结果；部分失败保留完成项，沿原操作重试未完成资源。
- 桌面偏好仅传输主题、缩放、视觉效果和背景光设置；不再隐含整份扩展设置。取消未开始的导出时清理冻结缓存，已开始的操作保留原计划用于重试。
- 修复原生输入框内 Escape 不关闭弹窗、下拉菜单与外窗同时关闭、低档菜单偏离按钮，以及 200% 缩放下详情导航和扩展正文不可达的问题。
- 通知历史清理等待实际结果，失败时保留列表并提示原因；取消恢复引导后，迟到的摘要或备份结果不会重开或覆盖其它窗口。
- 统一调小默认正文、导航、按钮与标题字号，保留所选界面缩放比例。
- 修复概览与设置中的更新中心未跟随界面缩放；高缩放下操作栏保持可见，长内容在窗口内部滚动。
- 已是最新版本时，更新详情只显示当前版本和关闭操作，避免升级后缓存候选造成同版本箭头或重复更新提示。
0.2.20 测试更新通道
0.2.20 测试更新通道，当前与已发布 stable/Latest 使用同一批签名资产。
latest.json 与 v0.2.20 的 manifest 字节相同，指向最终源码 b1750f5 / Release ID433103683。早期 bda 和34a验证候选均已撤回私有归档，当前通道不提供其资产。
完整CI、四种独立安装、macOS与Windows MSI/NSIS实际0.2.19→0.2.20签名更新及新窗口缩放均已验收。稳定下载请使用v0.2.20或Latest。
OpenCodeX Desktop v0.2.19
- 同步改为按配置快照比较新旧，先预览本次来源、范围与变化，确认后覆盖更新；下载和导入默认勾选更新前备份。
- 同名 MCP 定义不同时可在预览内选择来源，未选择的冲突项单独跳过；node_repl 默认不参与同步。同名 Skill 直接覆盖更新，同步忽略官方原生 openai。
- 修复 Windows 官方面板内嵌边界与首次布局时序；区分进程启动、健康检查和页面加载，避免短暂不可达误报启动失败，页面重试只重载内嵌内容。
- 修复 Windows 玻璃背景全透明：确认 Mica 可用后才透出原生底面，失焦或能力不可用时回退实色；打开内嵌面板后仍能刷新材质，低档页面和浮层保持实底。
- 修复未重启 Codex 时连续保存渠道模型被误判为外部修改，以及模型表头与行复选框错位。
- 统一侧栏字重、中文字体回退和概览状态行；公共通知增加自动收起倒计时，悬停或聚焦时暂停，收起时缩入铃铛。
安装
- macOS（Apple Silicon）：下载
.dmg，拖入「应用程序」。 - Windows（x64）：下载
*-setup.exe（NSIS）安装包。 - 均为未签名测试包：macOS 首次打开如被 Gatekeeper 拦截，右键 →「打开」；Windows SmartScreen 可能提示，选择「仍要运行」。
OpenCodeX Desktop v0.2.18
-
概览直接打开公共导入配置和安装弹窗，取消后仍停留概览；安装位置、来源、版本与确认同页展示，四个步骤显示名称。
-
更新详情与确认按原型还原，确认后切换独立进度内容；去掉重复标题和无关导航，保留跨页面重开、签名校验、备份及失败日志。
-
环境准备状态逐项沿原型呈现；Windows 使用本机安装指引，不显示 Homebrew 操作。
-
macOS 应用包明确采用 ad hoc 签名并封装资源，在发布流程校验包签名和许可资源；不改变更新器公钥与更新包验签。
-
Windows 路径展示统一覆盖数据根、OPENCODEX_HOME、备份、运行来源、Skills/MCP、导出和卸载结果；复制保留同一目录身份，打开和存储仍使用后端原值。路径字体明确使用反斜杠字形，输入提示使用本机路径格式。
-
修复模型命令继承宿主 PATH、缓存刷新覆盖隔离 HOME、官方 shim 缺少 Windows 环境及环境发现误认普通文件的问题；生命周期路径要求显式绝对路径。
-
卸载命令绑定当前 OPENCODEX_HOME、已识别的 npm 前缀和明确工作目录；系统打开动作改用 Unicode Shell API，避免从当前目录或 PATH 选择 cmd/explorer。
-
Windows 安装位置按普通目录身份可读显示，统一默认预填、恢复默认与目录选择，并保留路径中的合法空格。
-
保留 npm 失败阶段、脱敏错误和完整命令日志位置；命令日志记录工作目录、受控环境、stdout/stderr 与退出码，兼容 Windows 本地编码输出及扩展路径批处理入口。
-
安装失败后继续显示本次输出，联网流程不再误显示离线步骤；离线失败保留到达阶段，完成按钮等待实际安装与来源刷新结束。
-
版本查询保留 npm view 的失败原因、退出码、两路输出和脱敏命令日志；绑定当前 OPENCODEX_HOME，更新详情关闭重开后仍可查看失败详情，重试成功后清除查询错误。
-
兼容 registry 缺少 integrity 时 npm 返回版本字符串的形态；错误详情和安装输出沿用路径字体，保留合法空格、中文及原始诊断内容。
-
面板更新失败后保留本次安装输出，避免后续安装覆盖失败记录；备份失败时不展示上次安装日志。
安装
- macOS（Apple Silicon）：下载
.dmg，拖入「应用程序」。 - Windows（x64）：下载
*-setup.exe（NSIS）安装包。 - 均为未签名测试包：macOS 首次打开如被 Gatekeeper 拦截，右键 →「打开」；Windows SmartScreen 可能提示，选择「仍要运行」。
OpenCodeX Desktop v0.2.17
修复 Windows 托管安装路径与安装事务边界，并补齐 Windows 全链验收范围。
- Windows 安装向导识别普通、扩展盘符和 UNC 路径，保持默认数据根与自定义安装位置语义。
- 托管安装拒绝非受管非空目录；安装失败时保留旧包、入口与来源记录。版本探针同时校验零退出码、版本和有界输出。
- Windows 工具发现补充版本管理器声明路径；许可和第三方声明随应用资源打包；修正文案中的 CLI 能力边界。
- 修复安装脚本二次确认按钮始终不可用的问题；仅明确的脚本需要错误允许用户授权重试，普通安装错误不会自动开放脚本。
- 修复 Windows 离线安装把本地归档路径拼为 registry 版本的问题，离线重装继续仅使用本机缓存。
- Windows 任务栏暂不可用时，托盘颜色刷新失败只记录并等待重试，不再导致整个主窗口启动失败。
- 继续沿用模型配置、通知和原型样式，未新增保存核对流程。
使用边界
- Windows 原生安装、回滚和普通权限矩阵按发布证据记录；未覆盖所有 Windows 版本、企业代理、设备路径和物理 DPI 组合。
- 安装包延续未做 OS 代码签名／Apple 公证的测试分发策略，自更新资产使用既有签名及核验流程。
安装
- macOS（Apple Silicon）：下载
.dmg，拖入「应用程序」。 - Windows（x64）：下载
*-setup.exe（NSIS）安装包。 - 均为未签名测试包：macOS 首次打开如被 Gatekeeper 拦截，右键 →「打开」；Windows SmartScreen 可能提示，选择「仍要运行」。
OpenCodeX Desktop v0.2.16
渠道详情保存当前渠道后直接返回，列表保存统一处理剩余修改（macOS Apple Silicon / Windows x64）。
- 名称、协议、认证、Key 和节点直接进入当前编辑，移除重复的“确认连接与模型 / 还原配置”。获取模型列表仍在模型列表，检测仍在服务节点。
- 详情“保存”只写入当前渠道，不打开完整保存预览；成功返回列表，失败保留详情和输入。列表“保存”继续预览并提交全部剩余修改。
- 单渠道写入以实际配置文件为底，保留其他渠道的已存配置、未知字段、凭据与布局；不顺带提交其他渠道的新增、删除、全局排序或采用关系。预算按本次实际写入范围计算。
- 保存后保留其他渠道未提交的名称、Key、节点、型号缓冲、导入及模版编辑，更新文件基线；后续列表保存、取消或还原不会撤销已经完成的单渠道保存。
- 未修改时保存置灰，详情状态只反映当前渠道；保留请求并发、旧事件和晚到响应保护。Key 的掩码、眼睛显隐、空输入保持与明确清空沿既有行为。
- 保存反馈沿既有全局通知及铃铛，提供“立即重启 Codex / 稍后”；亮暗和各特效档的材质参数与原型对照，不增加常驻状态行或新通知入口。
使用边界
- 显式历史恢复保留独立流程，普通单渠道保存不代表整份历史恢复完成。
- 隔离配置文件、受控服务、浏览器引擎与原生安装器分别验证；未替换用户日常配置或强制重启活跃 Codex。
- 安装包延续未做 OS 代码签名／Apple 公证的测试分发策略，自更新资产使用既有签名和核验流程。
安装
- macOS（Apple Silicon）：下载
.dmg，拖入「应用程序」。 - Windows（x64）：下载
*-setup.exe（NSIS）安装包。 - 均为未签名测试包：macOS 首次打开如被 Gatekeeper 拦截，右键 →「打开」；Windows SmartScreen 可能提示，选择「仍要运行」。
OpenCodeX Desktop v0.2.15
让配置传输与模版助手继续使用当前渠道文件，并清理旧版本遗留入口（macOS Apple Silicon / Windows x64）。
- 配置导出和 WebDAV 配置同步读取当前 config.json，渠道、型号族与共享范围不再依赖管理器旧渠道副本。选择携带的凭据沿当前来源处理，文件加密仍可选。
- 导入采用先形成当前内存草稿，保留实际文件保存基准及不冲突的渠道、型号与 Key 编辑。只有模版的采用只更新模版库；确认保存后才把渠道和已选授权写入文件。
- Agent 配置使用当前文件的渠道身份与名称，重新打开或保存数据变化后刷新执行目录，处理重试和旧请求晚回；失效模型不会自动换成其它模型。
- 外部模版任务及内部制模的版本事务不再读取无关旧渠道策略或磁盘草稿。保留精确版本、人工锁、任务范围、只检查与提交回执；模版结果不会直接覆盖渠道文件。
- 自动迁移有效渠道身份、节点和模版采用信息，保留历史恢复、候选、有效凭据与任务回执；移除废弃的新增渠道磁盘计划及普通草稿写入命令，不要求清空配置重新开始。
- 沿用现有范围选择、比较、保存预览、Agent 配置及铃铛样式，没有增加常驻迁移状态或额外核对流程。
使用边界
- 自动迁移不把旧副本反向覆盖为当前文件；无法合并的编辑保留并说明。
- 隔离文件、回环 WebDAV/任务接口与平台安装器分别验证，模拟响应不代表所有供应商、网络、账户登录和设备组合均已通过。
- 本版未替换用户日常配置或强行重启活跃 Codex。安装包延续未做 OS 代码签名／Apple 公证的测试分发策略，自更新资产使用项目既有签名及核验流程。
安装
- macOS（Apple Silicon）：下载
.dmg，拖入「应用程序」。 - Windows（x64）：下载
*-setup.exe（NSIS）安装包。 - 均为未签名测试包：macOS 首次打开如被 Gatekeeper 拦截，右键 →「打开」；Windows SmartScreen 可能提示，选择「仍要运行」。