安装与更新出问题时

几乎每一个安装或更新问题都是这四件事之一。按下面的顺序走，解决得最快的排在最前面

开始之前

解法取决于来源。Homebrew、WinGet 和 Scoop 都可能落后于当前的 GitHub 发布

macOS —— 看看 tap 提供的是哪个版本：

brew info tristan666666/tap/agentisland

如果 tap 看着旧，先刷新它的元数据：

brew update && brew upgrade tristan666666/tap/agentisland

你应该看到：版本与最新发布一致。如果还是落后，直接装 DMG

Agent Island 是 ad-hoc 签名而不是花钱买的开发者签名，所以 macOS 可能用「应用已损坏，无法打开」拒绝第一次启动。这句话的意思是隔离标记，不是下载损坏。Homebrew 的 cask 会替你清掉，手动挂载的 DMG 不一定

xattr -dr com.apple.quarantine /Applications/AgentIsland.app

-r 很重要：更新器住在一个嵌套的包里，不递归清理会把它漏掉——后果是过一阵子表现为「更新器无法启动」

你应该看到：下次启动一切正常，检查更新也能用

Windows 会给从网上下载的压缩包打标记，App 可能因此一开就退。解压之前先解除锁定：右键文件 → 属性 → 勾选解除锁定 → 应用，然后重新解压到一个你有权限的文件夹

把一份从没解除锁定的副本解压到 Program Files 这种受保护位置，会重现同样的退出

你应该看到：Agent Island 启动后稳定留在系统托盘

macOS 的更新走 Sparkle，带签名的 appcast。在 设置 → 通用确认自动检查更新是开的，然后用立即检查马上测一遍这条路

点了没反应有两个无害的原因：你已经是最新的，或者你跑的是关闭了更新检查的构建

你应该看到：要么弹出更新面板，要么明确告诉你这已经是最新版

更新可能在旧进程还在跑的时候替换掉磁盘上的 App，而旧进程会继续报告旧版本号。从灵动岛菜单里退出 Agent Island，不要只关掉某个面板，然后重新启动

你应该看到：App 里的版本号与你期待的那个发布一致

偏好设置是按 bundle 标识符存的，重装不会丢，所以重装没有损失——但它也修不好上面四步没修好的任何问题。从你原来的渠道重装，让以后的更新走同一条路

Homebrew 一直装旧版

tap 元数据有缓存，先 brew update。如果还是落后，说明 tap 还没跟上，从发布页装 DMG

「应用已损坏，无法打开」

是隔离标记不是损坏。执行第 2 步。如果还在，用 HTTPS 重新下载并对一下文件大小

「更新器无法启动」

嵌套的更新器包还带着隔离标记。带 -r 重跑一次 xattr，让它覆盖整个包

更新装了但版本号没变

替换时旧进程还在跑。彻底退出、重新启动、再看一次

Windows 上没有出现更新

Windows 版和 macOS 挂在同一个发布上，但不走 Sparkle。从发布页下载当前压缩包替换整个文件夹