【免费下载链接】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 是 Steve Yegge 打造的轻量级 issue 追踪器随着原版架构大改社区 Rust 移植项目beads_rust命令行名br应运而生它冻结了经典的 SQLite JSONL 混合架构为开发者提供一个本地优先、零联网、非侵入的 Issue 追踪器——数据全部落在仓库的.beads/目录里无需账号、无需付费还支持 AI Agent 通过--json直接读写。本文将讲清楚这次移植到 Rust 的动机、核心设计以及 5 分钟上手的完整路径。一、为什么要把beads移植到Rust1. 架构分歧原版变道经典架构无人继承最初的 beads命令行bd采用SQLite JSONL混合存储SQLite 负责快速本地查询JSONL 负责 git 友好的协作导出。这套设计被许多工具链深度依赖。但原作者随后把 beads 推向 Gastown 多智能体方向存储层转向 Dolt代码复杂度几乎翻倍。对仍依赖经典架构的团队来说请求原作者维护遗留模式并不现实。于是 Jeffrey Emanuel 决定自己动手用 Rust 写一个冻结经典架构的移植版——这就是 beads_rust且获得了原作者的公开背书。完整的决策过程记录在 docs/porting/PLAN_TO_PORT_BEADS_WITH_SQLITE_AND_ISSUES_JSONL_TO_RUST.md。2. 工具链契合整套 Agent 生态都是 Rust 的作者围绕 beads 搭建了 Agent Flywheel 工作流配套的bv分析器、MCP Agent Mail 等周边工具多为 Rust 实现。把 beads 移植成 Rust能让整条工具链在语言、发布流程和错误处理风格上保持一致。3. 性能与分发单个静态二进制Rust 移植带来三个实际收益见 README.md 的 Why Rust instead of Go?单文件可执行无语言运行时、无守护进程、无 Dolt 依赖Linux 提供静态链接的 musl 构建内存安全无 GC 停顿启动即执行体积克制v0.6.0 x86_64 可执行文件约 26 MiB压缩包约 11 MiB比 Go 原版30 MB更轻二、beads_rust核心设计本地优先的Issue追踪器1. SQLite JSONL 双存储查询快协作好.beads/ ├── beads.db # SQLite 数据库主存储WAL 模式 ├── issues.jsonl # JSONL 导出提交进 git 的协作面 └── config.yaml # 项目配置可选写入走 SQLiteACID 事务、脏标记增量导出协作走 JSONL每行一个 issuegit 合并冲突极易手工解决。架构细节可参考 docs/ARCHITECTURE.md存储层实现位于 src/storage/JSONL 同步逻辑在 src/sync/。2. 非侵入设计绝不偷偷动你的 git ️这是br与原版bd最鲜明的差异也是它敢叫非侵入的原因行为br (beads_rust)原版 bd自动 git commit / push❌ 永不✅ 有安装 git hooks❌ 永不✅ 自动后台守护进程❌ 无✅ 有br的所有状态只落在.beads/里提交、推送永远由你自己执行。连br sync也要求必须显式指定方向--flush-only导出、--import-only导入不存在一把梭的默认行为从机制上杜绝误删数据。3. 依赖感知一条命令告诉你现在该做什么br支持blocks、parent-child、related等类型的依赖边。核心体验br dep add br-7f3a2c br-e9b1d4 # 认证 依赖 数据库 schema br ready # 只列出没被阻塞的任务被阻塞的 issue 不会出现在br ready结果里前置任务br close后下游自动解锁。对 AI Agent 来说br ready --json就是最稳定的工作入口。三、快速上手5步启用beads_rust# 1. 安装Linux / macOS / WSL自动识别平台 curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/beads_rust/main/install.sh | bash # 或从源码构建 git clone https://gitcode.com/gh_mirrors/be/beads_rust cd beads_rust cargo build --release # 2. 在项目里初始化 cd my-project br init # 3. 创建带优先级与依赖的 issue br create Implement user auth --type feature --priority 1 br create Set up database schema --type task --priority 1 br dep add br-7f3a2c br-e9b1d4 # 4. 查看可开工的任务认领并完成 br ready br update br-e9b1d4 --status in_progress br close br-e9b1d4 --reason Schema implemented # 5. 提交协作导出文件 br sync --flush-only git add .beads/ git commit -m Update issues常用查询命令br list --status open --priority 0-1、br blocked、br search authentication、br stats。每个命令都支持--json输出机器可读结果AI 集成的完整约定见 AGENTS.md 与 docs/agent/ 目录。四、br 和 GitHub Issues / Jira 差在哪维度br (beads_rust)GitHub IssuesJira / Linear离线可用✅❌❌数据在仓库内✅❌❌依赖追踪✅ 一等公民需变通✅费用免费有限免费$8–15/人/月AI Agent 机器可读✅--json仅 API仅 API上手成本1 条命令需账号账号配置定位总结想要离线、进仓库、依赖感知、Agent 友好的本地 issue 追踪选br想要 Linear/Jira 同步、RPC 守护、自动 hooks 这类重型生态则留在原版 beads。五、延伸阅读关键文档与模块路径项目总览与 FAQREADME.md完整架构设计双存储、脏标记、原子导出、安全不变式docs/ARCHITECTURE.md移植规划原始文档含同步安全威胁模型docs/porting/PLAN_TO_PORT_BEADS_WITH_SQLITE_AND_ISSUES_JSONL_TO_RUST.mdAgent 集成指南AGENTS.md、docs/agent/ROBOT_MODE.md同步安全模型docs/SYNC_SAFETY.md存储引擎实现src/storage/sqlite.rs、src/storage/events.rs同步与恢复实现src/sync/mod.rs、src/franken_sync/wal_index.rs从原版bd迁移的技能包skills/bd-to-br-migration/SKILL.md六、常见疑问Q从原版 bd 迁移难吗不难。直接拷贝原项目的issues.jsonl到新仓库.beads/目录然后执行br sync --import-only即可导入迁移技巧与检查项都写在 skills/bd-to-br-migration/ 里。QAI 编码 Agent 能用吗这是br的一等公民场景。所有命令支持--jsonbr schema可输出 JSON Schema 契约MCP 客户端可调用list_issues、create_issue等工具br serve --features mcp还有br robot-docs guide专供自动化 Agent 阅读。Q数据安全吗会丢 issue 吗br采用临时文件 fsync 原子重命名发布 JSONL空库或过期库默认拒绝覆盖已有 JSONL 行每次导出前还会在.beads/.br_history/保留本地快照可用br history restore回滚。安全模型详见 docs/SYNC_SAFETY.md。一句话总结beads_rust 用 Rust 把本地优先、非侵入、git 友好的 issue 追踪钉在了经典 SQLite JSONL 架构上——不抢 git 的活、不装后台进程、不联网要账号是 AI Agent 时代里一个克制而可靠的工程选择。赞分享【免费下载链接】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点击查看免费下载相关推荐ChatLab 为什么选择先整理再分析本地优先的聊天记录 AI 分析架构解析ChatLab 为什么选择先整理再分析本地优先的聊天记录 AI 分析架构解析 聊天记录里藏着大量有价值的信息——你和某人聊过什么、某个群最近在讨论什么、谁人工智能AI Agent数据分析桌面应用后端前端即时通讯MCP 服务本地部署从 4 小时到 30 分钟OpenCore EFI 一键生成指南黑苹果 OpenCore 配置全流程拆解从 4 小时到 30 分钟OpenCore EFI 一键生成指南黑苹果 OpenCore 配置全流程拆解 场景一台 2018 年的 ThinkPad开发工具CLIESP32真能跑动OpenCV从零上手嵌入式计算机视觉的完整路线ESP32真能跑动OpenCV从零上手嵌入式计算机视觉的完整路线 很多人以为计算机视觉是树莓派、Jetson这类大块头开发板的专利。动辄几百兆的Open创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 【免费下载链接】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 是 Steve Yegge 打造的轻量级 issue 追踪器随着原版架构大改社区 Rust 移植项目beads_rust命令行名br应运而生它冻结了经典的 SQLite JSONL 混合架构为开发者提供一个本地优先、零联网、非侵入的 Issue 追踪器——数据全部落在仓库的.beads/目录里无需账号、无需付费还支持 AI Agent 通过--json直接读写。本文将讲清楚这次移植到 Rust 的动机、核心设计以及 5 分钟上手的完整路径。一、为什么要把beads移植到Rust1. 架构分歧原版变道经典架构无人继承最初的 beads命令行bd采用SQLite JSONL混合存储SQLite 负责快速本地查询JSONL 负责 git 友好的协作导出。这套设计被许多工具链深度依赖。但原作者随后把 beads 推向 Gastown 多智能体方向存储层转向 Dolt代码复杂度几乎翻倍。对仍依赖经典架构的团队来说请求原作者维护遗留模式并不现实。于是 Jeffrey Emanuel 决定自己动手用 Rust 写一个冻结经典架构的移植版——这就是 beads_rust且获得了原作者的公开背书。完整的决策过程记录在 docs/porting/PLAN_TO_PORT_BEADS_WITH_SQLITE_AND_ISSUES_JSONL_TO_RUST.md。2. 工具链契合整套 Agent 生态都是 Rust 的作者围绕 beads 搭建了 Agent Flywheel 工作流配套的bv分析器、MCP Agent Mail 等周边工具多为 Rust 实现。把 beads 移植成 Rust能让整条工具链在语言、发布流程和错误处理风格上保持一致。3. 性能与分发单个静态二进制Rust 移植带来三个实际收益见 README.md 的 Why Rust instead of Go?单文件可执行无语言运行时、无守护进程、无 Dolt 依赖Linux 提供静态链接的 musl 构建内存安全无 GC 停顿启动即执行体积克制v0.6.0 x86_64 可执行文件约 26 MiB压缩包约 11 MiB比 Go 原版30 MB更轻二、beads_rust核心设计本地优先的Issue追踪器1. SQLite JSONL 双存储查询快协作好.beads/ ├── beads.db # SQLite 数据库主存储WAL 模式 ├── issues.jsonl # JSONL 导出提交进 git 的协作面 └── config.yaml # 项目配置可选写入走 SQLiteACID 事务、脏标记增量导出协作走 JSONL每行一个 issuegit 合并冲突极易手工解决。架构细节可参考 docs/ARCHITECTURE.md存储层实现位于 src/storage/JSONL 同步逻辑在 src/sync/。2. 非侵入设计绝不偷偷动你的 git ️这是br与原版bd最鲜明的差异也是它敢叫非侵入的原因行为br (beads_rust)原版 bd自动 git commit / push❌ 永不✅ 有安装 git hooks❌ 永不✅ 自动后台守护进程❌ 无✅ 有br的所有状态只落在.beads/里提交、推送永远由你自己执行。连br sync也要求必须显式指定方向--flush-only导出、--import-only导入不存在一把梭的默认行为从机制上杜绝误删数据。3. 依赖感知一条命令告诉你现在该做什么br支持blocks、parent-child、related等类型的依赖边。核心体验br dep add br-7f3a2c br-e9b1d4 # 认证 依赖 数据库 schema br ready # 只列出没被阻塞的任务被阻塞的 issue 不会出现在br ready结果里前置任务br close后下游自动解锁。对 AI Agent 来说br ready --json就是最稳定的工作入口。三、快速上手5步启用beads_rust# 1. 安装Linux / macOS / WSL自动识别平台 curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/beads_rust/main/install.sh | bash # 或从源码构建 git clone https://gitcode.com/gh_mirrors/be/beads_rust cd beads_rust cargo build --release # 2. 在项目里初始化 cd my-project br init # 3. 创建带优先级与依赖的 issue br create Implement user auth --type feature --priority 1 br create Set up database schema --type task --priority 1 br dep add br-7f3a2c br-e9b1d4 # 4. 查看可开工的任务认领并完成 br ready br update br-e9b1d4 --status in_progress br close br-e9b1d4 --reason Schema implemented # 5. 提交协作导出文件 br sync --flush-only git add .beads/ git commit -m Update issues常用查询命令br list --status open --priority 0-1、br blocked、br search authentication、br stats。每个命令都支持--json输出机器可读结果AI 集成的完整约定见 AGENTS.md 与 docs/agent/ 目录。四、br 和 GitHub Issues / Jira 差在哪维度br (beads_rust)GitHub IssuesJira / Linear离线可用✅❌❌数据在仓库内✅❌❌依赖追踪✅ 一等公民需变通✅费用免费有限免费$8–15/人/月AI Agent 机器可读✅--json仅 API仅 API上手成本1 条命令需账号账号配置定位总结想要离线、进仓库、依赖感知、Agent 友好的本地 issue 追踪选br想要 Linear/Jira 同步、RPC 守护、自动 hooks 这类重型生态则留在原版 beads。五、延伸阅读关键文档与模块路径项目总览与 FAQREADME.md完整架构设计双存储、脏标记、原子导出、安全不变式docs/ARCHITECTURE.md移植规划原始文档含同步安全威胁模型docs/porting/PLAN_TO_PORT_BEADS_WITH_SQLITE_AND_ISSUES_JSONL_TO_RUST.mdAgent 集成指南AGENTS.md、docs/agent/ROBOT_MODE.md同步安全模型docs/SYNC_SAFETY.md存储引擎实现src/storage/sqlite.rs、src/storage/events.rs同步与恢复实现src/sync/mod.rs、src/franken_sync/wal_index.rs从原版bd迁移的技能包skills/bd-to-br-migration/SKILL.md六、常见疑问Q从原版 bd 迁移难吗不难。直接拷贝原项目的issues.jsonl到新仓库.beads/目录然后执行br sync --import-only即可导入迁移技巧与检查项都写在 skills/bd-to-br-migration/ 里。QAI 编码 Agent 能用吗这是br的一等公民场景。所有命令支持--jsonbr schema可输出 JSON Schema 契约MCP 客户端可调用list_issues、create_issue等工具br serve --features mcp还有br robot-docs guide专供自动化 Agent 阅读。Q数据安全吗会丢 issue 吗br采用临时文件 fsync 原子重命名发布 JSONL空库或过期库默认拒绝覆盖已有 JSONL 行每次导出前还会在.beads/.br_history/保留本地快照可用br history restore回滚。安全模型详见 docs/SYNC_SAFETY.md。一句话总结beads_rust 用 Rust 把本地优先、非侵入、git 友好的 issue 追踪钉在了经典 SQLite JSONL 架构上——不抢 git 的活、不装后台进程、不联网要账号是 AI Agent 时代里一个克制而可靠的工程选择。赞分享【免费下载链接】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点击查看免费下载相关推荐ChatLab 为什么选择先整理再分析本地优先的聊天记录 AI 分析架构解析ChatLab 为什么选择先整理再分析本地优先的聊天记录 AI 分析架构解析 聊天记录里藏着大量有价值的信息——你和某人聊过什么、某个群最近在讨论什么、谁人工智能AI Agent数据分析桌面应用后端前端即时通讯MCP 服务本地部署从 4 小时到 30 分钟OpenCore EFI 一键生成指南黑苹果 OpenCore 配置全流程拆解从 4 小时到 30 分钟OpenCore EFI 一键生成指南黑苹果 OpenCore 配置全流程拆解 场景一台 2018 年的 ThinkPad开发工具CLIESP32真能跑动OpenCV从零上手嵌入式计算机视觉的完整路线ESP32真能跑动OpenCV从零上手嵌入式计算机视觉的完整路线 很多人以为计算机视觉是树莓派、Jetson这类大块头开发板的专利。动辄几百兆的Open创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考