使用 GetRun Harness App
安装 App，完成首次连接，并使用工作区、模型、会话、自动化和插件能力。
1. 下载与安装
从 GetRun 下载页获取与你的系统和架构匹配的安装包。
| 平台 | 安装包 | 安装方式 |
|---|---|---|
| macOS | Apple silicon / Intel DMG | 打开 DMG，将 App 拖入“应用程序” |
| Windows | x64 安装程序 | 运行安装程序并按提示完成安装 |
| Linux | x64 DEB / RPM | 选择发行版对应的安装包并完成安装 |
更新前先结束正在运行的任务并退出 App，再安装新版本。
2. 首次连接
启动后选择一种方式：
- 账号登录：登录 GetRun 账号并选择 API Key。
- 手动输入 Key：先在 API Key 页面创建 Key，再粘贴到 App，点击保存并启动。
连接成功后进入 App 首页。
macOS
Windows
3. 工作区与会话
工作区是 Agent 可以访问的项目目录，会话记录保存在对应工作区中。
- 在左侧工作区区域新建或选择目录。
- 点击新会话。
- 在输入框下方确认文件权限范围与当前模型。
- 描述任务并发送。任务运行时可查看工具调用和结果，也可随时停止。
macOS
Windows
4. 模型与运行模式
模型选择器会列出当前 Key 可用的 GetRun 模型。若旧会话中的模型不可用，请重新选择模型。
运行模式决定 Agent 可以使用的工具。开始任务前确认运行模式和工作区权限。
macOS
Windows
5. 自动化
在设置 → 自动化中启用 Browser Use 或 Computer Use：
- Browser Use 默认使用独立浏览器环境。如需连接当前 Chrome，请开启对应选项。
- Computer Use 会根据系统提示申请辅助功能、屏幕录制等权限。
- 导航、点击、输入、上传文件和启动应用等操作需要按界面提示确认。
6. 插件市场
- 在 App 设置中打开插件市场，也可以从 GetRun 插件详情页点击在 App 中打开。
- 搜索插件并查看名称、发布者、版本和来源。
- 点击安装并确认。
- 在已安装中管理或卸载插件。
- 按提示重启 App。
7. 退出登录与本地数据
在设置 → 账号中选择退出登录并确认。退出后返回登录页，工作区文件和会话记录会保留。
8. 故障排查
| 现象 | 处理 |
|---|---|
| Key 无效或没有模型 | 重新输入 Key，并确认模型权限和可用额度 |
| App 无法启动 | 完全退出 App 后重新打开 |
| 旧会话无法选择模型 | 在会话中重新选择可用模型 |
| 自动化不可用 | 检查自动化设置、系统权限和辅助组件状态 |
| 插件安装失败 | 检查网络后重试 |
使用其他客户端时，请查看 API Key 使用方法。