# @cero-base/cero 中文文档

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

版本：2\.12\.0
npm 元数据更新时间：2026-11-09T03:09:19.622Z
中文译文更新时间：2026-11-09T17:32:52.372Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：305 kB，51 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：23 个
- 首次发布：2026-05-28T22:51:24.621Z
- 最新版本发布：2026-11-09T03:09:19.428Z
- 近 30 天下载量：2106（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：78（近 12 个月 78 个）

## 中文简介

理想的p2p API——一切都是一个手柄,手柄中包含指针,指针中包含行.

## 安装

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

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

## README

# @cero-base/ cero (英语)

> \[大 这个项目是实验性的。 API可以更改,随时可能中断.

描述你的数据。 Cero把它储存在设备上,在你的设备上同步,并与你邀请的人分享. 没有服务器 .

Cero是SDK应用程序的用法,是Cero Base的两个软件包之一,位于A [梨树](https://pears.com/) 堆叠由 [霍莱蓬奇](https://holepunch.to/)另一种,核心([`@cero-base/core`](https://www.npmjs.com/package/@cero-base/core)),将原始人Cero从所建.

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

一个Cero应用程序是三个文件.

```js
// schema.js
import { cero, t } from '@cero-base/cero'

export const schema = cero.schema({
  notes: t.collection({ title: t.string, body: t.string }),
  room: { messages: t.collection({ text: t.string }) }
})
```

```js
// build.js, run once and after every schema change
import { build } from '@cero-base/cero/build'
import { schema } from './schema.js'

await build('./spec', schema)
```

```js
// index.js
import { cero } from '@cero-base/cero'
import { spec } from './spec/index.js'

const me = await cero('./data', spec)
await cero.put(me.notes, { title: 'first', body: 'hello' })

const room = await cero.open(me.room, { name: 'general' })
console.log(await cero.invite(room)) // give this to a friend
```

你的朋友,用他们自己的机器, 有相同的三个文件:

```js
// index.js
import { cero } from '@cero-base/cero'
import { spec } from './spec/index.js'

const me = await cero('./data', spec)
const invite = '…' // the string you gave them
const room = await cero.open(me.room, { invite })
for await (const { data } of cero.watch(room.messages)) console.log(data)
```

这是一个工作,加密, 离线第一,对等的应用程序。 你的话, `await cero.phrase(me)`,在任何其他设备上打开同一身份.

## 文档

-   [快速启动](https://github.com/lekinox/cero-base/blob/main/docs/quickstart.md)
-   [指南](https://github.com/lekinox/cero-base/blob/main/docs/README.md): 计划、数据、共享、设备、网络、应用程序、扩展、工作方式
-   [API 参考](https://github.com/lekinox/cero-base/blob/main/docs/api.md)
-   [错误](https://github.com/lekinox/cero-base/blob/main/docs/errors.md)

## 出口

| 子路径 | 它给你什么 |
| --- | --- |
| `@cero-base/cero` | `cero`, (中文(简体) ), `t`, (中文(简体) ), `schema`, (中文(简体) ), `restore`, (中文(简体) ), `peek`24个操作员, `Handle`, (中文(简体) ), `Ref`, (中文(简体) ), `Local` |
| `@cero-base/cero/build` | `build(specDir, schema, opts)` |
| `@cero-base/cero/server` | `serve(ipc, spec, opts)` 财务报告和审定财务报表 `Server`拥有数据的工人 |
| `@cero-base/cero/client` | `cero(ipc, spec)` (另见: `connect`, (中文(简体) ), `Client`, (中文(简体) ), `restore`, (中文(简体) ), `t`, (中文(简体) ), `schema` 和每个操作员 `before`, (中文(简体) ), `after` 财务报告和审定财务报表 `tx`,用于UI进程 |
| `@cero-base/cero/extensions` | `profileSync`, (中文(简体) ), `handleSync`, (中文(简体) ), `bundled`, (中文(简体) ), `extensionsOf`灯光 `cero` 与 `t`, (中文(简体) ), `schema` 和运算符,用于扩展模块 |

24个操作员,每个操作员都作为 `cero.put` 诸如: `put`, (中文(简体) ), `set`, (中文(简体) ), `get`, (中文(简体) ), `del`, (中文(简体) ), `watch`, (中文(简体) ), `call`, (中文(简体) ), `open`, (中文(简体) ), `tx`, (中文(简体) ), `invite`, (中文(简体) ), `revoke`, (中文(简体) ), `rotate`, (中文(简体) ), `accept`, (中文(简体) ), `deny`, (中文(简体) ), `leave`, (中文(简体) ), `close`, (中文(简体) ), `cancel`, (中文(简体) ), `suspend`, (中文(简体) ), `resume`, (中文(简体) ), `activate`, (中文(简体) ), `deactivate`, (中文(简体) ), `phrase`, (中文(简体) ), `nearby`, (中文(简体) ), `before`, (中文(简体) ), `after`。 。 。 .

建造于 [梨树](https://pears.com/) 堆栈: Hypercore, Autobee, HyperDB, Hyperblops, Hyperswarm, Blind-peering and bare 。 运行在节点和赤裸上,并附有TypeScript声明.

## 许可证

阿帕奇 - 2.0

## 常见问题

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

理想的p2p API——一切都是一个手柄,手柄中包含指针,指针中包含行\.

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

在项目目录运行 npm install @cero-base/cero，或使用 pnpm add / yarn add / bun add。

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

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

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

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

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

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

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

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

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

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

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

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