# @beeai/cli 中文文档

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

版本：0\.9\.0
npm 元数据更新时间：2026-10-21T17:11:54.296Z
中文译文更新时间：2026-11-07T23:06:47.043Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：431 MB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-02-04T21:07:07.867Z
- 最新版本发布：2026-10-21T17:11:54.023Z
- 近 30 天下载量：2089（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：16（近 12 个月 16 个）

## 中文简介

蜜蜂电脑的CLI客户端

## 安装

```sh
npm install @beeai/cli
```

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

## README

![Bee Rounded@2x](https://github.com/user-attachments/assets/d24ad62a-aad7-487a-a634-efde561194fe)

# BE AI 的 CLI 客户端

[🌐 **网站**](https://bee.computer/) 二. 支助 [📱 **iOS 应用程序**](https://apps.apple.com/us/app/bee-your-personal-ai/id6480349491) 二. 支助 [🤖 **Android 应用程序**](https://play.google.com/store/apps/details?id=com.bee.android&hl=en_US) 二. 支助 [🧩 **特工技能**](https://github.com/bee-computer/bee-skill)

CLI 客户端 [蜜蜂](https://www.bee.computer/) ——可穿戴的人工智能,能捕捉你的谈话并了解你.

> \[大 要使用 CLI , 您必须安装最新的 Be app 并启用开发者模式, 在 Sets 中使用 app 版本 5 次 .

## 怎么会这样?

蜜蜂是个 **加密** 可穿戴的个人AI设备,静静地坐在背景中,捕捉到您一整天的对话和经验. 它记录和加密了您的数据,只提供给您。 然后在安全计算单元内,它将环境上下文转换为:

-   **谈话记录** 使用扬声器识别
-   **每日摘要** 活动和讨论情况
-   **事实** - 事情BE学会和记得你
-   **待办事项** 从您的谈话中提取的动作项目
-   **个人见解** 和模式

蜂能理解40+语言,特征是14天的电池活,并与iOS应用程序合作,为您提供一个可搜索,AI动力的人生记忆.

## 为什么是蜜蜂CLI?

Bee CLI 将您的个人数据导出为平分文件, 并提供给:

-   **AI探员**:给克洛德,GPT,或其他助手你的个人背景,让他们更有效地帮助你
-   **本地搜索**: 使用 grep, riggrep, 或您的编辑器搜索您所有的对话
-   **备份**: 保留一个便携式的、离线的BE数据副本
-   **自定义集成**: 以您的对话历史、事实和待办事宜构建工作流程

## 使用带有 AI 助手的 Bee( MCP)

蜜蜂CLI也是个 [示范背景协议](https://modelcontextprotocol.io/) 服务器,因此克劳德和Codex等助手可以读取你的Bee语境——搜索对话,查找事实和待办事宜,取取出每日摘要——直接,将您的数据留在你的机器上.

一步内连接到客户端 :

```bash
bee mcp connect claude          # Claude Desktop (one-click install)
bee mcp connect claude-code     # Claude Code (CLI)
bee mcp connect codex           # Codex
bee mcp status                  # show what's connected
bee mcp disconnect claude-code  # remove
```

服务器通过您已有的 Bee 登录进行认证—— 没有额外的符号管理 。 直接使用其中一种运算方式

```bash
bee mcp serve                   # stdio JSON-RPC (what the connectors launch)
bee mcp serve-http [--port N]   # local HTTP, 127.0.0.1, bearer-token auth
```

> \[注\] `serve-http` 仅与本地主机绑定, 并需要一个认证符, 提供 `--token` 或 `BEE_MCP_HTTP_TOKEN` 环境变量(至少32个字符). 客户端发送为 `Authorization: Bearer <token>`。 。 。 .

以下每个读取、搜索和管理能力都作为MCP工具曝光(`bee_search`, (中文(简体) ), `bee_list_facts`, (中文(简体) ), `bee_get_daily_summary`,所以CLI和你的助手工作 从相同的数据.

对于Bee测试用户来说,线程工具允许一个助手与Bee代理聊天: `bee_create_thread`, (中文(简体) ), `bee_send_thread_message`, (中文(简体) ), `bee_wait_thread`, (中文(简体) ), `bee_list_threads`, (中文(简体) ), `bee_get_thread_messages`,以及 `bee_abort_thread`,发送工具附加本地文件(`file_paths`)或内置碱基64文件(`inline_files`) (中文(简体) ). 他们等着 `timeout_seconds` (default 45,在大约60秒的限制下,许多MCP客户提供工具呼叫;); `0` 发送不等待。 每个结果都有 `status`, (中文(简体) ), `thread_id`, (中文(简体) ), `message_id`,和(发送) `client_message_id` 在顶层。 何时 `status` 实值 `pending`电话 `bee_wait_thread` 和那些IDs继续等待。 若为 `message_id` 无效,Bee没有及时确认发送。 使用相同的调用发送工具 `client_message_id`;这样可以恢复信息,从不重复发送. 如果一个工具呼叫被切断, `bee_wait_thread` 仅限 `thread_id` 继续等待,并 `bee_list_threads` 找到一条新线.

## 安装

从 npm 安装 :

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

或从发布页面下载最新发布或从来源构建.

## 使用量

```bash
bee <command> [options]
```

## 图书馆(节点)

您也可以导入一个小库包, 将外壳切入到 `bee` 二进制 并使用 JSON 输出旗帜。 这在Node.js运行. 保证 `bee` 交给你了 `PATH`,或者通过习惯 `command` 创建客户端时的路径.

```ts
import { createBeeClient } from "@beeai/cli/lib";

const bee = createBeeClient();
const profile = await bee.api.me();

// Test users: chat with the Bee agent; keep waiting while status is "pending".
type Answer = { status: string; thread_id: string; message_id: string; text?: string };
let answer = await bee.api.threads.create<Answer>({ text: "Plan my day", timeout: 120 });
while (answer.status === "pending") {
  answer = await bee.api.threads.wait<Answer>(answer.thread_id, { after: answer.message_id });
}

const stream = bee.sse.streamJson({ types: ["new-utterance"] });
for await (const event of stream.events) {
  console.log(event.data);
}
```

## 图标

默认情况下,数据命令返回标记下. 使用 `--json` 打印生JSON.

-   `login` - 互动登录,与 `--token <token>` 编号 : `--token-stdin`,或通过代理 `--proxy <url|socket>`启用 `--no-wait` 立即打印认证链接并退出,而不是进行投票供批准(对代理/自动化有用;稍后用完) `bee status` 或者通过重新运行 `bee login`) (中文(简体) ).
    
-   `status` - 显示当前认证状态 .
    
-   `logout` - 清除和清除储存的证书.
    
-   `me` - 获取您的用户简介 。 使用 `--json` jSON的输出.
    
-   `today` - 获取今天的简介(日历事件和电子邮件) 。 使用 `--context` 可穿戴的蜜蜂上下文(每日摘要、活起的待办事宜、笔记、谈话)改为 `--json` jSON的输出.
    
-   `now` - 获取过去10小时的谈话 与语音。 使用 `--json` jSON的输出.
    
-   `activity` - 展示最近的活动,包括对话、摘要、笔记、待办事宜和见解。 选项 : `--limit N`, (中文(简体) ), `--json`。 。 。 .
    
-   `changed` - 获取最近的更改( 默认为持续24小时) 。 使用 `--cursor <cursor>` 财务报告和审定财务报表 `--json` jSON的输出.
    
-   `stream` - 流出实时活动。 选项 : `--types <list>`, (中文(简体) ), `--json`, (中文(简体) ), `--agent`, (中文(简体) ), `--webhook-endpoint <url>`, (中文(简体) ), `--webhook-body <template>`。 。 。 .
    
-   `facts` - 管理你的事实(Bee记得你的事).
    
    -   `facts list` - 列出事实 选项 : `--limit N`, (中文(简体) ), `--cursor <cursor>`, (中文(简体) ), `--unconfirmed`, (中文(简体) ), `--json`。 。 。 .
    -   `facts get <id>` - 获取一个具体的事实。 选项 : `--json`。 。 。 .
    -   `facts create --text <text>` - 创造出一个新的事实。 选项 : `--json`。 。 。 .
    -   `facts update <id>` - 更新事实。 选项 : `--text <text>` (省去时保留了现有案文), `--confirmed <true|false>`, (中文(简体) ), `--json`。 。 。 .
    -   `facts confirm <id>` - 确认事实 `confirmed=true`在保留其现有案文的同时。 选项 : `--json`。 。 。 .
    -   `facts delete <id>` - 删除一个事实。 选项 : `--json`。 。 。 .
    -   `facts search --query <text>` - 搜索保存的事实。 选项 : `--limit N`, (中文(简体) ), `--json`。 。 。 .
-   `todos` - 管理好你的待办事.
    
    -   `todos list` - 列出待办事宜。 选项 : `--limit N`, (中文(简体) ), `--cursor <cursor>`, (中文(简体) ), `--json`。 。 。 .
    -   `todos get <id>` - 找个具体的工作 选项 : `--json`。 。 。 .
    -   `todos create --text <text>` - 创建一个新的待办事宜。 选项 : `--alarm-at <iso>`, (中文(简体) ), `--json`。 。 。 .
    -   `todos update <id>` - 更新一个待办事宜 选项 : `--text <text>`, (中文(简体) ), `--completed <true|false>`, (中文(简体) ), `--alarm-at <iso>`, (中文(简体) ), `--clear-alarm`, (中文(简体) ), `--json`。 。 。 .
    -   `todos complete <id>` - 标记一个待办事宜完成。 选项 : `--json`。 。 。 .
    -   `todos delete <id>` - 删除一个待办事宜。 选项 : `--json`。 。 。 .
    -   `todos suggestions` - 列出蜜蜂推荐的待办事宜 选项 : `--limit N`, (中文(简体) ), `--json`。 。 。 .
    -   `todos accept-suggestion <id>` - 接受一个建议做, 把它变成一个真正的做。 选项 : `--json`。 。 。 .
    -   `todos dismiss-suggestion <id>` - 解除一个建议做的工作。 选项 : `--json`。 。 。 .
-   `conversations` - 获取你的录音谈话.
    
    -   `conversations list` - 名单对话。 选项 : `--limit N`, (中文(简体) ), `--cursor <cursor>`, (中文(简体) ), `--json`。 。 。 .
    -   `conversations get <id>` - 得到一个具体的谈话 与完整的记录。 选项 : `--json`。 。 。 .
    -   `conversations transcript <id>` - 把记录稿拿来 使用 `--since <epochMs>` 仅返回在特定时间或之后(划一毫秒)所发表的言论——方便投票,只提供新言论的实况记录。 选项 : `--since <epochMs>`, (中文(简体) ), `--json`。 。 。 .
    -   `conversations related <id>` - 找到一个相关的谈话 选项 : `--limit N`, (中文(简体) ), `--json`。 。 。 .
-   `daily` - 每日查阅活动摘要.
    
    -   `daily list` - 列出每日摘要。 选项 : `--limit N`, (中文(简体) ), `--cursor <cursor>`, (中文(简体) ), `--json`。 。 。 .
    -   `daily get <id>` - 获得具体每日摘要。 选项 : `--json`。 。 。 .
    -   `daily find <YYYY-MM-DD>` - 找到约会的每日摘要 选项 : `--json`。 。 。 .
-   `journals` - 打开你的日记.
    
    -   `journals list` - 列出日记。 选项 : `--limit N`, (中文(简体) ), `--cursor <cursor>`, (中文(简体) ), `--json`。 。 。 .
    -   `journals get <id>` - 找一份特定的日记 选项 : `--json`。 。 。 .
    -   `journals search --query <text>` - 搜索语音笔记/日记条目。 选项 : `--limit N`, (中文(简体) ), `--json`。 。 。 .
-   `insights` - 访问 蜜蜂对你的看法.
    
    -   `insights list` - 列出最近的见解 选项 : `--limit N`, (中文(简体) ), `--cursor <cursor>`, (中文(简体) ), `--json`。 。 。 .
    -   `insights get <id>` - 获取一个具体的见解。 选项 : `--json`。 。 。 .
-   `locations` - 进入你去过的地方.
    
    -   `locations clusters` - 显示按访问频率分组的地方。 选项 : `--limit N`, (中文(简体) ), `--min-visits N`, (中文(简体) ), `--visits`, (中文(简体) ), `--json`。 。 。 .
    -   `locations recent` - 显示最近的个人访问。 选项 : `--from <date>`, (中文(简体) ), `--to <date>`, (中文(简体) ), `--limit N`, (中文(简体) ), `--json`。 。 。 .
    -   `locations current` - 显示你最新的位置 选项 : `--json`。 。 。 .
-   `photos` - 访问照片同步 从你的相册.
    
    -   `photos list` - 列出照片,最新的第一。 选项 : `--daily-id N`, (中文(简体) ), `--date YYYY-MM-DD`, (中文(简体) ), `--limit N`, (中文(简体) ), `--json`。 。 。 .
    -   `photos get <id>` - 下载一张照片。 选项 : `--output <path>`, (中文(简体) ), `--json`。 。 。 .
-   `search` - 搜索你的蜜蜂数据.
    
    -   `search --query <text>` - 关键词搜索(默认)包括对话、每日摘要和事实。 范围 `--filter conversations|daily|facts|all` 顺序与 `--sort relevance|mostRecent`启用 `--neural` 用于语义性对话搜索(仅限对话); `--filter`编号 :`--sort` (不适用)。 按时间对任一模式进行约束 `--since`编号 :`--until` (epoch milli seconds) (英语). 选项 : `--limit N`, (中文(简体) ), `--json`。 。 。 .
-   `threads` - 用线程与蜜蜂代理商聊天(只限蜜蜂测试用户).
    
    -   `threads list` - 列出其编号、名称和状态的线索(`idle` 或者说 `running`选项 : `--json`。 。 。 .
    -   `threads create --text <text>` - 启动一条新线 以第一个消息等待答案。 选项 : `--photo <path>` 财务报告和审定财务报表 `--file <path>` (可重复;先上传,每封信最多20个,每封信25个MB), `--timeout <duration>`, (中文(简体) ), `--client-message-id <id>`, (中文(简体) ), `--json`。 。 。 .
    -   `threads send <thread-id> --text <text>` - 给一条已有的线条发送信息,等待答案。 与 `create`。 。 。 .
    -   `threads wait <thread-id>` - 继续等答案 等待线程的最新用户消息后, 或者等待 `--after <message-id>`选项: `--after <message-id>`, (中文(简体) ), `--timeout <duration>`, (中文(简体) ), `--json`。 。 。 .
    -   `threads messages <thread-id>` - 显示线条的信息,最古老的第一。 选项 : `--limit N` (最新N), `--json`。 。 。 .
    -   `threads abort <thread-id>` - 停止特工当前在线上的工作。 选项 : `--json`。 。 。 .
    
    `--timeout` 约束整个发送和等待,例如. `30s`, (中文(简体) ), `5m`,或 `1h` (赤数为秒. 默认为 `90s`,以及 `0` 发送不等待。 服务器等待, HTTP 超时, 并在最后期限前全部结束 。 唯一的例外是发送本身: 它总是得到至少10秒,所以 `0` 仍然传递信息。 上传是先上传的,不计数。 更长时间的等待被分为最多55秒的服务器呼叫. 当答案没有及时准备好时,命令仍然成功:它打印出线程 id,消息 id, `status: pending`,则a `bee threads wait <thread-id>` 指点 A 类 `stalled` 状态表示代理人有一段时间没有报告进度:再次等待,或中止并再次发送。 答案文本首先出现在降标输出; `--json` 打印全部有效载荷( y)`status`, (中文(简体) ), `thread_id`, (中文(简体) ), `message_id`, (中文(简体) ), `client_message_id`, (中文(简体) ), `hint`, (中文(简体) ), `text`, (中文(简体) ), `messages`, (中文(简体) ), `files`) (中文(简体) ).
    
    每次发送都带有 `client_message_id`生成,除非您通过 `--client-message-id`。打印后,信件可能存有每个结果和任何错误。 重复重用它,所以一个消息从来没有发出过两次. 重运行同一命令 `--client-message-id <id>` 恢复信息而不是发送新的信息。 上面还写着BE没有及时确认 `message_id: (not confirmed)`。重新运行 `create` 以相同的ID返回相同的线程. 照片和文件在消息发送前上传;如果有任何上传失败,则不发送. 在Bee应用中附设它们需要Be代理的同意.
    
-   `mcp` - 运行或连接 MCP 服务器(参见 [使用配有 AI 助手的 Bee](https://npmcn.com/package/%40beeai/cli/#readme-use-bee-with-ai-assistants-mcp)。子命令 : `serve`, (中文(简体) ), `serve-http [--port N] [--token VALUE]`, (中文(简体) ), `connect|disconnect <claude|claude-code|codex>`, (中文(简体) ), `status`。 。 。 .
    
-   `sync` - 把你的蜜蜂数据导出给AI探员 重跑是默认的递增(只有更改了的每日摘要,对话,和见解被重提). 选项 : `--output <dir>`, (中文(简体) ), `--recent-days N`, (中文(简体) ), `--only <facts|todos|daily|conversations|insights>`, (中文(简体) ), `--full`, (中文(简体) ), `--since <epochMs>`。 。 。 .
    
-   `proxy` - 开始本地的Bee API代理。 选项 : `--port N`, (中文(简体) ), `--socket [path]`, (中文(简体) ), `--idle-timeout SECONDS`。 。 。 .
    
-   `ping` - 运行快速连接检查。 使用 `--count N` 重复一遍 重复一遍.
    
-   `version` - 打印CLI版本。 使用 `--json` jSON的输出.
    

## 代理认证

当另一个可信任的本地进程处理 Bee API 认证时使用代理认证,而这个 CLI 应该通过它发送请求.

### 配置代理模式

```bash
# HTTP proxy
bee login --proxy http://127.0.0.1:8787

# Unix socket proxy
bee login --proxy ~/.bee/proxy.sock
```

这将代理配置保存到 `~/.bee/proxy-{env}.json`。当代理配置存在时,它优先于存储的代号认证.

### 启动本地代理服务器

```bash
# TCP listener (default auto-picks from 8787)
bee proxy
bee proxy --port 8787
bee proxy --idle-timeout 300

# Unix socket listener (default: ~/.bee/proxy.sock)
bee proxy --socket
bee proxy --socket /tmp/bee-proxy.sock
```

Bee Proxy设定了 Bun的服务器空闲超时,默认为120秒. 使用 `--idle-timeout SECONDS` 用于大型出口,或 `--idle-timeout 0` 以禁用闲置请求超时。 在套接字模式下, CLI 将删除 stale 套接字 在监听前的文件 .

## 串流事件

使用 `bee stream` 以接收服务器发送事件。 您可以过滤事件 `--types` (合并分离)或通过 `--types all` 以获得一切。 每个 事件包括 `event` 名字和一个JSON `data` 载荷.

使用 `--agent` 用于单行、方便代理的输出,例如: `Event new-utterance: [speaker_1] "Hello there" conv=uuid-string`。 。 。 . Webhook 模板使用相同的方便代理信件 `{{message}}`。 。 。 .

以下是事件类型和CLI预期/打印的有效载荷字段.

### 已连接

溪相接而发. 这个 `data` 有效载荷一般为空或被忽略.

### 新发作

新笔录片段.

有效载荷 :

```json
{
  "utterance": {
    "text": "Hello there",
    "speaker": "speaker_1"
  },
  "conversation_uuid": "uuid-string"
}
```

### 新对话

对话被创造.

有效载荷 :

```json
{
  "conversation": {
    "id": 123,
    "uuid": "uuid-string",
    "state": "processing",
    "title": "Optional title"
  }
}
```

### 更新对话

对话更新 .

有效载荷 :

```json
{
  "conversation": {
    "id": 123,
    "state": "processed",
    "title": "Optional title",
    "short_summary": "Optional short summary"
  }
}
```

### 更新-对话-摘要

更新了简短摘要.

有效载荷 :

```json
{
  "conversation_id": 123,
  "short_summary": "Summary text"
}
```

### 删除对话

对话被删除 .

有效载荷 :

```json
{
  "conversation": {
    "id": 123,
    "title": "Optional title"
  }
}
```

### 更新位置

对话位置更新 .

有效载荷 :

```json
{
  "conversation_id": 123,
  "location": {
    "latitude": 37.77,
    "longitude": -122.41,
    "name": "Optional name"
  }
}
```

### 已创建

托多创建.

有效载荷 :

```json
{
  "todo": {
    "id": 10,
    "text": "Call dentist",
    "completed": false,
    "alarmAt": 1700000000000
  }
}
```

### 任务更新

更新了todo(与todo-created相同的有效载荷).

### 待办事项已删除

待办删除 .

有效载荷 :

```json
{
  "todo": {
    "id": 10,
    "text": "Optional text"
  }
}
```

### 日记创建

创刊.

有效载荷 :

```json
{
  "journal": {
    "id": 55,
    "state": "processed",
    "text": "Optional raw text",
    "aiResponse": {
      "message": "Optional assistant message",
      "cleanedUpText": "Optional cleaned text",
      "followUp": "Optional follow up",
      "todos": ["Optional todo"]
    }
  }
}
```

### 日记更新

期刊更新(与期刊创建时的有效载荷相同).

### 日记已删除

杂志被删除.

有效载荷 :

```json
{
  "journalId": 55,
  "reason": "Optional reason"
}
```

### 日记文本

原始日记文本流入(例如作为语音注释被转录).

有效载荷 :

```json
{
  "journalId": 55,
  "text": "Optional raw text"
}
```

## 同步命令

这个 `sync` 命令将您的全部 BE 数据导出到本地目录中,作为下标记文件.

### 使用量

```bash
bee sync [--output <dir>] [--recent-days N] [--only <facts|todos|daily|conversations|insights>] [--full] [--since <epochMs>]
```

第一次同步后, 重新运行 `bee sync` 在同一输出目录上是 **递增**:它只重排日常摘要,谈话,和 自上次行动以来,人们的洞察力有所改变, 因为他们是小的。 同步状态被跟踪于 a `.bee-sync.json` 显示 输出目录内; 删除它( 或目录) 以强制完整 复作是语.

### 选项

| 选项 | 默认 | 说明 |
| --- | --- | --- |
| `--output <dir>` | `bee-sync` | 同步文件输出目录 |
| `--recent-days N` | 全部 | 将每日摘要、谈话和见解限制在最后N天(事实和待办事宜总是完全同步)。 仅适用于全同步; 在递增运行时被忽略 |
| `--only <targets>` | 全部 | 限制同步到逗号分隔列表 : `facts`, (中文(简体) ), `todos`, (中文(简体) ), `daily`, (中文(简体) ), `conversations`, (中文(简体) ), `insights` (或 `all`(中文(简体) ) |
| `--full` | 关 | 强制完全重同步, 忽略已保存的列表, 用新光标重写 |
| `--since <epochMs>` | —— 说 | 高级/ 回收: 覆盖已保存的增量光标, 并加一个明确 oc- milli seconds 时间戳, 用于改变消息驱动的目标 |

### 输出结构

```
bee-sync/
├── facts.md              # All facts (confirmed and pending)
├── todos.md              # All todos (open and completed)
├── daily/
│   └── YYYY-MM-DD/       # One folder per day
│       └── summary.md    # Daily summary
├── conversations/
│   └── YYYY-MM-DD/       # One folder per day
│       ├── 123.md        # Individual conversation files
│       ├── 456.md
│       └── ...
└── insights/
    └── YYYY-MM-DD/       # One folder per day the insight was generated
        └── 789.md        # Individual insight files
```

### 文件格式

#### 事实

包含您的所有事实 由确认身份.

```markdown
# Facts

## Confirmed

- Fact text here [tag1, tag2] (2024-01-15T10:30:00.000Z, id 42)
- Another fact (2024-01-14T08:00:00.000Z, id 41)

## Pending

- Unconfirmed fact (2024-01-16T12:00:00.000Z, id 43)
```

每个事实条目包括:

-   事实文本
-   括号中的标记(如果有)
-   ISO 8601格式的创建时间戳
-   独一无二的事实 ID

#### 待办事宜

包含您按完成状态排列的所有待办事宜 .

```markdown
# Todos

## Open

- Buy groceries (id 10, created 2024-01-15T09:00:00.000Z, alarm 2024-01-16T18:00:00.000Z)
- Call dentist (id 11, created 2024-01-15T10:00:00.000Z)

## Completed

- Finish report (id 9, created 2024-01-14T08:00:00.000Z)
```

每个待办事宜条目包括:

-   待办文本
-   唯一待办事宜 ID
-   创建时间戳
-   提醒时间( 如果设置)

#### 每日/YYY-MM-DD/摘要.md

每日摘要,载有当天的概况.

```markdown
# Daily Summary — 2024-01-15

- id: 100
- date_time: 2024-01-15T00:00:00.000Z
- created_at: 2024-01-16T02:00:00.000Z
- conversations_count: 5

## Short Summary

Brief overview of the day's activities.

## Summary

Detailed summary of conversations and events.

## Email Summary

Summary of email activity (if available).

## Calendar Summary

Summary of calendar events (if available).

## Locations

- 123 Main St, City (37.77490, -122.41940)
- Coffee Shop (37.78500, -122.40900)

## Conversations

- 123 (2024-01-15T09:00:00.000Z - 2024-01-15T09:30:00.000Z) — Meeting with team
- 124 (2024-01-15T14:00:00.000Z - 2024-01-15T14:15:00.000Z) — Quick chat
```

#### 对话/YYYY-MM-DD/ID.md

个人谈话记录 详细内容.

```markdown
# Conversation 123

- start_time: 2024-01-15T09:00:00.000Z
- end_time: 2024-01-15T09:30:00.000Z
- device_type: ios
- state: processed
- created_at: 2024-01-15T09:00:00.000Z
- updated_at: 2024-01-15T10:00:00.000Z

## Short Summary

Brief description of the conversation.

## Summary

Detailed summary of what was discussed.

## Primary Location

- 123 Main St, City (37.77490, -122.41940)
- created_at: 2024-01-15T09:00:00.000Z

## Suggested Links

- https://example.com/resource (2024-01-15T09:15:00.000Z)

## Transcriptions

### Transcription 456
- realtime: false

- Speaker 1: Hello, how are you?
- Speaker 2: I'm doing well, thanks!
```

每个对话文件包括:

-   元数据( 时间戳、 设备类型、 状态)
-   简短和详细摘要
-   坐标为主位置
-   从谈话中提取的建议链接
-   带有扬声器标签的全文复制

#### 见解/YYY-MM-DD/ID.md

个人见解 蜜蜂为你而生.

```markdown
# Insight 789 — Morning focus blocks

- id: 789
- generated_at: 2024-01-15T16:00:00.000Z

## Description

You do your deepest work before 11am on days without early meetings.

## Suggested Actions

- Block 9-11am for focused work on Tuesdays and Thursdays.
```

无法同步显示您在应用程序中被解职或标记不准确 。 A 类 `## Corrections` 一节在有更正之处时添加.

### 实例

同步到默认目录 :

```bash
bee sync
```

同步到自定义目录 :

```bash
bee sync --output ~/Documents/bee-backup
```

只同步特定数据 :

```bash
bee sync --only facts,todos
```

将每日摘要和谈话限制在过去7天:

```bash
bee sync --recent-days 7
```

### 页:1

-   第一个同步( 或 `--full`收集一切; 事实和待办事情总是被完全重提
-   重复运行是渐进的:只有每日的总结、谈话和自上次运行以来变化的洞察力被重新绘制,通过运行跟踪 `.bee-sync.json` 在输出目录中显示
-   对话与每日摘要同时取取,以更快同步
-   所有时间戳都采用ISO 8601格式(UTC)
-   输出目录如果不存在则创建
-   已更改项目的现有文件已覆盖; 删除内容未对齐, 因此服务器上后来删除的项目的本地文件将保留到 `--full` 重新同步到新目录

## 许可证

麻省理工学院

## 常见问题

### @beeai/cli 是什么？

蜜蜂电脑的CLI客户端

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

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

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

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

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

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

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

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

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

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

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

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