[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-steveyegge--beads":3,"tool-steveyegge--beads":61},[4,18,26,36,44,52],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",144730,2,"2026-04-07T23:26:32",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107888,"2026-04-06T11:32:50",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,60],"视频",{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":77,"owner_twitter":72,"owner_website":78,"owner_url":79,"languages":80,"stars":116,"forks":117,"last_commit_at":118,"license":119,"difficulty_score":32,"env_os":120,"env_gpu":121,"env_ram":121,"env_deps":122,"category_tags":128,"github_topics":129,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":133,"updated_at":134,"faqs":135,"releases":165},5380,"steveyegge\u002Fbeads","beads","Beads - A memory upgrade for your coding agent","Beads 是一款专为 AI 编程助手设计的“记忆升级”工具，旨在解决智能体在处理长期、复杂开发任务时容易丢失上下文或陷入混乱的痛点。传统模式下，AI 往往依赖杂乱的 Markdown 文件来规划任务，难以追踪依赖关系；而 Beads 通过构建一个具备版本控制能力的结构化图谱数据库，让 AI 能够清晰地管理任务层级、依赖阻塞及执行状态，从而从容应对长周期项目。\n\n这款工具特别适合需要利用 AI 辅助进行系统级开发、重构或维护大型代码库的开发者与技术团队。其核心亮点在于底层采用了 Dolt 技术，这是一个支持单元格级别合并与原生命题分支的 SQL 数据库，确保了多智能体协作时的数据一致性与零冲突。Beads 不仅支持任务的自动就绪检测和语义化“记忆压缩”以节省上下文窗口，还提供了独特的层级 ID 系统（如史诗 - 任务 - 子任务）和隐身模式，既能满足开源贡献者的隔离需求，也能适应维护者的协同流程。通过简单的命令行交互，Beads 让 AI 代理拥有了持久、有序且可追溯的工程记忆，显著提升了自动化编码的可靠性与效率。","# bd - Beads\n\n**Distributed graph issue tracker for AI agents, powered by [Dolt](https:\u002F\u002Fgithub.com\u002Fdolthub\u002Fdolt).**\n\n**Platforms:** macOS, Linux, Windows, FreeBSD\n\n[![License](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fsteveyegge\u002Fbeads)](LICENSE)\n[![Go Report Card](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsteveyegge_beads_readme_2b4a70945b89.png)](https:\u002F\u002Fgoreportcard.com\u002Freport\u002Fgithub.com\u002Fsteveyegge\u002Fbeads)\n[![Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fsteveyegge\u002Fbeads)](https:\u002F\u002Fgithub.com\u002Fsteveyegge\u002Fbeads\u002Freleases)\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@beads\u002Fbd)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@beads\u002Fbd)\n[![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fbeads-mcp)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fbeads-mcp\u002F)\n\n**Docs:** https:\u002F\u002Fgastownhall.github.io\u002Fbeads\u002F\n\nBeads provides a persistent, structured memory for coding agents. It replaces messy markdown plans with a dependency-aware graph, allowing agents to handle long-horizon tasks without losing context.\n\n## ⚡ Quick Start\n\n```bash\n# Install beads CLI (system-wide - don't clone this repo into your project)\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n\n# Initialize in YOUR project\ncd your-project\nbd init\n\n# Tell your agent\necho \"Use 'bd' for task tracking\" >> AGENTS.md\n```\n\n**Note:** Beads is a CLI tool you install once and use everywhere. You don't need to clone this repository into your project.\n\n## 🛠 Features\n\n* **[Dolt](https:\u002F\u002Fgithub.com\u002Fdolthub\u002Fdolt)-Powered:** Version-controlled SQL database with cell-level merge, native branching, and built-in sync via Dolt remotes.\n* **Agent-Optimized:** JSON output, dependency tracking, and auto-ready task detection.\n* **Zero Conflict:** Hash-based IDs (`bd-a1b2`) prevent merge collisions in multi-agent\u002Fmulti-branch workflows.\n* **Compaction:** Semantic \"memory decay\" summarizes old closed tasks to save context window.\n* **Messaging:** Message issue type with threading (`--thread`), ephemeral lifecycle, and mail delegation.\n* **Graph Links:** `relates_to`, `duplicates`, `supersedes`, and `replies_to` for knowledge graphs.\n\n## 📖 Essential Commands\n\n| Command | Action |\n| --- | --- |\n| `bd ready` | List tasks with no open blockers. |\n| `bd create \"Title\" -p 0` | Create a P0 task. |\n| `bd update \u003Cid> --claim` | Atomically claim a task (sets assignee + in_progress). |\n| `bd dep add \u003Cchild> \u003Cparent>` | Link tasks (blocks, related, parent-child). |\n| `bd show \u003Cid>` | View task details and audit trail. |\n\n## 🔗 Hierarchy & Workflow\n\nBeads supports hierarchical IDs for epics:\n\n* `bd-a3f8` (Epic)\n* `bd-a3f8.1` (Task)\n* `bd-a3f8.1.1` (Sub-task)\n\n**Stealth Mode:** Run `bd init --stealth` to use Beads locally without committing files to the main repo. Perfect for personal use on shared projects. See [Git-Free Usage](#-git-free-usage) below.\n\n**Contributor vs Maintainer:** When working on open-source projects:\n\n* **Contributors** (forked repos): Run `bd init --contributor` to route planning issues to a separate repo (e.g., `~\u002F.beads-planning`). Keeps experimental work out of PRs.\n* **Maintainers** (write access): Beads auto-detects maintainer role via SSH URLs or HTTPS with credentials. Only need `git config beads.role maintainer` if using GitHub HTTPS without credentials but you have write access.\n\n## 📦 Installation\n\n```bash\nbrew install beads           # macOS \u002F Linux (recommended)\nnpm install -g @beads\u002Fbd     # Node.js users\n```\n\n**Other methods:** [install script](docs\u002FINSTALLING.md#quick-install-script-all-platforms) | [go install](docs\u002FINSTALLING.md#quick-install-recommended) | [from source](docs\u002FINSTALLING.md#build-dependencies-contributors-only) | [Windows](docs\u002FINSTALLING.md#windows-11) | [Arch AUR](docs\u002FINSTALLING.md#linux)\n\n**Requirements:** macOS, Linux, Windows, or FreeBSD. See [docs\u002FINSTALLING.md](docs\u002FINSTALLING.md) for complete installation guide.\n\n### Security And Verification\n\nBefore trusting any downloaded binary, verify its checksum against the release `checksums.txt`.\n\nThe install scripts verify release checksums before install. For manual installs, do this verification yourself before first run.\n\nOn macOS, `scripts\u002Finstall.sh` preserves the downloaded signature by default. Local ad-hoc re-signing is explicit opt-in via `BEADS_INSTALL_RESIGN_MACOS=1`.\n\nSee [docs\u002FANTIVIRUS.md](docs\u002FANTIVIRUS.md) for Windows AV false-positive guidance and verification workflow.\n\n## 💾 Storage Modes\n\nBeads uses [Dolt](https:\u002F\u002Fgithub.com\u002Fdolthub\u002Fdolt) as its database. Two modes\nare available:\n\n### Embedded Mode (default)\n\n```bash\nbd init\n```\n\nDolt runs in-process — no external server needed. Data lives in\n`.beads\u002Fembeddeddolt\u002F`. Single-writer only (file locking enforced).\nThis is the recommended mode for most users.\n\n### Server Mode\n\n```bash\nbd init --server\n```\n\nConnects to an external `dolt sql-server`. Data lives in `.beads\u002Fdolt\u002F`.\nSupports multiple concurrent writers. Configure the connection with flags\nor environment variables:\n\n| Flag | Env Var | Default |\n|------|---------|---------|\n| `--server-host` | `BEADS_DOLT_SERVER_HOST` | `127.0.0.1` |\n| `--server-port` | `BEADS_DOLT_SERVER_PORT` | `3307` |\n| `--server-user` | `BEADS_DOLT_SERVER_USER` | `root` |\n| | `BEADS_DOLT_PASSWORD` | (none) |\n\n### Backup & Migration\n\nBack up your database and migrate between modes using `bd backup`:\n\n```bash\n# Set up a backup destination and push\nbd backup init \u002Fpath\u002Fto\u002Fbackup\nbd backup sync\n\n# Restore into a new project (any mode)\nbd init           # or bd init --server\nbd backup restore --force \u002Fpath\u002Fto\u002Fbackup\n```\n\nSee [docs\u002FDOLT.md](docs\u002FDOLT.md#migrating-between-backends) for full\nmigration instructions.\n\n## 🌐 Community Tools\n\nSee [docs\u002FCOMMUNITY_TOOLS.md](docs\u002FCOMMUNITY_TOOLS.md) for a curated list of community-built UIs, extensions, and integrations—including terminal interfaces, web UIs, editor extensions, and native apps.\n\n## 🚀 Git-Free Usage\n\nBeads works without git. The Dolt database is the storage backend — git\nintegration (hooks, repo discovery, identity) is optional.\n\n```bash\n# Initialize without git\nexport BEADS_DIR=\u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.beads\nbd init --quiet --stealth\n\n# All core commands work with zero git calls\nbd create \"Fix auth bug\" -p 1 -t bug\nbd ready --json\nbd update bd-a1b2 --claim\nbd prime\nbd close bd-a1b2 \"Fixed\"\n```\n\n`BEADS_DIR` tells bd where to put the `.beads\u002F` database directory,\nbypassing git repo discovery. `--stealth` sets `no-git-ops: true` in\nconfig, disabling all git hook installation and git operations.\n\nThis is useful for:\n- **Non-git VCS** (Sapling, Jujutsu, Piper) — no `.git\u002F` directory needed\n- **Monorepos** — point `BEADS_DIR` at a specific subdirectory\n- **CI\u002FCD** — isolated task tracking without repo-level side effects\n- **Evaluation\u002Ftesting** — ephemeral databases in `\u002Ftmp`\n\nFor daemon mode without git, use `bd daemon start --local`\n(see [PR #433](https:\u002F\u002Fgithub.com\u002Fsteveyegge\u002Fbeads\u002Fpull\u002F433)).\n\n## 📝 Documentation\n\n* [Documentation site](https:\u002F\u002Fgastownhall.github.io\u002Fbeads\u002F) (versioned) | [Installing](docs\u002FINSTALLING.md) | [Agent Workflow](AGENT_INSTRUCTIONS.md) | [Copilot Setup](docs\u002FCOPILOT_INTEGRATION.md) | [Articles](ARTICLES.md) | [Sync Branch Mode](docs\u002FPROTECTED_BRANCHES.md) | [Troubleshooting](docs\u002FTROUBLESHOOTING.md) | [FAQ](docs\u002FFAQ.md)\n* [![Ask DeepWiki](https:\u002F\u002Fdeepwiki.com\u002Fbadge.svg)](https:\u002F\u002Fdeepwiki.com\u002Fgastownhall\u002Fbeads)\n","# bd - 珠子\n\n**由 [Dolt](https:\u002F\u002Fgithub.com\u002Fdolthub\u002Fdolt) 提供支持的、面向 AI 代理的分布式图式问题跟踪器。**\n\n**支持平台：** macOS、Linux、Windows、FreeBSD\n\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fsteveyegge\u002Fbeads)](LICENSE)\n[![Go Report Card](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsteveyegge_beads_readme_2b4a70945b89.png)](https:\u002F\u002Fgoreportcard.com\u002Freport\u002Fgithub.com\u002Fsteveyegge\u002Fbeads)\n[![发布版本](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fsteveyegge\u002Fbeads)](https:\u002F\u002Fgithub.com\u002Fsteveyegge\u002Fbeads\u002Freleases)\n[![npm 版本](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@beads\u002Fbd)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@beads\u002Fbd)\n[![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fbeads-mcp)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fbeads-mcp\u002F)\n\n**文档：** https:\u002F\u002Fgastownhall.github.io\u002Fbeads\u002F\n\nBeads 为编码代理提供了一种持久化的结构化记忆。它用依赖感知的图结构取代了杂乱的 Markdown 计划，使代理能够在不丢失上下文的情况下处理长期任务。\n\n## ⚡ 快速入门\n\n```bash\n# 安装 beads CLI（系统全局安装——不要将此仓库克隆到你的项目中）\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n\n# 在你的项目中初始化\ncd your-project\nbd init\n\n# 告诉你的代理\necho \"Use 'bd' for task tracking\" >> AGENTS.md\n```\n\n**注意：** Beads 是一个只需安装一次即可在任何地方使用的命令行工具。你不需要将这个仓库克隆到你的项目中。\n\n## 🛠 功能特性\n\n* **基于 Dolt 的支持：** 可版本控制的 SQL 数据库，具备单元级合并、原生分支功能，并可通过 Dolt 远程仓库实现内置同步。\n* **针对代理优化：** JSON 输出、依赖关系跟踪以及自动检测就绪任务。\n* **零冲突：** 基于哈希的 ID（`bd-a1b2`）可防止多代理或多分支工作流中的合并冲突。\n* **压缩机制：** 语义上的“记忆衰退”会总结旧的已关闭任务，以节省上下文窗口。\n* **消息传递：** 支持带线程的消息类型（`--thread`），具有短暂的生命周期和邮件委派功能。\n* **图链接：** `relates_to`、`duplicates`、`supersedes` 和 `replies_to`，适用于知识图谱。\n\n## 📖 核心命令\n\n| 命令 | 功能 |\n| --- | --- |\n| `bd ready` | 列出没有未完成阻塞项的任务。 |\n| `bd create \"Title\" -p 0` | 创建一个 P0 级别任务。 |\n| `bd update \u003Cid> --claim` | 原子性地认领一个任务（设置经办人并标记为进行中）。 |\n| `bd dep add \u003Cchild> \u003Cparent>` | 链接任务（阻止、相关、父子关系）。 |\n| `bd show \u003Cid>` | 查看任务详情及审计轨迹。 |\n\n## 🔗 层次结构与工作流\n\nBeads 支持用于史诗级任务的层次化 ID：\n\n* `bd-a3f8`（史诗级任务）\n* `bd-a3f8.1`（任务）\n* `bd-a3f8.1.1`（子任务）\n\n**隐身模式：** 运行 `bd init --stealth` 可以在本地使用 Beads，而无需将文件提交到主仓库。非常适合在共享项目中个人使用。请参阅下方的 [无 Git 使用方式](#-git-free-usage)。\n\n**贡献者与维护者：** 在参与开源项目时：\n\n* **贡献者**（分叉的仓库）：运行 `bd init --contributor` 将规划问题路由到一个独立的仓库（例如 `~\u002F.beads-planning`）。这样可以将实验性工作排除在 PR 之外。\n* **维护者**（拥有写入权限）：Beads 会通过 SSH URL 或带有凭据的 HTTPS 自动检测维护者角色。只有在使用 GitHub HTTPS 而没有凭据但拥有写入权限的情况下，才需要运行 `git config beads.role maintainer`。\n\n## 📦 安装方法\n\n```bash\nbrew install beads           # macOS \u002F Linux（推荐）\nnpm install -g @beads\u002Fbd     # Node.js 用户\n```\n\n**其他方法：** [快速安装脚本（所有平台）](docs\u002FINSTALLING.md#quick-install-script-all-platforms) | [go install（推荐）](docs\u002FINSTALLING.md#quick-install-recommended) | [从源码编译（仅限贡献者）](docs\u002FINSTALLING.md#build-dependencies-contributors-only) | [Windows](docs\u002FINSTALLING.md#windows-11) | [Arch AUR](docs\u002FINSTALLING.md#linux)\n\n**要求：** macOS、Linux、Windows 或 FreeBSD。完整的安装指南请参阅 [docs\u002FINSTALLING.md](docs\u002FINSTALLING.md)。\n\n### 安全与验证\n\n在信任任何下载的二进制文件之前，请根据发行版中的 `checksums.txt` 文件验证其校验和。\n\n安装脚本会在安装前验证发行版的校验和。对于手动安装，请在首次运行前自行完成此验证。\n\n在 macOS 上，`scripts\u002Finstall.sh` 默认会保留下载的签名。本地临时重新签名需要显式启用 `BEADS_INSTALL_RESIGN_MACOS=1`。\n\n有关 Windows AV 误报的指导以及验证流程，请参阅 [docs\u002FANTIVIRUS.md](docs\u002FANTIVIRUS.md)。\n\n## 💾 存储模式\n\nBeads 使用 [Dolt](https:\u002F\u002Fgithub.com\u002Fdolthub\u002Fdolt) 作为其数据库。有两种可用模式：\n\n### 嵌入式模式（默认）\n\n```bash\nbd init\n```\n\nDolt 在进程中运行——无需外部服务器。数据存储在 `.beads\u002Fembeddeddolt\u002F` 目录下。仅支持单写操作（强制文件锁定）。这是大多数用户的推荐模式。\n\n### 服务器模式\n\n```bash\nbd init --server\n```\n\n连接到外部的 `dolt sql-server`。数据存储在 `.beads\u002Fdolt\u002F` 目录下。支持多个并发写入者。可以通过标志或环境变量配置连接：\n\n| 标志 | 环境变量 | 默认值 |\n|------|---------|---------|\n| `--server-host` | `BEADS_DOLT_SERVER_HOST` | `127.0.0.1` |\n| `--server-port` | `BEADS_DOLT_SERVER_PORT` | `3307` |\n| `--server-user` | `BEADS_DOLT_SERVER_USER` | `root` |\n| | `BEADS_DOLT_PASSWORD` | （无） |\n\n### 备份与迁移\n\n使用 `bd backup` 备份数据库并在不同模式之间迁移：\n\n```bash\n# 设置备份目标并推送\nbd backup init \u002Fpath\u002Fto\u002Fbackup\nbd backup sync\n\n# 恢复到新项目中（任意模式）\nbd init           # 或 bd init --server\nbd backup restore --force \u002Fpath\u002Fto\u002Fbackup\n```\n\n完整的迁移说明请参阅 [docs\u002FDOLT.md](docs\u002FDOLT.md#migrating-between-backends)。\n\n## 🌐 社区工具\n\n请参阅 [docs\u002FCOMMUNITY_TOOLS.md](docs\u002FCOMMUNITY_TOOLS.md)，了解社区构建的 UI、扩展和集成的精选列表——包括终端界面、Web UI、编辑器扩展和原生应用。\n\n## 🚀 无 Git 使用方式\n\nBeads 不需要 Git 即可工作。Dolt 数据库是存储后端——Git 集成（钩子、仓库发现、身份识别）是可选的。\n\n```bash\n# 在没有 Git 的情况下初始化\nexport BEADS_DIR=\u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.beads\nbd init --quiet --stealth\n\n# 所有核心命令都不需要调用 Git\nbd create \"Fix auth bug\" -p 1 -t bug\nbd ready --json\nbd update bd-a1b2 --claim\nbd prime\nbd close bd-a1b2 \"Fixed\"\n```\n\n`BEADS_DIR` 告诉 bd 将 `.beads\u002F` 数据库目录放置在哪里，从而绕过 Git 仓库的自动发现。`--stealth` 会在配置中设置 `no-git-ops: true`，禁用所有 Git 钩子的安装和 Git 操作。\n\n这在以下场景中非常有用：\n- **非 Git VCS**（Sapling、Jujutsu、Piper）——无需 `.git\u002F` 目录\n- **单体仓库**——将 `BEADS_DIR` 指向特定的子目录\n- **CI\u002FCD**——隔离的任务跟踪，不会对整个仓库产生副作用\n- **评估\u002F测试**——临时数据库位于 `\u002Ftmp`\n\n若需在无 Git 的情况下以守护进程模式运行，可使用 `bd daemon start --local`（参见 [PR #433](https:\u002F\u002Fgithub.com\u002Fsteveyegge\u002Fbeads\u002Fpull\u002F433)）。\n\n## 📝 文档\n\n* [文档网站](https:\u002F\u002Fgastownhall.github.io\u002Fbeads\u002F)（版本化）| [安装](docs\u002FINSTALLING.md) | [代理工作流](AGENT_INSTRUCTIONS.md) | [Copilot 集成](docs\u002FCOPILOT_INTEGRATION.md) | [文章](ARTICLES.md) | [同步分支模式](docs\u002FPROTECTED_BRANCHES.md) | [故障排除](docs\u002FTROUBLESHOOTING.md) | [常见问题解答](docs\u002FFAQ.md)\n* [![Ask DeepWiki](https:\u002F\u002Fdeepwiki.com\u002Fbadge.svg)](https:\u002F\u002Fdeepwiki.com\u002Fgastownhall\u002Fbeads)","# Beads (bd) 快速上手指南\n\nBeads 是一个专为 AI 编程代理设计的分布式图结构任务追踪工具。它基于 [Dolt](https:\u002F\u002Fgithub.com\u002Fdolthub\u002Fdolt)（支持版本控制的 SQL 数据库），用依赖感知的图谱取代了杂乱的 Markdown 计划，帮助代理在处理长周期任务时保持上下文不丢失。\n\n## 环境准备\n\n*   **操作系统**：macOS, Linux, Windows, FreeBSD\n*   **前置依赖**：\n    *   无需手动安装 Dolt，Beads 会自动处理嵌入式数据库或连接外部服务。\n    *   若使用 Git 集成模式，需确保系统已安装 `git`。\n    *   若使用无 Git 模式（Stealth Mode），则完全不需要 Git 环境。\n\n## 安装步骤\n\n推荐以下两种安装方式（任选其一）：\n\n### 方式一：使用官方安装脚本（推荐，适用于所有平台）\n此方法会全局安装 CLI 工具，**无需**将仓库克隆到你的项目中。\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n### 方式二：使用包管理器\n\n**macOS \u002F Linux (Homebrew):**\n```bash\nbrew install beads\n```\n\n**Node.js 用户:**\n```bash\nnpm install -g @beads\u002Fbd\n```\n\n> **安全提示**：手动下载二进制文件时，请务必对照发布页的 `checksums.txt` 验证校验和。官方安装脚本已内置验证逻辑。\n\n## 基本使用\n\n### 1. 初始化项目\n进入你的代码项目目录并初始化 Beads。这会在项目中创建 `.beads\u002F` 目录用于存储数据。\n\n```bash\ncd your-project\nbd init\n```\n\n> **提示**：如果你想在共享项目中个人私有使用（不提交文件到主仓库），可使用隐身模式：\n> `bd init --stealth`\n\n### 2. 配置 AI 代理\n在你的项目说明文件（如 `AGENTS.md` 或 System Prompt）中加入以下指令，让 AI 知道如何使用 Beads：\n\n```text\nUse 'bd' for task tracking\n```\n\n### 3. 核心工作流示例\n\n以下是日常开发中最常用的命令序列：\n\n**创建高优先级任务：**\n```bash\nbd create \"修复登录认证 Bug\" -p 0\n```\n\n**查看当前可执行任务（无阻塞依赖的任务）：**\n```bash\nbd ready\n```\n\n**认领任务（原子操作，设置负责人和状态为进行中）：**\n```bash\nbd update \u003Ctask-id> --claim\n# 例如：bd update bd-a1b2 --claim\n```\n\n**建立任务依赖关系（子任务依赖于父任务）：**\n```bash\nbd dep add \u003Cchild-id> \u003Cparent-id>\n```\n\n**查看任务详情及审计记录：**\n```bash\nbd show \u003Ctask-id>\n```\n\n**关闭任务：**\n```bash\nbd close \u003Ctask-id> \"已完成修复\"\n```\n\n### 4. 无 Git 环境使用（可选）\n如果你在不使用 Git 的版本控制系统（如 Sapling, Jujutsu）或纯测试环境中工作：\n\n```bash\nexport BEADS_DIR=\u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F.beads\nbd init --quiet --stealth\n\n# 之后所有命令均可正常运行，不会调用任何 git 操作\nbd create \"测试任务\" -p 1\nbd ready --json\n```","某全栈开发团队正利用多智能体协作重构一个遗留的电商微服务系统，需处理长达数周的复杂任务链。\n\n### 没有 beads 时\n- **上下文丢失严重**：AI 代理在处理长周期任务时，因缺乏持久化记忆，经常忘记之前的决策逻辑，导致重复劳动或逻辑矛盾。\n- **依赖管理混乱**：任务间复杂的阻塞关系仅靠杂乱的 Markdown 文档记录，代理无法自动识别哪些任务已具备执行条件，常盲目开工导致报错。\n- **协作冲突频发**：多个代理并行工作时，由于缺乏原子性的任务认领机制，经常出现两个代理同时修改同一模块的代码冲突。\n- **历史追溯困难**：当需要复盘某个功能点的演变过程时，分散的聊天记录和临时文件让审计轨迹难以拼凑完整。\n\n### 使用 beads 后\n- **记忆持久结构化**：beads 基于 Dolt 提供版本控制的图数据库，将任务状态永久保存，代理随时可回溯上下文，轻松驾驭长程规划。\n- **智能依赖调度**：通过 `bd ready` 命令，代理能自动识别无阻塞的任务节点，确保只在依赖项完成后才启动后续工作，流程井然有序。\n- **零冲突原子协作**：利用 `bd update --claim` 实现任务的原子性认领，配合哈希 ID 机制，彻底杜绝了多代理间的任务撞车问题。\n- **完整审计图谱**：所有任务变更、关联关系（如 `relates_to`）及评论线程均被自动记录在图中，一键即可查看完整的演化历史。\n\nbeads 通过将松散的文本计划升级为可版本控制的依赖感知图谱，赋予了编码代理真正的“长期记忆”与协作秩序。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgastownhall_beads_fbb28e28.png","gastownhall","Gas Town Hall","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fgastownhall_a76ff61d.png","Building community for Gas Town, your AI agent orchestrator.",null,"csells@sellsbrothers.com","https:\u002F\u002Fgastownhall.ai","https:\u002F\u002Fgithub.com\u002Fgastownhall",[81,85,89,92,96,100,104,107,110,113],{"name":82,"color":83,"percentage":84},"Go","#00ADD8",94,{"name":86,"color":87,"percentage":88},"Python","#3572A5",3.3,{"name":90,"color":91,"percentage":32},"Shell","#89e051",{"name":93,"color":94,"percentage":95},"JavaScript","#f1e05a",0.3,{"name":97,"color":98,"percentage":99},"PowerShell","#012456",0.2,{"name":101,"color":102,"percentage":103},"Makefile","#427819",0.1,{"name":105,"color":106,"percentage":103},"TypeScript","#3178c6",{"name":108,"color":83,"percentage":109},"Go Template",0,{"name":111,"color":112,"percentage":109},"Nix","#7e7eff",{"name":114,"color":115,"percentage":109},"CSS","#663399",20375,1353,"2026-04-07T23:55:25","MIT","macOS, Linux, Windows, FreeBSD","未说明",{"notes":123,"python":124,"dependencies":125},"该工具主要基于 Go 语言开发 (提供 CLI)，不依赖 GPU。核心数据存储依赖 Dolt 数据库，默认以嵌入式模式运行 (无需外部服务器)，也支持连接外部 Dolt SQL 服务器模式。可通过 Homebrew、npm 或 Go 安装。支持无 Git 环境运行 (通过设置 BEADS_DIR 和 --stealth 标志)。","未说明 (提供 Python MCP 包 beads-mcp，但未指定具体版本要求)",[126,127],"Dolt (内置或外部 SQL 服务器)","Git (可选，用于集成)",[13],[130,131,132],"agents","claude-code","coding","2026-03-27T02:49:30.150509","2026-04-08T13:00:42.235806",[136,141,146,151,156,161],{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},24401,"为什么 `bd ready` 命令运行得非常慢？","该问题通常由过时的守护进程锁（stale daemon locks）引起。解决方案是重置 Beads 数据库并升级到最新版本（v0.24.0+）。具体操作包括关闭守护进程以保持稳定，或者完全清除并重置数据库。如果问题仍然存在，请使用 `--profile` 参数运行并输出结果以便进一步调试。","https:\u002F\u002Fgithub.com\u002Fgastownhall\u002Fbeads\u002Fissues\u002F243",{"id":142,"question_zh":143,"answer_zh":144,"source_url":145},24402,"如何修复与 Claude Code 和 Opus 模型兼容性差的问题？","随着 Beads 和 Claude 模型的更新，用户体验已通过新命令显著改善。建议安装官方插件市场中的 Claude Skill 插件，并使用 `bd prime`、`bd onboard`、`bd ready` 等新命令来优化工作流。可以通过插件系统将技能添加到配置中，以解决语法错误或数据库损坏问题。","https:\u002F\u002Fgithub.com\u002Fgastownhall\u002Fbeads\u002Fissues\u002F429",{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},24403,"文档难以理解或看起来像 AI 生成的，在哪里可以找到清晰的人类编写文档？","项目文档已在 2025 年 11 月后进行了大幅重写。现在拥有专门的官方网站和改进后的 CLI_REFERENCE。用户应访问新的文档网站获取关于数据模型、Git 与 JSON\u002FSQL 交互的清晰解释，旧版中令人困惑的 AI 生成内容已被移除或由社区贡献的高质量文档取代。","https:\u002F\u002Fgithub.com\u002Fgastownhall\u002Fbeads\u002Fissues\u002F376",{"id":152,"question_zh":153,"answer_zh":154,"source_url":155},24404,"在多项目环境中，如何避免 Dolt 服务器端口冲突导致的数据泄露？","默认配置可能会从提交到 Git 的文件（如 `metadata.json`）中读取共享端口，导致连接错误的项目数据库。解决方法是显式设置环境变量 `BEADS_DOLT_SERVER_PORT` 为每个项目指定独立端口，或者修改项目配置以避免使用全局共享的端口设置，确保不同项目间隔离。","https:\u002F\u002Fgithub.com\u002Fgastownhall\u002Fbeads\u002Fissues\u002F2372",{"id":157,"question_zh":158,"answer_zh":159,"source_url":160},24405,"`bd init` 初始化后为什么会有未提交的警告，需要手动执行 git 命令吗？","早期版本中 `bd init` 不会自动提交文件，导致 `bd doctor` 报告警告。虽然曾有讨论提议自动初始化和提交，但随着代码库演进，建议用户遵循当前的最佳实践：在初始化后手动执行 `git add .beads\u002F` 和 `git commit`，或者检查最新版本是否已内置自动处理逻辑以减少此类“新手摩擦”。","https:\u002F\u002Fgithub.com\u002Fgastownhall\u002Fbeads\u002Fissues\u002F1989",{"id":162,"question_zh":163,"answer_zh":164,"source_url":150},24406,"遇到合并冲突、数据库锁定或 Worktree 不同步时该如何恢复？","这些问题通常源于对数据模型理解不足。建议参考重写后的官方文档中关于架构概述的部分，了解 Git、JSON 和 SQLite 如何协同工作。对于损坏的状态，通常需要重置本地 Beads 数据库，确保所有 `.beads\u002F` 文件正确跟踪，并在多 Worktree 环境下严格遵循同步指令，避免代理工具产生不可预测的行为。",[166,171,176,181,186,191,196,201,206,211,216,221,226,231,236,241,246,251,256,261],{"id":167,"version":168,"summary_zh":169,"released_at":170},153948,"v1.0.0","## beads v1.0.0\n\n适用于 Linux、macOS（Intel 和 Apple Silicon）、Windows（AMD64 和 ARM64）、Android\u002FTermux（ARM64）以及 FreeBSD 的预编译二进制文件。\n\n### 安装\n\n**Homebrew（macOS\u002FLinux）：**\n```bash\nbrew install beads\n```\n\n**快速安装（macOS\u002FLinux\u002FFreeBSD）：**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**手动安装：**\n请在下方下载适合您平台的二进制文件，解压后将其放置到您的 PATH 环境变量中。\n\n## 更改日志\n### 功能\n* 5e60961852167574687f4d4681761f077559bacf feat(init): 为 CI\u002F云代理添加 --non-interactive 和 --role 标志\n* 29531d2b68adf4ba6ddd304c5649b9717d303c3a feat: GitLab 同步 — 去重修复、类型筛选、史诗→里程碑映射、工作项层级结构 (#2889)\n* 7806fbf47f6284a79d421203690a28565b096ce3 feat: 为 CI 添加 bd bootstrap 的 --non-interactive 标志 (#2942)\n* 677f7bcd3da65755c7abc9c0cc7e10bbd2438fd7 feat: 在 Storage 接口中添加 SlotSet\u002FSlotGet\u002FSlotClear (#2870)\n* c46be6eee501e2eaa70d38abca8e3aa39c23ea91 feat: 添加 bd config set-many 用于批量配置操作 (#2943)\n* 4d88e4ac75bcfd79659bada15a158b3f55ea6c4b feat: 添加公共格式包用于问题渲染 (#2871)\n* 08ee138917621d1d27f70aafd3f267eda703ca67 feat: 将 Spike、Story 和 Milestone 添加为一类问题类型 (#2923)\n* 9b90ada4f6deb6df1f8293a113b5c67e40d21c0b feat: 从根包导出 WispFilter 类型 (#2868)\n* 8537d943bb3da00974f9fa923d19ab48a3adc548 feat: 将自定义状态和类型迁移到规范化表中 (#2961)\n* 73409d51d4877cb12a0553b3a38400ab683a02f3 feat: 通过装饰器将钩子触发移至存储层 (#2891)\n* dc39fdc128af83d8b9fe48a0cc4f0a4176d22a50 feat: 支持多个问题 ID 的批量依赖列表 (#2875)\n* bf4025be04ff245e6f67cb8b5d5ce9be1e5d28e5 feat: 支持 bd list --status 中使用逗号分隔的状态值（GH#2846）(#2929)\n### 错误修复\n* d56bf01d68accc99f150b6bda33dac3b51e9f491 fix(ado): 将 --types\u002F--states\u002F--no-create 过滤器应用于推送操作 (#2944)\n* 9e34b07a4b9553cb7aaf65846d4d201ec0882aaf fix(ado): 先创建初始状态的工作项，再过渡到目标状态\n* 20b39b3616242adc8b03a885a299114954940c93 fix(deps): 从 lipgloss v1 迁移到 charm.land\u002Flipgloss\u002Fv2\n* dc398f5acc770c7a7875778550ac76799ac23246 fix(deps): 将 github.com\u002Fyuin\u002Fgoldmark 更新至 v1.8.2\n* 30cb4a51e9860a447c081ee5fb4493fc52ab7526 fix(deps): 将模块 github.com\u002Fcenkalti\u002Fbackoff\u002Fv4 更新至 v5 (#2857)\n* 933253ec42e6999dd86d72a8426cc2aff90fdb14 fix(dolt): 为历史分歧错误添加恢复指南 (#2941)\n* ead8d09a82059b80cd803bc3165b81e9128445dd fix(gitlab): 解决硬编码的工作项类型 ID 和 O(n) 里程碑扫描问题\n* a44d4f9d583c2a3da90fb37e531699e1b4cae4e2 fix(init): 将 AGENTS.md 中的 'bd onboard' 替换为 'bd prime' (#2902)\n* 41001f7a07d73998095c59e08cbce1cda3a35239 fix(install): 将日志函数重定向到 stderr，以修复 WSL 平台问题","2026-04-03T05:38:27",{"id":172,"version":173,"summary_zh":174,"released_at":175},153949,"v0.63.3","## beads v0.63.3\n\n适用于 Linux、macOS（Intel 和 Apple Silicon）、Windows（AMD64 和 ARM64）、Android\u002FTermux（ARM64）以及 FreeBSD 的预编译二进制文件。\n\n### 安装\n\n**Homebrew（macOS\u002FLinux）：**\n```bash\nbrew install beads\n```\n\n**快速安装（macOS\u002FLinux\u002FFreeBSD）：**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**手动安装：**\n请在下方下载适合您平台的二进制文件，解压后将其放置到您的 PATH 环境变量中。\n\n## 更改日志\n### 错误修复\n* b706786c5df40567627dd32f4dd7c9e761d9ba82 修复（beads）：在数据库发现中检测嵌入式 dolt\u002F 目录 (#2909)\n* 884cc1171e3eb3ee44c1762973dfb8da6b56cdcc 修复（发布）：将所有非 Linux 目标恢复为 CGO_ENABLED=0，并将版本号提升至 v0.63.3\n* 97889d9a7989f7e66ff4e828cb49a97c08022bdd 修复：在 bd 公式列表的文本输出中包含 convoy-type 公式\n\n","2026-03-30T16:09:33",{"id":177,"version":178,"summary_zh":179,"released_at":180},153950,"v0.62.0","## beads v0.62.0\n\n适用于 Linux、macOS（Intel 和 Apple Silicon）、Windows（AMD64 和 ARM64）、Android\u002FTermux（ARM64）以及 FreeBSD 的预编译二进制文件。\n\n### 安装\n\n**Homebrew（macOS\u002FLinux）：**\n```bash\nbrew install beads\n```\n\n**快速安装（macOS\u002FLinux\u002FFreeBSD）：**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**手动安装：**\n请在下方下载适合您平台的二进制文件，解压后将其放置在您的 PATH 环境变量中。\n\n## 更改日志\n### 功能\n* 67249651676e758f72346e340f65f25c2914ac1c 合并 PR #2638：新增 --format json 别名，用于替代 --json 标志\n* 39ab50d447ac5a35df44b834624d6e87ba29b09c feat(ado)：添加 Azure DevOps 工作项跟踪器包\n* 9f5741f47287cc24bdcee62a492a7cbebf160f63 feat(ado)：添加 bd ado CLI 命令（sync、status、projects）\n* 9a8aa558845fedd47355d63625a733bf72ddb81e feat(embeddeddolt)：为 dep、duplicate、epic、graph、supersede、swarm 添加嵌入式 Dolt 支持（修复合并 PR #2734）\n* a44ecef7432293c5fd6d5acb6633179b1fa4d252 feat(init)：将 AGENTS.md 默认设置为最小化配置文件，并新增 --agents-profile 标志\n* 5f2d4334e7a71a8f4b616541b51f66f68ee89cd4 feat：新增 'bd note' 命令，作为追加备注的快捷方式\n* affb31496a24d19bac788699ddbea68e746d7144 feat：在 bd ready 和 bd list 中新增 --exclude-type 标志\n* d6e5a5f7af0665529783e7c9387fdf699b6d3c2c feat：新增 --format json 别名，用于替代 --json 标志\n* faa69f922be2c931886458da7bec351507241f26 feat：审计日志捕获关闭原因；新增 v0.62.0 更改日志和版本说明\n* a44e01e971be987654d9497ec93cca59c6d19f70 feat：审计日志状态变更记录到 interactions.jsonl 文件中（bd-42f）\n* 9b2c012e7eaf266ba7823d4047654fe466b115ea feat：自定义状态类别（active\u002Fwip\u002Fdone\u002Ffrozen）\n* fab29b00c2ff89e9f0c79cde8d702f10e303fe25 feat：在 MCP ready 工具中公开 issue_type 筛选器（PR #2660）\n* a22af2db566293a8eed28d573797cc34fb30f36d feat：在导出\u002F导入往返过程中包含记忆内容\n* 0fe9c032331ec6c0616e080b2e71cd3418486ee5 feat：在 prime、template 和 doctor 中展示质量\u002F生命周期相关命令（修复合并 PR #2664）\n### 错误修复\n* 679d7bf2796dd1a9e697c8ea69b26dcac8a623b7 合并 PR #2651：修复：在 pre-commit 钩子中使用 go run 运行 golangci-lint\n* ae28719ef82992665eb4dfc491d3b56a64534c6e fix(ci)：为 update-flake-lock 工作流添加写权限（PR #2642）\n* c84735356ecf0e47ec748a1d251ddba4dc5b89a4 fix(cli)：当 dolt_data_dir 跳出时，保留 repo 的 .beads 配置\n* e566d3a91897df2aecb28f5c9535b4893b010712 fix(config)：将未设置的配置路由至正确存储位置（GH#2727）\n* 4a5cb16f1916898000fdfb195f96f5f6f394cecc fix(deps)：将 dolthub\u002Fdriver 从 v0.2.1 更新至 v1.83.8（修复合并 PR #2720）\n* e6ee4f97bf8cc1230b13977c3356f266460a517c fix(deps)：将 github.com\u002Fanthropics\u002Fanthropic-sdk-go 更新至 v1.27.1（PR #2705）\n* 51d41e2d3501671021e32d0c60dd4b5cfab7b427 fix(deps)：将 github.com\u002Fdolthub\u002Fdriver 的摘要更新至 1f97424（PR #2650）\n* 164cea7c84293940ad5e163da35e03","2026-03-22T02:57:44",{"id":182,"version":183,"summary_zh":184,"released_at":185},153951,"v0.61.0","## beads v0.61.0\n\n适用于 Linux、macOS（Intel 和 Apple Silicon）、Windows（AMD64 和 ARM64）、Android\u002FTermux（ARM64）以及 FreeBSD 的预编译二进制文件。\n\n### 安装\n\n**Homebrew（macOS\u002FLinux）：**\n```bash\nbrew install beads\n```\n\n**快速安装（macOS\u002FLinux\u002FFreeBSD）：**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**手动安装：**\n请在下方下载适合您平台的二进制文件，解压后将其放置到您的 PATH 环境变量中。\n\n## 更改日志\n### 功能\n* ad0417af95e6cd597720b09fb400098bc4d7fce8 合并 PR #2543：特性(dolt)：服务器模式推送\u002F拉取的 CLI 凭证直通\n* ef59bd00f06cbdf58ada8a2e3552232f8775b953 合并 PR #2585：特性：初始化\u002F引导时自动检测 Git 远程仓库上的 beads 数据库\n* 947d557d519775484ebbb2ca56fe008bf8e6ea0f 合并 PR #2594：特性：添加 --claim-next 用于关闭任务，以及 --skills\u002F--context 用于创建任务\n* 22ab742d6e56ec91888d3e2438cd930b8d02ac6a 合并 PR #2600：特性：优先处理 SSOT 任务 8-12 — 初始化升级、配方清理、符号链接安全、过时检测\n* ee4dc9198b485371b0f9161799616b6cd8327885 合并 PR #2600：特性：优先处理 SSOT 任务 8-12 — 初始化升级、配方清理、符号链接安全、过时检测\n* de5f0b986a75155c86d98e2903b31c6e6facc579 合并 PR #2622：特性：添加 --no-history 标志，以区分跳过 Dolt 提交与是否符合 GC 清理条件\n* 5689f48364cb806985508cd0756ee3226d20855a 特性(dolt)：为联邦 PushTo\u002FPullFrom\u002FFetch 添加 CLI 凭证路由\n* 02dc8c8aa701819fae1b37fc9ea70f9846fbbb9f 特性(dolt)：为服务器模式推送添加 CLI 凭证路由\n* 1911d2d91b59ea41c9ca29132fa46480fd79eca4 特性(dolt)：将 CLI 凭证路由扩展至 ForcePush 和 Pull 操作\n* 6edd905b1bc21a3fb0c44073f8f0d6be20dd8211 特性(setup)：针对 CLAUDE.md 和 GEMINI.md 进行钩子集成\n* 7267cbbbbb45cf2dd59701efac8861dd32c88a70 特性(setup)：针对 CLAUDE.md 和 GEMINI.md 进行钩子集成\n* 93b85295d422295c880b166818925187520e12a2 特性：Claude 和 Gemini 设置安装最小化 AGENTS.md 部分（#2139，任务 5-6）\n* 6588c53d6fe86e2c864d53d38fcef9faaf70f1ac 特性：Claude 和 Gemini 设置安装最小化 AGENTS.md 部分（#2139，任务 5-6）\n* 1ce765eef881a2a7efcc005c789729242da19f8b 特性：为联邦安全事件使用 UUID 主键\n* ecad137f51480dd920ae9ebe877c42b9aff78053 特性：添加 --claim-next 用于关闭任务，以及 --skills\u002F--context 用于创建任务\n* 869cc17fcd0fb631c5048a9f86fe6d1262a0066d 特性：为 bd create 添加 --no-history 标志 — 跳过不符合 GC 清理条件的 Dolt 提交\n* 667302606895cfab2290fb18a6837a21d81b156d 特性：添加 --skip-agents 标志及无分支\u002FJJ 文档（GH#1335）\n* 04799bc229e3fbdc0e59941705c8b7da99781bee 特性：添加 bd import 命令，用于增量 JSONL 导入\n* 4d14fb8ce1aaca033d6f2f4b5987c87ccc9e23e2 特性：在引导过程中自动检测 Git 远程仓库上的 beads 数据库\n* 05142d01603d411a2b9aa2ab74507469c3469a38 特性：将主要 SSOT 部分的替换整合到","2026-03-16T02:13:06",{"id":187,"version":188,"summary_zh":189,"released_at":190},153952,"v0.60.0","## beads v0.60.0\n\n适用于 Linux、macOS（Intel 和 Apple Silicon）、Windows（AMD64 和 ARM64）、Android\u002FTermux（ARM64）以及 FreeBSD 的预编译二进制文件。\n\n### 安装\n\n**Homebrew（macOS\u002FLinux）：**\n```bash\nbrew install beads\n```\n\n**快速安装（macOS\u002FLinux\u002FFreeBSD）：**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**手动安装：**\n请在下方下载适合您平台的二进制文件，解压后将其放置在您的 PATH 环境变量中。\n\n## 更改日志\n### 功能\n* 43bca275bf79d01a464a4b25cb02c5790dfb1640 feat: 支持 JSON 格式的错误输出 + JSONL 模式验证 + 合约测试（GH#2499）\n* 71d7ae593b54d9e0c820e29e49b2b998dcf360ad feat: 添加 --design-file 标志，用于从文件中读取设计\n* 12dc4e075003308fe1e511df350e844f16478ecd feat: 添加 --destroy-token 标志，用于安全的非交互式重新初始化（GH#2497）\n* 9dc875a98efd8c76dbf8e711ed47160ddc928ce5 feat: 在 bd help 中添加 --list 和 --doc 标志，用于生成 CLI 文档（GH#2527）\n* 0cf8666fff4ec75b47ad831c372de447835211eb feat: 添加 GitHub Issues 集成（跟踪器插件）（GH#2373）\n* ac9ac70911d399051fde1ab53cda730c96baa111 feat: 添加 bd context 命令和安全优先的错误提示（修复合并 PR #2496）\n* 0bb3bf20a042778572bb71116e5b80598411a5ff feat: 添加工作区身份预检和 bd bootstrap 命令（GH#2438，GH#2372）\n* efd7568de5a08083c0fe292636d354cfcb178875 feat: bd bootstrap 现在会执行恢复操作，而不是仅打印建议\n* 2df714ffcf02d378d56ad06314bc13c7c3f4a16a feat: bd done \u003Cid> \u003Cmessage> 将最后一个参数视为原因\n* 21e23bc57148ecc0398e37eacf5bc66a476cb016 feat: 重大关闭保护、合并重定向父级以及进度显示\n* b7cc484441e7ce5f0cc57f9e4816b446c9542dc2 feat: 将基于哈希的 Dolt 端口替换为操作系统分配的临时端口（GH#2415）\n* 5e1d4b9d94c9722f800f0925d79c1df591cca716 feat: 在 bd search 中搜索 external_ref（GH#2494）\n* 3a2d351ea87c558f2d612ee72b9aa10b32771427 feat: 支持全局 ~\u002F.config\u002Fbeads\u002FPRIME.md 回退文件（GH#2330）\n### 错误修复\n* 0c12f463a1c695ed84725843a455858f49197302 Merge PR #2390: fix(deps): 更新 github.com\u002Fdolthub\u002Fdriver 的摘要至 bbe1450\n* dbbe212663f9eac49a7f3a6b72253a02ebb796af Merge PR #2408: fix(worktree): 当父目录模式已覆盖时，跳过 .gitignore 的追加\n* c3e70573befbdb63b82f6656a318c0e12acefb6e Merge PR #2413: fix(deps): 将 opentelemetry-go 单体仓库更新至 v1.42.0\n* 93841bd8af0c7203516511b927a696e53eccec2a Merge PR #2417: fix: 当 RootOnly=true 时，bd mol wisp 会报告错误的数量\n* 3502cb48867ce97a4addec286f2565fe72a375a5 Merge PR #2432: fix: 使用 Root().PersistentFlags() 来检查 PersistentPreRun 中的 --json 标志\n* 1d255044bf397b9773581693067b4d3356a10e49 Merge PR #2440: fix: 替换 CLI 帮助、设置生成器和文档中的过时 'bd sync' 引用\n* 1ffbd0f44b6f446b34d8ecfa4395560f8abd72ac Merge PR #2443: fix(list): 当 --tree 默认为 true 时，--json 标志会被忽略\n* f1e60736d4378883b","2026-03-12T04:02:07",{"id":192,"version":193,"summary_zh":194,"released_at":195},153953,"v0.59.0","## beads v0.59.0\n\n适用于 Linux、macOS（Intel 和 Apple Silicon）、Windows（AMD64 和 ARM64）、Android\u002FTermux（ARM64）以及 FreeBSD 的预编译二进制文件。\n\n### 安装\n\n**Homebrew（macOS\u002FLinux）：**\n```bash\nbrew install beads\n```\n\n**快速安装（macOS\u002FLinux\u002FFreeBSD）：**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**手动安装：**\n请在下方下载适合您平台的二进制文件，解压后将其放置到您的 PATH 环境变量中。\n\n## 更改日志\n### 功能\n* 57e576e903adbed213b80616a113de38f919ffeb 合并 PR #2342：新增功能：在全新克隆的错误流程中暴露 sync.git-remote\n* b3decc265920f430aa3c9e919b9e2bfd9a913b01 新增功能（bd）：移除守护进程基础设施（w-bd-001）\n* b4b586d3cc8eef1217005e69e046e7dd44f40d33 新增功能（doctor）：允许通过配置抑制特定警告（GH#1095）\n* 7702ebe566f0b1ffe0755e7747b830f8941c3267 新增功能（doctor）：检测 Dolt 服务器上的全新克隆状态\n* 1ca5e8ca01bc777672e28c24ef9c0ed6db83c796 新增功能（dolt）：在数据库未找到的错误中暴露 sync.git-remote\n* 4e408bc5fb7924923a73301216678d17defc7a72 新增功能（init）：在 init 检查中区分服务器是否可达与数据库是否存在\n* 7f41edd9c4350e5c68ebec6f9571e27833f27133 新增功能（nix）：为 nixpkgs-25.11 现代化 flake，修复合并 PR #2314\n* 5ea0eaa16d73419389cb2b623e04c45b203401b7 新增功能：将 OpenCode 配方添加到 bd 设置中\n* 7c8cd89e5c9a76291ac1d357852295e16a47b62e 新增功能：为 END 标记添加版本号，以便未来更好地匹配\n### 错误修复\n* a9a9c7a451a0cbfbcfddd8a0822f15c557ad44e9 合并 PR #2293：修复依赖项：将 fastmcp 更新至 v3\n* 6adf14b0755ef9d3e37cc66bebf6f5771b046405 合并 PR #2300：修复：当 Dolt 镜像未缓存时，跳过 Docker Hub 的网络请求\n* 8d3de51a18be11de79da9c0f7468e4c281a747bb 合并 PR #2322：修复文档：修正 QUICKSTART.md 中具有误导性的示例\n* 3b9ef20dd2b9f401f44372861475979c6004f160 合并 PR #2329：修复 dolt：批量处理所有 IN 子句查询，以防止全表扫描\n* 1be0a4174eb18cc98e1505ca47239d18dc335115 修复备份：默认关闭 git-push，需显式选择启用\n* 1b26227f978b95bac2270a9dbf4548c59c14caaf 修复备份：默认关闭 git-push，需显式选择启用\n* d14bed560016d6b493b5c096179481a341ddaa78 修复备份：在 hook 运行期间及功能分支上跳过 git 提交\n* 0b155507ff3a7f5ce566f85bd6e792d70835aaa4 修复电路：将冷却时间缩短至 5 秒，并添加主动 TCP 健康检查\n* 6e9a86feb50eae66ab1d3b0b5686ab8d0721e172 修复配置：将 backup.* 键路由至 config.yaml，以便尊重覆盖设置\n* 1b921b94823f4fe0574399a570f6e1c0dbd7e36f 修复依赖：为 dep 命令添加跨前缀路由（#2296）\n* 5cc48cf4b87e0179e731c66c9ded2d242edcd478 修复依赖：将 fastmcp 更新至 v3\n* d3c845cf1c758655c25db7dc6ab731fa30bbe3d7 修复依赖：将 github.com\u002Fdolthub\u002Fdriver 的摘要更新至 37b6617\n* 2d9ad516ef3140cf9d6b01084a229006cfa3e7f7 修复文档：修正 QUICKSTART.md 中具有误导性的示例\n* 431d84040","2026-03-06T00:07:28",{"id":197,"version":198,"summary_zh":199,"released_at":200},153954,"v0.58.0","## beads v0.58.0\n\n适用于 Linux、macOS（Intel 和 Apple Silicon）、Windows（AMD64 和 ARM64）、Android\u002FTermux（ARM64）以及 FreeBSD 的预编译二进制文件。\n\n### 安装\n\n**Homebrew（macOS\u002FLinux）：**\n```bash\nbrew install beads\n```\n\n**快速安装（macOS\u002FLinux\u002FFreeBSD）：**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**手动安装：**\n请在下方下载适合您平台的二进制文件，解压后将其放置到您的 PATH 环境变量中。\n\n## 更改日志\n### 功能\n* 94b699c41132f2c74cac3ccb4c9fcffa4dd47273 合并 PR #1995：新增功能：允许每个工作树的 .beads\u002Fredirect 覆盖主仓库\n* f6b04f741b1d44582ad29bd60efcbf37f8a0dc2f 合并 PR #1996：查询功能：在 bd 查询 DSL 中添加 has_metadata_key\n* 24e12a316aafa8392f8a81dd6ddcfcba9c246406 合并 PR #2088：新增功能：添加使用 Jira V2 API 的选项\n* 21ca8454f9650f91c7d0c3f0e3f702721f78f7a6 合并 PR #2143：新增功能：添加 dolt-data-dir 配置，用于自定义 Dolt 数据目录\n* a9ca7b78a2c73384d7d4d908a68f14e205b39d4a 合并 PR #2178：Dolt 功能：SSH 推送\u002F拉取回退 + 双面远程管理\n* feb8a007f9646adcd1884441d3dd4f10bc8a2eca 合并 PR #2221：新增功能：第一阶段钩子普查和迁移规划 (#2217)\n* 2ec8c10098f9e82cb566c575398ac77bf021e9ff 合并 PR：新增功能：在 bd init 中添加 --backend 标志，并附带 SQLite 已弃用的通知 (bd-7xj5)\n* e688ea767d76f9098bbe40a6b6dd65eb27ec71ea 备份功能：新增 'bd backup restore' 命令，用于从 JSONL 备份中启动\n* d82110945a327b7304bc38f8875dea1aa78597a7 备份功能：新增 JSONL 备份命令和自动备份支持\n* 051a43dd832cdbaa4c283d3bc0048cb7fd412f9d 备份功能：当存在 Git 远程时，自动启用 JSONL 备份\n* 84c954031a9556ee0508a243a5e23442abe462ae CLI 功能：为 bd close 添加 --comment 别名，为 bd mol burn 添加 --yes\u002F-y 别名\n* a3dd6531d3e98f15c71b6b120c45a9b94d15b102 CLI 功能：在命令反馈中显示标题 (GH#1384)\n* 587eabb5aae0ac16601bbd49e2ba5b6903490ad2 医生功能：将待处理的钩子迁移整合到 --fix 中\n* 573bdd1b4c37fdb33d4df4f3234eaa1d258ac03d Dolt 功能：新增 'bd dolt remote' 子命令（添加\u002F列出\u002F删除）\n* f710909589a95fc2bfe3cbc5f34a5d3265ea6c29 Dolt 功能：自动推送到 Dolt 远程，延迟 5 分钟\n* 20516a49079786502560316ec86efaa22d11f561 Dolt 功能：双面远程管理（SQL + CLI）\n* a30e02a5ee906ee57e18630ad7a1f1fcaef14728 初始化功能：新增 --database 标志，用于配置现有服务器数据库 (#2102)\n* 8cc0874f05af503400566bc567f1e8a82f7f72e8 初始化功能：将 sync.git-remote 配置接入 bd init，实现自动引导\n* 9a2eea88a9bab8ad4674c38a78fb82b50cd39016 标签功能：在创建子标签时继承父标签\n* e17d73ae9d1a5fea3d9bab373f9657c619512184 线性功能：新增项目同步支持\n* 3a86e9fdde86e3f4a52e701d9a20d7f65a5403ae MCP 功能：新增专用索赔工具，用于原子化开工 (#2071)\n* 5f0b3befa7f38d4bca5aadc6f9f550e4b7db043c 协议功能：la","2026-03-03T06:33:46",{"id":202,"version":203,"summary_zh":204,"released_at":205},153955,"v0.57.0","## beads v0.57.0\n\n适用于 Linux、macOS（Intel 和 Apple Silicon）、Windows（AMD64 和 ARM64）、Android\u002FTermux（ARM64）以及 FreeBSD 的预编译二进制文件。\n\n### 安装\n\n**Homebrew（macOS\u002FLinux）：**\n```bash\nbrew install beads\n```\n\n**快速安装（macOS\u002FLinux\u002FFreeBSD）：**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**手动安装：**\n请在下方下载适合您平台的二进制文件，解压后将其放置在您的 PATH 环境变量中。\n\n## 更改日志\n### 功能\n* 94b699c41132f2c74cac3ccb4c9fcffa4dd47273 合并 PR #1995：新增功能：允许每个工作树的 .beads\u002Fredirect 覆盖主仓库\n* f6b04f741b1d44582ad29bd60efcbf37f8a0dc2f 合并 PR #1996：查询功能：在 bd 查询 DSL 中添加 has_metadata_key\n* 24e12a316aafa8392f8a81dd6ddcfcba9c246406 合并 PR #2088：新增功能：添加使用 Jira V2 API 的选项\n* 21ca8454f9650f91c7d0c3f0e3f702721f78f7a6 合并 PR #2143：新增功能：添加 dolt-data-dir 配置，用于自定义 Dolt 数据目录\n* a9ca7b78a2c73384d7d4d908a68f14e205b39d4a 合并 PR #2178：Dolt 功能：SSH 推送\u002F拉取回退 + 双面远程管理\n* feb8a007f9646adcd1884441d3dd4f10bc8a2eca 合并 PR #2221：新增功能：第一阶段钩子普查和迁移规划 (#2217)\n* e688ea767d76f9098bbe40a6b6dd65eb27ec71ea 备份功能：添加 'bd backup restore' 命令，用于从 JSONL 备份中引导启动\n* d82110945a327b7304bc38f8875dea1aa78597a7 备份功能：添加 JSONL 备份命令和自动备份支持\n* 051a43dd832cdbaa4c283d3bc0048cb7fd412f9d 备份功能：当存在 Git 远程时自动启用 JSONL 备份\n* 84c954031a9556ee0508a243a5e23442abe462ae CLI 功能：为 bd close 添加 --comment 别名，为 bd mol burn 添加 --yes\u002F-y 别名\n* a3dd6531d3e98f15c71b6b120c45a9b94d15b102 CLI 功能：在命令反馈中显示标题（GH#1384）\n* 573bdd1b4c37fdb33d4df4f3234eaa1d258ac03d Dolt 功能：添加 'bd dolt remote' 子命令（添加\u002F列出\u002F删除）\n* f710909589a95fc2bfe3cbc5f34a5d3265ea6c29 Dolt 功能：以 5 分钟防抖动机制自动推送到 Dolt 远程\n* 20516a49079786502560316ec86efaa22d11f561 Dolt 功能：双面远程管理（SQL + CLI）\n* a30e02a5ee906ee57e18630ad7a1f1fcaef14728 初始化功能：添加 --database 标志，用于配置现有服务器数据库 (#2102)\n* 8cc0874f05af503400566bc567f1e8a82f7f72e8 初始化功能：将 sync.git-remote 配置接入 bd init，实现自动引导\n* 9a2eea88a9bab8ad4674c38a78fb82b50cd39016 标签功能：在创建子标签时继承父标签\n* e17d73ae9d1a5fea3d9bab373f9657c619512184 线性功能：添加项目同步支持\n* 3a86e9fdde86e3f4a52e701d9a20d7f65a5403ae MCP 功能：添加专用索赔工具，用于原子化开始工作 (#2071)\n* 5f0b3befa7f38d4bca5aadc6f9f550e4b7db043c 协议功能：第 6 条 — 新增 10 项协议不变量测试\n* 74ffe2303b4cb4ffad948c073434d356a833d095 准备功能：在 bd ready 中添加元数据过滤（GH#1406）\n* 5fd7fe352f08fde44973ff7fd4cef0006da7af27 回归功能：用快照替换 bd export","2026-03-01T08:44:50",{"id":207,"version":208,"summary_zh":209,"released_at":210},153956,"v0.56.1","## beads v0.56.1\n\n适用于 Linux、macOS（Intel 和 Apple Silicon）、Windows（AMD64 和 ARM64）、Android\u002FTermux（ARM64）以及 FreeBSD 的预编译二进制文件。\n\n### 安装\n\n**Homebrew（macOS\u002FLinux）：**\n```bash\nbrew install beads\n```\n\n**快速安装（macOS\u002FLinux\u002FFreeBSD）：**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**手动安装：**\n请在下方下载适合您平台的二进制文件，解压后将其放置到您的 PATH 环境变量中。\n\n## 更改日志\n### 功能\n* 8561884cbabea023512b117b0b9356100378ea91 feat(cook): 支持在 bd mol wisp 中独立执行扩展公式 (#1903)\n* 1d4ff862de3c125b389f89617e24362516144b29 feat(import): 添加 --skip-prefix-validation 标志，用于旧版数据迁移\n* 0c2d95c3cba5cca65c46ce70db1dcdc3ae113e61 feat(metadata): 在 bd show 和 bd list --long 中添加可读元数据可见性 (#1905)\n* 6e4ad9b283d743876c2ace91dd30d161d8dba8de feat(otel): 可选的 OpenTelemetry 指标监控 (#1940)\n* f383ce3efd49face1ff84d05807074b08746c40f feat(setup): 添加 Mux 设置配方，支持分层 AGENTS 和托管钩子\n* b2f7cc389fb7ca815cd368c7bde827a7b9832e05 feat(storage): 添加哨兵错误 ErrNotFound、ErrNotInitialized 和 ErrPrefixMismatch\n* 32a3bbaf85cd35f018e96a5049dbc2630aa383f1 feat: 添加 SIGTERM\u002FSIGHUP 批量提交刷新功能，并改进提交信息\n* 836835d8f6818d40417e600579d77c81ea3362d6 feat: 为 Dolt 添加批量自动提交模式，以减少提交膨胀\n* f06c2801db46f09e0e0865f2a345d4072a05da64 feat: 添加 bd migrate wisps 命令，用于 SQLite 到 Dolt 的临时数据迁移\n* 824481874d23781bc6ceedcecdd27aeaef98f446 feat: 为 RunInTransaction 添加提交信息参数，以便记录 Dolt 历史\n* b13720ddb19d239582d4ff20c61ec98581a13fb3 feat: 添加 dolt_ignore 模式并创建 wisps 表 (bd-f6b62)\n* 1ade634aa4a690c078b76155e27fc117909e7df3 feat: 移除 dolthub\u002Fdriver 依赖 — 二进制大小从 168MB 减少至 41MB\n* 87d49a6cc13cc41e0456358857f4cf8c5e88a14e feat: 使用 embed.FS 嵌入 AGENTS.md 模板，并添加 --agents-template 标志\n* 00e802f60c02b44f2c01fae1ee23962892daad56 feat: 使元数据可通过 bd list、bd search 和 bd query 查询 (#1908)\n* c4010c1977e6b19f80889e011444eb840eb84802 feat: 移除 dolt 命令中的 CGO 构建标签分支\n* ec62bc3faa23ea9041f1c653d80e768d048fa1eb feat: 移除 SQLite 临时存储代码及依赖项\n* 8e5710b5b35f454473fb08ec7bd12e4d2ba004b5 feat: 从医生检查中移除嵌入式 Dolt 模式（仅限服务器）\n* e2e341053fa1cf5abaa1df9a4683efaf732a1a99 feat: 从 init 和主命令路径中移除嵌入式 Dolt 模式\n* 630e1029beb1e2a1dc1b7b2e2a517ea9d4b0c5e4 feat: 将 wisp CRUD 路由至 dolt_ignored wisps 表，移除 SQLite 临时存储\n* 00f546f71e2f346d5ee05595962bfa5a8633eb83 feat: 为 Dolt 并发操作提供事务隔离、重试机制和批量封装\n### 错误修复\n* 7269df8481c6c4d6c621205ecf6bbebde748e2a5 fix(cook): ma","2026-02-23T03:41:08",{"id":212,"version":213,"summary_zh":214,"released_at":215},153957,"v0.55.4","## beads v0.55.4\n\n适用于 Linux、macOS（Intel 和 Apple Silicon）、Windows（AMD64 和 ARM64）、Android\u002FTermux（ARM64）以及 FreeBSD 的预编译二进制文件。\n\n### 安装\n\n**Homebrew（macOS\u002FLinux）：**\n```bash\nbrew install beads\n```\n\n**快速安装（macOS\u002FLinux\u002FFreeBSD）：**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows（PowerShell）：**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**手动安装：**\n请在下方下载适合您平台的二进制文件，解压后将其放置到您的 PATH 环境变量中。\n\n## 更改日志\n### 功能\n* 79ab4a464432c244d164b3f54fc51692b45f86f2 特性：为 wisps\u002Fmolecules 添加 SQLite 临时存储（bd-pedpnn）\n\n","2026-02-20T19:52:28",{"id":217,"version":218,"summary_zh":219,"released_at":220},153958,"v0.52.0","## beads v0.52.0\n\nPre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android\u002FTermux (ARM64), and FreeBSD.\n\n### Installation\n\n**Homebrew (macOS\u002FLinux):**\n```bash\nbrew install beads\n```\n\n**Quick Install (macOS\u002FLinux\u002FFreeBSD):**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**Manual Install:**\nDownload the appropriate binary for your platform below, extract it, and place it in your PATH.\n\n## Changelog\n### Bug Fixes\n* bb3fef966292caea9cc327b184d4a2a35a9deb26 fix(ci): resolve gosec G204 and unparam lint warnings\n* 9652a5e603de15d2eac90c8609a339b3184d2172 fix: block rename-prefix in git worktrees to prevent JSONL staleness (#1645)\n* 3f4c0ab4d2cc08e9d1411ab12deb2743dc65de73 fix: expand tilde in core.hooksPath on Windows (GH#1796)\n* 780be2d7b30a4d336468c61c471f0d4fb32407bc fix: guard dolt directory creation with server-mode check (#1800)\n* 2beaad3ae73a91e0ec85a766a5214f3775844cdf fix: guard dolt directory creation with server-mode check (bd-vyr)\n* abfcdd30a215137bda6da66a762294020e1c401a fix: resolve worktree redirect paths from worktree root, not .beads\u002F dir (#1266)\n### Others\n* 180030c6931c306930972e5980a20718fa69d6bc Block rename-prefix from running in git worktrees (#1792)\n* f581cf9456b5274584a3ed85ad299774dfc5e044 Fix CI: add stubs.go to gosec G204 exclusion (#1790)\n* 7eaea49b82e0108ff313c590923162fa54d43355 Fix bd ready excluding ephemeral issues, add --include-ephemeral flag\n* a6273c1f0bf202691b238ef34ef8a23ddb71253f Fix doctor redirect target resolution\n* 11ccf7a9d244e956e98fc7a67d557754c3512772 Fix doctor redirect target resolution (#1803)\n* ba15514f094490c73a8c9dc5e4339529c24c427e Fix getRedirectTarget() path resolution in worktree list (#1791)\n* bf6b47e22cfacf6bec80003d4b3ca161b9379bfc Fix tilde expansion in core.hooksPath on Windows (#1798)\n* 5075a873b57fa4f8d3d5ab934ea8564f2c159251 Remove dead git-portable sync functions (#1793)\n\n","2026-02-17T00:12:24",{"id":222,"version":223,"summary_zh":224,"released_at":225},153959,"v0.51.0","## beads v0.51.0\n\nPre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android\u002FTermux (ARM64), and FreeBSD.\n\n### Installation\n\n**Homebrew (macOS\u002FLinux):**\n```bash\nbrew install beads\n```\n\n**Quick Install (macOS\u002FLinux\u002FFreeBSD):**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**Manual Install:**\nDownload the appropriate binary for your platform below, extract it, and place it in your PATH.\n\n## Changelog\n### Bug Fixes\n* 0c6ef53e9444076bed0dad92423f756db4157b60 fix(create): swap dependency direction for explicit blocks: prefix\n* 1590e01eb3dec82f3438350b969519b92d503c24 fix(doctor): add AccessLock to doctor Dolt health checks\n* b24ee9078d5e7487b6ea5ebd944aca018083cc85 fix(doctor): add error-path tests and CloseWithTimeout documentation\n* 7440ef8e5dc73572d19de3dcc6e589a10b0a26a2 fix(doctor): honor --yes for repo fingerprint auto-fix\n* b8ba2de7264202a3d96dbd6eb8aa1215d49149cf fix(doctor): migrate remaining Dolt checks to shared AccessLock connection\n* 3db18e3401f46990470c81a42182adc8971d50db fix(doctor): restore sqliteConnString pragmas dropped by Phase 8 cleanup\n* 7c105633ea6db23fcaf1e17ee416ca3087a56410 fix(dolt): batch DeleteIssues queries to prevent hang on large ID sets\n* 42448554ca45f3b699236108fe9b5de43c48e69e fix(dolt): harden batch DeleteIssues correctness and add comprehensive tests\n* b47f2b9e668662d22e10073fc14a72974b276f7e fix(dolt): seed types.custom in default config\n* 02f4326bf93563eb7d9dfda92047095028b79d70 fix(mol): use analyzeMoleculeParallel for step readiness in bd mol current (#1276)\n* fa5622e347d9556ce7e707bb7b76ecf06baf8746 fix(types): add message as built-in issue type\n* f4f70a377e4eadb70447990f43d909ae73da791d fix: add non-CGO build stubs for goreleaser cross-compilation\n* 6a6c501141e6c090b7d74799f70030f42287d743 fix: deleteBatch signature mismatch and unused types import\n* 63544a5e5c91a3edf84a90d01ef71fb8ffcd9834 fix: dolt config tests corrupt rig metadata.json in worktree environments\n* 6caf05a3ae02b03075e0b5032ffd82c958885558 fix: filter workflow\u002Fidentity types from Dolt GetReadyWork\n* 304c6846e1fddb3d6700b05dfcd5c2af3246f9fa fix: gofmt formatting across 24 files and 2 lint warnings (bd-i4o4e)\n* b74fc0633ae78bf04f1b301059f3d3b9308d78e8 fix: malformed test names and obsolete SQLite-backend doctor tests (bd-gwm8z, bd-yqpwy)\n* 817efc93631452c6e657d815a669842b962303bd fix: read Dolt database name from metadata.json in embedded mode (bd-pqn2e)\n* dd01a655b9602ba20d0c666515467e064a815609 fix: repair test suite for Dolt-only backend (bd-h0zvj.4)\n* dc0dc1c8f40ddce09f4922044f9b247d423a4417 fix: serialize dolt.New() and stdio redirection to eliminate test race conditions (bd-cqjoi)\n### Others\n* 896d5ed361c9cfd58634ef5df828403603adfeea Dolt-native cleanup: remove legacy code, rename API, add server watchdog\n* 225ee7492920ceb4ba2e1110605353ff51318389 Fix typo in dolt migrate command\n* 97fa7ccd18b21bd22d64abaadbfbf15b4b15d99f Revise INSTALLING.md for mise installation methods\n* 5083873779f4daa650e5ab38ff944bf55d88d12d cleanup: delete deprecated SQLite-era docs (EXTENDING.md, MULTI_REPO_HYDRATION.md)\n* 03a14154196498518bac0e44fb9b1b87f47e57ad cleanup: remove stale golangci suppressions and dead compact methods\n* 85ba9bd49f69ff04d1f39cde575e4907f0cb8b87 cleanup: remove stale sqlite refs, fix lint warnings, update Makefile benchmarks\n* 5f59039b5b7b32ea8d4e1a8f905a5b3551495a3b perf(dolt): leverage CASCADE deletes to cut deletion queries by 60%\n* fa191afa29819ca3f2811c290de6a22583c0f5ca perf: skip schema init when already at current version\n* 5ffd625b4005b626081d4bb66ba400932d7ef206 refactor: Phase 8 CLI & config cleanup - remove SQLite\u002Fdaemon remnants (dolt-1s40.8)\n* 0e7461239b1f1d4c0dedbb7134334a4e1bdbd1e7 refactor: fix stale NewSQLiteStorage refs in docs and monitor-webui import (bd-h0zvj.8)\n* 76b2f1e4566ebb0325f7ff80da978bfd8cd85217 refactor: gut JSONL sync engine, keep simple manual import\u002Fexport (bd-h0zvj.2)\n* d6a8462a7303dbae3c95b61e4d4070d73dea2fff refactor: make bd sync a no-op, fix test suite for Dolt-only backend (bd-h0zvj.4)\n* 6a5da9035d3337e9b52fb236e6776c69733aea88 refactor: prune 12 dead\u002Fduplicate DoltStore methods and 650 lines (bd-h0zvj.6)\n* eacaa51617f707902c7f908ecd1e9dda57a1c834 refactor: prune 5 legacy doctor checks and 1457 lines of dead code (bd-h0zvj.4)\n* 51025129174cf113514d6dd22b894aa664414830 refactor: remove 3-way merge engine (Phase 3)\n* 8e10fd09d3b5d37bc94a4bd589ddc98297d76d60 refactor: remove JSONL sync layer (Phase 5)\n* a3bf3ee38178b590d2bb4339670236ebc69cce97 refactor: remove SQLite backend (Phase 6)\n* 6c82467b71b0056171cc8b2655534e350b69b6ad refactor: remove SQLite migration code and legacy backend detection (bd-h0zvj.3) [WIP]\n* cddddf72e307398d7e1faef4b1cab60eb1661ce6 refactor: remove all no-op stubs and dead functions (bd-h0zvj.1)\n* 5b6e015bb18cd07bf7735506","2026-02-16T19:18:18",{"id":227,"version":228,"summary_zh":229,"released_at":230},153960,"v0.50.3","## beads v0.50.3\n\nPre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android\u002FTermux (ARM64), and FreeBSD.\n\n### Installation\n\n**Homebrew (macOS\u002FLinux):**\n```bash\nbrew install beads\n```\n\n**Quick Install (macOS\u002FLinux\u002FFreeBSD):**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**Manual Install:**\nDownload the appropriate binary for your platform below, extract it, and place it in your PATH.\n\n## Changelog\n### Features\n* 3728ac1f08e1c404f9351696bdcb449b16eff6c9 feat: add PullHooks\u002FPushHooks to SyncEngine for battle-tested CLI behaviors\n### Bug Fixes\n* 0987367a8deda8e2263ca9833be12ac7153d8f08 fix: add routing and label-based agent check to bd slot commands (bd-yw7ui)\n* 118e451f6577263e57fa7ede9bb5896eff1026f1 fix: remove stale State assignment in jiraToTrackerIssue\n* 1f59a21bd71edb7454eb3b5bf9f701e1f46a6968 fix: use Required field for formula variable validation\n* 3b8562eb5e02b50901ac257f7fce9df3542f5119 fix: use errors.New for Jira sentinel error, add Jira tracker tests\n* 7de76f36aca7533f01e4606ded341fd112d5baa2 fix: wire FormatDescription hook in doPush, add GenerateID\u002FFormatDescription tests\n### Others\n* d582e00ffc916145187ca779cc387f8af9b2872f perf(tests): replace ~60 git init subprocess calls with cached template copy\n* fe2b537e52bf68fccdc6a0b4884c9e6910af5321 refactor: extract Jira integration into internal\u002Fjira\u002F package\n* 3c45dcbde43584bdf6f4f522c06c59c29a371ca2 refactor: inline tracker adapters into internal packages\n* 8f00fb7e76237d5d812a02cc9099256d56c2d069 refactor: wire Jira CLI through SyncEngine, delete duplicated sync code\n* 5a5407fafeab1a2a4584b0b05d09577d18e21d6a refactor: wire Linear\u002FGitLab CLI through SyncEngine, delete duplicated sync code\n* db1c3d773c514c68f72a2bfdfe620a750025e64b style: fix gofmt formatting across 14 files\n\n","2026-02-15T02:35:38",{"id":232,"version":233,"summary_zh":234,"released_at":235},153961,"v0.50.2","## beads v0.50.2\n\nPre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android\u002FTermux (ARM64), and FreeBSD.\n\n### Installation\n\n**Homebrew (macOS\u002FLinux):**\n```bash\nbrew install beads\n```\n\n**Quick Install (macOS\u002FLinux\u002FFreeBSD):**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**Manual Install:**\nDownload the appropriate binary for your platform below, extract it, and place it in your PATH.\n\n## Changelog\n### Features\n* 3894fd364fafa9c91a9a633cc3d9f4c5cfc9b6a1 feat: nudge all SQLite users to migrate to Dolt\n### Bug Fixes\n* 6c00524c767160b59d0aec9e78891487fae79acf fix(beads): stop FindBeadsDir walk from escaping sibling worktree boundary (#1731)\n* 1eb3bc1e4df7b0b2ede1070e0ec0c7f7be751ac6 fix(doctor): correct plugin install command in doctor output (#1732)\n* 3bdc97878c74b455cbde036a0e7fe9c1a386c5af fix: bump npm package version to 0.50.2\n* f7311e91364bc7001eefab85778a3a18a88a366f fix: reliable metadata writes for Dolt backend (bd_version, repo_id, clone_id) (#1741)\n* 53694a87ee0b9e53c3d71d48526771a00128afd7 fix: update backend descriptions to reflect Dolt as default since v0.50\n### Others\n* 1c92e9ce1c7c515872237c5a6f91ccd4e0e41773 perf(doctor): fix O(n) full-table scans causing 130s doctor runs (#1706)\n\n","2026-02-14T23:46:23",{"id":237,"version":238,"summary_zh":239,"released_at":240},153962,"v0.50.1","## beads v0.50.1\n\nPre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android\u002FTermux (ARM64), and FreeBSD.\n\n### Installation\n\n**Homebrew (macOS\u002FLinux):**\n```bash\nbrew install beads\n```\n\n**Quick Install (macOS\u002FLinux\u002FFreeBSD):**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**Manual Install:**\nDownload the appropriate binary for your platform below, extract it, and place it in your PATH.\n\n## Changelog\n### Features\n* cf4ffec01306d5162fb99bc148dd9ac499cda153 feat: add GitLab adapter for tracker framework (GH#1150)\n* 7b3148d1399e804fdc228b44420ad194d8c3e95c feat: add Linear adapter for tracker framework (GH#1150)\n* 66ffc44e9cbe773c64b51d4b79f9481075763088 feat: add audit log for bd dolt config set changes\n* 9d29ffd236657cbde46196f393b121d09e7d9f35 feat: add plugin-based issue tracker framework (GH#1150)\n### Bug Fixes\n* 32e3e832ebe6b8fcc672ec0f75947671a15c0501 fix(ci): remove dead RPC test code and fix CI failures for v0.50.0\n* 7dca841a4475acaf5e56c0c99249c247bbb5f9b7 fix(lint): add missing exclusions for tracker adapters and dolt audit log\n* 8319a85141d5f86a0922c1700aae70b30d03ffa5 fix: gofmt tracker adapter files\n* c0ad80dc6f0c3cd8c437eb4c3d68730ed985aa8a fix: remove auto-fallback from dolt server mode to embedded mode\n* 9861144c64998929013134f5748400023cbc4c25 fix: remove t.Parallel() from graph tests that race on os.Stdout\n\n","2026-02-14T22:40:15",{"id":242,"version":243,"summary_zh":244,"released_at":245},153963,"v0.49.6","## beads v0.49.6\n\nPre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android\u002FTermux (ARM64), and FreeBSD.\n\n### Installation\n\n**Homebrew (macOS\u002FLinux):**\n```bash\nbrew install beads\n```\n\n**Quick Install (macOS\u002FLinux\u002FFreeBSD):**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**Manual Install:**\nDownload the appropriate binary for your platform below, extract it, and place it in your PATH.\n\n## Changelog\n### Others\n* c064f2aa99814d65a439b7b700fa02c44c4e0bb2 release: v0.49.6\n* 2137693dad433942cf41df15c0259f8cbcdfe94d revert: restore embedded Dolt mode (was only supposed to be removed from Gas Town)\n\n","2026-02-08T06:06:40",{"id":247,"version":248,"summary_zh":249,"released_at":250},153964,"v0.49.5","## beads v0.49.5\n\nPre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android\u002FTermux (ARM64), and FreeBSD.\n\n### Installation\n\n**Homebrew (macOS\u002FLinux):**\n```bash\nbrew install beads\n```\n\n**Quick Install (macOS\u002FLinux\u002FFreeBSD):**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**Manual Install:**\nDownload the appropriate binary for your platform below, extract it, and place it in your PATH.\n\n## Changelog\n### Features\n* 3c167b82e74ac630f0be2679a84e4124fb167806 feat(dolt): fail-fast TCP check before MySQL protocol initialization\n* e06e0cc866bb7630888ecd8846609187a620f547 feat: add bd find-duplicates for AI-powered duplicate detection (bd-581b80b3)\n* 4d16070158272351c4890c46d3c512f915a89bf9 feat: add bd promote command for wisp-to-bead promotion (gt-7mqd.9)\n* 55a41404405f887d08e8960662e5e25aa28963f5 feat: add bd todo command for lightweight task management\n* 24ba7e31f44c7acc4554b3ffa26608e740364993 feat: add bd validate command for data-integrity health checks (bd-e108)\n* 6d99a8c04f2df94459800a5eb9edd79fcacf3118 feat: add content and null-check filters to bd search (bd-au0.5)\n* a6cbb7cdb2e0b1e72aa552f129f463a62cd9d8c2 feat: centralize AI model config into ai.model with DefaultAIModel()\n* 6fe7f20e38d6090d7b0b458ba39f2d697383e7d4 feat: default to chaining hooks in bd init instead of prompting (bd-bxha)\n* 66b7fc4a45d2fd82df906cb66031122932a2236d feat: embed Windows PE version info to reduce antivirus false positives (bd-t4u1)\n* e5330641228d90a22ae7530e1e815565f831289b feat: remove embedded Dolt mode, keep server-only connections (bd-esqfe)\n### Bug Fixes\n* f5e0de4daa56935d3a041d81840bbd3da675d9f3 fix(ci): resolve lint failures and test guard false positive (#1550)\n* f763b15cef3807a42a5a0fa792b996734d751572 fix(ci): resolve lint failures and test guard false positive on main\n* 31687be254d9c5efb23ae1dc9a02ba482c23171d fix(ci): unbreak Nix and Windows CI\n* 307cd1b1b518d0237b88a4eb00800b3a82d5cfa6 fix(ci): update vendorHash, fix pre-existing lint failures\n* 9affc8f9f631308c634f9d0cbe7fad6d06521fe2 fix(config): log when viper uninitialized in getConfigList\n* d0cb6506e4ffcf77bcb0caef929ca5132cbbbda8 fix(config): write beads.role to git config instead of SQLite\n* 3ba6bc3ffdc6770717a61c20c386469038e3be28 fix(daemon): use rpc.ShortSocketPath for daemon status\u002Fhealth\u002Fmetrics\n* 7057b080948eaf12177c10f98e9cb86ba7df2878 fix(docs): correct markdown link syntax in COMMUNITY_TOOLS.md\n* 3d4ac66449025cd2dacf78e51a682c4af72fc69a fix(doctor): correct brew upgrade command from \"bd\" to \"beads\"\n* c9f68c2ba99f40693cd5be5e1d0def8e93ac3429 fix(doctor): improve output formatting with summary-first layout (bd-4qfb)\n* 282c13e2bc4de4cbd934fb50f8d4a7d7213eeeaf fix(dolt): clean test tables in setupTestStore to prevent duplicate primary key errors\n* ac0ff2e53c17eaf94bf7b5d05dbf3a54e24f7202 fix(gitignore): add .jsonl.lock to template and requiredPatterns\n* 85bd4bb298459461c6b269ca576ef2b232cec3e2 fix(lint): suppress unparam for doctor\u002Fsqlite_open.go readOnly\n* 1296242541e8727964d88adae0eeb8021921a9ee fix(merge): use strings.HasPrefix to prevent panic on short error messages\n* 3e8bc4f03fe7cf326c4fd41bcc1d8a41ca37d8d6 fix(migrate): check for running daemon before dolt migration\n* 8566c342a25ef4ad45e87312152007b7dcaf4501 fix(nix): update flake.lock, remove CI workaround\n* a96df5ab94077281fa56d02859a7fd6d77d99017 fix(rpc): pass issueID via closure to prevent empty mutation events\n* fea2bc75846580554637a183237930c9512fc602 fix(rpc): replace hardcoded \u002Ftmp paths with t.TempDir() in tests\n* 531f7a9f7db22f93c8ce81d8f5d12db215660566 fix(security): path traversal in export handler and command injection in import\n* 85a5b845e249276cf559e744278a9b0d6b5dbafd fix(security): upgrade Go toolchain to 1.25.7 for CVE-2025-68121\n* eb1049baf371de3988123244bacac01b1a62ef67 fix(sqlite): make Close() idempotent to prevent WAL retry deadlock (bd-4ri)\n* 0f14a110a8025d2b6bb0fcf776a6ab42116e376f fix(sync): apply --ours\u002F--theirs strategy to conflict resolution\n* 914146d4c708b2d119447efbbdfeeb63f5d05787 fix(sync): include tombstones in auto-flush full export\n* f72000ab7a66a984b77db7397c4f9a2084e7fb1d fix(tests): add missing assertions to RPC coverage and list filter tests\n* 5b8090ec5e99eafa2357e82cc4a984561c2addd4 fix(tests): re-enable deadlock test and add timeout guards for peer sync (dolt-test-ebm)\n* 32738345fd907e8d866b768cf5e53e0ca2200185 fix(update): log DB error when GetCustomTypes fails\n* 182655ca74b22fd7301a0309e359d4b2f481b6bb fix(update): skip type pre-validation in daemon mode\n* 16ac05c8ef4dd27a561a7df1bea2170e4fb92712 fix: ShouldExportJSONL reads DB directly, returns false in dolt-native mode\n* 3d01c7feccf666cac987cc62e9320e2472bb31a2 fix: Support cross-prefix ID resolution in multi-repo scenarios (GH#1513)\n* 69ab6b67cb839cf9e4519162c59dffff8febef85 fix: ","2026-02-08T04:34:36",{"id":252,"version":253,"summary_zh":254,"released_at":255},153965,"v0.49.4","## beads v0.49.4\n\nPre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android\u002FTermux (ARM64), and FreeBSD.\n\n### Installation\n\n**Homebrew (macOS\u002FLinux):**\n```bash\nbrew install beads\n```\n\n**Quick Install (macOS\u002FLinux\u002FFreeBSD):**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**Manual Install:**\nDownload the appropriate binary for your platform below, extract it, and place it in your PATH.\n\n## Changelog\n### Features\n* ebead133d8633ce3d7bf903bbfba293cf0a7a26a feat(bd): add wisp_type field support for TTL-based compaction (gt-7mqd.2)\n* e8158aec3d22853a88bd349e4a288c8665e22a82 feat(cli): add --metadata flag to bd update (bd-0vud2)\n* feae3bc46500e8ad085c283bdc74f18c40b74f10 feat(config): support .beads\u002Fconfig.local.yaml for local overrides\n* 30e8c992f7122a6615b8ef9d774a6cc63c80ed51 feat(doctor): add Dolt migration validation checks (gt-nibe)\n* 22e21c6ae3dc9302ce59cdd11acc40142a45123a feat(dolt): add BD_SKIP_ACCESS_LOCK env var for lock testing\n* 8b24c125c0e77532a0c0979b06f097e41f9b0d95 feat(make): check repo is up-to-date before install\n* 909085b3b33fe3dd07470b9a6af52ee280fdbfd1 feat(migrate): add agent-managed Dolt upgrade path\n* c2ae767aaee8d0390d194d77fbde26a6ba016b99 feat(migrate): add orphan branch support for sync-branch mode\n* 7e21aef75ab87cbb06b6ea9367215eaa36a29ed1 feat(migrate): make orphan branch default for bd migrate sync (#1148)\n* e5c8c1d77263a002843d451ae4c8d4e919ffed28 feat(schema): add wisp_type column for TTL-based compaction (gt-7mqd.1)\n* 51dc5ffed64a7a3e7833b5562f146f3901e840e0 feat: add 'beads' alias for bd command during installation\n* 46b6b7a45efd294b6141b3677d2d72b168ef2cd0 feat: add --label-pattern and --label-regex flags to bd list\n* fa1218d8a6fd1cfb7e0b3b5ab59d885a6ceb8fb2 feat: add Dolt schema migration runner (bd-ijw)\n* f3874edee0a6feca5fe028f82d998bf49e438d98 feat: add simple query language for complex filtering\n* cf185ce965c923a86d98f50dc1df6cae37307f45 feat: add spec_id field for linking issues to specification documents (#1372)\n* a1c447eb66d72adde55309fbc2fc1ec29e124686 feat: add spec_id support\n* dc038c9272adbbf81109cfee015fb55fa03f6948 feat: allow UpdateIssue metadata updates via json.RawMessage\u002F[]byte (#1417)\n### Bug Fixes\n* 7451ddc61c5db2f1a0ea3b5db2e1fd7657b3145b Merge PR #1279: fix: add JSONL file locking to prevent race conditions\n* 0b92eae664d84050fb15f8b7a130bf2bd521732a Merge PR #1281: fix: add WAL checkpoint robustness with retry logic\n* f220cb4670b8f9a7c279fcee30fd116878f0ab42 fix(autoflush): use unique temp file names for concurrent writes\n* e48e94e248934a7f2c898c50ebc27c2e34f81f9c fix(compact): restore safety logic accidentally removed in cb1e3555\n* b5ae6e8ea1d5e7e58cc2639a1a035f669dc87f7b fix(daemon): add initial JSONL import on startup with hash update\n* 22bbbc474a2698db1b7fc3bf59878bac838df02e fix(daemon): update hash after auto-import to prevent export validation failure\n* 4d9fced9da71a1b6d65a47fed6c8c05925c764bc fix(daemon_lock): update race test to document transient PID state\n* 45647360938b8cb0cd502f3d600cf9c2b91e05f4 fix(dep): use factory.NewFromConfig for cross-rig dependency resolution\n* 1ee9fbe59ef8f584a1c5342f84402f803dbb59d7 fix(doctor): use read-only mode to avoid creating database\n* 6ec19436b38c9b05498d19eabad8364395ae0ed9 fix(dolt): add retry logic for server mode transient connection errors\n* 1c2166ea4c0c1ccecebec76c950cd39033413db5 fix(dolt): add spec_id column migration for existing databases\n* 9f2326b2bdb3ff12ca1cb515a8a9c1404c91a370 fix(dolt): add timeout to embedded Dolt close to prevent indefinite hang\n* eaa4e7993f8675faa8acb53cf15c97a18b1da1fe fix(dolt): fix driver bad connection errors from nested queries in server mode\n* 623c36b9ee6ecd2ae9c2765f217c4aaf3ce70bde fix(dolt): remove FK constraint on depends_on_id for external references\n* 054e92d9f6b8ec0bc16424c614762254be710989 fix(dolt): use correct variable in initSchemaOnDB\n* ead24289ef92a50f68d53695de697f4cf2d68cd6 fix(dolt): work around merge join panic in ready_issues view\n* bc704608f38e4555e91312e368c530a45243cbf7 fix(lint): address unparam warnings in gitlab_sync.go\n* bde38fde95087549fc9074d474dc86e836464c9e fix(lint): handle rows.Close() errors explicitly (G104)\n* 70bc3844be21fb576eafafa11f87292746e00848 fix(lint): suppress G304 false positive for @file.json syntax\n* 76e7aa25b5075551047b474dcab395aaeb695b71 fix(lint): use secure file permissions for lock file (G302)\n* f3317a3cb46beb374ec57e575b7adedd5b0fa30b fix(migrate): use --stdin for cross-platform empty tree creation\n* 1797e33396879baddfb6cfdf92931d91398de27a fix(nix): allow Go toolchain auto-download for version compatibility\n* 4af28d54fabc482decfd4fe76c1386f31b96c00e fix(nix): use Go 1.25.6 overlay for dolthub\u002Fdriver compatibility\n* 24097e047a63b95e43901eef251455a483e7e968 fix(nix): use buildGoModule.override for go","2026-02-05T18:28:27",{"id":257,"version":258,"summary_zh":259,"released_at":260},153966,"v0.49.3","## beads v0.49.3\n\nPre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android\u002FTermux (ARM64), and FreeBSD.\n\n### Installation\n\n**Homebrew (macOS\u002FLinux):**\n```bash\nbrew install beads\n```\n\n**Quick Install (macOS\u002FLinux\u002FFreeBSD):**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**Manual Install:**\nDownload the appropriate binary for your platform below, extract it, and place it in your PATH.\n\n## Changelog\n### Features\n* 0b25ff24685018d8991ab5d9eb3b3898e33ad6d4 feat: make embedded Dolt the default, server mode opt-in\n### Bug Fixes\n* a7cc4e15b208d1f1119c0ac4dbd119770ffb87f9 fix(dolt): eliminate all three-table joins that trigger mergeJoinIter panic\n* 9234aa93a9019317ff9fe89886766c29b6adc79f fix(dolt): prevent mergeJoinIter panic on type-filtered queries\n* 10797865b3b56bff00ed040560a6bbe5ba1367c3 fix(template): filter Handlebars keywords in extractVariables (#1411)\n* 5d813290a17e62108d743297b01b535e09cac367 fix(tests): extract initConfigForTest helper to prevent config state pollution\n* fe8d7c1f140d7fa1dffcd210d9d4f8f94082e4c2 fix: eliminate dolt split-brain root cause (B1+B2) and fix CGO build\n* 987f5dba3aeff67bed6d41c5e046ee043a2d0601 fix: guard auto-import against nil pointer panic in dolt-native mode\n\n","2026-02-01T04:41:39",{"id":262,"version":263,"summary_zh":264,"released_at":265},153967,"v0.49.2","## beads v0.49.2\n\nPre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android\u002FTermux (ARM64), and FreeBSD.\n\n### Installation\n\n**Homebrew (macOS\u002FLinux):**\n```bash\nbrew install beads\n```\n\n**Quick Install (macOS\u002FLinux\u002FFreeBSD):**\n```bash\ncurl -sSL https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https:\u002F\u002Fraw.githubusercontent.com\u002Fsteveyegge\u002Fbeads\u002Fmain\u002Finstall.ps1 | iex\n```\n\n**Manual Install:**\nDownload the appropriate binary for your platform below, extract it, and place it in your PATH.\n\n## Changelog\n### Features\n* e02c44d1d74b4ff78c8e9b1e8b4db17500071a64 Merge PR #1290: feat: Add GitLab backend for bidirectional issue sync\n* dc8bb7af1a30dce8026f60aa69c8a75067468349 feat(cli): add bd backend and bd sync mode subcommands\n* 7810c630b1c8eea4cc73555c9779e5192141ce4c feat(config): add env var overrides for Dolt server connection settings\n* 9df801effd606b3195c2108278eb511ebec7e27b feat(config): make agent roles configurable (bd-hx8w)\n* 857d2b696aabedda36dc0f8e094ff19272f0f59f feat(context): add UserRole detection to RepoContext\n* 9e37767df589f28555071231a20473f9b39f0a7e feat(dep): resolve external refs in dep list for cross-rig dependencies\n* e4886a0f1b44cf54393c0d0706022e8ac837f141 feat(doctor): add Dolt-specific diagnostics and performance profiling\n* abbc0914ec70fd0084db4d759a8946c73227373a feat(gitlab): implement GitLab REST API client wrapper\n* fc278403546dce5d6f93505183e7d4a894ea7496 feat(import): process JSONL deletion markers (bd-9qywp)\n* d5a8e0f236e852f2d58dfadf36215785c4c3c9eb feat(init): add interactive contributor role prompt\n* a2a94e1f2d3a3c7bca6d77cc69ed14933bd2db61 feat(init): auto-detect dolt server and enable server mode (gt-1mf.3)\n* 03ba29f647bb370e7246e748876fd051542427cf feat(jira): add pull_prefix and push_prefix config options\n* eb07ed986e8f7833bd41571bcb40e6a96d85d86a feat(kv): add key-value store commands\n* 13dbef58d73206d207e8c371745d01b05ea918a4 feat(kv): add key-value store commands (#1164)\n* 82a235494a70e421baeab1923f731f2ff20f984d feat(mol): add hint to view step instructions in mol current output (#1403)\n* 9e16f3473315fd49c4db07a03f0bf4b3e38ed52b feat(role): implement explicit role configuration via git\n* b080961c1af5220a6192ee53cc26a0271e31b7a9 feat(sync): detect push permission errors during sync\n* 774cc5bbd0d35142e8dcc1f6b694c168ac218bf2 feat: add comment_count to issue JSON views (list, ready, search)\n* c23a84801d22a5851d077d365897066d3f2c1779 feat: add events JSONL export (opt-in via events.export config)\n* 92fd124f5c23871c6359a983f5bc3980859bd658 feat: add optional per-issue JSON metadata field (SQLite + Dolt) (#1407)\n### Bug Fixes\n* 2879554b26a37363c6df07b315ba958cdf30fed6   fix: handle nil pointer dereference in bd restore with invalid issue ID\n* e66b775d800e503d353508895f3d54d2b1c2f9f8 fix(build): add CGO build tags to Dolt storage for cross-compilation\n* 9e5ea59fea9d10cf73b0af2bce434225b8f5fe67 fix(ci): disable CGO for Windows build in goreleaser\n* 051aeb0a631ffc726fbb254b7b07be24a8c8ca4a fix(cli): address code review feedback for backend\u002Fsync mode commands\n* e07ac184cf0de31a2266a76936f1d1282f7081b9 fix(cli): use abstract error messages instead of exposing internals (bd-ats9.3.2)\n* 7448754152b1ef5bf3408ccec0c0acbc805335f0 fix(config): add YAML config support for daemon auto-sync settings (#1294)\n* 3abec58fc4e083cf8c2ec95ad120f5f3cd387c02 fix(create): remove Gas Town-specific --role-type flag (bd-31ajf)\n* 02b445e87662389154cd6b94230099c0a46b2707 fix(daemon): make daemon start idempotent (#1334)\n* 9939e717bf55fe76ab047bfd223e2267d73d795f fix(doctor): add Dolt backend detection to all fix functions (gt-doctor-dolt-fix)\n* cb1a3790503618e89ba86d5cc0f328f625a230e6 fix(doctor): add fix for stale JSONL in dolt-native mode (bd-bbo8)\n* 289512ad809c76d929ad4d5fbcba3a828e605eaa fix(doctor): address review issues in Dolt diagnostics\n* bf194b7d8be357a6f1215bc3431d000ce255a48a fix(doctor): skip SQLite-specific checks when using Dolt backend\n* ba3a725299de5a554a86e7d038262946cbca475a fix(formula): add dev build handling to local-install step\n* 93965b4abeed920a4701e03571d1b6bb75810722 fix(formula): ignore undeclared handlebars in description text (gt-ky9loa) (#1394)\n* a90720395f191bc88129fe7d728d5bef48131424 fix(gitlab): P0 - conflict detection before push and SyncContext\n* f9f3a03ad68ead99c3c59995334f48ff54b7c8b7 fix(gitlab): P1 - add pagination limit and context cancellation\n* 745002eeac58e61eb34430b258321eac9ea09c73 fix(gitlab): P2 - fix error handling and type safety\n* 917d8be8ff7de91a6f5309aa784325b09a9b6d5d fix(gitlab): P2-P3 - cleanup deprecated code and improve docs\n* 96a28eefaa3b13fb8bc27f0f23e912fc077fcad8 fix(gitlab): address PR review findings for merge readiness\n* 8604c5ec1872b67ae9b87471846d75891bd3c909 fix(gitlab): address code review round 3 feedback\n* a17617704d0d333dba852fb9100b02c6f6ecbf38 fix(importer): remove dead code with sqlite.IsUniqueConstraintError (","2026-01-31T09:26:34"]