安装 Pinar
安装 Chrome 扩展,并在这台电脑上打开 Pinar 应用。
4 分钟本指南内容
浏览器扩展
从 Chrome Web Store 安装 Pinar。
- 在 Chrome 的扩展菜单中固定 Pinar 图标,让它保持可见。
- 打开 Chrome Web Store 商品页 以添加官方扩展。
Pinar 应用
在 macOS 上,Pinar 应用位于菜单栏。在 Windows 上,位于通知区域。打开 Pinar 应用即可开始捕获。在 Linux 上,使用下面的命令安装。
- 捕获会留在这台电脑上。选择 「打开文件夹」 即可查看。
- 在 macOS 和 Windows 上,「登录时启动」 会在您登录后让 Pinar 保持可用。
- 如果某次捕获没有图像,请打开 Pinar 后再试。
安装并打开
通过下面的链接下载并安装 Pinar 应用,然后打开它。
打开 Pinar 后,选择 「打开工作区」。如果显示 「本地服务器:关闭」,请选择 「启动」。如果粘贴的捕获不再出现,请重新打开 Pinar。
- macOS:下载 Pinar 应用,打开磁盘映像并拖到 「应用程序」。
- Windows:下载 Pinar 应用,解压后运行
.installer文件夹旁边的Pinar-Setup.exe。图标会出现在通知区域。 - Windows:首次运行可能显示 「Windows 已保护你的电脑」。请选择 「更多信息」,然后选择 「仍要运行」。
- Linux:
curl -fsSL https://pinar.dev/install.sh | sh
更新桌面应用
Pinar 菜单会自行检查更新,也会在您选择 「检查更新…」 时检查。若有更新的版本,它会在后台下载,同时菜单显示 「正在下载 {version}…」。选择 「更新到 {version}」 即可应用已下载的更新:应用会以新版本重新打开,本地服务器也会随之重启。若没有更新的版本,菜单会短暂显示 「已是最新」。
若检查失败,应用会保持打开,菜单显示 「检查更新失败」。选择该条目可重新运行检查。各版本的变化可在网站 「新功能」 页阅读,或打开 「设置 → 关于」 中 「更新内容」 链接查看,该链接就在您当前构建所运行版本的旁边。
- 检查失败只阻塞更新本身:正在运行的版本、您的捕获和本地服务器都会继续工作。
- 桌面应用在启动时会检查更新,因此菜单通常会在您询问之前显示结果。
智能体会话钩子
每个受支持的智能体都会注册一个 Pinar 会话钩子。当您在 Claude Code、Codex、Cursor、Grok、Antigravity、Pi 或 OMP 中打开会话时,钩子会打开 Pinar,并在智能体开始工作前确保本地服务器正在运行。
Pinar 桌面应用在启动时注册这些钩子,命令行安装器在安装助手时也会注册它们,因此无需为每个智能体单独设置。每个智能体使用的钩子文件,以及智能体可能要求的初次信任步骤,都列在 Pinar README 的会话钩子部分中。
- 钩子只会打开应用或启动本地服务器,不会读取您的文件,也不会改变智能体的行为。
- 重新运行安装器或重启桌面应用会在您清除了钩子或切换了智能体后重新注册钩子。
在 Linux 和 Windows 上通过命令行安装
在 Linux 和 Windows 上,您可以改为从命令行安装 Pinar 的助手。单行安装器会把助手下载到您用户账户中的一个文件夹,将该文件夹加入您的 PATH,并注册智能体会话钩子,因此新的终端会话会立即找到助手。
助手就是桌面应用运行的那个本地 Pinar 服务:它在本机保存捕获,并提供本地工作区和查看器。Pinar README 的安装部分记录了命令行安装程序。
- 在没有桌面应用的机器上,或从远程终端管理 Pinar 时,请使用命令行。
- 同时安装桌面应用和命令行助手是安全的:它们使用同一个本地服务和相同的捕获。