维护与排障

更新、数据位置与卸载

更新

有新版本时，Pine 会弹出更新对话框，显示更新内容并让你安装。也可以随时回到发布页下载最新安装包，直接覆盖安装，数据不会丢失。

数据位置

内容	位置
项目、会话、设置、模型凭据	系统的应用数据目录（macOS：~/Library/Application Support/ 下的 Pine 目录；Windows：%APPDATA% 下的 Pine 目录）
你授权的文件夹	就是你自己的文件夹，Pine 不会搬走它

完全退出

如果开启了”后台运行”，关闭窗口并不会退出 Pine。要彻底退出：点菜单栏（macOS）或通知区域（Windows）的 Pine 图标 → 退出 Pine（Quit Pine）。自动化和远程控制只在 Pine 运行时工作。

卸载

• macOS：把”应用程序”里的 Pine 拖到废纸篓。需要同时清理数据时，再删除上面的应用数据目录。
• Windows：设置 → 应用 → 已安装的应用 → Pine → 卸载。需要同时清理数据时，再删除上面的应用数据目录。

卸载不会删除你授权的文件夹里的任何文件。

常见问题

打开 Pine 时 macOS 说”无法验证开发者”或”已损坏”。 见安装 → macOS：右键打开，或在”隐私与安全性”里点”仍要打开”，必要时用 xattr 命令去掉隔离标记。

Windows 一直停在启动阶段 / 没有出现主窗口。 首次启动要配置沙箱，需要在 UAC 弹窗里点”是”。如果之前拒绝过，完全关闭 Pine 后重新启动再允许一次。

提示没有可用模型，或发送后无响应。 到 Pine 设置（Pine Settings） → 模型（Models） 确认已经配置了提供商且选中了模型；检查 API Key 是否填对、账户是否有余额；确认你的网络能访问对应服务商。

发送后报网络错误或超时。 多数是网络问题：确认能打开服务商官网，必要时为系统配置可用的代理后重启 Pine。

费用涨得比预期快。 在 Context usage 里查看本次会话的费用，并设置 会话成本上限（Session cost limit）。长会话可以点 立即压缩上下文（Compact context now） 压缩上下文，或新开一个会话。

Agent 说没有权限访问某个文件。 它只能访问项目授权的文件夹。到 Pine 设置（Pine Settings）→ 项目管理（Projects）→ 编辑（Edit） 添加该文件夹，并按需选择”只读”或”读写”。

Agent 修改了不该修改的文件。 关闭审批更宽松的模式，切回 让我过目（Let Me Review）；重要文件先备份，或把资料文件夹设为”只读”。

想反馈问题。 到 GitHub 提交 Issue：https://github.com/aldinelabs/pine/issues 。请附上 Pine 版本号、系统版本、问题现象，以及不含敏感信息的截图。不要在 Issue 里贴 API Key。

想在服务器上运行或从源码构建，见进阶安装。