@cero-base/tools

中文文档
2.12.0发布于 2026/11/09Apache-2.0TypeScriptES Module近 30 天下载 1807

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

中文使用文档
文档目录8 节
  1. 安装
  2. 代理侧- 附加水龙头
  3. 消费者方面——连接
  4. 国 际
  5. 编辑
  6. API 密码
  7. 状态
  8. 许可证

@cero-base/工具

被动编舞工具 切罗 观察一个运行中的例子 数据页:1 事件日志,以及 p2p/复制数据 从另一个过程, 从来没有接触过它测量的群.

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

安装

npm install @cero-base/tools

代理侧- 附加水龙头

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 })(中文(简体) )
bufferSize1000事件环缓冲大小( 最旧)
sampleInterval1000数据取样间隔(毫秒)
redact—— 说(单位:千美元) (ref, row) => row 面具或配置 { fields, match, deny } (见编辑)
token随机a. 印入启动标语的自带标记; false 禁用闸门

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

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

消费者方面——连接

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()

国 际

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)›:

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 共发布 66 个版本,首次发布于 2026/06/01;过去 12 个月发布了 66 个版本。

版本发布日期距今
2.12.0latest2026/11/09今天
2.11.02026/11/09今天
2.10.02026/11/027 天前
2.9.02026/10/3010 天前
2.8.02026/10/3011 天前
2.7.02026/10/2713 天前

关于 @cero-base/tools 的常见问题

@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 和提交记录判断。