# @clearlysh/beehaven 中文文档

规范地址：https://npmcn.com/package/%40clearlysh/beehaven/

版本：0\.8\.38
npm 元数据更新时间：2026-10-30T07:53:15.300Z
中文译文更新时间：2026-11-10T01:00:53.431Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40clearlysh/beehaven
原文对照：https://npmcn.com/package/%40clearlysh/beehaven/?lang=original
项目主页：https://www.clearly.sh/docs/cli
源码仓库：https://github.com/clearly-sh/clearly

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

- 包体积（解压后）：3.4 MB，197 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：5 个
- peer 依赖：@clearly-sh/beehaven-core \>=0\.3\.0
- 首次发布：2026-09-27T06:05:15.914Z
- 最新版本发布：2026-10-30T07:53:15.105Z
- 近 30 天下载量：1976（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

Beehaven CLI——从终端指挥你明显的工作空间、特工和帆布

## 安装

```sh
npm install @clearlysh/beehaven
```

也可以使用：`pnpm add @clearlysh/beehaven`、`yarn add @clearlysh/beehaven`、`bun add @clearlysh/beehaven`

## README

# 蜂窝

命令行为 **毕哈芬** ——明经云. 指挥你的工作空间, 代理、画布和应用终端命令文件系统的方式 本地守护程序将机器(和人工智能特工)连接到它.

贝哈芬是世界的名字 很明显 云,蜂窝,蜂窝 守护者 蜜蜂 这不是一个单独的产品 你购买; 这是明显的地方生活, 这就是你用外壳说话的方式.

## 所需资源

-   节点.js **\>= 20** (CLI是一个节点程序;出版的档案包括它的) 运行时间依赖关系)

## 安装

对于与节点20或更新的一次性代理会话,直接运行 npm 包:

```bash
npx --yes beehaven@latest guide
```

`guide` 在注册前工作。 它解释当明显有用时 人类是一个注册链接, 并展示认证的第一件文物. `npx` 使用一个 ephemeral npm 安装;它不创建 Clear 账户或上传任何信息 . 公共建筑发送一个匿名的,无内容 `cli:guide` 使用事件,除非 `BEEHAVEN_NO_TELEMETRY` 或当地 `telemetry-off` 文件禁用遥测. 该套件还提供了 `beehaven` 全局 npm 安装的 二进制 :

```bash
npm install -g beehaven@latest
beehaven guide
```

同样的释放也列在明显npm组织之下: `@clearlysh/beehaven`。 。 。 .

### 帮一个没有帐户的人

当一个特工的工作准备好 之前的人已经报名, `handoff` 需求 不登录并打印一个私有链接 :

```bash
npx --yes beehaven@latest handoff plan.md
npx --yes beehaven@latest handoff plan.md --tasks todo.md --csv budget.csv --wait
```

人物对其进行预览,在自由账户中签名或创建自由账户并保存. A 类 单凭文件即可成为私人草案 `--tasks` (Markdown核对表或 JSON 阵列)或 `--csv` 文件成为私人项目,每个任务都有票 每张CSV一张 链接是一个证书——第一个保存它的人 因此,只发给与你合作的人。 未保存的交割 7天后期满. `--wait` 保存时返回.

自成一体的安装器仍然是推荐的持久性安装. 没错 不需要 npm 来解决用户机器上的依赖性 :

```bash
curl -fsSL https://clearly.sh/install.sh | sh
```

取出一个版本的柏油球并写下 `beehaven` 改为 `~/.local/bin`已发布 档案包括它们的依赖性; 旧的档案可能需要npm. 添加垃圾桶 您的目录 `PATH` 如果安装者说它不存在.

校验 :

```bash
beehaven --version
beehaven doctor        # environment + daemon + relay checks
```

在单人房里工作?

```bash
cd packages/cli && npm install && npm run build && npm link
```

`npm link` 可能无法胜出: 安装者写入 `~/.local/bin/beehaven`,该 目录通常先于 npm 前缀 `PATH`检查 `which beehaven` 财务报告和审定财务报表 `beehaven --version` 在完成本地变化之前.

Npm和安装器均将公共CLI所建造. 安装器下载 一个版本化的归档从 `downloads.clearly.sh` 并核实SHA-256 更新清单。 npm通过登记册验证包的完整性.

## 更新

运行 `beehaven --version` 以查看版本和文件同时执行. CLI在命令启动时最多检查一次已发布的版本 当找到更新的版本时,打印通知。 这是通知,不是互动 快点 卷轴化的CLI(`~/.beehaven/cli`)可由一个人或个人更新 代理为 `beehaven update`;它验证了发布档案的SHA-256之前 安装。 此本地命令不需要工作空间代理登录 . Npm 用 npm 安装更新; a `npx` 运行可以请求 `@latest` 再来一次.

当一个已安装的 CLI 拥有一个独立的守护进程时, 守护进程在启动时检查 和小时,安装一个经核实的更新,并重新开始。 守护进程开始于 Mac App将更新留给了应用。 启动时生产和运行Mac Apps检查 每4小时下载一次,然后默认退出; 托盘也提供 **检查更新**. 更新一个相连的发展结构 通过重建它的退票。 显然 Dev. app 也没有发布更新器; 重建 并重新安装该应用程序以更新其捆绑的CLI.

## 快开始

```bash
beehaven login                # authenticate (browser OAuth)
beehaven connect home         # set the active target — your default workspace
beehaven agent login codex --label "my task" --client cli  # identity + one work session + brief
beehaven actions              # what can I call here?
beehaven call canvas-catalog '{}'   # every canvas verb + its args
```

三个命令几乎覆盖一切: **连接** 对目标,问什么 **动作** 它已经, **调用** 一个 见 `beehaven help` 用于整个地表,或 `beehaven help <command>` 任何单一动词.

## 代理图像表达式

本地化的外形可以使用主动代理身份进行定位. 使用简短 主表达式表面的旗帜 :

```
beehaven --mood curious
beehaven --emote cheer "tests passed"
```

持续的情绪是:中立,快乐,悲伤,惊讶,愤怒,困惑,好奇, 和调情。 生命周期值为 `wake` 财务报告和审定财务报表 `sleep`,设置为 `--lifecycle`; 思维和 庆祝是活动姿势。 一发即发的口号是:波,欢呼,心,笑,舞蹈,嗡嗡,点头, 摇摆,思考,惊喜,睡觉。 被封杀后的一个可选理由 在200个字符.

`--emote think` 是一发反应。 兼容命令 `beehaven avatar think` 是持续的思维状态.

代理代理代理代号将电话传至代理代理的外形;没有代理代理代号 用的是房屋活字 兼容性命令仍然可用 :

```
beehaven avatar emotion curious
beehaven avatar react cheer "tests passed"
```

守护进程 MCP 表面 暴露出持续情感的外观 avatar 反应一发反应. 两种外观都需要外观 : 允许签名代理.

见 [缩略语.md](https://npmcn.com/docs/AVATAR_EXPRESSIONS.md) 全体会议 跨地表合同和真相来源地点.

## 对云说话——守护进程+Do

CLI与当地人交谈 **守护进程** 中继连接 蜂窝云 并引导 RPC 到右边的持久对象.

```bash
beehaven login                # authenticate (browser OAuth) — required
beehaven status               # connection + auth state
beehaven connect home         # set the active target (default workspace alias)
beehaven actions              # list callable actions on the target
beehaven call <action> '{…}'  # invoke one
```

对于需要多个工作空间动作的脚本,CLI也会被曝光 服务器没有第二个执行引擎的脚本原始:

```bash
beehaven batch @steps.json --json       # {"steps":[{"action":"…","input":{}}]}
beehaven code-run @script.mjs --json    # source file; use `-` for stdin
```

`batch` 运行最多25个相继步骤(共计400个行动),而不是 交易; `stopOnError` 默认为真实. `code-run` 是一个沙盒,用于 工作空间呼叫之间的计算( 200 个呼叫, 20秒, 100k 来源) 字符). 两个适配器使用相同的活性目标,代理归属, 权限检查和非零故障语义为 `beehaven call`。 。 。 . `batch` 也接受工人本土 `{method,params}` 拼写和规范化 两份表格在发送前都存在.

守护进程通常运行在蜂巢桌面应用程序内. CI / 服务器/ 代理 没有桌面, 请运行它无头 :

```bash
beehaven daemon start         # spawn a headless daemon (requires a prior `beehaven login`)
beehaven daemon status
```

## 驾驶帆布( 代理表面)

CLI可以在开放的浏览器标签中审查并驱动 Clear 编辑器画布 —— 人类在UI的表演 暴露在守护者身上.

```bash
beehaven canvas status [id]                  # compact health summary (tab connected? nodes? tool?)
beehaven canvas perceive [id]                # read the live "room": gaze, contents, focus, chrome
beehaven canvas actions                      # discover every callable editor action
beehaven canvas invoke <action> '{…}'        # drive one action (returns the handler result)
beehaven canvas verify [--composition id]    # self-test EVERY canvas action, then clean up after itself
```

`canvas verify` 创建抓取节点, 练习针对活的每个动作 选项卡,声明结果,然后删除它创建的一切(它相对于 基线快照,所以它从不触及先前存在的内容)并恢复打印 设置。 这是对毒剂/罐头表面的烟雾测试.

## 警卫

-   **需要认证.** 每一次云调都带一个经认证的 身份; `canvas-invoke` 编号 : `canvas-perceive` 拒绝未经认证的呼叫者 并且只到达打电话者的 _拥有_ 连接客户端( 没有交叉账户访问) .
-   **只允许列表动作 .** 通过动作 id 远程帆布控制发送 没有任意的代码执行路径.
-   **本地的IPC是象征性的守护.** CLI 认证到守护进程 每枚发射令牌 `~/.beehaven/ipc-auth`。 。 。 .

## 文档

-   每个命令帮助 : `beehaven help <command>`

## 许可证

麻省理工学院显然(显然(sh))

## 常见问题

### @clearlysh/beehaven 是什么？

Beehaven CLI——从终端指挥你明显的工作空间、特工和帆布

### 如何安装 @clearlysh/beehaven？

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

### @clearlysh/beehaven 支持 TypeScript 吗？

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

### @clearlysh/beehaven 支持 ESM 还是 CommonJS？

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

### @clearlysh/beehaven 需要什么版本的 Node\.js？

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

### @clearlysh/beehaven 可以商用吗？

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

### @clearlysh/beehaven 的下载量有多少？

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

### @clearlysh/beehaven 还在维护吗？

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