# @abloatai/ablo 中文文档

规范地址：https://npmcn.com/package/%40abloatai/ablo/

版本：0\.67\.3
npm 元数据更新时间：2026-11-06T19:53:58.271Z
中文译文更新时间：2026-11-06T09:04:14.544Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：850 kB，167 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：3 个
- peer 依赖：ai ^6\.0\.0 \|\| ^7\.0\.0，react ^19\.2\.8
- 首次发布：2026-05-24T09:32:08.264Z
- 最新版本发布：2026-11-06T19:53:57.901Z
- 近 30 天下载量：3684（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：127（近 12 个月 127 个）

## 中文简介

公众Ablo SDK协调阅读、承诺、主张、观察和反应应用.

## 安装

```sh
npm install @abloatai/ablo
```

也可以使用：`pnpm add @abloatai/ablo`、`yarn add @abloatai/ablo`、`bun add @abloatai/ablo`

## README

[![Ablo](https://npmcn.com/package/%40abloatai/ablo/assets/banner.png)](https://abloatai.com/)

**为在共享国家工作的代理人、应用程序、服务和人员建立协调基础设施.**

[文档](https://docs.abloatai.com/)  |  [安装](https://docs.abloatai.com/installation)  |  [API 密码](https://docs.abloatai.com/api)  |  [GitHub 图像](https://github.com/Abloatai/ablo)

[![npm](https://img.shields.io/npm/v/@abloatai/ablo?style=flat-square&color=2563eb)](https://www.npmjs.com/package/@abloatai/ablo) [![license](https://img.shields.io/badge/license-Apache--2.0-2563eb?style=flat-square)](https://npmcn.com/package/%40abloatai/ablo/LICENSE) ![node >=24](https://img.shields.io/badge/node-%E2%89%A524-22c55e?style=flat-square) ![types included](https://img.shields.io/badge/types-included-2563eb?style=flat-square)

* * *

Ablo是代理人、应用程序、服务和服务的协调基础设施 在共享状态下工作的人.

每一个写作都经过它,所以权威, 公正,冲突,命令, 并且确认在一个地方执行。 您的邮袋仍然是 事实.

共享状态的组合结构可以到达每个人或代理人。 宣布: 数据的范围和参与权,然后让授权订阅保留 被动视图当前; HTTP 代理明确读取或观察变化 。 开始 与 [团体和共同背景](https://npmcn.com/package/%40abloatai/ablo/docs/groups.md) 连接会员,访问, 装入并更新.

## 为什么阿布洛

软件曾经有一个编剧:人类通过应用程序点击. 大赦国际 应用程序现在有人类、代理、工作流程和服务 同时 数据库保持交易的一致性。 他们不协调 自主的作品,现在读, 30秒的理由, 和以后写.

人类会自然地处理这件事 我们发现有人在编辑 同意谁 参与其中,等待轮到我们,再看一看再继续。 Ablo给的 软件行为者具有相同的能力:有限度的权威、共有、, 新的背景,安全交接, 和一个归属记录 发生了什么事.

## 开始

```sh
npm install @abloatai/ablo
npx ablo init
npx ablo dev
```

`ablo dev` 为您的 Git 分支准备一个孤立的 Ablo 分支,写下它 临时证书来标记 `.env.local`推着计划,看 用于更改.

通过一个输入的 API 读取和写入 :

```ts
const order = await ablo.orders.read({ id: orderId });

if (!order) throw new Error('Order not found');
await ablo.orders.update({
  id: order.id,
  data: { status: 'approved' },
  reads: [order],
});
```

`confirmed` 指权威数据库将更改报告回. 这个 如果呼叫者失去连接,同样的承诺可以安全地重新测试.

当工作需要30秒而不是一个请求时,在 代理开始推理 :

```ts
await using claim = await ablo.orders.claim({ id: orderId });

const priced = await pricingAgent(claim.data);

await ablo.orders.update({
  id: claim.data.id,
  data: { total: priced.total, status: 'repriced' },
  claim,
});
```

另一位演员碰同一部作品时,会公平等待并获得新鲜状态 轮到它开始。 如果代理失败,索赔自动释放。 如果有的话 上下文变得僵化, 写入被拒绝而不是默默地覆盖 它从未见过的工作.

如果使用 AI SDK,则暴露与打入的模型工具相同的操作:

```ts
import { updateTool } from '@abloatai/ablo/ai-sdk';

const approveOrder = updateTool(ablo.orders, {
  description: 'Approve an order after reviewing it.',
  inputSchema: z.object({ orderId: z.string() }),
  id: ({ orderId }) => orderId,
  apply: () => ({ status: 'approved' }),
});
```

用品 `readTool`, (中文(简体) ), `createTool`, (中文(简体) ), `updateTool`,以及 `deleteTool` 超过 同样的权威资源。 AI SDK 保留模型循环和工具的所有权 执行.

对于一个需要多个读数的模型调用加上应用程序拥有的检索或 记忆, [`context()`](https://npmcn.com/package/%40abloatai/ablo/docs/context.md) 正在等待所选值,并带有 确切的Ablo排入了写作 `reads` 选项。 它没有添加搜索, 内存,或模式运行时间.

使用 `@abloatai/ablo` 代理和后端代码, `@abloatai/ablo/client` 用于现场申请,以及 `@abloatai/ablo/react` 为反应。 所有入境点都有同样的计划, 授权、承诺、要求和命令更改.

读取 [快速启动](https://docs.abloatai.com/quickstart)浏览 [页面存档备份,存于互联网档案馆. docs.abloatai.com](https://docs.abloatai.com/),或运行 `npx ablo docs`。 。 。 .

## 导航源

此寄存器保存了软件包所有权边界而不是 将执行简化为 `packages/ablo`数字 :

-   `packages/ablo` 是品牌化的公共外观。 其档案大多是再导出 每个API的软件包.
-   `packages/transaction` 拥有共享模式运营合同和 无头HTTP/WebSocket运输实施.
-   `packages/humans` 拥有被动的WebSocket/local/React执行.

那意味着只在里面找 `packages/ablo/src` 将找不到 执行情况 `create`, (中文(简体) ), `update`, (中文(简体) ), `delete`,或 `claim`。阅读 **[源代码映射](https://npmcn.com/package/%40abloatai/ablo/CODEMAP.md)** 逐个动词所有权表和 引导调用跟踪 默认客户端和被动客户端.

## 捐款

Ablo是自由开放源代码. 你可以帮助 [打开一个问题](https://github.com/Abloatai/ablo/issues), (中文(简体) ), [推荐一个特性](https://github.com/Abloatai/ablo/issues/new),或 [贡献代码](https://github.com/Abloatai/ablo/pulls)。 。 。 .

请私下报告弱点 [GitHub 安全顾问](https://github.com/Abloatai/ablo/security/advisories/new)。 。 。 .

## 许可证

阿帕奇许可证2.0. 见 [自由主义](https://npmcn.com/package/%40abloatai/ablo/LICENSE) 财务报告和审定财务报表 [通知](https://npmcn.com/package/%40abloatai/ablo/NOTICE)。 。 。 .

## 常见问题

### @abloatai/ablo 是什么？

公众Ablo SDK协调阅读、承诺、主张、观察和反应应用\.

### 如何安装 @abloatai/ablo？

在项目目录运行 npm install @abloatai/ablo，或使用 pnpm add / yarn add / bun add。

### @abloatai/ablo 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @abloatai/ablo 支持 ESM 还是 CommonJS？

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

### @abloatai/ablo 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @abloatai/ablo 可以商用吗？

@abloatai/ablo 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @abloatai/ablo 的下载量有多少？

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

### @abloatai/ablo 还在维护吗？

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