wehub-resource-sync
86 lines
2.8 KiB
Markdown
86 lines
2.8 KiB
Markdown
# 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 可用磁盘空间
|