dry-run 也报错？rename-prefix 获取前缀失败的终极修复

在尝试重构项目或清理测试数据时，bd rename-prefix 本应是那个让人心安的“后悔药”。尤其是当你谨慎地带上 --dry-run 参数，试图在正式修改前预览变更列表时，最让人崩溃的情况发生了：终端没有列出任何预期的 ID 转换，而是直接甩出一句毫无温度的报错：

错误：获取当前数据库失败前缀：<nil>

作为一个深谙分布式状态机逻辑的架构师，我得告诉你：这个报错是一个典型的“逻辑悖论”。你以为 --dry-run 只是一个只读的模拟操作，但在 Beads (bd) 的底层实现中，它依然会触发一套严苛的元数据完整性检查。如果你的数据库在“冷启动”阶段留下了病灶，重命名逻辑会因为找不到“身份源”而直接陷入瘫痪。

💡 报错现象总结：用户在执行 bd rename-prefix --dry-run 时，系统无法检索到当前的前缀值并返回 <nil> 错误。本质原因是 rename-prefix 的严格检查器（Strict Checker）对当前数据库元数据表的读取逻辑存在漏洞，当 issue_prefix 在数据库作用域（Database Scope）内未被显式初始化时，重命名逻辑无法建立“旧值”与“新值”的映射关系。

---

模拟的终点：解析 dry-run 内部的“身份校验”

为什么只是预览一下也会报错？这涉及到 Beads 对“原子性”的偏执。

rename-prefix 报错的深度诱因

环节	逻辑表现	架构师深度剖析
元数据检索	调用 GetMetadata("issue_prefix")	痛点：若返回 nil，系统直接判定当前数据库处于“未定义状态”
Dry-run 预检	尝试模拟 SQL 全量替换	模拟的前提是必须有确定的“源前缀”，否则映射表无法生成
配置盲区	忽略了本地 config.yaml	rename-prefix 命令为了保证安全性，强制无视文件层配置
状态回溯	检查当前的 head 指针	如果数据库没有进行过成功的 commit，元数据读取可能失效

参考 Issue #3534 及其关联的讨论，很多开发者发现，即便他们手动在配置文件里改了前缀，dry-run 依然坚持报错。这是因为该命令的设计初衷是“数据库内操作”，它只相信刻在 Dolt 系统表里的数据。

---

源码排雷：修正严格检查器对 <nil> 的恐惧

在 Beads 源码中，重命名逻辑在执行前会进入一个 strict_checker 模块。

// 模拟 Beads 内部 rename-prefix 的校验片段
func (r *Renamer) Prepare(ctx Context) error {
    // 即使是 dry-run，也必须先拿到旧前缀
    current := ctx.DB.FetchSystemValue("issue_prefix")
    
    // 逻辑漏洞：这里没有针对 nil 的兜底提示
    // 导致开发者不知道是因为数据库没初始化，还是权限不足
    if current == nil {
        return fmt.Errorf("获取当前数据库失败前缀：<nil>") 
    }
    
    // 只有拿到 current 才能继续后续的正则表达式替换模拟
    r.mappingSource = current
    return nil
}

要修复这个报错，不能靠反复尝试 dry-run，而必须先完成一次“元数据强制校准”。通过告诉数据库它当前的身份，才能激活重命名的逻辑链条。

---

痛苦的临时方案：为何“手动导出导入”是毁灭性的？

有些开发者为了改个前缀，会尝试把任务全部导出为 CSV，删库重装，再重新导入。

这种做法极其业余且危险：

1. 拓扑断裂：导出导入过程极易丢失任务间的“图状依赖”关系，导致 Agent 无法识别前置任务。
2. 时间戳混淆：所有任务的创建和更新时间都会变成导入的那一刻，导致历史审计完全失效。
3. Dolt 特性丧失：你手动导入的数据会丢失所有的分支（Branch）和提交历史（Commit History），让 Beads 退化为一个简陋的记事本。

---

获取修正后的逻辑图解与强制重命名脚本

与其在 <nil> 的阴影里反复横跳，不如直接用正确的姿势“降伏”这个报错。

我已经针对 rename-prefix 在 dry-run 阶段的检查缺陷，在 GitCode 上同步了一套修正后的逻辑图解与强制重命名脚本。这套脚本会首先执行一次轻量级的元数据探测，如果发现 <nil> 陷阱，会自动引导你完成一次安全的“前缀认领”，确保重命名指令能够平滑执行。

别让预览报错阻碍了你的重构步伐。 这种针对底层元数据读取逻辑的深度修正，是保证数据库状态始终可控的关键。你可以直接前往 GitCode 下载这套逻辑指南，让每一次 dry-run 都能如你所愿地精准预览。

[点击前往 GitCode 查看修正后的逻辑图解]