# @buoy-gg/agent-core 中文文档

规范地址：https://npmcn.com/package/%40buoy-gg/agent-core/

版本：7\.0\.87
npm 元数据更新时间：2026-11-07T01:50:05.293Z
中文译文更新时间：2026-11-08T20:02:47.746Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40buoy-gg/agent-core
原文对照：https://npmcn.com/package/%40buoy-gg/agent-core/?lang=original
项目主页：https://buoy.gg/buoy/latest/docs/tools/ask-buoy
源码仓库：https://github.com/LovesWorking/react-native-buoy

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

- 包体积（解压后）：3 MB，160 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-09-02T23:24:36.148Z
- 最新版本发布：2026-11-07T01:50:05.104Z
- 近 30 天下载量：5187（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：54（近 12 个月 54 个）

## 中文简介

Ask Buoy 的无头代理核心 - 工具目录, BYO- 模型提供者, 转回循环和效果分类账, 让 LLM 驱动 Buoy devtools

## 安装

```sh
npm install @buoy-gg/agent-core
```

也可以使用：`pnpm add @buoy-gg/agent-core`、`yarn add @buoy-gg/agent-core`、`bun add @buoy-gg/agent-core`

## README

# @ buoy- gg/ 代理核心

Ask Buoy使用的无头引擎. 它没有React,React Induct,或节点内置导入.

它规定:

-   **工具目录** – 从一个源文件生成的Buoy工具动作. JSON-Schema 参数已验证 _在此之前_ 发送,每动作效果类(读/写/破坏性),每动作放出-建立真理:需要只发展能力的行动会被拒绝解释,绝不允许假冒成功. 参数计划描述每个动作接受的名称和值.
-   **转圈** ——提供者流线(Anthropic和OpenAI有线形状,在提供者提供时迅速缓存),独立发送的工具读取重叠,结果编辑(证书字段名) _财务报告和审定财务报表_ 、 值形状 、 自通取取、 循环检测、 弹出前的历史压缩、 和步骤和时间封顶 —— 有 `stopReason` 每页 `done`,持有仍在应用的改变的回合最后从内存中掉出,一个被节奏或过大的请求被狭义地重试:只有在溪流没有产生,所以没有运行两次.
-   **证据库** 每一个结果在修改后都保持完整,所以 `ask-buoy.retrieve` 可以在24k读取一个结果切出的任何部分,或者重新读取模型在写作之前所看到的确切内容. 在记忆中,会议范围从未持续.
-   **成果检查** 5个写作在着陆后被读取(存储、存储和缓存编辑、导航、超标规则); 裁决在工具结果和a上 `tool-verified` 事件: `verified` 编号 : `unverified` (已着陆,尚不可见——何以使之如此)/ `failed` (一改一从来.
-   **托肯校正** ——预算以代币记账并按提供者自己的用法报告衡量的比例进行折算,而不是猜测出4个字符/音符.
-   **地面摘要** ——从工具本身构建的紧凑,无值的运行中的应用程序图片:路由路径,存储并存储密钥名称,挂载先查询密钥,以及项目 **形状** 以未知名称命名,而不是留待猜测。 以深度,宽度和字符总数为界,因此由几百个记录所键入的商店无法将"契约"素描变成即时最出名的东西.
-   **效果分类账** - 特工改变了什么 怎样放回去 存储写入和查询- cache 编辑是预读的, 因此撤消恢复了之前的精确值; 任何无法被撤销的都报告为永久而不是隐藏 .
-   **政策** ——批准门(默认情况下破坏性地等待人用水龙头),允许/拒绝规则,按呼批准,只读模式,以及默认关闭的安全Store值门. `requestApproval` 可能解决 `{ approved, reason, trust }`:一个有下降的音符逐字到达模型 `trust` 免去会议这一动作的名片——只批准,从未有过政策.
-   **程序** —— 说 `context.procedures` 是应用程序的游戏本 `id — summary` 在即时,身体由引擎服务 `ask-buoy.openProcedure`。 。 。 .
-   **块** ——封闭的,申报性的UI目录(`buoy_ui`模型作者对工具结果预测的引擎生成的收据作出了丰富的反应.

一个主机提供模型端点、协议、模型、可用动作和 `dispatch(toolId, action, params)` 函数。 主机还必须强制访问账户,认证模型请求,并处理权限和生命周期事件.

## 用这个

对于 React 本地聊天界面, 使用 [`@buoy-gg/ask-buoy`](https://www.npmjs.com/package/@buoy-gg/ask-buoy), React Industrial 聊天表就是以此为基础建立的. 它安装这个引擎作为依赖.

直接用于自定义主机. 这是集成草图: `endpoint`, (中文(简体) ), `model`, (中文(简体) ), `myDispatch`,以及 `availableActions` 来自您的主机, 它不是一个独立的应用程序.

```ts
import { createAskBuoySession } from "@buoy-gg/agent-core";

const session = createAskBuoySession({
  endpoint, protocol: "anthropic", model,
  dispatch: myDispatch,           // (toolId, action, params) => Promise<unknown>
  availableActions,               // what this host can actually reach
  isRelease: false,
});

for await (const event of session.send("what did the last network call return?")) {
  // text deltas, reasoning, tool starts/ends, blocks, approvals, token usage
}
```

内置目录验证支持动作及其参数. 仅发布您主机可以发送的动作, 并查阅 Ask Buoy 配置指南, 用于政策和自定义工具集成 .

## 文档

**[浮标.gg/docs/工具/水缸](https://buoy.gg/buoy/latest/docs/tools/ask-buoy)**

## 许可证

见 [浮标.gg](https://buoy.gg/) 许可证发放.

## 常见问题

### @buoy-gg/agent-core 是什么？

Ask Buoy 的无头代理核心 - 工具目录, BYO- 模型提供者, 转回循环和效果分类账, 让 LLM 驱动 Buoy devtools

### 如何安装 @buoy-gg/agent-core？

在项目目录运行 npm install @buoy-gg/agent-core，或使用 pnpm add / yarn add / bun add。

### @buoy-gg/agent-core 支持 TypeScript 吗？

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

### @buoy-gg/agent-core 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @buoy-gg/agent-core 可以商用吗？

@buoy-gg/agent-core 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @buoy-gg/agent-core 的下载量有多少？

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

### @buoy-gg/agent-core 还在维护吗？

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