# @bli-cockpit/cli 中文文档

规范地址：https://npmcn.com/package/%40bli-cockpit/cli/

版本：0\.2\.291
npm 元数据更新时间：2026-10-31T16:05:58.744Z
中文译文更新时间：2026-10-31T16:40:21.841Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：4.7 MB，671 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：4 个
- 首次发布：2026-06-05T19:26:34.171Z
- 最新版本发布：2026-10-31T16:05:58.532Z
- 已发布版本数：278（近 12 个月 278 个）

## 中文简介

驾驶舱会观察你和你的人工智能特工是如何工作的，这样爱德华就可以根据证据而不是屏幕截图和状态ping进行指导。

## 安装

```sh
npm install @bli-cockpit/cli
```

也可以使用：`pnpm add @bli-cockpit/cli`、`yarn add @bli-cockpit/cli`、`bun add @bli-cockpit/cli`

## README

# 驾驶舱CLI

驾驶舱会观察你和你的人工智能特工是如何工作的，这样爱德华就可以根据证据而不是屏幕截图和状态ping进行指导。

## 90秒speedrun

在应该收集的Mac或Windows PC上运行此命令：

```bash
npm i -g @bli-cockpit/cli && cockpit doctor
```

医生安装、修理并验证机器。遵循任何登录或信任 提示它打印。它以托收证明或剩余行为结束。

## 每个命令，它做什么，为什么叫它

在一台空白的Mac或Windows电脑上， `npm i -g @bli-cockpit/cli && cockpit doctor` 足以登录，选择根，并收敛机器。 `onboard` 保留命名的设置子集，其余的用于恢复和维护。

Cockpit在苹果硅质Mac和普通Windows上的工作方式是一样的 电脑。所有经你批准的法典和克劳德会议都被收集起来， 在它离开你的机器之前把所有敏感的东西都拿走，然后 上传时附上收据，或者列出没有上传的确切原因。如果一个 座舱是这么说的——绿屏永远掩盖不了一个。

我们只会在一个版本端到端经过测试后才将它发布到npm 普通用户，在macOS和Windows上。

| 命令 | 它是做什么的 | 为什么会有这个名字 |
| --- | --- | --- |
| `cockpit onboard` | 命名的设置子集：让你登录（电子邮件代码），注册这台机器，开始捕获，上传一次，完成所有历史的Codex和Claude回填保存的批准根，安装15分钟的后台同步，然后打印证明你是活的。 | 你要登船了。 `doctor` 当设置丢失时调用此流；直接重新运行是安全的。部分或失败的回填块准备情况，并具有确切的重试原因。 |
| `cockpit doctor` | 将Mac或Windows PC从空白或已登录状态聚合：最新的CLI，登录设备令牌，保存根，自动启动，历史回填，原始证据GC和新鲜同步。互动首先运行提示邮件OTP和收集根；无头/`--json` 运行explain并退出，而不是阻塞。 `--dry-run` 没有书面的预览。 | 爱德华可以打出一行，每个实习生的机器都应该是绿色的。它检查每一行，修复它，并验证结果。 |
| `cockpit status` | 在一个屏幕中打印安装/登录/捕获/上传运行状况。 | “it is working?”命令。当你不确定的时候就运行它。 |
| `cockpit backfill --all` | 上传你的历史法典+克劳德会议（从驾驶舱存在于这台机器之前）。发现默认深度为3和50个仓库；提高 `--max-depth` 或者 `--max-repos` 当返回的重试命令表示达到上限时。 | 只补一次，所以你过去的工作也算。“回填” =填回目录。 |
| `cockpit sync` | 立即捕获并上传一次。这是后台代理每15分钟运行一次的内容——你几乎不用自己输入。 | 根据其功能命名：将本地会话文件同步到仪表板。 |
| `cockpit analyze` | 运行一个新的同步，然后对最近上传的会话进行队列批处理分析。它立即返回；状态和结果显示在我的工作中。 | 一个命令，当你想要新完成的工作上传和判断现在。 |
| `cockpit start --ticket <id>` | 标记你当前的工作与线性票证，所以会话属性到它。 `--clear-ticket` 返回常规捕获。 | “开始（做）x。”代理通常根据代理规则为您运行此操作。 |
| `cockpit login` / `cockpit pair` | 只需登录+设备注册步骤，独立（板载已经包含它）。在新机器上也可以工作：它首先写一个最小的本地配置（没有收集根-运行） `cockpit onboard` 然后去登记)。两个名字，一个命令： `login` 是人类的猜测， `pair` 是仪表板上的设备屏幕上的名称。 | 当会话过期或切换帐户时，或者在新机器上首次登录时，恢复路径。 |
| `cockpit logout` | 删除此机器的会话。 | 登录的撤销。 |
| `cockpit update` / `cockpit upgrade` | 从npm更新CLI本身，然后在板上重新运行。两个名字，一个命令——别名，因为一半的人都猜对了。 | 的由来;当爱德华宣布有新版本时就跑。 |
| `cockpit install` | 只写入本地配置（板载的第1步，独立）。 | 管道;存在，所以船上的部件是单独运行的。你可能永远都不会打字。 |
| `cockpit sessions` | 只读：列出您观察到的会话以及每个会话的属性。 | 调试“为什么我的会话没有显示？”而不上传任何内容。 |
| `cockpit autostart install|uninstall|status` | 管理macOS启动代理或每用户Windows任务调度任务后的15分钟后台同步。 | 当您需要停止/检查背景片时，可以直接控制它。 |
| `cockpit agent-rules install|uninstall|status` | 管理驾驶舱票务绑定文本块内部 `~/.codex/AGENTS.md` / `~/.claude/CLAUDE.md`. | 这就是“你的探员读过的规则”。被动降价——从来没有一个可执行的钩子。 |
| `cockpit serve` | 运行一个小型的本地HTTP状态服务器。 | 利基：让其他工具询问收集器它做得怎么样。 |
| `cockpit logout`， `cockpit release`， `cockpit admin *` | `release` 发布CLI（维护者，repogated）； `admin` （引导/邀请）完全不在公共构建中。 | 维护表面-实习生从不接触这些。 |

诚实的命名注意事项： `update`/`upgrade` 和 `login`/`pair` 有意使用的同义词别名便宜吗 原谅胜过“找不到命令”)； `install` “写配置”是一个误导性的名字，但是 是为了保持机载步骤的对称性。

## 旗帜

正常设置不需要标志。仅在默认猜测错误时使用标志：

```bash
cockpit onboard --email <you@buildlaunchiterate.ca> --workspace ~/BLI
cockpit onboard --workspace ~/BLI --workspace ~/side-projects
cockpit onboard --device-name "Ian MacBook"
cockpit onboard --no-auth
```

-   `--email` 跳过电子邮件提示。
-   `--workspace` 销一个集合根；对多个不相关的根重复此步骤。
-   从主文件夹进行交互式登录询问是否同步计算机上的所有项目。回答 `y` 只有在公司的机器上收集每一个当前和未来的回购 `$HOME` 目的是。 `n` or Enter要求输入实际的工作文件夹；如果没有选择有效的非主文件夹，座舱不会捕获任何内容并告诉您重新运行 `--workspace <path-to-your-work-folder>`.
-   `--allow-home-root` 是无头/脚本形式的全家福选择。
-   `--device-name` 只改变驾驶舱中显示的人类标签。
-   `--dashboard-url` 仅用于登台/自定义仪表板。生产是默认的。
-   `--no-auth` 强制旧的手动审批队列。
-   `--repo` 仍然是一个遗留的别名 `--workspace`.

`cockpit doctor` 是正常的舰队会聚命令。在交互式首次运行时，它使用与登录相同的电子邮件OTP登录和根选择器流程，然后重新检查机器。在无头，发射， `--json`，或者没有tty运行，它永远不会提示；缺失的authth或根与修复文本保持红色。 `--dry-run` 预览而不写auth或config。

`cockpit update` 安装最新的公共CLI，并根据保存的根重新运行登录检查。 `cockpit upgrade` 是同一个命令。

`cockpit --version`， `cockpit -V`, `cockpit version` 打印已安装的 公共包版本。Windows自动启动的详细信息和验证步骤 [`docs/runbooks/cockpit-windows-task-scheduler-sync.md`](https://npmcn.com/package/docs/runbooks/cockpit-windows-task-scheduler-sync.md).

## 分析最新工作

```bash
cockpit analyze --workspace "$PWD"
```

`cockpit analyze` 首先执行与 `cockpit sync`． 它 只有在上传成功后才对分析进行排队，然后无需等待就退出 用于“烟花”批次。使用 `--json` 的单个机器可读对象 包含同步接收和排队作业状态。仪表板按钮 分析后台收集器已经存储的最新上传；运行 当工作结束时间过短时，执行CLI命令进行15分钟的后台同步。 每个人可以每三小时进行一次队列分析，具体时间取决于团队 共享 `$2` utc日裁判上限。完成可能需要几分钟加上等待 接下来的15分钟收集者投票；“我的工作”显示已排队、正在运行、已完成或 等待时的失败状态。

## 父模式

使用父文件夹，例如 `~/BLI` 当它包含多个repos时。驾驶舱扫描子git的repo /工作树，为每个工作树创建一个稳定的工作上下文，并将它们卷到仪表板中的repo行下。

默认值：3个文件夹级别深，最多50个仓库。与 `--max-depth` 和 `--max-repos`.

## 配对复苏

v2幸福路径自动批准配对后，电子邮件OTP。恢复仍然存在手动审批：

```bash
cockpit onboard --no-auth --email <you@buildlaunchiterate.ca> --workspace ~/BLI
```

当邮箱不可用、认证路由关闭或Edward添加了确切的非域电子邮件例外时，使用该选项。驾驶舱打印URL和代码；Admin审批来自Ambient -> Collector审批。如果代码过期，则重新运行 `cockpit onboard` 批准后，持久访问行将自动配对。

如果这是一个重用的笔记本电脑或虚拟机，保留 `--email` 集。驾驶舱只在现有会话属于相同的电子邮件和仪表板URL时重用它。

## 票的语义

设置是一般的环境捕获。不要发明登机票。

当真正的售票工作开始时：

```bash
cockpit start --ticket <ticket-id> --workspace "$PWD"
cockpit sync --workspace "$PWD" --json
```

对于重要的无票工作：

```bash
cockpit start \
  --workspace "$PWD" \
  --topic "lead ingestion planning" \
  --intent planning \
  --phase discovery \
  --intent-confidence 0.9
```

`cockpit onboard` 中刷新受管理的票绑定指导 `~/.codex/AGENTS.md` 和 `~/.claude/CLAUDE.md` 因此，代理在确认的工作空间内编辑之前绑定可见的线性票。

## 存储布局

本地文件:

-   `~/.config/bli-cockpit/config.json`：仪表板URL，设备标签，集合根。
-   `~/.config/bli-cockpit/session.json`配对的设备令牌和所有者元数据。
-   `~/.local/state/bli-cockpit/spool/`：等待重试的上传。
-   `~/.local/state/bli-cockpit/spool/install-events/`私有原子收集器 等待经过身份验证的交付的健康收据。收据只包含 净化操作元数据，从不使用命令输出或记录内容。
-   `~/.local/state/bli-cockpit/cursors/`：书签显示上传的进度，没有原始内容。
-   `.codex-autorunner/contextspace/active_context.md`： repo中的当前工作上下文。

远程数据:

-   批准的用户/设备标识；
-   repo/worktree指纹，分支，head SHA，可选票证，源代码计数；
-   私人原始证据对象和 `ambient_evidence_refs` 指针;
-   Codex/Claude会话归属元数据。

永远不要向这个CLI提供服务角色密钥、原始DB url、cookie、根环境文件或部署令牌。采集器从不读取env文件，也不收集随机的桌面截图或屏幕记录。

## 调试

```bash
cockpit sessions --workspace "$PWD" --json
cockpit status --workspace "$PWD" --json
cockpit sync --workspace "$PWD" --json
```

`status --json` 包括 `pending_health_receipt_count`， `oldest_pending_health_receipt_at`, `last_health_receipt_failure_reason`． 非零计数意味着驾驶舱保存了A 本地收集器失败，并将在下一次经过身份验证的运行时重播。

如果 `cockpit update` NPM失败 `EACCES`修复Homebrew全局包所有权一次：

```bash
sudo chown -R $(whoami) /opt/homebrew/lib/node_modules/@bli-cockpit /opt/homebrew/bin/cockpit
```

不要使用 `sudo npm i -g`;这又产生了所有权问题。

## 常见问题

### @bli-cockpit/cli 是什么？

驾驶舱会观察你和你的人工智能特工是如何工作的，这样爱德华就可以根据证据而不是屏幕截图和状态ping进行指导。

### 如何安装 @bli-cockpit/cli？

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

### @bli-cockpit/cli 支持 TypeScript 吗？

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

### @bli-cockpit/cli 支持 ESM 还是 CommonJS？

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

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

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

### @bli-cockpit/cli 可以商用吗？

@bli-cockpit/cli 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @bli-cockpit/cli 还在维护吗？

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