steveyegge/beads
GitHub: steveyegge/beads
为 AI 编程代理提供基于图结构的持久化任务记忆系统，解决长周期任务中的上下文丢失问题。
Stars: 17812 | Forks: 1106
# bd - Beads
**分布式、基于 git 的 AI 代理图表跟踪系统。**
**平台：** macOS, Linux, Windows, FreeBSD
[](LICENSE)
[](https://goreportcard.com/report/github.com/steveyegge/beads)
[](https://github.com/steveyegge/beads/releases)
[](https://www.npmjs.com/package/@beads/bd)
[](https://pypi.org/project/beads-mcp/)
Beads 为编码代理提供持久的结构化记忆。它用具有依赖感知能力的图结构取代了杂乱的 markdown 计划，允许代理在处理长周期任务时不丢失上下文。
## ⚡ 快速开始
```
# 安装 beads CLI（全局 - 不要将此 repo 克隆到您的项目中）
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
# 在您的项目中 Initialize
cd your-project
bd init
# 告知您的 agent
echo "Use 'bd' for task tracking" >> AGENTS.md
```
**注意：** Beads 是一个 CLI 工具，只需安装一次即可随处使用。您无需将此仓库克隆到您的项目中。
## 🛠 功能特性
* **由 [Dolt](https://github.com/dolthub/dolt) 驱动：** 版本控制的 SQL 数据库，支持单元格级合并、原生分支以及通过 Dolt remotes 进行内置同步。
* **代理优化：** JSON 输出、依赖跟踪和自动就绪任务检测。
* **零冲突：** 基于哈希的 ID（`bd-a1b2`）可防止多代理/多分支工作流中的合并冲突。
* **压缩：** 语义化的“记忆衰退”会总结旧的已关闭任务，以节省上下文窗口。
* **消息传递：** 消息类型支持线程（`--thread`）、短暂生命周期和邮件委托。
* **图链接：** 用于知识图谱的 `relates_to`、`duplicates`、`supersedes` 和 `replies_to`。
## 📖 核心命令
| 命令 | 操作 |
| --- | --- |
| `bd ready` | 列出没有开放阻塞的任务。 |
| `bd create "Title" -p 0` | 创建一个 P0 任务。 |
| `bd update --claim` | 原子性地认领任务（设置指派人 + in_progress）。 |
| `bd dep add ` | 链接任务（阻塞、相关、父子）。 |
| `bd show ` | 查看任务详情和审计跟踪。 |
## 🔗 层级与工作流
Beads 支持 Epic（史诗）的层级 ID：
* `bd-a3f8` (Epic)
* `bd-a3f8.1` (Task)
* `bd-a3f8.1.1` (Sub-task)
**隐身模式：** 运行 `bd init --stealth` 可在本地使用 Beads，而无需将文件提交到主仓库。非常适合在共享项目中个人使用。
**贡献者 vs 维护者：** 在进行开源项目协作时：
* **贡献者**（forked 仓库）：运行 `bd init --contributor` 将规划问题路由到单独的仓库（例如 `~/.beads-planning`）。避免将实验性工作混入 PR。
* **维护者**（写权限）：Beads 通过 SSH URL 或带有凭据的 HTTPS 自动检测维护者角色。仅当您在没有凭据的情况下使用 GitHub HTTPS 但拥有写权限时，才需要 `git config beads.role maintainer`。
## 📦 安装
* **npm:** `npm install -g @beads/bd`
* **Homebrew:** `brew install beads`
* **Go:** `go install github.com/steveyegge/beads/cmd/bd@latest`
**系统要求：** Linux, FreeBSD, macOS, 或 Windows。
## 🌐 社区工具
请参阅 [docs/COMMUNITY_TOOLS.md](docs/COMMUNITY_TOOLS.md) 获取社区构建的 UI、扩展和集成列表——包括终端界面、Web UI、编辑器扩展和原生应用。
## 📝 文档
* [安装](docs/INSTALLING.md) | [代理工作流](AGENT_INSTRUCTIONS.md) | [Copilot 设置](docs/COPILOT_INTEGRATION.md) | [文章](ARTICLES.md) | [同步分支模式](docs/PROTECTED_BRANCHES.md) | [故障排除](docs/TROUBLESHOOTING.md) | [常见问题](docs/FAQ.md)
* [](https://deepwiki.com/steveyegge/beads)
标签：AI编程助手, DLL 劫持, Dolt, EVTX分析, EVTX分析, Git存储, GNU通用公共许可证, Go语言, Linux 内核安全, MCP, Node.js, PyRIT, Python, SQL数据库, 上下文压缩, 上下文窗口, 任务调度, 任务追踪, 依赖管理, 内存管理, 冲突解决, 分布式系统, 响应大小分析, 多智能体系统, 多线程, 大语言模型, 威胁情报, 安全可观测性, 开发者工具, 持久化存储, 数据结构, 文档结构分析, 无后门, 日志审计, 暗色界面, 版本控制, 程序破解, 自动化运维, 记忆系统, 语义摘要, 项目管理