★ FEATURED ARTICLE 【免费下载链接】beads_rustFast Rust port of Steve Yegges beads: local-first, non-invasive issue tracker storing tasks in SQLite with JSONL export for git collaboration项目地址https://gitcode.com/gh_mirrors/be/beads_rust点击查看免费下载beads_rust是一个用 Rust 重写的本地优先local-firstissue 跟踪工具命令名为br。它将任务存储在仓库内的 SQLite 数据库中并导出issues.jsonl供 git 协作完全离线可用。如果你之前一直在用 Go 版 beads命令bd好消息是两者的数据架构一脉相承迁移本质上是一次机械式的改名 一个行为差异的适配绝大多数人 10 分钟即可完成。本文带你走一遍完整流程安装初始化、JSONL 数据互通、命令映射、文档迁移最后附常见坑点清单。为什么要迁移到 br原版 beads 正在向新的 GasTown 方向演进而br冻结了经典的 SQLite JSONL 混合架构保持长期稳定维度bdGo 版 beadsbrbeads_rust存储SQLite JSONLSQLite JSONL同构sync行为自动提交 git永不执行 git 命令仅导出 JSONL守护进程 / RPC有无速度快更快Rust 原生冷启动低延迟数据目录.beads/.beads/完全兼容核心结论数据不用搬格式不用改——因为 JSONL 互通就是为互操作设计的。一键安装并初始化 br 工作区安装脚本会自动检测平台并下载对应二进制支持 Linux、macOS、Windows WSL仓库内的 install.sh 即为入口curl -fsSL install.sh 地址 | bash进入你的项目目录后执行cd my-project br init # 在 .beads/ 初始化工作区 ls -la .beads/ # beads.db # SQLite 数据库本地权威存储 # issues.jsonl # git 友好的导出文件 如果.beads/是旧 bd 留下的目录br可以直接打开它——这就是 JSONL 互通的基础。数据互通JSONL 是 bd 与 br 之间的桥梁br对数据目录采用JSONL 为 git 协作权威、SQLite 为本地索引的双轨模型配置见 README.md 的 Configuration 一节.beads/config.yaml中auto_flush与auto_import默认开启。导入旧 beads 数据如果.beads/issues.jsonl中存在 bd 时代的数据而beads.db缺失或希望以 JSONL 为准一条命令重建# 以 JSONL 为权威重建 SQLite 并清理库内多余条目 br sync --import-only --rebuild # 若旧数据的 issue ID 前缀不是 br-例如仍是 bd-xxx导入时自动改写前缀 br sync --import-only --rebuild --rename-prefix关于--rename-prefix的三个要点详见 docs/CLI_REFERENCE.md 的 sync 章节只替换前缀段ID 的 slug 与 hash 部分原样保留bd-cargo-license-spdx-ay8→br-cargo-license-spdx-ay8旧 ID 会存入新条目的external_ref字段输出中的prefix_renames列表会完整报告每次改写方便你修正外部引用即使不改前缀br也容忍bd-前缀的旧 ID如br show bd-abc123可正常工作属于刻意保留的跨工具兼容特性。导出与提交唯一的行为差异这是迁移中唯一需要改变肌肉记忆的地方# bd 时代bd sync 会自动 commit bd sync # br 时代只导出 JSONLgit 操作由你自己执行 br sync --flush-only git add .beads/ git commit -m sync beadsbr是非侵入式non-invasive工具永不执行任何 git 命令、不安装 hook——这既更安全也意味着文档里必须显式写清 git 步骤下面会讲。日常使用中变更默认会自动 flush 到 JSONLbr sync --flush-only只作为提交前的最终检查。命令映射表把 bd 换成 br 就对了除 sync 外其余命令都是纯改名s/bd/br/g即可完整对照参考 skills/bd-to-br-migration/SKILL.md 的 Command Mapbdbr变更类型bd ready/bd list/bd show idbr ready/br list/br show id仅改名bd create/bd update/bd closebr create/br update/br close仅改名bd dep add/bd statsbr dep add/br stats仅改名bd syncbr sync --flush-only 手动 git⚠️ 行为变更优先级体系P0-P4、issue 类型、依赖跟踪、.beads/权威地位全部保持不变无需额外学习成本。文档与 AGENTS.md 迁移7 步机械式转换如果你的仓库里AGENTS.md、工作流文档或 agent 提示词中写满了bd指令仓库内置了完整的迁移技能包路径在 skills/bd-to-br-migration/按 SKILL.md 规定的顺序执行 7 步转换章节标题bd (beads)→br (beads_rust)标题后补充非侵入式说明br 永不执行 gitsync 后需手动git add .beads/ git commit命令改名bd X→br Xready/list/show/create/update/close/dep/statssync 转换bd sync→br sync --flush-only每处sync 后补上git add .beads/git commitissue ID 改写bd-###→br-###彻底删除 daemon、auto-commit、hook 安装、RPC 模式的描述这些在 br 中不存在改完立即验证bd残留必须为 0grep -c bd AGENTS.md # 必须为 0 grep -c bd sync AGENTS.md # 必须为 0 grep -c br sync --flush-only AGENTS.md # 必须 0 # 或使用官方脚本 ./skills/bd-to-br-migration/scripts/verify-migration.sh AGENTS.md前后可对照示例见 references/TRANSFORMS.md。批量迁移10 个文件以上多文件项目建议按批处理先用 scripts/find-bd-refs.sh 列出所有需要迁移的文件然后每批约 10 个文件交给一个 subagent 顺序转换每批之间必须跑一次验证再进入下一批。策略细节在 references/BULK.md。五大常见坑点附排查方法以下内容整理自 references/PITFALLS.md#坑点症状排查命令1sync 后漏写 git 步骤最大坑会话结束后数据丢失grep br sync --flush-only f.md ! grep git add .beads/ f.md2只改成br sync漏掉--flush-only行为不符合预期grep -n br sync$ f.md3同一文件里bd-123与br-123混用文档混乱grep -n bd-[0-9] f.md4漏加非侵入式说明读者仍期待自动提交grep -c non-invasive f.md应为 05残留 daemon / hook / RPC 描述误导 agentgrep -in daemon\|hook\|rpc f.md⚠️ 第 5 项的残留内容要直接删除而不是转换——br 中这些机制根本不存在。迁移完成度自检清单.beads/beads.db与.beads/issues.jsonl均能被br正常打开br list无报错执行br sync --status只读确认同步状态一致若做了--rename-prefix按输出的prefix_renames列表修正外部引用grep确认文档中bd命令残留为 0br sync --flush-only后均带 git 步骤提交一次git add .beads/ git commit作为迁移基线参考文档迁移技能主文档skills/bd-to-br-migration/SKILL.md转换前后完整对照skills/bd-to-br-migration/references/TRANSFORMS.md批量迁移策略skills/bd-to-br-migration/references/BULK.md命令全量参考sync 各模式详解docs/CLI_REFERENCE.md同步安全模型docs/SYNC_SAFETY.md赞分享【免费下载链接】beads_rustFast Rust port of Steve Yegges beads: local-first, non-invasive issue tracker storing tasks in SQLite with JSONL export for git collaboration项目地址https://gitcode.com/gh_mirrors/be/beads_rust点击查看免费下载相关推荐SilentPatch 安装指南一次修复 GTA III、VC 与圣安地列斯的现代系统兼容性顽疾SilentPatch 安装指南一次修复 GTA III、VC 与圣安地列斯的现代系统兼容性顽疾 深夜十一点你双击圣安地列斯的图标屏幕黑了一下弹出半句英游戏开发逆向工程初识HIPHelium改进提案库完全指南——149份治理提案如何塑造全球最大去中心化LoRaWAN网络初识HIPHelium改进提案库完全指南——149份治理提案如何塑造全球最大去中心化LoRaWAN网络 HIPHelium Improvement PropHyprPanel音频系统深度配置从音量控制到播放设备管理的完整指南HyprPanel音频系统深度配置从音量控制到播放设备管理的完整指南 HyprPanel是一款为Hyprland打造的高度可定制化面板工具其音频系统不仅提供创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
