谁说追踪任务必须开 Git？Beads 的“隐身模式”深度实测

在大多数开发者的潜意识里，任务追踪（Issue Tracking）和 .git 文件夹是绑死的。无论是 GitHub Issues 还是各类本地工具，往往默认你就在一个 Git 仓库的根目录下。

但如果你正在使用 Sapling、Jujutsu 或 Google 的 Piper 这种非 Git 版本控制系统，或者你只是想在一个临时目录、甚至是单体仓库（Monorepo）的某个子文件夹里快速记录 Agent 的思维链，传统的工具就会显得极其“越权”——它们会疯狂搜索你的父级目录，试图寻找那个不存在的 .git，然后以一个 Not a git repository 报错收场。

如果你正在寻找 Git-Free Issue Tracker，希望实现任务管理与版本控制的解耦，Beads (bd) 的“隐身模式”（Stealth Mode）可能是唯一的硬核选解。

💡 报错现象总结：在非 Git 环境下运行 bd init，程序常因无法探测到 repo-root 而初始化失败。通过设置 BEADS_DIR 环境变量并配合 --stealth 参数，可以强制 bd 跳过所有 Git 钩子安装与身份校验，实现完全隔离的“任务沙盒”。

---

隔离的艺术：BEADS_DIR 如何接管存储控制权？

为什么大多数工具离不开 Git？因为它们需要 Git 提供身份（User Name/Email）和位置（Root Path）。Beads 的高级之处在于，它允许你通过环境变量手动注入这些元数据，从而实现“隐身”运行。

场景对标：Git-Free 模式的实战价值

场景	传统工具表现	Beads (Stealth 模式)	架构师深度剖析
非 Git VCS (如 Sapling)	报错，无法找到仓库根目录	正常运行	Beads 仅依赖 Dolt 引擎，不强制绑定 .git
Monorepo 子目录	任务会污染全局根目录	精准锁定子目录状态	通过 BEADS_DIR 实现任务空间的逻辑隔离
CI/CD 临时流水线	需配置繁琐的 Git 全局身份	零配置极速启动	--stealth 模式彻底禁用所有 Git Ops 侧重逻辑
评估与测试	产生大量冗余的 .git 日志	静默创建/销毁	非常适合在 /tmp 目录下建立瞬时数据库

在 Beads 的逻辑中，只要你定义了 BEADS_DIR=/path/to/project/.beads，它就会把这里当成整个宇宙的中心，不再去窥探你的父目录是否有 .git 文件夹。

---

源码探秘：--stealth 参数到底关掉了什么？

在 Beads 的配置文件逻辑中，--stealth 参数本质上是向 config.yaml 写入了 no-git-ops: true。

# 模拟执行隐身初始化
export BEADS_DIR=/tmp/my_shadow_project/.beads
bd init --quiet --stealth

# 架构师视角：此时底层发生的关键变化
# 1. 跳过 git hooks 的检测与自动注入
# 2. 忽略 .gitignore 的自动修改
# 3. 禁用身份检测逻辑（不再尝试从 git config 读取 user.email）

即使在没有 Git 的环境下，所有的核心命令——bd create、bd ready、bd prime——都能正常工作。这是因为 Beads 的后端是 Dolt，它本身就是一个自带版本控制能力的数据库。你可以理解为：Beads 内置了一个“微型 Git”专门服务于任务数据，而不需要外部 Git 的加持。

---

痛苦的临时方案：为何“手动建 .git 空文件夹”是饮鸩止卧？

有些开发者为了骗过那些强制依赖 Git 的工具，会习惯性地在目录下执行 git init，或者建一个空的 .git 文件夹。

这种方案极其恶劣：

1. 路径混乱：这会干扰你真正的版本控制系统（如 Sapling）对根目录的判断。
2. 身份污染：你必须为这个假仓库配置 user.name，否则提交任务时依然会报错。
3. 清理困难：在 CI/CD 环境中，这些残留的“假仓库”可能会导致构建脚本误判环境，引发生产事故。

---

获取离线版部署模版与 Stealth 预设

与其为了适配工具而修改你的开发环境，不如让工具彻底顺从你的工作流。

我已经针对非 Git 环境（特别是 CI 隔离环境和复杂单体仓库），在 GitCode 上整理了一套离线版部署模版。这套模版预设了最优的 BEADS_DIR 组织结构，并包含了一个封装好的 bd-stealth 脚本，让你在任何目录下都能瞬间开启一个隔离的任务追踪沙盒，无需担心任何 Git 相关的副作用。

让任务归任务，代码归代码。 这种完全解耦的架构才是追求极致效率的开发者该有的姿势。你可以直接前往 GitCode 归档库下载这套预设方案，体验真正的 Git-Free 开发流程。

[点击前往 GitCode 获取离线版部署模版]