核心概念

ORG-2 在界面、文档和磁盘格式中一致地使用一小组名词。把它们学一遍，其余内容都会好读很多。本页用应用自己的词汇定义每一个概念，并说明它们如何组合在一起。

各部分如何嵌套

org
 └── project
      └── work item          (what should happen)

workspace (one or more repos)
 └── session                 (what actually happened)
      └── turn / round
           └── event

这两半通过链接相连，而不是严格的包含关系。会话锚定在一个工作区路径和一个分支上，而不是锚定在项目上；当你希望计划和执行记录互相指向时，就把会话链接到某个工作项。共享的范围按组织划分：只有在你明确允许的工作区里，队友才能看到你的会话。

工作区、仓库与项目

仓库（repo） 是磁盘上的一棵 Git 工作树。侧边栏和 Launchpad 把它们归在我的仓库（My Repos）下。Git 状态、分支和 diff 都挂在这个单位上。

工作区（workspace） 是被一起打开的一个或多个文件夹根目录——也就是 VS Code 和 Cursor 里那种熟悉的多根模型。每个根要么是一个 Git 仓库，要么是一个普通文件夹，其中一个被标记为主根；主根就是交给智能体和语言服务器的默认工作目录。保存下来的多根工作区是一个 .orgii-workspace 文件，单独列在我的多仓库工作区（My Multi-Repo Workspaces）下。会话卡片上写「工作区」时，指的就是它。

项目（project） 是一个规划对象，不是文件夹。它位于项目管理器（Project Manager）中，归属于某个组织，并容纳工作项。每个项目都有一种同步方式：存储（Storage）（一个本地数据库），或 Git（通过 .orgii）——后者会把组织的项目和工作项镜像到某棵 Git 工作树里的 .orgii/projects/...，这样它们就能跟着代码一起流转。

会话、轮次与事件

会话（session） 是与一个智能体、针对一个工作区展开的一段连续对话。它带有标题、智能体、模型、执行模式、仓库、分支、状态，以及完整的事件历史。会话是长生命周期的：关掉标签页它依然存在，可以恢复；后台会话在标签页消失之后仍会继续运行。状态是明确枚举出来的，而不是一个「忙/闲」标志——pending、idle、running、waiting_for_user、waiting_for_funds、paused、completed、failed、cancelled、abandoned、timeout、archived，其中最后六个是终态。每个会话都有一种执行模式，它会改变系统提示词和可用工具；选择器提供 Build、Ask 和 Plan。

轮次（turn） 是一次用户到智能体的往返：你的消息发出去，智能体流式返回响应、调用工具，如此循环直到停下。聊天界面把它叫做 rounds——你会看到 Round 3 / 12、该你了（Your Turn） 和轮次完成（Turn Finished），会话详情视图则会给出 Rounds 计数。轮次是取消、重试和回滚的单位：取消停掉的是当前轮次而不是整个会话，而且每一轮都会单独记录自己的 Token 用量、工具调用和改动过的文件。一个轮次处于四种状态之一：running、completed、cancelled 或 failed。

事件（event） 是会话内部的原子记录——一条消息、一个思考块、一次工具调用、一个工具结果、一次文件变更、一次终端写入。每个事件都有 id、会话 id、事件类型、可选的工具名、参数、结果、可搜索文本、时间戳，以及一个用来固定顺序的单调递增历史序号。

轨迹与回放

一个会话的有序事件流，就是它的轨迹（trajectory）。轨迹（Trajectory）面板用两种方式渲染它：带可读说明的 UI 视图，以及带原始载荷的 JSON 视图。正因为轨迹是一份持久的有序记录，而不是渲染过程的副产品，回放、搜索、分析和分享才有可能实现。

回放（replay） 就是把这条轨迹读回来。有两个界面用到这个词：轮次卡片上的 Replay turn 会回放单独一轮，并附上它的工具调用数和文件变更数；会话的模拟器（Simulator）则播放整条轨迹，带播放/暂停、倍速控制、上一个/下一个事件单步，以及事件筛选器（所有事件、关键交互、文件变更、终端事件、探索、其他）。会话还在运行时，同一个界面就是一场直播——你是在跟着智能体走，而不是拖动进度。

智能体、运行时与 Runner

智能体（agent） 是一个有名字、有配置的参与者。会话创建器把它们分成几类：

• 内置智能体（Built-in Agents） —— 包括 SDE Agent（写代码）、OS Agent（计算机操作自动化），以及 ADE Manager——一个可以派生并协调其他会话、还能通过一套结构化动作系统驱动应用界面的元智能体。
• CLI 智能体（CLI Agents） —— 你已经装好的第三方命令行智能体，比如 Claude Code、Codex 或 Cursor CLI。ORG-2 负责运行它们并捕获它们的轨迹。
• 外部智能体（External Agent） —— 来自另一个 IDE（目前是 Cursor IDE）的活动，导入后渲染为轨迹。
• 自定义智能体（Custom Agents） 和智能体团队（Agent Teams） —— 你自己的定义，以及带层级结构的智能体分组。

你的运行时（harness），是指底层智能体更换时依然保持不变的那一切：你的 Skill、MCP 服务器、规则，以及智能体积累起来的关于你代码库的记忆。它刻意与任何单一厂商解耦，因此你可以换掉智能体而不必从头再来。

Runner 是工作真正发生的地方。上下文栏会显示此 Mac（This Mac）或 Worktree；针对某个 worktree 启动的会话会被锁定在它上面，启动之后无法再切换 Runner。

工作项

工作项（work item） 是项目内部被跟踪的一个工作单元——相当于应用里的 issue。它有状态（Backlog、待办（Todo）、进行中（In Progress）、审核中（In Review）、已完成（Done）、已取消（Cancelled））、优先级（无优先级、紧急、高、中、低）、一个可以是人也可以是智能体的负责人，以及日期、标签和可选的关联项目。视图有概览（Overview）、列表（List）、看板（Kanban）、甘特图（Gantt）和日历（Calendar）。删除的条目会进入删除箱（Delete Bin），并在 7 天内保持可恢复。

组织、成员与角色

「组织」有三种不同的含义，别把它们混在一起。

智能体团队的层级模式分为扁平（flat）（不展示任何结构）、柔性（soft）（默认——只是一种提示，路由不受限制）或严格（strict）（成员只能给它的直属上级、直接下属或协调员发消息）。

在协作组织里，成员（member） 是一个参与者，带有角色（admin 或 member——只有管理员能创建邀请链接）和身份类型（human 或 agent——只有人类能在群聊里发言）。你可以粘贴 orgii:// 邀请链接或邀请码来加入。你对外暴露多少，由每个组织各自的会话访问模式决定：关闭（Off）、仅 Session 卡片（Session cards only）（标题、所有者、分支、工作区），或完整 replay（Full replay）（队友可以请求完整的事件快照）。

警告： 完整 replay 可能包含提示词、输出、工具调用和文件路径。它需要在每个组织内单独选择开启，并且仅限于一份工作区路径白名单。参见协作。

记忆、Skill 与 MCP 服务器

记忆（memory） 是会话结束后仍然留存下来的东西，分为两层。Learnings 是按智能体划分的长期记忆：会话产出 Tier-1 条目，应用空闲时会周期性地把它们整合成 Tier-2 主题；新条目到达时处于待定状态，只有你把它们提升为激活状态，它们才会进入提示词。工作区记忆（workspace memory） 是以文件形式存放的、限定在工作区范围内的笔记，默认位于 .orgii/workspace-memory/。

Skill 是智能体可以主动选用的一份 Markdown 能力说明：一个带 frontmatter 的 SKILL.md 文件，放在 .orgii/skills/ 中只对单个工作区生效，放在 ~/.orgii/skills/ 中则对所有工作区生效。Skill 可以被标记为始终加载；如果某个 Skill 因为缺少必需的可执行文件或环境变量而不可用，设置界面会把它标出来。

MCP 服务器是一个说 Model Context Protocol 的外部工具服务器。它的工具会和内置工具一起注册进智能体的工具集，注册时会拦截名称冲突。配置文件在全局是 ~/.orgii/mcp-servers.json，按工作区则是 {workspace}/.orgii/mcp-servers.json。

术语速查

下一步

• 跑通你的第一个会话，看着轨迹一点点填满。
• 会话结束后，把轨迹读回来。
• 配置智能体，并接入你的密钥。
• 准备好把队友拉进来时，创建一个组织。