Beads：给 AI 编程助手装上「项目经理大脑」，22.4K Star 的分布式任务追踪器
痛点：AI 编程助手最缺的是什么？
当你同时让多个 AI 编程助手（Claude Code、Codex、Cline）协作处理一个复杂项目时，问题很快就来了：
- 任务一多就乱套：上下文有限，AI 在海量信息里迷失方向
- Jira 太重：对 AI 来说集成成本太高，API 复杂
- Markdown 太散：版本控制、依赖关系根本搞不定
- 上下文窗口不是无限的：长期项目处理时，早期决策容易被遗忘
Beads 正是为解决这些问题而生——它是专门为 AI 编程助手设计的分布式图状任务追踪系统，底层基于 Dolt（版本控制的 SQL 数据库），GitHub 斩获 22.4K Stars，直接登上 Trending 榜单。
它的定位很清晰：给 AI 们配一个专业项目经理，让多 Agent 协作井井有条。
一、项目背景：Gas Town 愿景
Beads 由 gastownhall 团队开发，是更大愿景 Gas Town 的底层基石。
Gas Town 被定义为 AI Coding 领域的 「Kubernetes」，而 Beads 就是它的记忆系统——负责管理任务、追踪状态、维护依赖关系。
简单说：
- Beads = 任务管理 + 记忆系统
- Gas Town = 多 Agent 协作平台（Beads 是其中一环）
二、核心亮点
1. Dolt 驱动：版本控制的数据库
Beads 底层不是普通的 SQLite 或 MySQL，而是 Dolt——一个支持版本控制的 SQL 数据库。
这带来三个关键能力：
| 能力 | 说明 |
|---|---|
| 单元格级合并 | 多个 Agent 修改同一任务的不同字段时，可以像 Git 合并代码一样智能合并 |
| 原生分支支持 | 每个 Agent 可以在自己的分支上工作，互不干扰 |
| 内置同步 | 通过 Dolt remotes 可以轻松在不同机器间同步任务数据 |
效果：任务管理拥有了 Git 一样的版本控制能力，但又保持了 SQL 数据库的查询便利性。
2. AI 优化设计
Beads 从一开始就是为 AI 设计的，而不是给人类用的 Jira 改改：
- JSON 原生输出：所有命令都支持
--json输出，AI 解析毫不费力 - 依赖追踪：自动维护任务间的依赖关系图，AI 不用手动梳理
- 自动就绪检测：
bd ready一条命令列出所有没有阻塞的可执行任务
3. 零冲突设计
多 Agent 协作最怕冲突。Beads 的解决方案很聪明：
- 哈希 ID：每个任务都有唯一哈希 ID（如
bd-a1b2c），避免命名冲突 - 分布式存储：任务数据存储为文件，通过 Git 同步，天然支持分布式协作
- 智能合并：基于 Dolt 的单元格级合并，最大限度减少冲突
4. 记忆衰减机制（Compaction）
AI 的上下文窗口虽然越来越大，但还是有限的。Beads 内置了「记忆衰减」功能：
- 语义摘要：自动把已完成的旧任务压缩成摘要
- 节省窗口：只把关键信息留给 AI，不浪费 Token
- 按需展开：需要时仍然可以查看完整历史
5. 图状链接
任务不是孤立的列表，而是一张知识图谱：
| 链接类型 | 含义 |
|---|---|
relates_to | 相关任务 |
duplicates | 重复任务 |
supersedes | 替代任务 |
replies_to | 回复关系 |
这些链接让 AI 能够理解任务之间的上下文关系，而不只是孤立的 To-Do 列表。
三、快速上手
安装（四种方式）
# Homebrew（推荐 macOS）
brew install beads
# NPM
npm install -g @beads/bd
# 安装脚本
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
# Go
go install github.com/gastownhall/beads/cmd/bd@latest
在项目中使用
# 进入项目目录
cd your-project
# 初始化 Beads
bd init
# 告诉 AI 助手用 Beads（加到 AGENTS.md）
echo "Use 'bd' for task tracking" >> AGENTS.md
常用命令
# 创建任务（-p 优先级 0=紧急, 1=高, -t 类型）
bd create "实现用户登录功能" -p 0
bd create "修复数据库连接bug" -p 1 -t bug
# 查看就绪任务（没有阻塞的）
bd ready
# 认领任务（原子操作：设置分配者 + 状态改为进行中）
bd update bd-a1b2c --claim
# 添加依赖（A 依赖 B）
bd dep add bd-a1b2c bd-d3e4f
# 查看任务详情
bd show bd-a1b2c
# 关闭任务
bd close bd-a1b2c "已完成"
# 同步到 Git
bd sync
# 备份与迁移
bd backup init /path/to/backup
bd backup sync
四、为什么 Beads 值得每个 AI 编程者关注
Beads 解决了目前 AI 协作中的几个核心痛点：
| 痛点 | Beads 解法 |
|---|---|
| AI 重启丢失上下文 | ✅ 任务状态持久化到 Dolt 数据库 |
| 多 Agent 任务冲突 | ✅ 哈希 ID + 单元格级合并，零冲突 |
| 手动梳理优先级 | ✅ bd ready 自动计算就绪任务 |
| 上下文窗口浪费在旧任务上 | ✅ 记忆衰减机制自动压缩 |
| 多机器协作同步困难 | ✅ Git 同步，天然分布式 |
Gas Town 的更大愿景：未来 AI 编程工具的竞争，不只是在模型层，更会在「协议兼容层、路由层、工具层」。Beads 是这个方向的先行者。
五、项目地址
- GitHub：https://github.com/gastownhall/beads
- 官方文档：https://gastownhall.github.io/beads/
- 22.4K Stars，登上 GitHub Trending
总结
Beads 是一个真正为 AI 编程助手设计的任务管理工具，它不追求取代 Jira 或 Linear，而是专为 AI 优化：
- 上下文持久化：AI 重启不会丢失任务状态
- 依赖管理：自动计算就绪任务，不用手动梳理
- 分布式协作：多个 Agent 在不同分支工作零冲突
- 记忆衰减：自动压缩旧任务，节省上下文窗口
- 不依赖 Git：任何项目都能用
- 多种安装方式：一行命令就能上手
如果你经常让 AI 助手处理复杂的多步骤项目，或者在尝试多 Agent 协作，Beads 绝对值得一试。
它就像给 AI 们配了一个专业的项目经理，让整个协作过程井井有条。
标签： #Beads #AI编程 #开源工具 #多Agent协作 #Dolt #Gas Town #Claude Code #AI Coding