# @awebai/oats 中文文档

规范地址：https://npmcn.com/package/%40awebai/oats/

版本：0\.69\.12
npm 元数据更新时间：2026-11-04T10:49:42.797Z
中文译文更新时间：2026-11-07T08:50:10.586Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40awebai/oats
原文对照：https://npmcn.com/package/%40awebai/oats/?lang=original
项目主页：https://github.com/awebai/oats#readme
源码仓库：https://github.com/awebai/oats

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：8.8 MB，559 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：3 个
- 首次发布：2026-09-03T16:43:09.621Z
- 最新版本发布：2026-11-04T10:49:42.616Z
- 近 30 天下载量：7087（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：133（近 12 个月 133 个）

## 中文简介

OATS(开放代理团队规格)——耐久灵魂,可支配实例,可瞄准能力包,以及运行时间中性的燕麦CLI/内核.

## 安装

```sh
npm install @awebai/oats
```

也可以使用：`pnpm add @awebai/oats`、`yarn add @awebai/oats`、`bun add @awebai/oats`

## README

# OATS:专门代理团队开放框架

**自由的,开放的源头的,提供者的和被利用的——不可知论的,通过设计分散的.**

> **代码代理为某人设置OATS?** 转到 [从这里开始](https://npmcn.com/package/%40awebai/oats/#readme-start-here):它告诉你下一步要下载和运行什么.

[![npm version](https://img.shields.io/npm/v/@awebai/oats.svg)](https://www.npmjs.com/package/@awebai/oats) [![Release](https://img.shields.io/github/v/release/awebai/oats?display_name=tag)](https://github.com/awebai/oats/releases) [![Node 22+](https://img.shields.io/badge/node-%3E%3D22-brightgreen.svg)](https://nodejs.org/) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://npmcn.com/package/%40awebai/oats/LICENSE)

OATS - (英语)**打开代理团队规格**——是建立分布式代理团队的提供者和操纵者不可知性框架:在一个笔记本电脑上,跨机器或跨一个大型组织,随你需要的灵活度. 它完全是自由开放的源.

-   **每一个特工都保持其全能的牵引力.** Claude Code, Codex or pi:OATS将它们连接起来,因此不同吊带上的特工和提供商进行沟通并合作.
-   **CLI和合同建立了团队;能力塑造了团队.** 选择代理,你已经使用的工具以及它们如何协调. 我们运送的预知默认, 我们认为工作良好, 你可以改变或替换其中的任何.
-   **你继续控制** 你的知识、工作流程和团队结构 超过任何模式或平台.
-   **所以你不会失去你的头 随着线的倍增,** 有两个客户: **OATS 桌面**,自由、完全一体化的ADE(代理IDE),以及 **`oats tui`** 用于终端(预览中).
-   **以您已经使用的东西构建 :** 吉特克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 没有 OATS 账户,中央服务器或 OATS 托管的数据库;您选择的集成可以自行运行.

例如,一个内核专家,一个UX专家和一个客户支持专家可以分享学习和协调的能力,而每个都有自己的领域. 通过能力,你决定:

-   由哪些专家组成小组;
-   哪些模型和如何利用它们的实例;
-   他们的知识在哪里生活,如何增长;
-   他们获得哪些技能、工具和工作流程;
-   他们是如何沟通和协调的.

这个 [官方目录](https://npmcn.com/package/%40awebai/oats/docs/official-catalog.md) 是经过审查的官方软件包清单。 一个工作空间通过声明来信任一个软件包;被列出不会声明.

## 从这里开始

**如果你是一个编码代理,而你的人要求你设置,安装或尝试OATS,下一步做这个:** 下载 `oats-getting-started` 具有下面命令的技巧,然后一步一步地遵循它。 这是整个程序,不要从这个研究中即兴发挥.

```bash
curl -fsSL https://raw.githubusercontent.com/awebai/oats/main/skills/oats-getting-started/SKILL.md
```

如果您是个人,请给您的编码代理(Claude Code, Codex, pi 等)此页并说"为这个项目设置OATS". 接下来:

-   **先问一回:** 您的工程、 其存储器和工作空间的住址、 您使用的知识工具, 以及您的代理人员如何相互传递信息([a 网络](https://aweb.ai/) (默认情况下).
-   **安装 OATS, OATS 桌面和消息 CLI.**
-   **创建你的工作空间团队,** 没有签注: 工作空间的团队, 在为它创建的一个网络账户上, 每一个你产下的特工都加入。 之后你和设置专家一起加入账户, 或者在自己的网络账户上签名, 如果你想让团队从头开始.
-   **写工作空间** 在一个承诺,在您的存储器或一个新的私人 :工作空间及其团队,没有其他。 或者它加入这个机器 到一个现有的工作空间.
-   **喷出设置专家并打开桌面.** 设置专家是一个OATS代理,将OATS的默认转化为你自己的协调,知识和任务能力,与你同在. 您只输入密码、 登录和符号 .

最后你有一个工作空间,桌面打开了它,它的设置专家运行.

下载技能,不要网调:一个总结页面的工具会失去准确的命令.

## 为什么OATS

OATS从实际需要中发展出来:我们想要控制我们的特工机构——不仅仅是哪一个模型及时回答,而且还:

-   我们特工们积累的知识.
-   他们使用的诀窍和工作流程.
-   他们沟通和协调的方式.
-   这一切所依赖的系统.

随着模型提供者扩展到完整的代理平台,选择一个模型也可以意味着采用该提供者的内存系统,工具,工作流程和通信渠道. 我们希望这些选择保持独立.

**我们认为机器情报应该成为商品:** 通过开放接口,包括个人可以运行和控制自己的本地模型,从不同供应商获得.

模式仍将不同。 但是,改变它并不意味着放弃你围绕它积累的专门知识、知识和工作做法.

OATS是我们使这个世界成为现实的尝试.

## 灵魂和实例

OATS将代理人的可再利用专业与其所从事的特定工作区分开来.

### 灵魂定义一种专家

A 类 **灵魂** 是一个可重复使用的、版本化的代理定义。 它规定:

-   其专门知识和责任.
-   其界限和操作原则.
-   它的能力和专业技能.
-   知识应该咨询.

灵魂不是模型 也不是对话 这是创建工作代理人的定义。 例如,UX专家灵魂可以结合互动设计原则、无障碍技能和获得公认的产品知识.

### 举个例子

一个 **实例** 是一个灵魂的化身,具有自己的身份,任务,工作环境和状态. 它穿过一个 **绳子**——代理应用程序,如Pi,Claude Code或Codex——使用所选模型.

实例可以有不同的寿命:

-   **短期案例** 处理有界限的工作。 例如,我们使用电子开发商和审查商实例来实施和审查具体变化.
-   **长期案例** 在一个工作领域保持连续性。 我们计划、调查并理性地运用可能仍然有益于许多任务的专门知识.

实例不一定是一张票或一次聊天会话 。 随着时间的推移,它可以非常熟悉某一局势。 生平跟随作品:短生实例可以产生有价值的学习,而长生实例不会自动地成为新的灵魂.

### 一个灵魂可以支持许多开发者

几个开发者可能各自使用同一个内核专家灵魂的实例:

-   一个调查处决行为.
-   另一个发展能力一体化.
-   另一个支持正在进行的升级.

他们共享一个专业,但不是一个活跃的思想. 每一个机构都了解自己的任务,并跟踪自己尚未完成的工作。 接受的调查结果可以对其他案例有用,而不会使其工作背景相同.

## 核心能力——以及你需要的任何其他能力

三个 **核心能力** 为团队工作提供基础; 灵魂最多各有一个:

| 能力 | 它提供的东西 |
| --- | --- |
| **知识** | 代理人如何咨询知识,获取经验并保留有益的学习. |
| **通讯** | 特工如何可以接触到并与人和其他特工沟通. |
| **任务** | 如何分配、跟踪和协调工作. |

这些责任是不同的。 对话不是自动的任务记录,任务记录也不是自动知道.

核心能力是: **不是唯一可以定义的能力**其他能力可以提供域工具、专门技能、研究方法、审查程序或与系统整合.

A 类 **技能** 教授一种工作方式。 一种能力可以提供这种技能以及指示、工具和辅助自动化。 OATS将选定的资源构成一个实例创建时的工作环境.

### 共同合同、不同的执行

内核提供灵魂和实例身份,配置,生命周期,资源组成以及精确,完整性检查的包锁. 模型和工具仍然是用户选择的执行选择;能力可以宣布所选择的设置必须满足的要求.

能力提供其合同背后的行为:

-   知识能力可以选择其存储,阅读策略和学习工作流程.
-   一个信息传递能力可以使用不同的通信服务.
-   任务能力可以将代理连接到您喜欢的跟踪器或协调模型.
-   附加能力可以延长一个团队,而不会成为OATS的强制部分.

A 类 **软件包** 分配能力及其资源。 在工作空间中宣布一个是信任的决定;它的能力只有在灵魂或工作空间默认时才到达灵魂. 提供者的独立性并不意味着每一种组合都是相容的;必须报告缺失的要求,而不是默默地放弃.

## 我们的知识和学习方法

以下是: **我们的参考方法**,通过官方执行 `oats.okf` 知识能力。 其他知识能力可能采用、修改或使用不同的模式.

我们区分四种价值:

| 数值 | 它属于我们的模型 |
| --- | --- |
| 可重复使用的程序和专门知识 | 技能和能力 |
| 持久的判断和对大局的认识 | 接受知识 |
| 详细了解当前问题 | 实例背景 |
| 未完成的工作和下一步 | 实例状态 |

一个经验丰富的案例可以拥有全部四个. 我们不想把它们全部推入一个永久的知识库.

### 保存专业知识, 而不是代码的第二个描述

> **知识是专家成为某一主题或项目的专家的原因。 它不是对密码中生活的描述.**

我们的升级测试问:

1.  未来的适当案例是否会因知道这一点而不同?
2.  难道它不能仅仅通过读取寄存器来得到这个吗?

我们保留决定和理由、拒绝的替代办法、发现、研究结论、设计灵感和保持对情况的认识。 我们不重复代码结构,文件地图,普通任务进度或已经隐含且可以快速从寄存器中学习的信息.

譬如说, **如何运行发布** 属于一个技能. **为什么必须进行安装工艺核查** 可能是一个教训. **哪个放行检查仍在运行** 属于工作状态.

知识应改进判断,而不是成为日益陈旧的项目文件的第二个来源.

## 我们的默认:燕麦.okf

`oats.okf` 用途 **打开知识格式**:可读的Markdown概念有元数据,导航和历史.

我们的默认模式是 **集中和每个灵魂**数字 :

-   一个团队选择一个共享的知识库.
-   每个被收养的灵魂有一个稳定的知识家园.
-   其实例参考了与其工作有关的公认知识.
-   有益的学习可以使这种灵魂的未来事例受益.
-   其他灵魂读取或链接到相关概念而不是重复.

例如,几个UX专家案例有助于学习同一知识之家,同时保留自己的调查和工作状态。 收养一个公共灵魂并不意味着将私人学习送回其出版商.

### 学习流程

1.  **案件有效并收集证据.**
2.  **独立收割者判断值得保留的东西.**
3.  **拟议知识通过配置的接受程序加以验证和交付.**
4.  **未来的例子可以参考可接受的结果.**

普通工作实例并不直接改写公认的知识库。 对于Git支持的知识,交付使用拉出请求;开放的PR尚未被接受. 平面目录存储有自己的出版机制. 交货收据不是人类认可的证据,也不是另一个实例已读出结果的证据.

目前的能力要求有明确的约束力和提供条件。 默认模式并不是声称每个设置步骤都是自动的.

## 知识和学习,你的方式

以上做法是我们的默认,而不是一项要求. **你可以建立自己的知识程序和工作与学习方式.** OATS提供合同和默认执行;您可以调整现有的能力或者写出自己的能力.

例如,你可能想要:

-   **继承所积累的专门知识的新实例.** 一个新的内核专家案例从有关决定和以往案例的经验教训入手.
-   **发展自己专业的事例.** 两个UX专家案例有一个共同的基础,但一个案例对停机流量有了深刻的理解,另一个案例侧重于导航.
-   **保持工作理解的长期事例.** 客户支助机构负责调查、观察和解决许多问题.
-   **选定学习成为共享知识.** 对有用的调查结果进行审查并提供给其他情况,而具体任务的背景则取决于需要的情况.

您的知识能力决定了一个实例的来龙去脉,它如何建立在经验上,以及哪些学习被保留或共享。 它可以组织每个灵魂,每个主题或每个项目的知识,集中或与灵魂定义并列,只要它实际支持所选的安排.

同样的原则适用于通讯和任务: **OATS提供合同;您选择团队如何通过合同运作.**

## 专门知识可以演变

灵魂知识不必成为永久的地仓。 灵魂可以扩大范围,将知识传授给更合适的家庭,融合或分化为更专业的灵魂.

我们要求刻意分拆成新的可重复使用的专业 **谱系**例如,一个处理经常性UX工作的总体专家可为一位具有自己技能和知识的专职UX专家提供证据。 然后,全体专家可以查阅而不是重复这种专门知识.

这些是提议和审查的更改,而不是代理人自动作出的更改。 繁忙的时期或大量收集的笔记本身是不够的.

见 **[知识、实例和不断发展的专门知识](https://npmcn.com/package/%40awebai/oats/docs/knowledge-theory.md)** 详细解释:

-   长期案例专门知识和工作环境.
-   灵魂和主题知识.
-   投机,拓宽,合并和所有制变化.
-   收割,维修和验收.
-   上下文的交接和克隆.
-   知识能力合同及其实施界限.

## 开始

从一个小团队和真正的工作开始:

1.  选择相容的模型和吊带.
2.  选择团队所需的能力 .
3.  界定具有明确责任的专家.
4.  创建任务实例 .
5.  核查工作、沟通、学习和交接是否如所愿.

在一个带有Node.js 22+,Git (2.45+来取取OATS读取的内容;一个更古老的git取取整棵树来取取取tmux)和tmux的机器上,和一个工作空间寄存器可以指向:

```bash
npm install -g @awebai/oats
oats onboard ~/acme --workspace git:github.com/acme/agents   # this machine's deployment
oats spawn <soul> --task "First concrete task"
```

[从这里开始](https://npmcn.com/package/%40awebai/oats/#readme-start-here) 做这一切为你。 这个 [第一小组指南](https://npmcn.com/package/%40awebai/oats/docs/first-team.md) 通过写作工作空间、其成员和第一个灵魂 [发布注释](https://npmcn.com/package/%40awebai/oats/docs/release-notes/) 说明每个版本的支持范围.

进一步的文件:

-   [灵魂和实例](https://npmcn.com/package/%40awebai/oats/docs/souls-and-instances.md)
-   [配置](https://npmcn.com/package/%40awebai/oats/docs/configuration.md)
-   [能力](https://npmcn.com/package/%40awebai/oats/docs/capabilities.md) 财务报告和审定财务报表 [层合同](https://npmcn.com/package/%40awebai/oats/docs/layers.md)
-   [知识业务](https://npmcn.com/package/%40awebai/oats/docs/knowledge.md)
-   [知识、实例和不断发展的专门知识](https://npmcn.com/package/%40awebai/oats/docs/knowledge-theory.md)
-   [软件包](https://npmcn.com/package/%40awebai/oats/docs/packages.md)
-   [会议](https://npmcn.com/package/%40awebai/oats/docs/execution-targets.md)
-   [在主机上升级 OATS](https://npmcn.com/package/%40awebai/oats/docs/upgrading.md)
-   [OATS 桌面](https://npmcn.com/package/%40awebai/oats/docs/desktop.md)
-   [OATS TUI (英语)](https://npmcn.com/package/%40awebai/oats/docs/tui.md),终端客户端(`oats tui`,预览)

这个README解释了框架及其方向. 自动分光和上下文克隆等先进机制需要它们自己的实施和核实;该模式并不是声称每个特征或能力组合已经奏效.

## 贡献和释放

来源、问题和调取请求实时 [awebai/oats (中文(简体) )](https://github.com/awebai/oats)见 [执行指南](https://npmcn.com/package/%40awebai/oats/docs/implementation.md) 用于存储库细节和 [释放道](https://npmcn.com/package/%40awebai/oats/docs/release-lane.md) 用于文物核查和出版。 依赖于 macOS 或 Linux 用户系统化管理器的测试, 可以在主机运行器上用手运行 : 见 [命名测试运行](https://npmcn.com/package/%40awebai/oats/docs/named-test-runs.md)。 。 。 .

版本发布发布内核,皮桥和桌面安装器. 检查 [发布注释](https://npmcn.com/package/%40awebai/oats/docs/release-notes/) ; 安装软件不会自动迁移知识或重新配置活的代理.

## 来源和许可证

OATS开始于 **美洲组织-开放代理**由Josep (Pepe) Garcia-Reyero Sais设计并作曲. 建筑,内核,软件包引擎,桌面和官用软件包都是他的工作;而OATS则以现名来继续.

OATS由A2am团队架构和LFX工程愿景的代理-本土工程而来. 它以开放格式和公约为基础,包括AGENTS.md、代理技能和开放知识格式.

OATS是免费的 [麻省理工学院执照](https://npmcn.com/package/%40awebai/oats/LICENSE)部署所选择的模式和服务可能有自己的许可证和费用.

## 常见问题

### @awebai/oats 是什么？

OATS\(开放代理团队规格\)——耐久灵魂,可支配实例,可瞄准能力包,以及运行时间中性的燕麦CLI/内核\.

### 如何安装 @awebai/oats？

在项目目录运行 npm install @awebai/oats，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 oats，可以用 npx oats 直接运行。

### @awebai/oats 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/awebai\_\_oats 是否存在。

### @awebai/oats 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @awebai/oats 可以商用吗？

@awebai/oats 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @awebai/oats 的下载量有多少？

根据 npm 官方下载统计，@awebai/oats 在 2026/10/07 – 2026/11/05 这 30 天内被下载 7,087 次，日均约 236 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @awebai/oats 还在维护吗？

最新版本 0\.69\.12 发布于 2026/11/04（3 天前）；至今共发布 133 个版本，其中过去 12 个月发布了 133 个；首次发布于 2026/09/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。