wehub-resource-sync
2.8 KiB
GenericAgent 桌面版安装指南
📦 安装步骤
第一步：打开安装包
双击下载的 GenericAgent_x.x.x_aarch64.dmg 文件，会弹出一个安装窗口。
将左边的 GenericAgent 图标拖到右边的 Applications 文件夹图标上，等待拷贝完成。
拷贝完成后，可以右键点击桌面上的 DMG 图标，选择「推出」来关闭安装包。
第二步：首次打开前的准备（重要）
由于本应用暂未通过 Apple 官方签名认证，macOS 会阻止首次打开。这是正常的安全提示，不代表应用有问题。
请按以下步骤解除限制：
1. 打开「终端」应用
不知道终端是什么？别担心，它就是一个可以输入命令的工具。打开方式：
- 按下键盘上的
Command(⌘) + 空格键，会弹出搜索框（Spotlight） - 输入
终端或Terminal，按回车键打开
你会看到一个黑色或白色的文字窗口，里面有一个闪烁的光标，这就是终端。
2. 输入解除限制的命令
在终端窗口中，复制粘贴以下这行命令（整行复制，一个字都不要漏��：
xattr -cr /Applications/GenericAgent.app
粘贴方法：在终端窗口里按 Command(⌘) + V
然后按 回车键(Enter) 执行。
如果终端要求输入密码，输入你的 Mac 开机密码（输入时不会显示任何字符，这是正常的），然后按回车。
执行完毕后，终端不会有任何提示，这代表成功了。
3. 打开 GenericAgent
现在可以正常打开应用了：
- 打开 Finder → 侧边栏点击「应用程序」
- 找到 GenericAgent，双击打开
首次打开可能还会弹出一个确认框，点击「打开」即可。之后就不会再弹出了。
❓ 常见问题
Q: 提示「GenericAgent 已损坏，无法打开」怎么办？
这不是真的损坏，是 macOS 的安全机制。请回到第二步，确保在终端中执行了 xattr -cr 命令。
Q: 提示「无法打开，因为无法验证开发者」怎么办？
方法一（推荐）：执行第二步的终端命令。
方法二：右键点击 GenericAgent.app → 选择「打开」→ 在弹出的对话框中点击「打开」。
Q: 我的 Mac 是 Intel 芯片的，能用吗？
当前版本仅支持 Apple Silicon（M1/M2/M3/M4）芯片的 Mac。如果你的 Mac 是 2020 年之前购买的，大概率是 Intel 芯片，暂时无法使用本安装包。
查看方法：点击左上角 → 「关于本机」，如果芯片一栏显示 Apple M1/M2/M3/M4，就可以使用。
Q: 终端命令执行后没有任何反应？
没有反应就是成功了。Unix/macOS 的设计哲学是「没有消息就是好消息」。
🔧 系统要求
- macOS 12 (Monterey) 或更高版本
- Apple Silicon 芯片（M1/M2/M3/M4）
- 约 50MB 可用磁盘空间