用途:archive-searcher 是一套 Git 取证与归档检索方法,用于在深层历史中找回被删除或迁移的代码、配置、分支与决策背景,并将结果与 Conductor 任务归档关联。
主要能力:字符串生命周期追踪(git log -S,Pickaxe);正则内容变更追踪(git log -G);reflog 找回 amend、rebase、hard reset 与删除分支;git fsck --lost-found 查找悬空对象与丢失 blob;git bisect 自动定位回归;git log --follow 追踪文件重命名;通过 git cat-file -t/-p 检查对象类型与内容;配合 Conductor 的 conductor/archive/、conductor/tracks/<track_id>/archive/ 与 conductor/index.md 还原任务语境。
使用方式(示例命令保持原样): git log -S "DeprecatedAPI" --patch --oneline git log -S "auth_token_v1" --all --graph --decorate --oneline git log -G "port: 3[0-9]{3}" --patch git reflog --date=relative git fsck --lost-found git bisect start / git bisect bad HEAD / git bisect good v1.5.0 / git bisect run bun test / git bisect reset git log --follow -- <new_path> git checkout <hash>^ -- config/settings.yaml 浅克隆时用 git fetch --unshallow 获取完整历史。
适用场景:恢复被删除的配置或分支、定位引入或移除某字符串的提交、安全审计与密钥排查、合规审计导出、AI 生成变更的溯源、重命名文件的历史查询。
限制:-S 与 -G 在大仓库上较慢;浅克隆会导致历史搜索失效;git gc 会修剪 reflog 条目,被清理后无法找回;历史中可能残留个人数据与旧密钥,需注意隐私与密钥轮换。