# @agentium/edge 中文文档

规范地址：https://npmcn.com/package/%40agentium/edge/

版本：4\.11\.0
npm 元数据更新时间：2026-10-23T22:36:33.446Z
中文译文更新时间：2026-11-07T09:09:16.659Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：181 kB，46 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：^22\.18\.0 \|\| ^24\.11\.0
- 运行依赖：1 个
- peer 依赖：i2c-bus \>=5\.0\.0，node-libgpiod \>=0\.4\.0，@agentium/core ^4\.11\.0，@stoprocent/noble \>=2\.0\.0
- 首次发布：2026-05-22T13:05:05.543Z
- 最新版本发布：2026-10-23T22:36:33.116Z
- 近 30 天下载量：1967（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 40 个）

## 中文简介

Aginium的边缘部署——IOT工具包(GPIO、传感器、相机、BLE)、边缘运行时间,以及Raspberry Pi的Ollama助手

## 安装

```sh
npm install @agentium/edge
```

也可以使用：`pnpm add @agentium/edge`、`yarn add @agentium/edge`、`bun add @agentium/edge`

## README

# @ agentium/ edge (帮助)

Agentium的边缘部署——IOT工具包(GPIO,传感器,相机,BLE,Servo,系统)加上有资源监测,预设,和Ollama帮助器的边缘运行时间. 为Raspberry Pi所设计,但在任何Linux SBC上工作.

## 安装

```bash
npm install @agentium/edge
```

硬件工具包按要求装入其原生装订. 只安装您使用的东西, 例如 :

```bash
npm install onoff           # GPIO
npm install i2c-bus         # sensors
npm install @abandonware/noble  # BLE
```

## 快速启动 — Ollama 支持的本地代理

```typescript
import { Agent } from "@agentium/core";
import { EdgeRuntime, edgePreset, ollama } from "@agentium/edge";

const runtime = new EdgeRuntime(edgePreset("pi-5-balanced"));
await runtime.start();

const agent = new Agent({
  name: "edge-bot",
  model: ollama(runtime.recommendedModel),
  instructions: "You are an edge AI assistant running on-device.",
});

console.log(await agent.run("hello"));
```

## 信息技术工具包

每个工具包都暴露了打入的工具(带有Zod schemas),代理可以称为:

| 工具包 | 示例工具 |
| --- | --- |
| `GpioToolkit` | `gpio.write`, (中文(简体) ), `gpio.read`, (中文(简体) ), `gpio.toggle` |
| `SensorToolkit` | `sensor.read_temperature`, (中文(简体) ), `sensor.read_humidity` (I2C/一线) |
| `CameraToolkit` | `camera.snapshot`, (中文(简体) ), `camera.start_stream` |
| `BleToolkit` | `ble.scan`, (中文(简体) ), `ble.connect`, (中文(简体) ), `ble.read_characteristic` |
| `ServoToolkit` | `servo.move_to`, (中文(简体) ), `servo.center` |
| `SystemToolkit` | `system.cpu_temp`, (中文(简体) ), `system.uptime`, (中文(简体) ), `system.shutdown` |

```typescript
import { Agent } from "@agentium/core";
import { GpioToolkit, SensorToolkit } from "@agentium/edge";

const agent = new Agent({
  name: "garden-bot",
  model: ollama("llama3.2:3b"),
  toolkits: [
    new GpioToolkit({ pumpPin: 17 }),
    new SensorToolkit({ moistureBus: 1 }),
  ],
});

await agent.run("Water the plants if soil moisture is below 30%.");
```

## 边缘运行时间

`EdgeRuntime` 持续监控CPU,RAM,温度和存储,以便能对资源压力做出反应(缩小模型大小,推迟非关键工具,同步到云等).

```typescript
const runtime = new EdgeRuntime(edgePreset("pi-zero-2-low-power"));
runtime.on("threshold:cpu", (s) => console.warn("CPU pressure", s));
await runtime.start();
```

## 云同步

`EdgeCloudSync` 船舶本地代理运行/传感器日志到一个中央端点,并进行离线排队——对有间断连接的皮斯舰队有用.

## 文档

完整文件时间 [参考文献. agentium.in](https://docs.agentium.in/)

## 社区

加入对话 [解析器](https://discord.gg/T86SJshP)。 。 。 .

## 许可证

麻省理工学院

## 同步和相机行为

同时期的冲锋呼叫共享活动交付批次. 下一批请求中排队的事件仍然存在;只有确认的身份证被取出。 出货失败保留了批次进行再试,因此接收者必须处理重复出货. 相机抓取在删除其临时文件之前返回完整的碱基64图像;应用程序仍然选择如何将图像呈现给多模式模型.

## 常见问题

### @agentium/edge 是什么？

Aginium的边缘部署——IOT工具包\(GPIO、传感器、相机、BLE\)、边缘运行时间,以及Raspberry Pi的Ollama助手

### 如何安装 @agentium/edge？

在项目目录运行 npm install @agentium/edge，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@agentium/core（^4\.11\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agentium/edge 支持 TypeScript 吗？

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

### @agentium/edge 支持 ESM 还是 CommonJS？

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

### @agentium/edge 需要什么版本的 Node\.js？

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

### @agentium/edge 可以商用吗？

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

### @agentium/edge 的下载量有多少？

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

### @agentium/edge 还在维护吗？

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