文档

在 ORG-2 中运行、审阅并共享智能体工作所需的一切。

全部文档

简介

ORG-2 是一款基于 Rust 与 Tauri 构建的开源、本地优先的智能体开发环境,其设计目标是让智能体的工作始终可审查、可回放、可协同。

ORG-2 是一款用于与编码智能体协作的开源桌面应用。它在本地运行,把数据存放在你自己的机器上,底层基于 Rust 和 Tauri 而不是 Electron。真正让它区别于聊天侧边栏或终端智能体的,是每一个会话都会被记录成结构化、可回放的轨迹——你可以看着智能体工作,事后审计它做了什么,并把这份记录交给同事。

这个项目把自己定位为 Agentic Development Environment(ADE,智能体开发环境),而不是 IDE。IDE 默认人是唯一的主角,一切围绕人的打字速度做优化。ADE 则默认人和智能体都是一等参与者,围绕委派、观察和审查做优化。

ORG-2 要解决的问题

智能体的能力提升速度,快过围绕它的工具链。在大多数智能体 IDE 里:

  • 工作是不透明的。 工具调用被折叠,推理过程被隐藏,你只看到最终答案,看不到产生它的过程。一个你无法审计的智能体,就是一个你无法信任的智能体。
  • 工作是无法审查的。 一个输出正确、却没有留下可读痕迹的会话,既没法调试,也没法改进或交接。让别人接手一个不是他跑出来的会话,几乎不可能。
  • 工作是各自为战的。 上下文困在某一个人的聊天记录里。两个智能体重复劳动,记忆按工具各自割裂,团队层面没有任何东西在跟踪谁——人还是智能体——该为什么负责。
  • 配置无法迁移。 换一个工具,就意味着从零重建 MCP 配置、Skill,以及积累下来的每一份项目上下文。

ORG-2 把这些当作真正的产品问题,而不是副作用。

它的不同之处

能力实际意味着什么
可回放的轨迹每个会话都会被持久化为一条有序事件流。你可以用播放/暂停和倍速控制来拖动它,逐个事件单步查看,也可以筛选出关键交互、文件变更或终端事件。
实时会话视图在智能体运行时直接观察它的工作台,每一步都配有它当时说了什么、做了什么的说明,而不是读一堵折叠起来的工具调用墙。
跨会话记忆智能体会积累 Learnings 和工作区记忆文件,它们在会话之间、模型更换和智能体升级之后都会保留。
AI BlameORG-2 会索引哪个会话、哪个智能体、哪个模型改动了哪些文件、函数和提交,并通过 Agent Blame 和 AI Impact 面板呈现出来。
组织层面的对齐内置的项目管理器带有组织(ORG)、项目和工作项,让智能体的产出能挂回目标和责任人,而不是四处漂着。
自带智能体和密钥直接使用你已有的 API 密钥和智能体订阅。密钥只保存在你本地设备上,绝不会上传到 ORG-2 服务器。

除此之外,应用还内置了 GUI、CLI、终端、Git、浏览器、LSP、时间线和数据库工具;提供定时与自动启动的会话,让智能体可以通宵干活;还有能感知资源的执行策略——它会根据 CPU、内存,以及你人是否真的在键盘前来做出反应。

注意: 项目 README 把组织层面的对齐界面和会话协作标记为进行中(work-in-progress)。相比会话与回放这两层,它们的变动会更快、更多。

自带智能体和密钥

ORG-2 不转售推理算力,也不会把你锁死在某一家模型厂商上。你接入的是自己本来就在付费的东西:

  • 直连 API 服务商 —— Anthropic、OpenAI、Google Gemini、DeepSeek、Groq、xAI、Zhipu、DashScope、Moonshot、MiniMax、OpenRouter、ZenMux、Azure OpenAI、Azure 托管的 Anthropic,以及自托管的 vLLM。
  • 基于 CLI 的编码智能体 —— Claude Code、Codex、Cursor CLI、Gemini CLI、GitHub Copilot、Kiro、Kimi CLI 和 OpenCode。
  • 外部智能体会话 —— Cursor IDE 的活动会被导入,并与原生会话一样渲染成轨迹。

ORG-2 的原生智能体用 Rust 编写,与应用其余部分跑在同一个本地进程里。参见 API 密钥与模型智能体

它适合谁

  • 认真审查智能体产出的开发者 —— 他们想要一条合并时可查的审计轨迹,而不只是一份凭空冒出来的 diff。
  • 把工作委派给智能体的团队 —— 难点在协同、共享上下文,以及搞清楚谁该负责什么。
  • 在做小产品的人 —— 设计目标是帮你把应用做出来、交到别人手上,而不只是帮你把代码写得更快。
  • 希望自己那套配置能随身带走的人 —— 你的密钥、Skill、MCP 服务器和记忆,都归你所有,也都留在本地。

开放内核

ORG-2 采用开放内核(open core)模式,这个切分是刻意的:

  • 桌面应用是开源的,许可证为 AGPL-3.0-or-later。包括 Rust 智能体运行时在内的完整源码都在公开仓库里。
  • 自托管 Supabase 是免费的。 团队同步——组织、成员、共享的会话元数据、群聊——跑在一个你自己拥有的 Supabase 项目上。应用可以帮你生成建库用的 SQL。
  • ORG-2 Cloud 是可选的托管后端。 它提供同样的同步能力,外加账号、计费和分享功能,适合不想自己运维 Postgres 的人。参见 ORG-2 Cloud

本地单人使用的整套体验完全不需要账号。欢迎参与贡献,但需要签署 CLA;详见仓库中的 CONTRIBUTING.md

平台支持

平台状态
macOS(Apple Silicon).dmg 形式发布,构建目标为 aarch64-apple-darwin
Windows x64.exe 安装程序和 .msi 形式发布,构建目标为 x86_64-pc-windows-msvc
Linux未提供预编译的发布二进制;可以从源码构建

有两项能力依赖构建时下载的可选原生 sidecar:Browser Use 使用 agent-browser,Computer Use 使用 peekabooComputer Use 仅支持 macOS。 如果缺少某个 sidecar,相关能力会回退到 PATH 查找,或者在你运行 pnpm run download:sidecars 之前一直不可用。

这套文档怎么读

大致按下面的顺序读下来。

先跑起来

  • 安装 —— 下载、首次启动,以及从源码构建。
  • 快速上手 —— 添加仓库、添加密钥、跑通第一个会话。
  • 核心概念 —— 后面所有文档都默认你已经掌握的词汇。

日常使用

  • API 密钥与模型 —— 接入服务商和 CLI 智能体。
  • 智能体 —— 内置智能体、CLI 智能体、自定义智能体和智能体团队。
  • 会话 —— 启动、恢复和引导一个会话。
  • 回放 —— 事后读懂一条轨迹。
  • 工具 —— 智能体到底能做什么,以及约束它们的策略。

扩展智能体

  • MCP 服务器 —— 接入外部工具服务器。
  • Skill —— 添加 SKILL.md 能力。
  • 记忆 —— Learnings、工作区记忆与整合。
  • 排程 —— 周期性会话与自动启动的会话。

和其他人协作

  • 项目 —— 项目与工作项。
  • 组织 —— 把项目归拢起来,以及智能体团队。
  • 协作 —— 与队友共享会话。
  • ORG-2 Cloud —— 托管后端。

运维它

  • 安全 —— 密钥存储、共享层级与脱敏。
  • 故障排查 —— 出问题的时候看这里。

下一步

有问题?欢迎到 ORG-2 Discord 提问。 Discord