Pine
致力于为所有人提供更多可能性的 AI 代理工作区。
[!CAUTION]
Pine 目前是早期开发者预览版，界面、数据格式和 Agent 行为都可能发生不兼容变更，请勿用于重要数据。
简介
多数 AI Agent 工具面向开发者：终端、编辑器插件、命令行参数。Pine 是一个桌面端 Agent 工作区，面向每天处理文档、表格、报表和资料的人：
- 各类文件在工作区内直接预览，Agent 操作的就是你看到的文件。
- Agent 的读取、工具调用和文件修改都显示在会话中，需要审批的操作会先询问，随时可以中止。
- 项目、会话和文件保存在本机；模型连接（API key / OAuth）由你自己配置，Pine 不做中转。
功能
- 按项目组织会话，一个项目可关联多个文件夹并分别设置只读 / 读写权限；多个会话可同时运行。
- 预览文本与代码、PDF、Office / iWork 文档、数据表格、图片、音视频、压缩包、邮件、电子书、图表、CAD 图纸和 3D 模型等。
- Agent 的本地工具限制在授权文件夹内，提供从逐一审批到完全自主的多档权限模式。
- 任务清单、后台进程、上下文压缩、图像生成、网页搜索与抓取。
- 支持 Skills、MCP 服务器和 Computer Use。
- 内置多家模型提供商，也可自定义提供商与模型。
- 在浏览器中使用 Pine，或用二维码 / 链接配对其他设备，通过 Aldine 远程使用这台电脑上的 Pine，无需端口转发，端到端加密（设置 → 远程控制）。
- 中英文界面，浅色 / 深色主题，可选的阅读字体。
macOS 已支持，Windows 部分支持，Linux 暂不支持。
从源码运行
需要 Bun，具体版本见 package.json 的 packageManager。
git clone https://github.com/aldinelabs/pine.git
cd pine
bun install --frozen-lockfile
bun run dev
Windows 首次启动时会提示配置 Windows 沙箱，按提示在 UAC 中允许即可。
服务器部署
Pine 也可以不开窗口运行在 macOS 或 Linux 服务器上，只通过浏览器使用（需要较新的 Node.js；Linux 还需要 bubblewrap、socat 和 ripgrep，具体要求见部署文档）：
bun install --frozen-lockfile
bun run build:server
PINE_PASSWORD='至少 8 个字符' node apps/desktop/.vite/server/server.mjs
默认只监听 127.0.0.1:9415，建议放在反向代理后面。全部选项、systemd 示例和与桌面端的差异见 docs/headless-server.md。
开发
bun run dev # 启动开发环境
bun run check # 格式、Lint、类型检查与单元测试
bun run build # 打包
架构与设计文档在 docs/，发布流程见 docs/release.md，开发约定见 AGENTS.md。欢迎 Issue 和 PR，提交前请运行 bun run check。
License
AGPL-3.0
