49
// 项目简介
Beads 是一个由 Dolt 驱动的分布式问题追踪系统，旨在为 AI 编程 Agent 提供持久化且结构化的记忆。它利用依赖感知图结构来帮助 Agent 管理复杂的长周期任务，而不会丢失关键上下文。该工具提供灵活的存储模式，并能无缝集成到使用或不使用 Git 的开发工作流中。
// 技术分析
Beads 是一个分布式、具备依赖感知能力的图形化问题追踪器，专为 AI 编码代理提供持久化、结构化的记忆而设计。通过利用 Dolt 作为其底层的版本控制 SQL 数据库，它使代理能够管理长周期任务和复杂工作流，而不会出现传统基于 Markdown 规划所带来的上下文丢失问题。该项目优先考虑对代理友好的输出和无冲突协作，提供灵活的存储模式，使其既可以作为集成的基于 Git 的工具运行，也可以作为非 Git 环境下的独立系统使用。
// 核心亮点
01
利用 Dolt 作为版本控制 SQL 后端，提供单元级合并和原生分支功能。
02
采用基于哈希的 ID，确保在多代理和多分支工作流中实现零冲突的任务管理。
03
具备语义记忆压缩功能，可汇总已关闭的任务，从而优化 AI 代理的上下文窗口。
04
支持分层任务结构，允许使用唯一标识符组织史诗（epics）、任务和子任务。
05
提供隐身模式和无 Git 配置，以支持非 Git 版本控制系统、monorepos 和隔离的 CI/CD 环境。
06
提供原生依赖追踪和自动就绪任务检测，帮助代理有效地确定工作优先级。
// 典型使用场景
01
利用依赖感知图结构为 AI Agent 提供持久化任务追踪
02
使用 Dolt 进行版本控制的问题管理，实现可合并与可分支的数据
03
通过语义记忆压缩来优化长周期项目的上下文窗口
// 快速开始
首先，通过提供的 shell 脚本、Homebrew 或 npm 安装 Beads CLI。安装完成后，进入您的项目目录并运行 'bd init' 来初始化本地数据库。随后，您可以使用 'bd create' 和 'bd ready' 等命令开始管理任务，或查阅文档以了解服务器模式或隐身使用等高级配置。