Beads：编码代理的分支感知内存
用基于Dolt的依赖感知图替代杂乱无章的Markdown计划，为编码代理提供持久的结构化内存。
证据显示：README 和 SECURITY.md 明确说明本地优先、无遥测，但 Dolt 依赖默认收集指标，需用户手动禁用；安装脚本验证校验和，但未提供用户确认步骤；数据流透明性较好，文档说明数据存储位置和同步机制；敏感数据处理不足，明文存储令牌，无加密；依赖安全有 go.sum 固定和 Renovate 监控，但依赖数量庞大；外部影响有限，但 git 操作和 Dolt 同步可能产生副作用；回滚支持有限，仅通过 Dolt 历史；来源归属不明确，发布者未验证。扣分原因：缺少用户确认机制、敏感数据明文存储、依赖过多、发布者身份未知。
证据显示：README 和 SECURITY.md 内容一致，命令描述清晰；依赖通过 go.sum 固定，但 Dolt 等依赖可能不可用；失败消息提供可操作错误，如 schema 版本不匹配。扣分原因：依赖可用性未验证，失败消息仅部分覆盖。
证据显示：明确目标用户为编码代理，场景包括多代理、CI/CD、非 git 环境；能力边界清晰，如 stealth 模式、contributor 模式；触发精度高，命令明确；环境适配广泛，支持多平台。扣分原因：未提供详细的环境配置示例。
证据显示：文档结构清晰，有安装指南、FAQ、已知限制；安装说明详细，支持多种方式；命名稳定，但版本号未明确；示例和 FAQ 存在；已知限制明确；MIT 许可证；版本变更日志未提供；维护责任未明确。扣分原因：缺少版本变更日志、维护责任不明确。
证据显示：输出可用性高，提供 JSON 输出；边际价值高，解决代理记忆问题；成本效益未充分说明，依赖复杂。扣分原因：成本效益分析不足。
证据显示：README 中的声明部分有文档支持，但未提供测试结果；跨来源验证不足，仅依赖单一仓库；事实与推断分离不明确。扣分原因：缺乏测试证据和外部验证。
- Dolt 默认收集指标，需用户手动禁用，可能违反隐私预期。
- 敏感数据（如 API 令牌）以明文存储，无加密，不适合生产环境。
- 依赖数量庞大，增加供应链风险，需定期审计。
- 发布者身份未验证，安装前应验证校验和。
这个 Agent 能做什么，适合哪些场景？
Beads是一个分布式图式问题追踪器，为编码代理提供持久化、结构化的内存。它以Dolt（一个版本控制的SQL数据库）为基础，提供单元格级合并、原生分支和同步功能。Beads通过依赖关系图替代了杂乱的Markdown计划，让代理无需丢失上下文即可处理长期任务。它提供JSON输出、依赖跟踪和自动就绪任务检测等功能，并采用基于哈希的ID（如bd-a1b2）来避免冲突。Beads支持嵌入式和服务器模式，可跨机器同步，并具有上下文窗口压缩和消息、图链接等功能。它可集成到Claude Code、Codex等代理中，支持macOS、Linux、Windows和FreeBSD平台。
Beads（bd命令）提供一系列CLI命令来管理供AI代理使用的问题图。它可以初始化项目（bd init），并安装代理集成（如bd setup claude、bd setup codex）。代理可以列出可认领的任务（bd ready）、创建新任务（bd create）、原子认领任务（bd update --claim）、显示任务详情（bd show）、关闭任务（bd close）以及关联任务（bd dep add）。它还提供bd prime来打印工作流上下文和持久内存，以及bd remember来存储项目记忆。Beads使用Dolt数据库（嵌入式或服务器模式）存储数据，并通过git remote（bd dolt push/pull）同步。它支持层次化ID（如bd-a3f8.1）用于史诗，并具有压缩功能来归档旧任务。
- 想要为AI编码代理提供可靠任务记忆的开发者，使用Beads来跟踪长期项目中的问题和待办事项。
- 使用Claude Code或Codex CLI的团队，安装Beads以自动创建AGENTS.md、钩子和设置。
- 在多代理或多分支环境中工作的维护者，利用哈希ID和Dolt合并来避免冲突。
- 需要跨机器同步任务状态的远程团队，通过git remote使用bd dolt push/pull。
- 希望在不使用git的项目（如非git VCS或CI/CD）中管理任务的用户，可以通过--stealth模式使用Beads。
这个 Agent 有哪些优点和局限？
- 基于Dolt的版本控制数据库提供单元格级合并和分支能力，支持复杂多代理工作流。
- 哈希ID和依赖图结构消除了合并冲突，使多代理协作更流畅。
- 针对代理优化的JSON输出和自动就绪任务检测，可无缝集成到代理工作流中。
- 提供Stealth模式，可在不使用git的项目中使用，增加灵活性。
- 跨平台支持（macOS、Linux、Windows、FreeBSD）和多种安装方式。
- 需要学习新的CLI命令和概念（如beads、依赖图、压缩），可能对不熟悉此类工具的开发者有学习曲线。
- 对于小型项目，可能过于复杂，不适合简单的待办事项管理。
- 依赖Dolt数据库，增加了存储和同步的复杂性，可能需要额外的维护。
- 安装脚本执行代码，需要用户信任来源并验证校验和。
- 某些高级功能（如服务器模式、跨机器同步）可能需要额外配置。
如何安装或部署这个 Agent？
从GitHub releases安装最新版本：
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash或者使用包管理器：
brew install beads
# 或者
npm install -g @beads/bd如何使用这个 Agent？
在你的项目目录中初始化Beads：
cd your-project
bd init可选地安装代理集成（例如Claude Code）：
bd setup claude常用命令：
- bd ready 查看没有未解决阻断器的任务。
- bd create "Title" -p 0 创建P0任务。
- bd update <id> --claim 领取任务。
- bd close <id> "Fixed" 关闭任务。
- bd prime 打印工作流上下文和持久记忆。
- bd remember "insight" 存储项目记忆。