# 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 可用磁盘空间