Releases: imchenway/zeus
Releases · imchenway/zeus
Release list
Zeus v0.2.16
Zeus 0.2.16 更新内容
本次更新
- 本版本收录了 v0.2.15 之后进入固定候选提交的功能改进与问题修复。
- AI 发布说明不可用时采用保守模板，不根据缺失证据扩写具体功能。
如何升级
- Homebrew 用户可执行
brew upgrade --cask imchenway/tap/zeus。 - 也可以下载
Zeus-0.2.16-arm64.dmg，退出正在运行的 Zeus 后覆盖安装。
系统要求与已知限制
- 最低系统版本：macOS 13.0。
- 若公开清单显示应用尚未完成 Developer ID 签名或 Apple 公证，首次启动可能需要按 macOS 提示手动确认。
发布验证
- 公开前将由 Release Workflow 对固定候选提交执行类型检查、正式打包、DMG 完整性和更新清单一致性校验。
- 发布完成后将核对 GitHub 资产服务端摘要、更新清单与 Homebrew Cask。
Zeus v0.2.15
Zeus 0.2.15 更新内容
本次更新
- 本版本收录了 v0.2.14 之后进入固定候选提交的功能改进与问题修复。
- AI 发布说明不可用时采用保守模板，不根据缺失证据扩写具体功能。
如何升级
- Homebrew 用户可执行
brew upgrade --cask imchenway/tap/zeus。 - 也可以下载
Zeus-0.2.15-arm64.dmg，退出正在运行的 Zeus 后覆盖安装。
系统要求与已知限制
- 最低系统版本：macOS 13.0。
- 若公开清单显示应用尚未完成 Developer ID 签名或 Apple 公证，首次启动可能需要按 macOS 提示手动确认。
发布验证
- 公开前将由 Release Workflow 对固定候选提交执行类型检查、正式打包、DMG 完整性和更新清单一致性校验。
- 发布完成后将核对 GitHub 资产服务端摘要、更新清单与 Homebrew Cask。
Zeus v0.2.14
Zeus 0.2.14 更新内容
磁盘写入量改善
- 修复了在持续会话期间产生大量磁盘写入的问题。此前的存储方式会在每次保存时重写整个数据库，导致写入量与历史数据总量成正比；现在改为仅写入发生变化的数据页，日常使用中的磁盘写入量将不再随数据库体积无限增长。
- 为现有数据库切换前自动创建备份，并校验备份完整性；首次启动新版本时，如果检测到异常会拒绝启动，避免覆盖历史数据。
子任务上下文支持
- 将子任务推送到新会话时，现在可以选择携带父任务的背景信息。弹窗中会展示祖先任务列表，您可逐项选择要包含的任务信息、内部会话和附件。
- 默认不选择任何父任务内容，确保不会无意中发送您不希望共享的信息。
- 所选内部会话会以文件路径形式包含在任务提示中，所选附件通过结构化通道传递；若所选运行内核不支持附件，会明确提示并阻止发送。
界面与交互改进
- 改进了弹窗的键盘操作和焦点管理，开启弹窗后焦点会被限制在弹窗内，关闭后恢复到触发位置，减少误操作。
如何升级
- 通过 Homebrew 升级：
brew upgrade --cask imchenway/tap/zeus
- 手动升级：下载
Zeus-0.2.14-arm64.dmg并替换旧版本。
系统要求与已知限制
- 最低支持 macOS 13.0（Intel 和 Apple Silicon）。
- 首次升级时可能因数据库迁移而需要额外磁盘空间，并自动创建备份文件（
.pre-native-sqlite.bak），升级完成后可手动删除。 - 父任务上下文中的会话路径会作为文本发送给 AI 运行内核，可能包含本机绝对路径，请谨慎选择。
- 若所选 AI 运行内核不支持附件，则父任务附件选择将被禁用。
发布验证
- 本版本已通过 lint、类型检查、构建和打包验证的静态阶段，但我们不会声称已经完成正式制品签名或公证。
- 正式制品和公开发布将在后续流程中生成并验证，包括 DMG 签名、公证和安装包完整性检查；这些动作目前尚未执行。
- 升级路径的验证将在正式发布前进行，以确保从旧版本升级时数据迁移正确且无数据丢失。
Zeus v0.2.13
Zeus 0.2.13 更新内容
本次更新
- 本版本收录了 v0.2.12 之后进入固定候选提交的功能改进与问题修复。
- AI 发布说明不可用时采用保守模板，不根据缺失证据扩写具体功能。
如何升级
- Homebrew 用户可执行
brew upgrade --cask imchenway/tap/zeus。 - 也可以下载
Zeus-0.2.13-arm64.dmg，退出正在运行的 Zeus 后覆盖安装。
系统要求与已知限制
- 最低系统版本：macOS 13.0。
- 若公开清单显示应用尚未完成 Developer ID 签名或 Apple 公证，首次启动可能需要按 macOS 提示手动确认。
发布验证
- 公开前将由 Release Workflow 对固定候选提交执行类型检查、正式打包、DMG 完整性和更新清单一致性校验。
- 发布完成后将核对 GitHub 资产服务端摘要、更新清单与 Homebrew Cask。
Zeus v0.2.12
Zeus 0.2.12 更新内容
会话列表与阅读体验
- 会话列表改为按照排队、运行、待回复、完成等阶段的实际变化时间排序。打开或阅读会话，以及同步消息、Token 和配置，不再让会话意外置顶。
- 历史会话会根据已有阶段记录恢复排序时间；升级后列表可能发生一次符合新规则的重排。任务详情中的关联会话仍按创建时间顺序展示。
- 回答和过程说明改为按自然语言片段自适应显示；完整答案与历史答案直接呈现，文件路径、链接和行内代码不再逐字符缓慢增长。
- 修复部分历史 Pi／DeepSeek 会话发送消息后短暂消失并回填输入框的问题。Zeus 只会在本地记录提供充分证据时修正会话归属，正常 Codex 会话不会因模型名称被误判。
任务流程与 Git 操作
- 可分别为每个项目新增、改名、改色、排序和删除任务管理状态；全局设置中可维护新项目的默认状态模板，模板修改不会自动改变已有项目。
- 删除仍被任务或默认流程使用的状态时，需要选择替代状态；保存后，已有任务及原状态承接的流程行为会一并迁移，避免任务失去状态。
- 任务状态颜色会用于列表、详情和状态选择入口，同时保留文字标签，并适配浅色与深色主题。
- 任务代码提交说明会根据任务类型默认使用
feat、fix或perf前缀，且仍可在提交前手工修改；代码交付产生的合入说明不受影响。 - 多仓任务中，单个仓库远端认证或网络失败不再清空全部工作区。远端不可用时仍可查看本地变更并创建本地提交，仅禁用依赖远端的拉取、推送和合入操作。
- 没有配置远端的纯本地仓库会使用本地命名分支，不再因缺少 remote 而阻止本地查看和提交。
命令运行耗时
- 命令执行历史和详情现在都会显示实际耗时，并将原有“超时”明确标注为“超时上限”。
- 实际耗时从命令真正启动时开始计算，不包含等待用户确认的时间；运行中逐秒更新，结束后固定，从未启动的记录显示“未启动”。
Zeus 会话远程接管
- 设置页进一步明确手机端操作的是 Zeus 当前会话，底层连接仍由 Codex Remote Control 提供。
- 启用失败时会保留经脱敏处理的实际原因，并在同一设置区域提供安装、登录说明和“重新检测并重试”入口，不再只显示笼统的退出码。
- 远程接管启动失败后会恢复为未启用状态，避免后续普通 Codex 操作被导向失败的远程链路。
如何升级
0.2.12 正式公开并完成制品回验后，可通过 Homebrew 手动升级：
brew upgrade --cask imchenway/tap/zeus也可以在正式公开后下载版本化安装包 Zeus-0.2.12-arm64.dmg。退出正在运行的 Zeus 后打开 DMG，并用新版本覆盖旧版本。
Homebrew 和版本化 DMG 均为手动升级方式，本版本不声明应用内自动安装可用。
系统要求与已知限制
- 支持 Apple Silicon Mac，要求 macOS 13 或更高版本。
- Zeus 不附带 Codex；使用 Codex 模型及会话远程接管仍依赖本机安装、完成登录且兼容的 Codex CLI。
- Zeus 不会自动安装、替换或切换外部 Codex CLI。显式配置的 CLI 路径仍具有优先级，修复外部安装或登录问题后需要手动重新检测并重试。
- 历史 Pi 会话修复采用严格证据条件。证据不足的异常记录会保持不变，以避免误改真实 Codex 会话。
- 远端不可用时只能继续本地查看与提交；恢复拉取、推送及依赖最新远端的合入仍需先解决网络或仓库凭据问题。
发布验证
- 草稿通过后，将把根包和桌面包版本从 0.2.11 写入 0.2.12，并将已审阅的 Release notes 写入候选提交。
- 同一干净候选提交将执行冲突残留、空白与格式、ESLint、TypeScript、生产构建、验收矩阵和 AI CLI 适配检查，并生成正式 macOS 应用、
Zeus-0.2.12-arm64.dmg、发布清单及 Homebrew Cask。 - 公开前将使用隔离数据和桌面交互回验会话阶段排序、历史会话迁移、流式内容分块、结构化片段显示、减少动态效果，以及历史 Pi 会话与正常 Codex 会话的身份隔离。
- 还将回验任务状态的新增、改名、改色、排序和删除迁移，默认提交说明生成，多仓远端失败时的本地提交能力，以及运行中、已结束和未启动命令的耗时展示。
- 会话远程接管将核对失败原因展示、失败状态回滚和重新检测入口；正式制品不会仅凭设置页可见或刷新成功宣称手机配对与远端回答回流可用。
- 正式候选制品将核对应用身份、包体健康、DMG 完整性，以及发布清单中的版本、架构、文件大小、SHA-256、签名和公证状态。
- 只有本地发布门禁和候选提交的主分支 CI 通过后，才会创建不可变标签
v0.2.12、触发 Release Workflow、生成 GitHub Release 并同步 Homebrew Tap。 - 公开流程完成后，还将重新下载
Zeus-0.2.12-arm64.dmg和发布清单，复验 DMG，并对账 GitHub Release 正文与资产、发布清单以及 Homebrew Cask 的版本、架构和摘要。
Zeus v0.2.11
Zeus 0.2.11 更新内容
历史任务附件恢复可用
- 从旧数据目录迁移后，历史任务中仍指向旧位置的附件，可在“推送到新会话”时重新识别当前托管目录中的有效副本。
- Zeus 启动时会自动修复可验证的历史附件引用；修复不会改动任务内容及其业务更新时间，也不会删除或改写旧目录。
- 推送前会再次解析历史引用，因此迁移尚未写回或后来导入的旧任务也可使用当前托管副本。
- 只有资源名称、类型、大小和现有副本内容等信息能够安全对应时才会恢复。当前副本缺失或不一致时仍会阻止创建会话，并提示重新添加附件。
如何升级
0.2.11 正式公开并完成制品回验后，可通过 Homebrew 手动升级：
brew upgrade --cask imchenway/tap/zeus也可以在正式公开后下载版本化安装包 Zeus-0.2.11-arm64.dmg。退出正在运行的 Zeus 后打开 DMG，并用新版本覆盖旧版本。
Homebrew 和版本化 DMG 均为手动升级方式，本版本不声明应用内自动安装可用。
系统要求与已知限制
- 支持 Apple Silicon Mac，要求 macOS 13 或更高版本。
- Zeus 不附带 Codex；使用 Codex 模型仍依赖本机安装且兼容的 Codex CLI。
- 自动恢复要求附件在当前 Zeus 托管目录中存在可验证副本。资源缺失、类型或大小不符、内容不一致以及符号链接等不受信资源不会被自动恢复。
- 首次启动可能需要读取历史附件以完成一致性检查；旧附件目录会保持原样，不会自动清理。
- 本次修复只处理历史任务的附件引用。如果旧数据没有完整迁移到当前数据目录，仅升级应用不能替代项目、附件、会话文件和命令脚本的完整恢复。
- 当前证据中的隔离测试包使用 ad-hoc 签名且未经 Apple 公证；0.2.11 正式制品的签名与公证状态将在制品生成后按发布清单核对。
发布验证
- 草稿通过后，将把根包和桌面包版本从 0.2.10 写入 0.2.11，并将已审阅的 Release notes 写入候选提交。
- 同一干净候选提交将执行冲突残留、空白与格式、ESLint、TypeScript、生产构建、验收矩阵和 AI CLI 适配检查，并生成正式 macOS 应用、
Zeus-0.2.11-arm64.dmg、发布清单及 Homebrew Cask。 - 公开前将使用隔离应用和正式数据库副本回验历史附件恢复：确认有效引用迁移到当前托管目录、任务业务更新时间不变，并实际从历史任务向新会话推送附件。
- 还将使用缺少或不一致附件副本的隔离场景，确认 Zeus 不改写原引用、不会绕过受信目录校验，并继续阻止创建会话。
- 正式候选制品将核对应用身份、包体健康、DMG 完整性，以及发布清单中的版本、架构、文件大小、SHA-256、签名和公证状态。
- 只有本地发布门禁和候选提交的主分支 CI 通过后，才会创建不可变标签
v0.2.11、触发 Release Workflow、生成 GitHub Release 并同步 Homebrew Tap。 - 公开流程完成后，还将重新下载
Zeus-0.2.11-arm64.dmg和发布清单，复验 DMG，并对账 GitHub Release 正文与资产、发布清单以及 Homebrew Cask 的版本、架构和摘要。
Zeus v0.2.10
Zeus 0.2.10 更新内容
任务列表列调整更直观
- 可以直接拖动列标题调整列顺序；单击列标题仍用于排序，独立换位把手和键盘换列操作继续保留。
- 列宽分隔线现在会显示低对比度提示，并提供更容易命中的拖动区域。所有可调列均可在各自的可读下限与
640px上限之间连续调整。 - 列顺序、列宽、显隐和排序继续保存在同一套任务表布局偏好中。
- “任务类型”改为只读彩色胶囊：需求为蓝紫色、缺陷为红色、优化为绿色，同时保留完整文字。
新任务工作区采用最新且干净的来源
- 对配置了远端的仓库，创建任务工作区前会先刷新远端，只显示本次刷新获得的远端分支，并从所选分支的精确提交创建任务开发线。
- 原项目目录中已暂存、未暂存和未跟踪的内容不会自动进入新任务工作区，避免把其他本机工作意外带入任务。
- 没有远端的纯本地仓库仍可创建任务工作区，默认同样不携带未提交内容；需要时可显式选择带入。
- 任务成果对比会固定使用创建工作区时的来源提交，不会因同名来源分支之后移动而改变比较基准。
推送与目标分支合入更安全
- 推送任务分支前会重新刷新远端。首次推送和正常快进推送仍受支持；同名远端分支已经领先或发生分叉时会阻止覆盖，不会执行强制推送。
- 配置远端的仓库必须先让本地任务分支与远端任务分支完全一致，才能合入目标分支。
- 合入候选从最新远端目标分支创建，只合入当前任务提交一次，不会先把目标分支合回任务分支，也不会自动改写任务分支历史。
- 最终交付前若目标分支已经前进，旧候选会被废弃并从最新目标提交安全重建。没有冲突草稿且重建后无冲突时会继续交付。
- 已有冲突草稿时，只有冲突内容保持一致才会恢复草稿，并要求重新确认；冲突内容发生变化时不会自动套用旧草稿。
- 纯本地仓库仍可在本地完成提交和目标分支合入。
如何升级
0.2.10 正式公开并完成制品回验后，可通过 Homebrew 手动升级：
brew upgrade --cask imchenway/tap/zeus也可以在正式公开后下载版本化安装包 Zeus-0.2.10-arm64.dmg。退出正在运行的 Zeus 后打开 DMG，并用新版本覆盖旧版本。
Homebrew 和版本化 DMG 均为手动升级方式，本版本不声明应用内自动安装可用。
系统要求与已知限制
- 支持 Apple Silicon Mac，要求 macOS 13 或更高版本。
- Zeus 不附带 Codex；使用 Codex 模型仍依赖本机安装且兼容的 Codex CLI。
- 远端模式要求网络和 Git 凭据可用。远端刷新失败时，创建任务工作区、推送或目标合入会被阻止，不会退回缓存的远端分支记录。
- 两个分支真实修改同一段代码时仍可能产生冲突，需要人工判断；目标分支持续更新时，合入候选可能多次重建并要求重新确认冲突。
- 从旧数据目录升级且首次迁移未成功的用户仍可能看到空白项目列表。若历史数据位于
~/Library/Application Support/@zeus/desktop、当前~/.zeus为空，请先退出 Zeus 并备份两个目录；完整恢复需要同时保留附件、会话文件和命令脚本，不能只替换数据库文件。 - 0.2.10 正式制品的签名与公证状态将在制品生成后按发布清单核对；完成前不作 Apple 认证分发声明。
发布验证
- 草稿通过后，将把根包和桌面包版本从 0.2.9 写入 0.2.10，并以同一干净候选提交执行完整发布门禁。
- 门禁将检查冲突残留、空白与格式、ESLint、TypeScript、生产构建、验收矩阵和 AI CLI 适配，并生成正式 macOS 应用、
Zeus-0.2.10-arm64.dmg、发布清单及 Homebrew Cask。 - 公开前将使用独立身份的隔离测试应用回验列标题换位、列宽调整、布局保存、任务类型胶囊，以及远端来源刷新、未提交内容隔离、任务分支一致性门禁、目标推进后的候选重建和冲突草稿确认。
- 正式生产制品将核对应用身份、包体健康和 DMG 完整性，并核对发布清单中的版本、架构、文件大小、SHA-256、签名及公证状态。
- 只有候选门禁和主分支 CI 通过后，才会创建不可变标签
v0.2.10、触发 Release Workflow、生成 GitHub Release 并同步 Homebrew Tap。 - 公开流程完成后，还将重新下载
Zeus-0.2.10-arm64.dmg和发布清单，复验 DMG，并对账 GitHub Release 正文与资产、发布清单以及 Homebrew Cask 的版本、架构和摘要。
Zeus v0.2.9
Zeus 0.2.9 更新内容
任务详情支持直接粘贴附件
- 在任务标题、需求描述、缺陷现状与预期、复现步骤、优化现状与预期以及标签编辑框中，可以直接粘贴图片、文件和文件夹。
- 普通短文本仍会插入当前光标位置；达到 5000 个字符的长文本会自动转为文本附件。
- 支持从 Finder 和 Paste.app 粘贴资源。附件关联期间会保留当前文字草稿、焦点和选区，随后保存文字时不会因附件更新产生冲突。
- 资源读取或保存失败时，文字草稿不会丢失，并会显示错误和重试入口。
下拉菜单自动避开窗口底边
- 任务列表底部的状态菜单不再固定向下展开：下方空间不足时会改为向上完整展开。
- 这一行为同时适用于任务详情、设置和弹窗中的同类下拉菜单；下方空间充足时仍保持向下展开。
Codex 询问可以在后台切换后继续回答
- Codex 等待用户回答期间，即使后台会话服务已经切换，仍可在原会话中提交选项或自定义文字，无需放弃会话或重新描述上下文。
- 符合该情形、此前因后台切换而失败的最近一次询问也可以恢复显示并继续回答。
- 续接会在同一 Codex 会话中开启新的轮次；涉及操作审批时，不会沿用切换前的旧批准，Codex 需要重新发起明确审批。
Pi 会话显示完整最终回答
- 通过 Pi 使用 DeepSeek 等模型时，工具调用前的阶段说明会在执行期间保留；最终回答到达后，会替换阶段说明，不再让会话停留在第一句话。
- 对本地已经保存完整最终正文的受影响 Pi 历史会话，Zeus 会恢复完整的最终回答显示。
如何升级
0.2.9 正式公开并完成制品回验后，可通过 Homebrew 手动升级：
brew upgrade --cask imchenway/tap/zeus也可以在正式公开后下载版本化安装包 Zeus-0.2.9-arm64.dmg。退出正在运行的 Zeus 后打开 DMG，并用新版本覆盖旧版本。
Homebrew 和版本化 DMG 均为手动升级方式，本版本不声明应用内自动安装可用。
系统要求与已知限制
- 支持 Apple Silicon Mac，要求 macOS 13 或更高版本。
- Zeus 不附带 Codex；使用 Codex 模型仍依赖本机安装且兼容的 Codex CLI。
- 在极矮的窗口中，下拉菜单即使改为向上展开，顶部仍可能被窗口边缘裁切。
- Pi 的阶段说明不会作为独立消息永久保留；最终回答到达后会覆盖它。历史会话只有在本地已经保存完整最终正文时才能恢复完整显示。
- 从旧数据目录升级且首次迁移未成功的用户，仍可能看到空白项目列表。若历史数据位于
~/Library/Application Support/@zeus/desktop、当前~/.zeus为空，请先退出 Zeus并备份两个目录；完整恢复需要同时保留附件、会话文件和命令脚本，不能只替换数据库文件。 - 截至本候选草稿生成阶段，当前公开稳定制品 0.2.8 仍为 ad-hoc 签名且未经过 Apple 公证，因此只采用手动升级口径。0.2.9 的签名与公证状态将在正式制品生成后按实际清单核对，完成前不作 Apple 认证分发声明。
发布验证
- 草稿通过后，将把根包和桌面包版本从 0.2.8 写入 0.2.9，并以同一干净候选提交执行完整发布门禁。
- 门禁将检查冲突残留、空白与格式、ESLint、TypeScript、生产构建、验收矩阵和 AI CLI 适配，并生成正式 macOS 应用、版本化 DMG、发布清单及 Homebrew Cask。
- 公开前将使用隔离测试应用回验任务详情资源粘贴、下拉菜单上下展开、Codex 询问恢复和 Pi 最终回答覆盖；同时核对应用身份、包体健康、DMG 完整性，以及清单中的版本、架构、文件大小、SHA-256、签名和公证状态。
- 只有候选门禁和主分支 CI 通过后，才会创建不可变标签
v0.2.9、触发 Release Workflow、生成 GitHub Release 并同步 Homebrew Tap。 - 公开流程完成后，还将重新下载
Zeus-0.2.9-arm64.dmg和发布清单，复验 DMG，并对账 GitHub Release 正文与资产、清单以及 Homebrew Cask 的版本、架构和摘要。
Zeus v0.2.8
Zeus 0.2.8 更新内容
会话失败原因直接显示
- 执行失败后，会话时间线会在对应轮次原位置显示原因卡片，不再只显示“本轮失败”。
- Zeus 会区分认证、限流、网络、模型配置和权限等常见问题，并给出相应的恢复建议。
- 可展开“技术详情”查看错误代码、运行状态和供应商返回的原因；API Key、Bearer 凭据、本机完整路径和堆栈会在展示前脱敏或移除。
- 即使失败轮次没有生成助手消息，原因卡片也会保留。历史失败只有在本地数据库已保存错误内容时才能显示，Zeus 不会补造缺失的供应商错误。
更多内置模型供应商
- 模型连接新增 Kimi 和 Z.AI / GLM 内置入口，并继续提供 DeepSeek、阿里云百炼以及自定义兼容供应商。
- 内置入口预设官方服务地址和模型目录。配置时只需填写 API Key、保存连接并获取候选模型，减少误改地址或能力参数的风险。
- 自建服务、代理或其他兼容渠道仍可使用自定义供应商，并继续手工维护服务地址、模型和能力档案。
更准确的模型能力选择
- DeepSeek 官方渠道的 V4-Flash 提供
low、high、max思考深度，V4-Pro 提供high、max；默认均为high。 - 阿里云百炼托管的 DeepSeek V4-Flash 和 V4-Pro 仅展示实际可区分的
high、max，避免把效果相同的别名显示为独立档位。 - 迁移只更新旧系统的精确默认配置；用户手工修改过的能力设置保持不变。
- 模型不支持或尚未确认思考深度时，会话输入框和“推送到新会话”窗口会隐藏深度选择，不再显示无效的
off选项。 - 图片能力尚未确认时仍允许尝试；只有模型被明确标记为不支持图片时才会关闭图片入口。最终是否可用仍取决于具体供应商、模型和协议端点。
如何升级
0.2.8 已公开发布并完成 Homebrew Tap 同步，可通过 Homebrew 手动升级：
brew upgrade --cask imchenway/tap/zeus也可以从 0.2.8 对应的 GitHub Release 下载版本化安装包 Zeus-0.2.8-arm64.dmg。退出正在运行的 Zeus 后打开 DMG，并用新版本覆盖旧版本。
Homebrew 和版本化 DMG 均为手动升级方式，本版本不声明应用内自动安装可用。
系统要求与已知限制
- 支持 Apple Silicon Mac，要求 macOS 13 或更高版本。
- Zeus 不附带 Codex；使用 Codex 模型仍依赖本机安装且兼容的 Codex CLI。
- 历史失败记录只有在本地数据库已经保存错误内容时才能显示详细原因。
- 模型能力由接入渠道、具体模型和协议端点共同决定；一个渠道确认的思考深度、图片或 Responses 能力不能直接套用于其他渠道。
- 从旧数据目录升级且首次迁移未成功的用户，仍可能在启动后看到空白项目列表。一种已确认的情况是历史数据仍保留在
~/Library/Application Support/@zeus/desktop，而当前数据目录~/.zeus为空。遇到这种情况时，请先退出 Zeus并保留、备份两个目录；完整恢复还需包含附件、会话文件和命令脚本，不能只替换数据库文件。 - 0.2.8 公开制品为 ad-hoc 签名且未经过 Apple 公证，只能通过 Homebrew 或 DMG 手动升级。首次打开时，可能需要在“系统设置 → 隐私与安全性”中选择“仍要打开”。
发布验证
v0.2.8指向发布提交290ede9d542e55eaa45b6357dae36583b046438a，根包和桌面包版本均为0.2.8。- 统一发布门禁、139 项验收矩阵、AI CLI 适配探针、正式 macOS 打包、主分支 CI 和 Release Workflow 均已通过。
- 公开 DMG 为
Zeus-0.2.8-arm64.dmg，SHA-256 为1af47e9317479758123ea4c18b3e5bf75b7628a22707acdb9c8e65f99a781f11。 - 公开 DMG 已重新下载并通过
hdiutil verify；Release 资产元数据、manifest、Homebrew Cask 的版本、架构和摘要已经完成一致性对账。 - 真实
Zeus Test.appGUI 已验收失败原因卡片、恢复建议、脱敏技术详情和四个内置模型供应商入口；正式/Applications/Zeus.app未被启动或替换。
Zeus v0.2.7
Zeus 0.2.7 更新内容
新会话前的 Codex 登录门禁
- 在“推送到新会话”中选择需要 OpenAI 认证的 Codex 模型时，Zeus 会先检查其专属 Codex 账号状态，避免创建一条必然在首轮失败的会话。
- 未登录时，原弹窗会显示“登录并继续”并打开官方 ChatGPT 登录页。登录完成后，Zeus 会保留已选模型、工作区、权限和补充信息，自动继续创建会话。
- 取消登录、打开登录页失败或等待超时不会创建会话或任务工作区，当前填写内容会保留，用户可以直接重试。
- Zeus 专属 Codex 与 Codex App 保持独立登录状态，不会复制或覆盖 Codex App 的账号信息。
- 真正创建会话前，服务端会再次检查账号状态；即使绕过界面调用创建入口，未登录的 Codex 请求也会被拒绝。已经就绪的 Pi 模型不受此门禁影响。
- 如果登录在真实执行轮次建立后失效，失败会话仍会保留，用户可完成登录后在原会话重试。
如何升级
本候选尚未公开发布。正式发布并完成 Homebrew Tap 同步后，可通过 Homebrew 手动升级：
brew upgrade --cask imchenway/tap/zeus也可以从 0.2.7 对应的 GitHub Release 下载版本化安装包 Zeus-0.2.7-arm64.dmg。退出正在运行的 Zeus 后打开 DMG，并用新版本覆盖旧版本。
Homebrew 和版本化 DMG 均为手动升级方式，本版本不声明应用内自动安装可用。
系统要求与已知限制
- 支持 Apple Silicon Mac，要求 macOS 13 或更高版本。
- Zeus 不附带 Codex；相关 AI 执行仍依赖本机安装且兼容的 Codex CLI。需要 OpenAI 认证的新会话可通过本版本新增的登录门禁完成 Zeus 专属登录。
- 从旧数据目录升级且首次迁移未成功的用户，仍可能在启动后看到空白项目列表。已确认的一种情况是历史数据仍保留在
~/Library/Application Support/@zeus/desktop，而当前数据目录~/.zeus为空；0.2.7 未加入自动迁移修复。遇到这种情况时，请先退出 Zeus 并保留、备份两个目录；完整恢复还需包含附件、会话文件和命令脚本，不能只替换数据库文件。 - 截至本草稿生成时，当前公开制品仍为 ad-hoc 签名且未经过 Apple 公证，只能通过 Homebrew 或 DMG 手动升级。首次打开时，可能需要在“系统设置 → 隐私与安全性”中选择“仍要打开”。0.2.7 正式制品的签名与公证状态以发布门禁生成的清单为准。
发布验证
- 当前处于 Release notes 草稿生成阶段；候选提交中的根包和桌面包版本仍为
0.2.6，尚未执行0.2.7版本写入、发布提交、正式打包或公开发布。 - 草稿通过后，编排器将写入根包和桌面包的
0.2.7版本及本发布正文，并形成与候选范围绑定的干净发布提交。 - 随后将执行统一发布门禁，包括冲突与空白检查、变更文件格式检查、lint、类型检查、生产构建、验收矩阵、AI CLI 适配探针及正式 macOS 打包。
- 功能回验将覆盖 Codex 未登录提示、官方登录页打开、取消与超时恢复、登录后保留原配置并自动继续、服务端创建前复验、绕过界面时的拒绝，以及 Pi 模型不受门禁影响；同时确认真实轮次建立后发生认证失败时，原会话仍可登录后重试。
- 制品门禁将检查应用身份、包内结构与可执行文件、严格 codesign、DMG 完整性和 SHA-256，并核对发布清单、签名、公证状态及 Homebrew Cask 的版本、架构和摘要一致性。
- 本地门禁通过后，编排器才会推送
main并等待对应 CI 成功，然后创建不可变的v0.2.7标签，由发布工作流创建 GitHub Release 并同步 Homebrew Tap。 - 公开流程完成后还将重新下载 DMG 和发布清单，复核文件摘要、DMG 完整性、Release 资产元数据、Release notes 与 Homebrew Cask；这些步骤完成前不视为发布结束。