# @cero-base/tools 中文文档

规范地址：https://npmcn.com/package/%40cero-base/tools/

版本：2\.12\.0
npm 元数据更新时间：2026-11-09T03:13:16.230Z
中文译文更新时间：2026-11-09T19:18:16.468Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：61.7 kB，22 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：6 个
- 首次发布：2026-06-01T12:57:36.193Z
- 最新版本发布：2026-11-09T03:13:15.920Z
- 近 30 天下载量：1807（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：66（近 12 个月 66 个）

## 中文简介

Cero的被动支架——在局部出带管上观测数据、事件和p2p/再生数据.

## 安装

```sh
npm install @cero-base/tools
```

也可以使用：`pnpm add @cero-base/tools`、`yarn add @cero-base/tools`、`bun add @cero-base/tools`

## README

# @cero-base/工具

被动编舞工具 [切罗](https://www.npmjs.com/package/@cero-base/cero) 观察一个运行中的例子 **数据**页:1 **事件日志**,以及 **p2p/复制数据** 从另一个过程, 从来没有接触过它测量的群.

A 类 `devtools()` 扩展引用实例于 a **本地出带管** 所以连接、核心长度和复制数字 都和没有固定的编组一样 由建筑只读;身份秘密在结构上是无法接触到的.

## 安装

```sh
npm install @cero-base/tools
```

## 代理侧- 附加水龙头

```js
import { cero } from '@cero-base/cero'
import { devtools, loopback } from '@cero-base/tools'

const me = await cero('./data', spec, {
  extensions: [...spec.extensions, devtools({ transport: loopback({ port: 9111 }) })]
})
// ...then create your instance as usual; the tap follows it and every child handle.
```

`devtools(opts)`数字 :

| 选择 | 默认 | 含义 |
| --- | --- | --- |
| `transport` | —— 说 | (单位:千美元) `{ accept(handler) }` 消费者联系来源(使用) `loopback({ port })`(中文(简体) ) |
| `bufferSize` | `1000` | 事件环缓冲大小( 最旧) |
| `sampleInterval` | `1000` | 数据取样间隔(毫秒) |
| `redact` | —— 说 | (单位:千美元) `(ref, row) => row` 面具或配置 `{ fields, match, deny }` (见编辑) |
| `token` | 随机 | a. 印入启动标语的自带标记; `false` 禁用闸门 |

未注册时为零; 所有清理都与根柄相连 `close`。 。 。 .

任何本地进程都可以拨回回路端口, 因此水龙头需要每个运行符: 第一个 连接的框架必须携带它或丢弃连接。 横幅印出准确的 `cero-tools <port> --token <token>` 命令。 不论如何,都不要生产建筑 水龙头是一个开发工具.

## 消费者方面——连接

```js
import { connect, dial } from '@cero-base/tools'

const session = await connect(dial({ port: 9111 }))

await session.handles() // [{ id, type }, ...] — root + open children
await session.get('messages') // { data, total, size } — reuses cero's read operators
session.watch('messages') // Readable of live snapshots
session.events() // Readable of { op, name, row, writerKey, seq } — local AND remote
session.stats() // Readable of { network, bee, cores }
session.close()
```

## 国 际

```sh
cero-tools <port> --token <token> [refs...]
# prints the handle tree + state for each ref, then tails events + stats until Ctrl-C
```

## 编辑

App行可以保持任何东西,所以 `devtools({ redact })` 口罩在快照和事件上都匹配字段——内容隐藏,形状保存(`‹redacted:bytes(32)›`:

```js
devtools({ redact: {} }) // default denylist: seed/secret/token/private/...
devtools({ redact: { fields: ['profile.apiKey'] } })
devtools({ redact: { match: (key) => key.endsWith('Secret') } })
```

默认是 **按字段名称列出的拒绝列表** - 以非列名名称储存的秘密(`otp`, (中文(简体) ), `recoveryCode`,.) 中转无假冒. 通过 `fields`编号 :`match`,或者通过自己的 `(ref, row) => row` 允许语义学的口罩.

身份证明(种子和键盘)不需要修改:它们是 `local` 建筑物和检查表面仅供申报 `meta.refs`所以他们永远无法到达.

## API 密码

`devtools(opts)` • 妇女 `serve(stream, me, opts)` • 妇女 `connect(stream)` • 妇女 `stats(handle)` • 妇女 `redact(config)` • 妇女 `loopback(opts)` • 妇女 `dial(opts)`

## 状态

MVP: 本地管道运输, `get`编号 :`watch` + 事件 + 抽样统计, 编辑, a CLI. 推迟至后期:列入白名单的散装运输,只读复制/时间旅行平面,以及MCP/UI消费者.

## 许可证

阿帕奇 - 2.0

## 常见问题

### @cero-base/tools 是什么？

Cero的被动支架——在局部出带管上观测数据、事件和p2p/再生数据\.

### 如何安装 @cero-base/tools？

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

### @cero-base/tools 支持 TypeScript 吗？

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

### @cero-base/tools 支持 ESM 还是 CommonJS？

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

### @cero-base/tools 需要什么版本的 Node\.js？

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

### @cero-base/tools 可以商用吗？

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

### @cero-base/tools 的下载量有多少？

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

### @cero-base/tools 还在维护吗？

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