【免费下载链接】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点击查看免费下载brbeads_rust是 Steve Yegge 的 beads 的快速 Rust 移植版一个本地优先local-first、非侵入式non-invasive的 issue 追踪器任务存储在仓库内的 SQLite 数据库中并通过 JSONL 导出实现 git 协作。相比云端工具本地工具的最大隐患其实是越权和损坏——而 br 的安全设计恰恰围绕这两点展开。本文带你拆解它的 3 层防护非侵入式原则、多进程写锁模型以及发布签名验证。一、为什么一个 CLI 工具需要安全设计很多人对命令行工具的安全认知停留在别装来路不明的二进制。但 br 的场景更复杂️ 它长期驻留在你的仓库里.beads/目录随时可能被其他进程包括 AI agent 集群并发访问 它要同步数据库和 git 中的 JSONL 文件稍有不慎就可能破坏你的源代码或提交历史 它通过一键脚本和自更新命令分发布二进制属于典型的供应链攻击面。br 针对这三类风险分别建立了下面三道防线。二、非侵入式原则br 承诺永不越界 ️非侵入式non-invasive是 br 最核心的设计哲学官方将其列为明确的设计非目标non-goals。br sync 永远不会做的 6 件事在 docs/SYNC_SAFETY.md 中项目用一张负面清单划出了硬边界#承诺含义1不执行任何 git 命令不 commit、不 push、不 stage一切 git 操作由你手动完成2不修改允许清单外的文件默认写入被限制在.beads/目录内3不安装 git hooks完全手动绝不偷偷挂钩子4不运行后台守护进程简单 CLI无后台进程需要管理5不自动提交更改每一次 git 操作都需要显式用户动作6不连接外部服务离线优先零网络调用这张清单还配了配套的导出防护空库防护防止 0 条 issue 覆盖 N 条 JSONL、过期数据库防护、未导入内容防护等任何可能造成数据丢失的导出都会被默认拦截必须显式--force才能突破。写入范围被钉死在 .beads/ 目录即使你指定了外部的 JSONL 路径br 也会对它施加扩展名校验、符号链接防护、路径穿越防护和.git/目录隔离。换句话说默认路径下br sync 永远碰不到你的源代码即便越出默认路径也有一整套守卫把关。README.md 中的 Limitations 章节把这条哲学总结得非常直白——自动 git 提交、hook 安装、后台守护进程都被有意不支持理由栏清一色写着Non-invasive philosophy。 对新手来说这条原则的价值很实际你可以放心让 AI agent 在仓库里高频调用br它不会在背后动你的 git 状态。三、写锁模型多进程并发下的数据库守护 当多个 br 进程或 agent 集群同时读写同一个 SQLite 数据库时如何保证不出现半写状态和文件损坏br 的答案是一套三层写锁体系。三层锁各司其职在 src/sync/mod.rs 中br 定义了两种写权威write authorityWorkspace 写锁基于规范路径的 sidecar 文件锁负责在数据库尚未创建、或发生原子替换时串行化不同工作区的写入Database 写锁src/sync/mod.rs#L444-L455数据库文件存在后的最终写权威把 workspace 锁和数据库 inode 锁组合在一起防止同一个物理数据库通过硬链接获得两份独立写权限JSONL 写锁由于 JSONL 导出是新建文件 → 原子 rename 覆盖直接锁目标 inode 会在每次 flush 后失效因此 br 改用基于规范路径哈希的 sidecar 权威锁在 rename 之间保持稳定。数据库 inode 锁只锁 1 个字节 这是整个写锁模型里最精彩的一笔实现在 src/sync/db_inode_lock.rs。历史教训v0.2.20 曾对数据库文件加整文件锁结果在 macOS 上锁与 SQLite 引擎自身的锁冲突导致database is busy在 Windows 上甚至让数据库 schema 都读不出来。根因是 SQLite 引擎会在 inode 的固定字节区间0x40000000..0x40000200上打自己的建议锁。修复方案非常巧妙在i64::MAX - 1这个字节偏移处只锁1 个字节——远超出 SQLite 锁字节区间也超出任何真实数据库的文件大小Unix 上使用F_OFD_SETLK打开文件描述锁跨进程互斥但永不与 SQLite 的锁区间重叠Windows 上对同一偏移做 1 字节LockFileEx强制锁语义上同样不会挡住引擎的 I/O。正如模块注释所说这个锁锁住了数据库的 inode 本身却碰不到引擎的任何一个字节。多进程竞争失败时br 会返回带retryable标志的WriteLockTimeout错误让调用方安全重试而不是硬闯。未来演进方向写合并队列记录在 docs/WRITE_COMBINING_QUEUE_DESIGN.md只有经过白名单审核的变更类命令才允许进入合并批次读命令和带副作用的命令一律走直连路径。四、发布签名验证minisign SHA256 双重校验 ✍️本地优先不意味着从官网随便下载。br 的分发链路有完整的完整性校验。强制 SHA256 校验升级链路的默认行为自 v0.4.1 起每个发布资产br-version-platform.tar.gz或.zip都附带强制的.sha256sidecar。一键安装脚本 install.sh 会自动下载校验和并验证只有明确传入--insecure-skip-checksum才允许跳过内置的br upgrade命令src/cli/commands/upgrade.rs在执行任何更新前会下载对应的.sha256资产并逐字节比对哈希——缺少校验和资产时直接报错拒绝升级而不是降级为不校验继续装。minisign 签名可手动验证的数字签名README 的 Verify Release Signatures 章节给出了完整验证方式README.md#L453-L473minisign -Vm br-version-platform.tar.gz \ -P RWTQoKUb0Ue4NsqTpPWnABCrIU0m25zsMlbv6UcRClQ7jmRP3A7NmTB几个值得注意的细节 当前发布密钥 ID 为36B847D11BA5A0D0仓库内跟踪了对应的 Minisign 公钥 src/release_public_key.bin密钥轮换有据可查v0.4.0 用的是一次性密钥v0.4.1 起切换到可恢复的 DSR 密钥v0.5.1 起在发布流程中上传前强制验证当前密钥——完整的密钥历史都写在 README 里早期不可验证的签名被明确标注应视为不可验证 资产命名有严格约定只有br-version-platform前缀的资产才是官方产物其他前缀比如带 Rust target 别名的资产不产自发布流程、不带签名、不受支持。这套哈希管完整性、签名管来源的双轨设计意味着即使攻击者能污染下载通道也拿不出能通过 minisign 公钥验证的合法签名。五、CI 供应链防护Actions 全部 SHA 锁定 发布安全还有一环容易被忽略构建 br 的 CI 流水线本身。docs/CI_SUPPLY_CHAIN.md 记录了这套机制所有外部 GitHub Action 在 workflow 中锁定到 40 位完整 commit SHA禁止 tag 或短 SHA.github/action-pins.jsonl清单为每个锁定记录预期 SHA 和人工溯源说明校验器刻意做到本地且确定性——不联网、不建 PR、不改文件只做比对发布流程中的高危 shell 片段校验和聚合、产物检测等有专门的本地 harness 用 fixture 逐条覆盖例如 tests/workflow_release_fragments.rs 会精确断言minisign -Vm ... -x ... -P ...验证命令的存在。一句话总结连构建 br 的流水线也被纳入了 br 自己的安全模型。六、总结安全是默认开启的 防线核心机制防的是什么️ 非侵入式原则负面清单 .beads/写入域 导出防护工具越权、误改源码、丢失数据 三层写锁模型workspace 锁 / inode 1 字节锁 / 路径哈希锁多进程并发写入损坏数据库✍️ 发布签名验证强制 SHA256 minisign 签名 Action SHA 锁定供应链投毒、二进制被篡改br 的安全设计有一个共同特点保护是默认行为绕过必须显式声明——跳过校验和要传 flag覆盖导出数据要--force外部 JSONL 路径要 opt-in。对于新手来说这意味着你只需要正常地使用br init、br create、br sync安全边界就已经在你身后守好了。更多细节可参阅docs/SYNC_SAFETY.md、docs/ARCHITECTURE.md 与 docs/INSTALLING.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点击查看免费下载相关推荐LSPosed模块签名验证安全性与兼容性平衡LSPosed模块签名验证安全性与兼容性平衡 引言模块安全的隐形守护者 Android生态中模块框架面临着严峻的安全挑战。据XDA开发者论坛2024年安全移动开发插件系统模型安全第一道防线ONNX签名验证技术全解析模型安全第一道防线ONNX签名验证技术全解析 ONNXOpen Neural Network Exchange作为机器学习互操作性的开放标准为不同框架间人工智能机器学习深度学习Webhook安全机制触发器规则与签名验证Webhook安全机制触发器规则与签名验证 本文详细介绍了Webhook安全机制的核心组件包括触发器规则配置、HMAC签名验证、IP白名单与访问控制以及参数后端API网关创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
