安装

安装

从 GitHub Releases 下载与系统匹配的安装包。请使用 x64 或 arm64 对应本机架构。

平台	安装包	应用内更新
Windows	NSIS StackFerry-*-Setup.exe（x64 / arm64）	可用
Linux	AppImage、deb（x64 / arm64）	可用
macOS	ad-hoc 签名 DMG（arm64 / x64）	不可用，请重新下载 DMG

启用供应商后，请重启对应 CLI 或终端（已开故障路由时，切换自定义上游通常不必重启）。

Windows

1. 运行 *-Setup.exe。安装器不是一键安装，可选目录。
2. 未签名安装包可能被 SmartScreen 拦截，选择 仍要运行。
3. 卸载不会删除应用数据（供应商、路由、Skills、MCP 仍保留）。

Linux

• AppImage：先 chmod +x，再运行。
• deb：用系统包管理器安装。应用内更新时，系统可能弹出密码框。

macOS

CI 打出的是 ad-hoc 签名 DMG，不是公证过的 Developer ID 包。Gatekeeper 常会提示「已损坏」。这是隔离标记（quarantine），不是文件坏了。

1. 下载 arm64（Apple 芯片）或 x64（Intel）。
2. 打开 DMG，把 StackFerry.app 拖到 /Applications。不要从 DMG 里直接运行。
3. 去掉隔离属性：

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

4. 在 Finder 里对应用 按住 Control 再点按 → 打开。若仍被拦，到 系统设置 → 隐私与安全性 → 仍要打开。

不要用 spctl --master-disable 关掉整机 Gatekeeper。换版本后重新做第 3、4 步。

应用更新

已打包的 Windows 与 Linux 会检查 GitHub Releases。可在 设置 → 关于 → 应用更新 里检查、下载、安装并重启。

macOS 与开发运行没有应用内更新，请重新下载 DMG。安装更新时 StackFerry 会退出；未保存的 CLI 工作不会自动恢复。