dsh-checkout-guard
在终端中运行以下命令:
dsh plugin install YaoleWu/dsh-checkout-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中运行:dsh plugin install YaoleWu/dsh-checkout-guard(源码:https://github.com/YaoleWu/dsh-checkout-guard)。
插件介绍
在同时操作许多仓库或为自动化脚本做决定时,最常见的事故往往不是 Git“报错”,而是你误以为当前工作区处在另一个状态:落后远端却开始改、改的是陈旧克隆、HEAD 已被别的进程切走、索引里早就塞了别人的暂存,或作者邮箱并不是你以为的那一个。dsh-checkout-guard 把这类“事后才发现”的风险前移:在你真正写入、提交或推送之前,先读完当前检出与远端的关系。
插件提供两件互补能力:对单个路径用 checkout_guard 做深入检查,概括工作区相对远端的位置、远端信息有多旧、下一次提交会记到谁名下、索引里已有哪些改动,以及本机是否还有同一远端仓库的其他克隆已经走得更前;对整棵目录用 checkout_guard_scan 快速扫出需要留意的检出,并标出重复的远程克隆。输出里的 safeToWrite 是调用方最关心的结论;blockers 表示继续下去会丢活或搞错归属的状态,warnings 则是值得留意但未必自动错误的情形。
你可以只做描述,也可以传入 expectBranch、expectIdentity 把报告升级成断言:与预期不符时直接拒绝,而不是给出“可能有问题”的含糊提示。默认离线、只读,不拉索引锁,只有显式开启 fetch 才会联网比对 ahead/behind;它不会替你 pull、rebase、stash 或 checkout,也不替你判断身份应当是什么——只如实反映配置与状态。
适合在多仓库、多代理或并行任务场景下工作的人,以及希望在写入前用同一套护栏统一决策的自动化流程:先用 scan 找出该细看的目录,再对关键路径用 guard,把“是不是你以为的那个工作区”问清楚再动手。
使用场景
- 写入或提交前快速确认相对远端与信息是否过期
- 怀疑有多个本地克隆时找出是否已有更前的副本
- 自动化里用期望分支或邮箱断言,不符即阻断
适合人员
- 同时维护许多仓库并怕误判工作区状态的开发者
- 并行脚本或代理需要在不动索引锁下做只读探测的团队
- 为工具链增加统一预检门闸的运维或平台工程