# @awebai/oats-pi 中文文档

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

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

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

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

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

- 包体积（解压后）：20.2 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：typebox \*，@earendil-works/pi-ai \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-09-03T16:43:11.907Z
- 最新版本发布：2026-11-04T10:49:43.875Z
- 近 30 天下载量：7030（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：133（近 12 个月 133 个）

## 中文简介

OATS pi 运行时桥 — 运行时中立的存储会话事件和工作前空间拖带@ awebai/ oats内核

## 安装

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

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

## README

# @awebai/ oats- pi

皮带桥 [业务](https://github.com/awebai/oats)。 。 。 .

运行时间中立的内核和通用 `oats` CLI 住在这里 `@awebai/oats`。与内核一起锁定发布(同版本) 从同一个释放标记). 这座桥梁没有操作工具。 仅此而已:

-   曝光情况 `oats-getting-started` 在 OATS 工作空间存在之前( 购置漏斗;
-   贡献实例- 本地 `.agents/skills` 在产子体内 实例;
-   担任法院的开幕任务`@TASK.md`在pi自己的路上直到没有 转动另一个扩展已激活 所以pi运行一次, 而不是拒绝它。 它永远不会等待 用于任务本身的运行: pi 1.2 并随后计算为活动运行于 在其开始前( a),并排入同时发送的消息, 任务完成后。 它从来不发送、重新发送或更改信息。 这个 例外: 桥后加载的开始转弯( 或 等待 I/O 当一个开始时) 在自己的输入处理中打开 快速, 或者在 pi 之前的 1. 2 , 在它的 agent start 之前, 仍然可以使 pi 拒绝它, 因为 pi 的交互模式发送初始消息 流媒体行为 。 @ awebai/ pi 没有这样的处理器 。 关闭的会话 (重新装入,如) 释放被扣,然后pi运行或拒绝 (b) 根据其自己的规则执行任务;
-   一旦 pi 停止重试, 则报告一个转弯以提供者出错结束 恢复(`agent_settled`,pi 0.80.4和以后):等待索赔 结束 `oats instance waiting`,生产者 `oats.pi`,在下次运行时清除, 因此,实例显示需要输入而不是隐蔽;
-   日记压缩摘要, 当活动时发出回转 创造知识能力 `STATE.md`编号 :`log.md`。启动会得到推动 仅在 pi 保留了更早的家会话时( pi 文件一次会话) 所以新家的第一个转弯就是它的开局任务 什麽 `STATE.md` 说没有决定, 和桥写什么可告诉. 知识所有权、阅读/获取指示、判断和交付 继续拥有能力.

技能分辨率本身由内核拥有:产卵实现精确 内核 + 灵魂 + 活性能力 设置到每个实例 `.agents/skills` 并用该目录作为明确的技能路径发射 pi. 环境 技能(用户级别、软件包、工作树)与由OATS组成的软件集共存.

```bash
npm install -g @awebai/oats
pi install npm:@awebai/oats-pi
```

业务 从同版本标签中发布两个软件包. 适配器后重新装入 pi 安装或升级.

**桥的内核.** 大桥进口了内核 `lib/core.mjs`,来自:

1.  `OATS_PKG_ROOT`,内核软件包目录(检查 当其为一时;
2.  在 OATS 实例中, 启动它的内核: 家庭的自身 `oats` (单位:千美元)`$OATS_INSTANCE_HOME/.oats/bin/oats`),一个链接,内核在 每一次发射 因此,一个家庭不需要全球安装,不管PATH派 运行时,当其内核从一次结账或局部安装中运行;
3.  页:1 `oats` 在PATH上,当它的真正路径位于内核包: 全局安装, 或退机后 `npm link`。一个 `oats` 这是 脚本从其它名称运行内核, 没有软件包并被传递 结束;
4.  `@awebai/oats` 在 npm 的全局文件夹中 (`npm root -g`) (中文(简体) ).

除了一个没有这样的案例之外 Pi 报告延期失败了 要装入,请使用“未找到 OATS 内核” 和三种出局方式: `npm install -g @awebai/oats`,一个 `oats` 连接到内核的路径,或 `OATS_PKG_ROOT`。 。 。 .

所有生命周期/配置/包装操作都使用外壳可见的CLI: `oats status`, (中文(简体) ), `oats spawn`, (中文(简体) ), `oats doctor`, (中文(简体) ), `oats install`, (中文(简体) ), `oats trust`, (中文(简体) ), `oats use`,以及 `oats retire`。 。 。 .

与 [OKF v2 (英语)](https://npmcn.com/package/docs/knowledge.md),状态/日志/笔记保持零星状态 被接受的专业知识生活在外部基地,被暴露为不可改变的读者观点. 皮桥不是收割机或知识库. 选择独立工人 (b) 来源的退休取决于持久的证据保管, 不是这个适配器的出现。 V0.23.1 一体化 [已编制但尚未公布的索赔](https://npmcn.com/package/docs/release-notes/v0.23.1.md)。 。 。 .

## 常见问题

### @awebai/oats-pi 是什么？

OATS pi 运行时桥 — 运行时中立的存储会话事件和工作前空间拖带@ awebai/ oats内核

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

在项目目录运行 npm install @awebai/oats-pi，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typebox（\*）、@earendil-works/pi-ai（\*）、@earendil-works/pi-coding-agent（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

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

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

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

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

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

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

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

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

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

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