# @berthos/cli 中文文档

规范地址：https://npmcn.com/package/%40berthos/cli/

版本：0\.3\.1
npm 元数据更新时间：2026-10-31T15:54:57.045Z
中文译文更新时间：2026-10-31T16:07:54.302Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：876 kB，287 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19
- 运行依赖：14 个
- peer 依赖：@berthos/adapter-e2b ^0\.3\.1，@berthos/adapter-k8s ^0\.3\.1，@berthos/adapter-daytona ^0\.3\.1
- 首次发布：2026-09-27T08:50:28.852Z
- 最新版本发布：2026-10-31T15:54:56.715Z
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

泊位命令行—init、dev、test、doctor、mcp、test、os、snapshot、publish、deploy

## 安装

```sh
npm install @berthos/cli
```

也可以使用：`pnpm add @berthos/cli`、`yarn add @berthos/cli`、`bun add @berthos/cli`

## README

# @berthos / cli

这个 `berth` 命令：scaffold，运行，测试和部署常驻应用程序，检查您的机器是否可以强制执行，并将应用程序连接到任何MCP客户端。

[泊位](https://github.com/Ash20pk/BerthOS) 在沙盒中运行人工智能代理的工具。每个工具在类中声明它可以接触什么 `berth.yml` manifest， Linux内核（Landlock和seccomp）执行它。

```sh
npm install -g @berthos/cli
```

需要Node.js 22.19+。在带有KVM的苹果芯片Mac或Linux上，这就是全部：每个沙箱都是一个启动Berth自己内核的小型VM，因此执行不依赖于您的机器，而且是第一个 `berth dev` 下载它（大约140 MB，每个文件都根据sha256进行检查）。没有KVM的英特尔mac、Windows和Linux使用Docker代替 `berth test` 和 `berth deploy` 构建一个容器镜像，所以他们需要Docker在任何地方([文档](https://github.com/Ash20pk/BerthOS/blob/main/docs/local-vm.md)）。

## 使用

```sh
berth doctor              # can this machine enforce?
berth init my-app         # scaffold a resident app
cd my-app
berth dev                 # boot it in a sandbox, reload on save
berth test                # build the production image and check every export
berth mcp --app my-app    # serve its exports as MCP tools over stdio
```

## 命令

| 命令 | 它是做什么的 |
| --- | --- |
| `berth init [name]` | 搭建一个常驻应用程序(`--template`， `--registry`） |
| `berth dev` | 在本地沙盒中使用热加载启动应用程序(`--apps` 添加配套应用程序， `--runtime docker|vm` 选择沙盒) |
| `berth test` | 构建生产镜像，检查导出契约，运行应用程序的测试(`--json`） |
| `berth doctor` | 检查此机器是否可以强制执行功能 |
| `berth mcp --app <name>` | 将应用程序的导出公开为MCP工具(`--only`， `--warm`， `--no-boot`） |
| `berth rpc <app> --export <name>` | 直接调用一个导出(`--input` 将JSON) |
| `berth vm install|status|stop|logs` | 安装和管理本地microVM运行时([文档](https://github.com/Ash20pk/BerthOS/blob/main/docs/local-vm.md)） |
| `berth os up|down|status` | 保持沙盒运行，以便代码可以立即重新连接到它 |
| `berth attest <runId>` | 生成运行的证明记录 |
| `berth audit list|verify` | 显示审计跟踪，或检查其散列链 |
| `berth snapshot create|list|restore|fork` | 检查点和恢复沙盒 |
| `berth deploy --fleet=<e2b|daytona|k8s>` | 部署到远程提供程序 |
| `berth fleet status|scale`， `berth logs` | 管理和跟踪已部署的实例 |
| `berth publish --registry=<url>` | 将应用程序发布到 `berth-registry` |
| `berth tls init` | 生成本地CA和服务器证书 |

运行 `berth <command> --help` 每一面旗帜。部署需要在CLI旁边安装匹配的适配器： `@berthos/adapter-e2b`， `@berthos/adapter-daytona` 或者 `@berthos/adapter-k8s`.

`berth agent run`， `berth crew run` 和 `berth eval` 驱动实验性代理框架，该框架尚未发布。它们只能从一个克隆的仓库中工作。

## 文档

[快速入门](https://github.com/Ash20pk/BerthOS/blob/main/docs/quickstart.md) · [MCP快速入门](https://github.com/Ash20pk/BerthOS/blob/main/docs/mcp-quickstart.md) · [医生](https://github.com/Ash20pk/BerthOS/blob/main/docs/doctor-reference.md) · [回购](https://github.com/Ash20pk/BerthOS)

## 常见问题

### @berthos/cli 是什么？

泊位命令行—init、dev、test、doctor、mcp、test、os、snapshot、publish、deploy

### 如何安装 @berthos/cli？

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

### @berthos/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/berthos\_\_cli 是否存在。

### @berthos/cli 支持 ESM 还是 CommonJS？

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

### @berthos/cli 需要什么版本的 Node\.js？

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

### @berthos/cli 可以商用吗？

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

### @berthos/cli 还在维护吗？

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