SmartAgent macOS 安装指南

安装 SmartAgent

1. 1

   先确认 Mac 芯片

   点击屏幕左上角苹果菜单 →“关于本机”。看到 Apple M1/M2/M3/M4 即可安装；Intel 芯片不能使用当前安装包。

2. 2

   打开 DMG 安装包

   在“下载”文件夹中双击 SmartAgent_1.5.1_macos-arm64.dmg。系统询问是否打开互联网下载的文件时，选择“打开”。

3. 3

   拖入“应用程序”

   把 SmartAgent 图标拖到 Applications（应用程序）文件夹。复制完成后，关闭安装窗口并推出磁盘映像。

4. 4

   允许第一次启动

   在“访达 → 应用程序”中双击 SmartAgent。出现“无法验证开发者”时先关闭提示，再进入“系统设置 → 隐私与安全性”，找到被阻止说明并点击“仍要打开”。

   注意：这个确认通常只需要一次。请先确认安装包来自官方或社群管理员，再输入 Mac 密码或使用触控 ID。

首次启动与 AI 配置

对新手最省事的方式，是使用会员账号自动同步配置。

1. 1

   进入首次启动引导

   打开 SmartAgent，阅读并确认使用说明，进入“配置 AI 模型”页面。

2. 2

   点击绿色的“会员token”按钮

   输入会员账号和密码并登录。登录成功后，软件会自动同步文字模型、提示词编译、语音和图片模型配置。

   注意：不要把会员账号、密码、验证码或包含个人信息的配置截图发给陌生人。

3. 3

   完成引导并等待状态变为“运行中”

   看到“会员配置成功”后继续下一步。IM 通道暂时不用时可以跳过。顶部显示“运行中”后，再开始聊天。

   暂时不会配置也没关系。可以选择“跳过，稍后配置”，进入软件后再点击顶部“会员token”。

4. 4

   完成第一次测试

   • 先发送一句“你是谁”，确认模型可以正常回复。
   • 需要语音输入时，再按系统提示允许麦克风权限。
   • 需要操作浏览器或电脑时，只授予当前任务确实需要的权限。
   • 会员密钥由软件安全保存，界面不会显示完整 API Key。

覆盖升级到新版本

1. 1

   完全退出 SmartAgent

   确认后台任务已经结束。

2. 2

   打开新版 DMG

   把新版 SmartAgent 再次拖入“应用程序”。

3. 3

   选择“替换”

   系统询问时选择替换旧版本。

4. 4

   检查版本号

   启动新版，确认左下角已经显示新版本号。

覆盖升级不会删除工作区、对话和配置。不要手动删除用户主目录中的 .smartagent 文件夹。

macOS 专项排查

1. 1

   提示“App 已损坏，无法打开”

   先确认安装包来源可靠，再请熟悉电脑操作的人打开“终端”，依次执行：

   xattr -dr com.apple.quarantine /Applications/SmartAgent.app
   open /Applications/SmartAgent.app

   注意：只对可信安装包执行，不要全局关闭 macOS 安全保护。

2. 2

   软件申请麦克风、辅助功能或屏幕录制权限

   这些权限只在语音输入或电脑自动化任务中需要。进入“系统设置 → 隐私与安全性”，按任务需要开启；不用相关功能时可以保持关闭。