# @circleback/cli 中文文档

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

版本：1\.3\.1
npm 元数据更新时间：2026-11-07T01:43:21.724Z
中文译文更新时间：2026-11-09T16:55:06.508Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40circleback/cli
原文对照：https://npmcn.com/package/%40circleback/cli/?lang=original
项目主页：https://circleback.ai/

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

- 包体积（解压后）：129 kB，41 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：5 个
- 首次发布：2026-03-18T02:53:07.781Z
- 最新版本发布：2026-11-07T01:43:21.567Z
- 近 30 天下载量：5428（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：38（近 12 个月 38 个）

## 中文简介

圆背CLI. 搜索和访问会议、电子邮件、日历活动等等.

## 安装

```sh
npm install @circleback/cli
```

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

## README

# 圆背 CLI

搜索和访问您的会议、记录誊本、电子邮件、日历活动以及终端上的其他活动,并管理您的动作项目、标签、文件夹和会议访问.

## 安装

```bash
npm install -g @circleback/cli
```

需要节点.js 18或以后。 软件包安装了两个二进制: `circleback` 财务报告和审定财务报表 `cb` (快手语.

## 快开始

```bash
# Log in with your browser
cb auth login

# Search recent meetings
cb meetings

# Search by keyword
cb meetings "product review"

# Read by ID (from the meeting URL, e.g. circleback.ai/meetings/abc123)
cb meetings read abc123

# Search transcripts
cb transcripts "pricing discussion"

# Search emails
cb emails "from:alice@example.com after:2026-01-01"

# Mark an action item done
cb action-items update 123 --status DONE

# Get raw JSON for scripting
cb meetings --json
```

## 图标

| 命令 | 说明 |
| --- | --- |
| `cb auth login` | 用浏览器登录到 Circleback |
| `cb auth login --api-key` | 登录 API 密钥 |
| `cb auth logout` | 在此设备上签名 |
| `cb update` | 更新 CLI 到最新版本 |
| `cb meetings [search]` | 搜索会议 |
| `cb meetings read <ids...>` | 详细阅读会议信息、说明和行动项目(最多50个) |
| `cb meetings update <id>` | 更新会议 |
| `cb meetings share <id>` | 共享会话或删除访问 |
| `cb transcripts <search>` | 搜索记录内容 |
| `cb transcripts read <ids...>` | 全文阅读(最多50份) |
| `cb calendar` | 搜索日历事件 |
| `cb calendar update <id>` | 更新日历事件 |
| `cb people <names...>` | 搜索人们的名字 |
| `cb companies <terms...>` | 搜索公司名称或域名 |
| `cb emails [search]` | 搜索连接的电子邮件账户 |
| `cb support [search]` | 搜索回转支持文章 |
| `cb action-items [search]` | 搜索动作项目 |
| `cb action-items create <title>` | 创建动作项目 |
| `cb action-items update <id>` | 更新一个行动项目 |
| `cb action-items delete <id>` | 删除动作项目 |
| `cb teams` | 列出您的工作空间和团队 |
| `cb tags` | 列表标签 |
| `cb tags create <name>` | 创建标签 |
| `cb tags update <id>` | 更新标签 |
| `cb tags delete <id>` | 删除标签 |
| `cb folders` | 列表文件夹 |
| `cb folders read <ids...>` | 读取文件夹 |
| `cb folders create <name>` | 创建文件夹 |
| `cb folders update <id>` | 更新文件夹 |
| `cb folders delete <id>` | 删除文件夹 |
| `cb folders share <id>` | 共享文件夹 |

运行 `cb --help` 或者说 `cb <command> --help` 完全使用细节.

## 会议标识符

`cb meetings read` 财务报告和审定财务报表 `cb transcripts read` 接受最多50个会面身份证.

## 过滤

会议、记录和日历搜索支持按日期范围过滤。 通过标签、个人和公司进行过滤:

```bash
cb meetings --tags 1,2 --profiles 42 --domains acme.com
cb meetings --last 30              # Last 30 days
cb meetings --from 2026-01-01 --to 2026-03-01
cb calendar --last 7                # Next 7 days of events
```

电子邮件搜索支持内置过滤语法 :

```bash
cb emails "from:alice@example.com"
cb emails "to:bob@example.com after:2026-01-01"
cb emails "participant:carol@example.com before:2026-06-01"
```

## JSON 输出

过 `--json` 以获取原始 JSON 而非格式化表格。 用于管道 `jq` 或与其他工具相融合:

```bash
cb meetings "standup" --json | jq '.[].name'
```

## 登录

```bash
cb auth login              # Opens your browser to log in
cb auth login --api-key    # Asks for your API key securely
cb auth logout             # Signs out on this device
```

API 密钥登录链接到 [设置 ~ API 密钥](https://circleback.ai/settings?tab=api-access),验证密钥,并将其保存在您的设备上.

对于无国籍的自动化,设置 `CIRCLEBACK_API_KEY` 而不是登录在 :

```bash
CIRCLEBACK_API_KEY=cb_your_api_key cb meetings --json
```

更改会议、动作项目、标签、文件夹或共享权限需要写入权限。 浏览器在v0.5.0 之前登录, 不包含它, 所以运行 `cb auth login` ; 只读的 API 密钥无法更改 .

限于一个文件夹的 API 密钥只到达文件夹的会议、记录和动作项目,所以 `cb --help` 仅列出可以运行的命令.

`CIRCLEBACK_API_KEY` 优先于存储的证书。 运行前取消它 `cb auth login`· ; `cb auth logout` 无法从外壳中清除环境变量.

## 探员

CLI旨在与AI代理和工具使用系统良好地合作:

-   每个命令都接受 `--json` 用于结构化、可解析的产出
-   命令跟随一致 `<resource> <action>` 模式
-   所有选项都有长式名称以明确
-   错误消息包括可操作指令
-   退出代码遵循标准惯例(0=成功,1=出错)

## 链接

-   [倒转](https://circleback.ai/)
-   [支助](https://circleback.ai/docs/support)

## 常见问题

### @circleback/cli 是什么？

圆背CLI\. 搜索和访问会议、电子邮件、日历活动等等\.

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

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

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

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

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

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

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

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

### @circleback/cli 的下载量有多少？

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

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

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