@beads/bd

中文文档
1.3.4发布于 2026/11/04MITCommonJS零依赖构建来源已验证近 30 天下载 4.3万

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

中文使用文档
文档目录10 节
  1. 安装
  2. 贝兹是什么?
  3. 快速启动
  4. 常见命令
  5. Claude 网络整合代码
  6. 平台支持
  7. 完整文档
  8. 为什么Npm包对WASM?
  9. 许可证
  10. 支助

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

npm version License: MIT

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

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

安装

npm install -g @beads/bd

或作为一个项目依赖:

npm install --save-dev @beads/bd

贝兹是什么?

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

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

快速启动

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

bd init

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

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

您的代理将自动 :

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

常见命令

# 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 会话中, 请添加到您的会话启动钩头 :

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

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

平台支持

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

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

完整文档

关于完整的文件,见 珠子 GitHub 仓库数字 :

为什么Npm包对WASM?

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

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

许可证

麻省理工学院-见 自由主义 详细情况.

支助

版本与发布记录

@beads/bd 共发布 76 个版本,首次发布于 2025/11/04;过去 12 个月发布了 71 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.3.4latest2026/11/043 天前
1.3.32026/11/043 天前
1.3.22026/10/2414 天前
1.3.12026/10/011 个月前
1.3.02026/09/161 个月前
1.2.22026/08/152 个月前

关于 @beads/bd 的常见问题

@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 和提交记录判断。