安装 ORG-2

ORG-2 是一个用 Rust 和 Tauri v2 构建的桌面应用，没有任何东西需要托管，也不用跑服务端——你只装一个应用，数据始终留在自己的机器上。本页介绍下载包、首次启动会发生什么、可选的原生辅助程序、更新如何送达，以及怎样从源码构建。

下载

预构建的安装包一律通过 GitHub 的 "latest release" 指针解析，所以下面的链接永远不会失效。

每个版本产出的全部安装包（包括带版本号的文件名）都列在最新发布页上。

注意： 发布流水线目前只跑两个构建任务——macOS 的 aarch64-apple-darwin 和 Windows 的 x86_64-pc-windows-msvc。如果你看的那个版本没有附带 Linux 安装包，请改用本页末尾的步骤从源码构建。

系统要求

• macOS： Apple Silicon。安装包声明的最低系统版本是 macOS 10.15。
• Windows： 64 位（x64）。.exe 和 .msi 装出来的是同一个应用。
• Linux： x64，前提是该版本发布了对应构建。
• 磁盘： 应用本体的设计目标是占用不超过 100 MB。你的数据目录会随着运行会话另行增长。

Windows：选安装程序还是 MSI？

-setup.exe 是 NSIS 安装程序，普通的单用户安装选它就对了。.msi 是为那些用 MSI 工具链分发软件的环境准备的。二选一即可，同时安装两个是不受支持的。

macOS：签名与首次启动

在配置了签名密钥的情况下，发布构建会用 Apple Developer ID 证书签名，并在发布流程中完成公证。已签名并公证的 .dmg 可以正常打开：把 ORG2 拖进 /Applications 然后启动即可。

如果你是自己构建且没有签名，macOS Gatekeeper 会拒绝首次启动——这是未签名本地构建的正常现象，不是下载出了问题。

Windows 产物在同一套流程里通过 Azure Trusted Signing 签名，同样只在签名凭据齐备时才会执行。

首次启动会发生什么

1. 登录界面。 ORG-2 打开后是登录页。你并不需要账号：选择 暂不登录，继续使用，就能完全依靠自己的密钥运行。这个选择会一直保留，直到你登录或退出登录。
2. 设置向导。 首次运行的向导会带你走六个步骤，左侧竖排列出：欢迎、主题、Dev Passport（页面标题为「设置 Dev Passport」）、GitHub、项目（页面标题为「打开项目」）和 完成。用 继续 和 返回 前后移动，点击任一步骤可直接跳转，也可以随时按 跳过设置。最后一步的按钮是 开始使用。
3. 工作站（Workstation）。 走完或跳过向导后，你会进入工作站，也就是主要的工作界面。

向导里没有任何一步是必须的——GitHub 和工作区都可以稍后再连。想要一次有人带路的首次运行，见 快速上手。

可选的原生 sidecar

有两个功能依赖原生辅助程序，它们被刻意排除在签名应用之外：

Sidecar 按需安装到 ~/.orgii/bin/，绝不会在启动时下载——网络慢不该把应用卡在启动画面后面。你可以从 设置 → Computer Use → Sidecar 下载 安装它们，那里每一行都会显示 已安装 / 未安装 / 不支持，并提供 下载 操作和一个 刷新状态 控件。

没有它们时，Browser Use 和 Computer Use 要么回退到 PATH 上找到的二进制文件，要么就用不了。应用的其他部分不受影响——会话、工具、记忆和回放在没有 sidecar 的情况下都能正常工作。

从源码开发时，pnpm run download:sidecars 会为当前操作系统和 CPU 把同样的二进制文件取到 src-tauri/bin。如果构建时缺少某个 sidecar，Rust 构建会写入一个很小的占位资源，让构建仍然能成功。

更新

ORG-2 内置了 Tauri 更新器。它会在启动时检查新版本，之后每小时检查一次。发现新版本时：

• 导航侧边栏底部会出现一个标注了新版本号的 下载更新 按钮。
• 点击它会打开更新对话框，里面有 更新、稍后 和 跳过此版本。跳过只会在本次运行期间屏蔽那个特定版本。
• 选择 更新 会带进度条下载、安装，然后重启应用。

你也可以从 设置 → 应用更新 手动检查，那里会显示 当前版本 和一个 检测更新 操作。

注意： 发布流程生成的更新清单目前只包含 darwin-aarch64 条目。在 Windows 上，请下载并运行更新版安装程序来完成更新。

数据存放在哪里

ORG-2 在本地存储的一切都位于 ~/.orgii/ 之下：

后台清理任务会在启动十分钟后运行，修剪长尾数据：日志、计划文件、Merkle 快照、文件历史以及会话 / 事件缓存保留 30 天，浏览器截图保留 7 天。某个会话消失后，它遗留的目录会被清除。

设置 → 存储 会列出数据目录和日志文件及各自的磁盘占用，并提供 打开文件夹 和 在文件夹中显示 操作。

从源码构建

按仓库贡献指南，前置条件如下：

然后在仓库根目录执行：

pnpm install
pnpm run download:sidecars
pnpm run tauri:dev

pnpm run tauri:dev 会通过 Tauri 的 beforeDevCommand 启动 webpack 开发服务器并打开应用；请用 Tauri 的脚本，不要单独启动前端。如果想针对打包产物更快地迭代，pnpm run tauri:build:fast 只会为本地开发 profile 重新构建应用目标，并打开构建结果。

提交 pull request 之前，按你改动的范围跑对应的检查：前端跑 pnpm run lint、pnpm run test 和 pnpm run check:circular；Rust 跑 pnpm run cargo:check、pnpm run cargo:clippy 和 pnpm run cargo:test。

ORG-2 采用 AGPL-3.0-or-later 许可证。

下一步

• 快速上手 —— 十分钟走完首次运行，从设置向导到你的第一次回放。
• API 密钥 —— 添加服务商密钥，或登录某个智能体 CLI。
• 核心概念 —— 会话、轨迹和工作区之间是怎么衔接的。
• 故障排查 —— 应用或会话不对劲时该检查什么。