# @beads/bd 中文文档

规范地址：https://npmcn.com/package/%40beads/bd/

版本：1\.3\.4
npm 元数据更新时间：2026-11-04T09:29:34.827Z
中文译文更新时间：2026-11-07T19:34:13.732Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：18.1 kB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=14\.0\.0
- 运行依赖：0 个
- 首次发布：2025-11-03T18:39:03.362Z
- 最新版本发布：2026-11-04T09:29:34.403Z
- 近 30 天下载量：42520（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：76（近 12 个月 71 个）

## 中文简介

Beads 发行跟踪器 - 有本地二进制支持的编码代理的轻量级内存系统

## 安装

```sh
npm install @beads/bd
```

也可以使用：`pnpm add @beads/bd`、`yarn add @beads/bd`、`bun add @beads/bd`

## README

# @ 蜂窝/ bd - 蜂窝问题跟踪器

[![npm version](https://img.shields.io/npm/v/@beads/bd)](https://www.npmjs.com/package/@beads/bd) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**给您的编码代理一个内存升级**

Beads是一个用于编码代理的轻量级内存系统,使用以图表为基础的问题跟踪器. 这个npm软件包为Node.js环境,包括Claude Code for Web,提供了方便的本地bd 二进制安装.

## 安装

```bash
npm install -g @beads/bd
```

或作为一个项目依赖:

```bash
npm install --save-dev @beads/bd
```

## 贝兹是什么?

Beads是专为AI编码代理设计的问题跟踪器. 它规定:

-   ✨ **零设置** - 说吧 `bd init` 创建项目本地数据库
-   🔗 **依赖性跟踪** - 四种依赖类型(块、相干、亲子、从中发现)
-   📋 **准备工作检测** - 自动查找没有打开阻断器的问题
-   🤖 **方便探员** - 说吧 `--json` 方案整合旗帜
-   📦 **版本控制** - 具有完整历史和分支的多尔特数据库
-   🌍 **按设计分配** - 通过 Dolt 远程共享一个逻辑数据库

## 快速启动

在安装后, 在您的工程中初始化 :

```bash
bd init
```

然后告诉你的 AI 代理 使用 bd 来进行任务跟踪 而不是 标记下 :

```bash
echo "Use 'bd' commands for issue tracking instead of markdown TODOs" >> AGENTS.md
```

您的代理将自动 :

-   工作期间创建和跟踪问题
-   管理任务之间的依赖性
-   找到工作准备 `bd ready`
-   各届会议保持长期背景

## 常见命令

```bash
# Find ready work
bd ready --json

# Create an issue
bd create "Fix bug" -t bug -p 1

# Show issue details
bd show bd-a1b2

# List all issues
bd list --json

# Start work
bd update bd-a1b2 --claim

# Add dependency
bd dep add bd-f14c bd-a1b2

# Close issue
bd close bd-a1b2 --reason "Fixed"
```

## Claude 网络整合代码

要将 Claude 代码中的 bd 自动安装到 Web 会话中, 请添加到您的会话启动钩头 :

```bash
# .claude/hooks/session-start.sh
npm install -g @beads/bd
bd init --quiet
```

这将确保每个新会话中都有bd,而无需手工设置.

## 平台支持

此软件包为您的平台下载适当的本地二进制 :

-   **马科斯**: darwin-amd64, darwin-arm64 (英语)
-   **链接**: linux-amd64, linux-arm64 (英语)
-   **窗口**: 窗口-amd64

## 完整文档

关于完整的文件,见 [珠子 GitHub 仓库](https://github.com/gastownhall/beads)数字 :

-   [完成读取](https://github.com/gastownhall/beads#readme)
-   [快速启动( 文件站点)](https://beads.gascity.com/getting-started/quickstart) • 妇女 [in- repo 源码](https://github.com/gastownhall/beads/blob/main/docs/getting-started/quickstart.md)
-   [安装指南](https://github.com/gastownhall/beads/blob/main/docs/getting-started/installation.md)
-   [财务问题](https://github.com/gastownhall/beads/blob/main/docs/reference/faq.md)
-   [解决问题](https://github.com/gastownhall/beads/blob/main/docs/reference/troubleshooting.md)

## 为什么Npm包对WASM?

Npm 软件包将本地的 bd 二进制包包起来, 而不是使用 Web Assembly , 因为 :

-   QQ 完整 SQLite 支持( 不需要自定义 VFS)
-   所有特性都与本地 bd 相同
-   性能好(本土对WASM间接费用)
-   \* 较简单的维护

## 许可证

麻省理工学院-见 [自由主义](https://npmcn.com/package/%40beads/bd/LICENSE) 详细情况.

## 支助

-   [GitHub 问题](https://github.com/gastownhall/beads/issues)
-   [文档](https://github.com/gastownhall/beads)

## 常见问题

### @beads/bd 是什么？

Beads 发行跟踪器 - 有本地二进制支持的编码代理的轻量级内存系统

### 如何安装 @beads/bd？

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

### @beads/bd 支持 TypeScript 吗？

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

### @beads/bd 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @beads/bd 需要什么版本的 Node\.js？

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

### @beads/bd 可以商用吗？

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

### @beads/bd 的下载量有多少？

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

### @beads/bd 还在维护吗？

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