95
// 项目简介
Beads 是一个由 Dolt 驱动的分布式问题追踪系统，专为 AI 编程 Agent 提供持久化记忆而设计。它利用依赖感知图结构来管理复杂的长周期任务，并通过基于哈希的标识符来防止合并冲突。该工具提供灵活的存储模式，并能无缝集成到开发工作流中，无需进行仓库级的 git 操作。
// 技术分析
Beads (bd) 是一个分布式基于图的问题追踪器，专为 AI 编码代理提供持久化、结构化的记忆而设计。通过利用 Dolt 作为其底层版本控制 SQL 数据库，它实现了支持依赖关系的任务管理，使代理能够在长期项目中保持上下文。该架构优先考虑对代理友好的交互，例如 JSON 输出和基于哈希的任务标识，有效地用稳健且可合并的数据结构取代了非结构化的 markdown 计划。
// 核心亮点
01
利用 Dolt 作为版本控制 SQL 后端，提供单元级合并和原生分支功能。
02
实现基于哈希的任务 ID，确保跨多个代理和分支的工作流零冲突。
03
具备语义记忆压缩功能，可汇总已关闭的任务，从而优化 AI 代理的上下文窗口。
04
支持分层任务结构，允许组织史诗（epics）、任务和子任务。
05
提供仅限本地使用的隐身模式，无需修改宿主仓库的文件结构即可进行任务追踪。
06
提供灵活的存储模式，包括嵌入式单写模式和支持并发多写访问的服务器模式。
// 典型使用场景
01
为 AI 编程 Agent 提供持久化且具备依赖感知能力的任务追踪
02
在多 Agent 或多分支工作流中实现无冲突的问题管理
03
通过语义记忆压缩来优化上下文窗口的使用效率
// 快速开始
首先，使用提供的安装脚本或通过 Homebrew/npm 安装 Beads CLI。安装完成后，导航到您的项目目录并运行 'bd init' 来初始化本地数据库。随后，您可以使用 'bd create' 和 'bd ready' 等命令开始管理任务，或者通过更新项目中 AGENTS.md 文件来配置您的代理以与系统进行交互。