dsh-checkout-guard

Git 从不抱怨，它忠实执行你发出的每一条指令。但当你落后远程八个提交还在改代码、暂存区里混着别人未完成的改动、仓库没有本地邮箱配置导致工作地址永久附在公开提交上、或者同一仓库有两个克隆而你改的是旧的那份，git 全部静默通过，工作却丢了、放错了、再也找不回来。dsh-checkout-guard 要拦截的正是这一整类误读状态下的操作。

它提供两个只读工具：checkout_guard 对单个工作副本做深度体检，报告分支偏离、暂存内容、提交身份来源、远程新鲜度，以及本机是否存在更领先的重复克隆；checkout_guard_scan 则扫描根目录下所有工作副本，一次列出哪些落后、哪些分叉、哪些处于游离 HEAD，并自动识别同一仓库的多个克隆。通过 expectBranch 和 expectIdentity 参数，你可以把描述升级为断言，不匹配即阻断。

它适合同时管理多个仓库、跨克隆协作、或在 CI 与本地之间频繁切换的开发者，也适合在多 agent 工作流中为每个写入操作加一道前置安全门的自动化脚本。它不修任何东西、不碰索引锁、不做认证网络请求，只做一件事：在你动手之前告诉你，你脚下的这块地面是否还是你以为的那一块。