快速开始

这份指南写给第一次安装 Pine 的普通用户：不需要会写代码，按步骤做即可。如果你想在服务器上运行，或从源码构建，请看进阶安装。

注意

Pine 目前是早期开发者预览版，界面、数据格式和 Agent 行为都可能发生不兼容变更。请不要把唯一一份重要文件交给它处理，先备份再使用。

开始之前

不确定自己的 Mac 是哪种芯片：点屏幕左上角 → “关于本机”，看”芯片”一栏。写着 Apple M1/M2/M3/M4 等的是 Apple 芯片，写着 Intel 的是 Intel。

一个可用的 AI 模型账号。Pine 本身不提供模型，也不做中转，模型连接由你自己配置。你需要下列之一：
- 某个模型服务商的 API Key（如 Anthropic、OpenAI、Google、DeepSeek、智谱、Moonshot 等，Pine 内置了多家提供商）；
- 支持登录授权的订阅账号（OAuth 登录，在 Pine 里点登录即可）；
- 自建或第三方的 兼容接口（需要地址和密钥，可用”自定义提供商”添加）。
能访问你选用的模型服务的网络。部分服务商在某些地区需要代理，请先确认你的网络能打开对应服务商的官网。
一个想让 Pine 处理的文件夹（文档、表格、资料都可以）。

Pine 的安装包有两个下载来源，内容相同，任选其一。

下面的链接始终指向最新版本，发布新版后不需要换链接，点击即可下载。不需要 GitHub 账号，也不用在页面里找文件：

想确认下载的文件没有损坏，可以打开校验文件 SHA256SUMS，对照里面的 SHA-256 值与自己下载文件的值是否一致。

安装包也发布在 GitHub：

打开页面后，在 Assets 里选择与你系统对应的文件：

注意：

第一次打开可能被系统拦截。 Pine 的安装包目前没有经过 Apple 公证，macOS 可能提示”无法验证开发者”或”已损坏”。这是系统对未公证应用的常规拦截，处理方法：

先在”应用程序”里右键点击 Pine → 打开，在弹窗里再点”打开”。
如果没有”打开”按钮：到 系统设置 → 隐私与安全性，往下找到关于 Pine 的提示，点 仍要打开，然后输入电脑密码确认。
如果提示”已损坏，无法打开”，打开”终端”，运行下面这一行后再重新打开（只对你确认来自官方发布页的文件使用）：
```
xattr -dr com.apple.quarantine /Applications/Pine.app
```

双击下载的 win32-x64.exe 安装程序。
如果出现蓝色的 “Windows 已保护你的电脑”（SmartScreen）：点 更多信息 → 仍要运行。这是因为安装包可能未带商业代码签名证书，确认下载来源是官方发布页即可。
安装是一键完成的，不需要选择路径；完成后会自动启动 Pine，并创建桌面 / 开始菜单快捷方式。

直接进入主界面。如果之后用到屏幕相关能力（如快速输入框抓取当前窗口、Computer Use），系统会请求”屏幕录制”或”辅助功能”权限，按需在 系统设置 → 隐私与安全性 中允许即可，不用这些功能可以一直不授权。

Windows 首次启动时，Pine 会先配置 Windows 沙箱（用来把 Agent 的命令限制在授权文件夹内）。

Pine 的界面支持简体中文、繁体中文、英文、日文、韩文、西班牙文、法文、德文和俄文。如果显示的不是你想要的语言：

装好之后，继续连接模型与服务。