Zeus

Zeus 是一款 AI 研发工作台，将项目与任务管理、Coding Agent 会话、代码理解、Git 变更审查和自动化协作整合在同一个工作空间中。

功能

• 管理项目、任务和 Coding Agent 会话。
• 在创建任务中粘贴 GitHub Issue、Jira 工作项或禅道详情链接，读取标题和正文后确认创建；受限内容通过 Zeus 登录，GitHub 与 Jira 附件保留为来源链接。
• 浏览和编辑项目源码，搜索文件与代码内容。
• 接入 Codex、Claude、Gemini 等 Coding Agent，并保存执行日志。
• 查看 Git 状态与 Diff，重要写操作保留确认步骤。
• 可选接入 Telegram，接收通知和执行受控命令。

安装

当前 Homebrew 安装包支持 Apple Silicon Mac，要求 macOS 13 或更高版本。

brew install --cask imchenway/tap/zeus

安装完成后，可从“应用程序”打开 Zeus。升级使用：

brew upgrade --cask imchenway/tap/zeus

彻底卸载 Zeus（包括 Homebrew Cask 已登记的本地配置）使用：

brew uninstall --cask --zap imchenway/tap/zeus

如需保留本地项目、会话和配置，请去掉 --zap，使用 brew uninstall --cask imchenway/tap/zeus。

也可以前往 GitHub Releases 下载安装包。

应用内更新会识别当前安装方式：Homebrew 管理的应用沿用 Homebrew 更新；手动从 DMG 安装的应用，在正式签名、公证、版本兼容和安装位置条件满足时，可下载后确认重启安装。条件不足时显示“下载新版”，引导手动替换应用，不会反复尝试下载。临时签名的旧版需先手动安装一次正式签名版本，才能使用后续的直接自动安装。

正式发布使用已有的 REQUIRE_APPLE_DISTRIBUTION=true 检查证书和公证配置；没有凭据时保留手动升级入口。开发验证无需配置正式证书。

首次打开

当前公开版本尚未经过 Apple 公证。首次打开时，如果 macOS 提示无法验证 Zeus：

1. 关闭提示窗口。
2. 打开“系统设置”。
3. 进入“隐私与安全性”。
4. 在安全性区域找到 Zeus，点击“仍要打开”。
5. 根据系统提示再次确认打开。

即：系统设置 → 隐私与安全性 → 仍要打开。

如果没有看到“仍要打开”，请先再次尝试启动 Zeus，然后返回该页面。此操作只会为当前 Mac 添加一次例外，具体说明见 Apple 官方帮助。

未配置 Apple Developer 凭据时，公开包仍采用 ad-hoc 签名且不做公证；发布清单会如实标记该状态。生产 ad-hoc 包包含稳定的代码 requirement，用于减少升级后因代码身份变化而重复询问“文稿”“下载”等隐私权限。用户主动选择项目、附件或导出位置时，macOS 仍可能 按真实目录访问边界请求授权。配置 Developer ID 与公证凭据后，仍可显式启用严格 Apple 分发。

版本更新内容见 GitHub Releases。

网络代理位于“设置 → 通用”，可保持默认、强制直连或填写 HTTP/HTTPS 代理地址及绕过列表。保存后等待任务结束，完全退出并重新打开 Zeus 生效；仅关闭窗口或保留后台任务不会切换代理。默认模式保留系统与启动环境；手动模式不支持 SOCKS 或地址内账号密码，本机回环请求始终直连。

在 Zeus 内使用 Codex 订阅登录后，会等待本次模型目录同步完成；同步失败会单独提示原因。日常运行每五分钟检查模型目录，账号变化会提前检查。在所使用的 Codex 运行组件仍与官方服务兼容时，账号已开放的新模型会随目录更新进入可选列表，无需反复登录。Zeus 当前仍通过本机 Codex 运行组件调用模型；目录自动更新不代表任意旧版 CLI 都支持未来的新模型。自动更新保留现有模型选择，实际可用范围以官方对该账号开放的目录为准。

开发与验证

使用 Node.js 24–25 和 pnpm 10，首次运行 pnpm install --frozen-lockfile。

• pnpm dev：构建后直接运行 Electron 源码，不生成安装包；开发数据使用当前仓库的 .tmp/electron-development-data，与 DMG 安装版分开。
• pnpm verify:publish：本地与 CI 共用的检查入口，执行冲突、格式、Lint、架构边界、类型和构建检查，不发布。
• pnpm package:mac：默认只生成独立身份 Zeus Test.app，输出到 dist/test/mac-arm64/（Intel 为 dist/test/mac/）；运行验收使用独立用户数据目录。
• pnpm package:mac:release：生成正式 DMG；仅在明确需要安装包或发布时执行。
• pnpm package:clean：预览 dist、dist/test 中的旧安装包；加 --apply 执行清理。沿用 ZEUS_PACKAGE_OUTPUT_DIR 可指定单个输出目录。
• pnpm verify:release：正式发布候选的检查、打包和产物校验；不自动安装或发布。

打包与产物校验成功后，自动清理当前输出目录中同一身份、架构的旧安装包；每种身份、架构保留最新实际版本的 DMG、ZIP 及配套文件。 清理只处理符合 Zeus 命名规则的普通文件，保留 App、其他文件和目录。优点是避免历次安装包无限累积；需要长期留存旧包时，请先移出构建输出目录。

日常改动按影响范围执行检查；行为变化补充真实运行证据。既有专项探针按需使用，不默认全量运行。 测试包必须来自当前任务的正常构建，不能用改名、重签的系统程序或篡改版本的应用样本替代。 启动本任务的测试包后，可执行 node scripts/verify-packaged-app-health.mjs "<Zeus Test.app绝对路径>" --runtime-root "<本次ZEUS_USER_DATA_DIR>" --runtime-pid <本次主界面进程号>，检查真实应用进程、宿主身份及持续推进的连接心跳。 该命令只读取已运行的测试实例，不启动或重试；未传运行参数时只检查包结构。更新验收应分别核对新版启动及失败回退后的真实连接，不能将模拟响应视为成功。存在外接屏时，使用 ZEUS_TEST_DISPLAY_ID 将测试窗口从首次创建起放在非主外接屏。 开启 Computer Use 后可控制另一个独立的 Zeus Test 实例，无需额外 QA 模式；当前宿主、控制服务和正式 Zeus 实例仍禁止控制，敏感操作仍需用户确认。多个 Test 同时运行时使用应用绝对路径指定目标。

Computer Use 的动作和观察可通过 wait_for 在同次调用中确认控件出现、消失或文本值变化，并返回可继续操作的新快照。条件未满足时只报告超时，不重放动作；确认范围仅为可访问的界面状态。默认返回紧凑控件或较小的差异，首次未缓存观察附带截图，后续确认按需使用 include_screenshot；需要全部控件属性时使用 full_output。优点是减少额外等待与模型往返；复杂界面可能需要补充完整观察，实际性能需以相同流程复测。 发布正文由发布准备流程写入 releases/v<版本>.md。任务记录与验收证据统一保留在本地 docs/，整个目录已加入 Git 忽略规则，不随源码提交。旧记录可从 Git 历史查阅，不维护新旧两套发布文档路径。