安装

Zshell 未经 Apple 公证。当前版本需要的最低 macOS 版本，标在首页的下载按钮旁边。

下载复制链接

从首页下载 .dmg。当前 0.1.11 提供 Universal、Apple Silicon 和 Intel 安装包，Gitee 同时提供镜像下载。 打开磁盘映像后，把 Zshell 拖进「应用程序」文件夹。

首次打开时，macOS 可能会拦截应用。尝试打开后，前往 系统设置 → 隐私与安全性 → 仍要打开，确认打开 Zshell。 通过 Homebrew 安装也可能需要这一步。

Homebrew复制链接

brew install wzz6423/tap/zshell

cask 放在 wzz6423/homebrew-tap，会按本机处理器安装 ZIP 包，安装后由 Sparkle 更新。 需要显式通过 Homebrew 更新，或补齐落后的已安装版本时，可以运行：

brew upgrade --cask --greedy-auto-updates zshell

更新复制链接

直接下载和 Homebrew 安装都通过 Sparkle 更新。 中国大陆优先访问 Gitee，失败后尝试 GitHub；其他地区优先访问 GitHub，失败后尝试 Gitee。 地区优先使用当前网络出口 IP 的国家码，查询失败时使用 macOS 系统地区。 国家码查询使用 ipinfo.io/country，最多等待 5 秒，结果仅在内存中 缓存 30 分钟。服务会接收到网络公网 IP，Zshell 不保存 IP；关闭自动检查也会停止后台国家码查询。

feed 或更新包下载失败时，只切换到另一个源重试一次。安装前会验证 feed 和更新包的签名， 并保留安装包的架构；在 Rosetta 下运行的 Intel 版会迁移到 Apple Silicon 版。

用 Cmd+, 打开 设置 → 更新，可分别控制自动检查更新和 自动下载更新。自动下载默认开启，需要开启自动检查；开启后才显示独立的自动安装更新开关，默认关闭。 只开启自动下载时，会在后台下载，并在退出 Zshell 时安装。两个开关都开启时，更新准备就绪后会自动安装并重启 Zshell。 重启会停止正在运行的终端进程，重新打开后恢复工作区。关闭自动下载会隐藏自动安装并阻止自动重启， 但保留自动安装的选择，供再次开启下载时使用。两个开关的选择都会在应用重启后保留。 检测到更新时，项目侧栏底部、反馈按钮左侧会显示更新图标；点击可打开更新或查看进度， 也可重试待完成的重启。也可以选择检查更新…立即手动检查，或使用上面的 Homebrew 命令显式更新。

推荐工具复制链接

打开 设置 → 推荐，可以浏览终端效率、网络与数据、开发工具链、实用工具和桌面应用， 其中包括 Zisla。页面打开期间会自动检测已安装的工具和可用更新。点击单项的 安装或更新，用 安装未安装项安装所有尚未安装的推荐工具，或用 全部更新 更新 Homebrew 管理且有新版本的工具。

工具安装使用 Homebrew；尚未安装 Homebrew 时，页面会提供安装说明入口。 自动检查不会自行安装或更新工具。通过其他方式安装的工具会标注 非 Homebrew 安装； 通过 Homebrew 安装 会安装一份由 Homebrew 管理的副本，Shell 的 PATH 仍可能优先找到 原来的版本。更改安装后，可以点击 刷新重新检查。Zshell 自身的更新在设置 → 更新中管理。

从 Finder 打开文件夹复制链接

Zshell 注册了一个名为 New Zshell Project Here 的 macOS 服务。在 Finder 里选中一个或多个文件夹，右键，从 服务 子菜单里选它——每个文件夹都会作为一个项目打开，终端已经在对应目录里启动好了。

如果菜单里没有它，去 系统设置 → 键盘 → 键盘快捷键 → 服务 → 文件和文件夹 打开。macOS 只会在应用至少启动过一次之后才列出新服务。

卸载复制链接

如果打开了 设置 → Automation → AI，请先关掉再删除应用，让 Zshell 移除它安装的 agent 支持。

从「应用程序」里删掉 zshell.app，如果想彻底清干净，再删掉它的配置：

rm -rf ~/.config/zshell

窗口布局、侧边栏宽度和会话快照存在 macOS 自己的偏好设置里：

defaults delete sh.zshell