ENVPilot 是一款原生 macOS 开发环境管理工具。它统一管理 Node.js、JDK、Python 运行时，以及 Codex、Claude Code、Pi、OpenCode 等 AI 编码工具，并按你在应用里选定的版本为终端生成对应的环境。
- 运行时由 ENVPilot 自主管理，不依赖 Homebrew、SDKMAN、nvm、fnm 或 pyenv
- 同时提供图形界面、
envpilot-helperCLI 和简写命令ep - 菜单栏常驻入口，随时查看和切换当前生效版本；可选开机自启动、关窗后是否继续留在菜单栏
点击菜单栏图标即可查看三类运行时的当前生效版本，并直接切换：
| 收起 | 展开版本列表 |
|---|---|
 |
 |
- 每行显示运行时与当前生效版本，点击整行展开已安装版本列表
- 已安装版本标注来源（ENVPilot 管理 / 系统安装），当前版本打勾，选中即切换并收起面板
- 未安装时给出明确的「未安装」状态，展开后可跳转到运行时页处理
- 底部是窗口级操作：主窗口、设置、退出
主窗口分为四个页面，左侧栏切换：
| 页面 | 作用 |
|---|---|
| 概览 | 当前生效的 Node / JDK / Python 与 AI 编码工具；有更新时可直接跳转到对应页面 |
| 运行时 | 一个页面内切换 Node / JDK / Python；已安装版本与可安装版本分区展示，支持搜索、仅 LTS 过滤与安装进度 |
| 包管理器 | 集中查看 npm、pnpm、Homebrew、uv 的安装位置、当前版本与最新版本，支持安装和更新 |
| AI 环境 | 集中查看 Codex、Claude Code、Pi、OpenCode 的安装位置、当前版本与最新版本，并按安装来源执行更新 |
首次启动会打开环境检查，逐项确认 ENVPilot Node、命令行工具、zsh 自动激活与 AI CLI 可见性；必需项缺失时可以直接一键配置或修复。之后可从侧边栏底部的盾牌按钮再次检查。
侧边栏底部只留设置按钮。重新读取本机运行时放在「显示」菜单里，快捷键仍是 ⌘R。
应用设置在 ENVPilot ▸ 设置… 或 ⌘, 的独立窗口中，不占用主窗口页面。里面有四个开关：菜单栏入口、关闭主窗口后是否保留菜单栏图标、开机自启动（走 macOS 登录项）、以及每天自动检查更新。
- Node.js：从 Node 官方分发查询版本，支持 LTS 过滤、安装、切换和卸载。
- JDK：从 Adoptium Temurin 与 Azul Zulu 查询版本，支持 LTS 过滤，保留完整的 macOS
.jdk目录结构，并通过JAVA_HOME和PATH激活。 - Python：从 Python 官方分发查询 Python 3.8+，安装 ENVPilot 管理的 CPython，并通过
ENVPILOT_PYTHON_HOME和PATH激活。 - 已安装运行时默认保存在
~/.envpilot/runtimes。下载带进度显示；安装前校验归档路径，并使用暂存目录完成安全替换，替换失败会恢复原安装。
版本只由全局选择决定：终端环境不随所在目录变化，也没有「预设」这层间接。envpilot-helper activate 仍然接受 --cwd（已安装用户的 ~/.zshrc 片段带着它跑），但那个参数只用于显示当前目录，不再参与选版本。
- 从 GitHub Releases 查询最新版本（优先 Releases API，被限流或不可达时退回
releases/latest的跳转地址），并按语义化版本比较——0.6.10比0.6.9新，预发布版小于同号正式版。 - 一键更新：下载
ENVPilot.zip→ditto解压 → 校验 bundle id、CFBundleShortVersionString与codesign --verify --deep --strict→ 退出应用后由一个脱离进程的脚本替换.app、清掉隔离属性、顺手刷新~/.local/bin/envpilot-helper，再重新启动。校验任何一步不过都不会动现有安装。 - 当前运行位置无法替换时（
swift run的非打包进程、DMG 或 App Translocation 的只读路径），退回到下载 dmg 并打开，不做危险操作。 - 入口有四个：应用菜单 检查更新…、菜单栏面板的 检查更新…（已发现新版本时直接显示 更新到 vX.Y.Z…）、设置窗口的「软件更新」卡片，以及侧边栏底部的新版本角标。
- 默认每天启动后自动查一次（可关）。更新说明直接取 Release 正文，在卡片里滚动查看。
- 自动探测
codex、claude、pi、opencode，显示可执行文件路径、安装来源、当前版本与最新版本。 - 识别 Homebrew Cask、Homebrew Formula、ENVPilot Node、npm 与 pnpm 安装，更新时分别走
brew upgrade或工具自身的更新命令。 - 已由其他来源安装的工具可一键切换到 ENVPilot 管理：安装最新版到当前 ENVPilot Node，新终端优先使用该版本。
- 支持单个更新与「全部更新」；检查失败时保留本机版本信息，不影响其他工具。
- 自动探测
npm、pnpm、brew、uv，显示来源、路径、当前版本和最新版本。 - 未安装时使用官方安装脚本；已安装时优先使用自身的更新命令，Homebrew 管理的工具走
brew upgrade。 - 独立安装的 pnpm 和 uv 可一键切换到 ENVPilot 管理：pnpm 安装到当前 ENVPilot Node，uv 安装到
~/.envpilot/tools，新终端优先使用 ENVPilot 版本。 - 支持单个安装、单项更新与「全部更新」，并复用 AI 环境页的进度和取消交互。
从 Releases 下载 ENVPilot.dmg，打开后把 ENVPilot 拖到「应用程序」目录。
装好之后不必再手动下载：ENVPilot ▸ 检查更新…（或设置里的「软件更新」卡片）会查询最新发布并一键更新到新版本。
要求 macOS 14 或更高版本、Apple Silicon（arm64）。
发布构建为 ad-hoc 签名、未经 Apple 公证。首次打开若提示「已损坏」或「无法验证开发者」，请执行
xattr -dr com.apple.quarantine /Applications/ENVPilot.app，或在「系统设置 ▸ 隐私与安全性」中允许打开。
需要 macOS 14+ 与支持 Swift 6.2 的工具链：
git clone https://github.com/imi4u36d/ENVPilot.git
cd ENVPilot
./scripts/create_dmg.sh脚本会完成 release 构建、组装 .app、签名并生成 DMG：
open dist/ENVPilot.dmg# 查看当前环境与诊断结果
ep status
ep doctor
# 查询和安装运行时
ep available node --lts
ep available jdk --lts
ep available python
ep install-node 22.17.0
ep install-jdk 21
ep install-python 3.13.7
# 输出完整帮助
ep help多数查询命令支持 --format json，修改命令支持 --dry-run。完整命令以 ep help 输出为准。
# 构建全部目标
swift build
# 运行测试
swift test
# 一键创建 DMG
./scripts/create_dmg.sh产物位于 dist/ENVPilot.dmg 与 dist/ENVPilot.dmg.sha256。版本号可通过环境变量注入，发布流水线即以此覆盖 tag 版本：
APP_VERSION=0.6.1 APP_BUILD=4 ./scripts/create_dmg.sh.github/workflows/release.yml 在推送 v* tag 时自动在 macos-26 运行器上构建并发布：
swift test（当前 61 个用例）./scripts/create_dmg.sh，用 tag 覆盖CFBundleShortVersionString- 校验 bundle 签名，产出
ENVPilot.dmg与ENVPilot.zip - 创建对应的 GitHub Release 并附上产物
手动触发（Actions ▸ Release macOS app ▸ Run workflow）时只上传 workflow artifact，不创建 Release。需要正式发布时打 tag 即可：
git tag v0.6.1
git push origin v0.6.1项目包含三个 SwiftPM 产品：
ENVPilotApp：SwiftUI macOS 应用（Sources/NodePilotApp）ENVPilotCore：运行时检测、安装、配置与 shell 集成（Sources/NodePilotCore）envpilot-helper：终端 CLI，安装后同时提供ep符号链接（Sources/nodepilot-helper）