在 Windows 下，rg（ripgrep）是非常常用的文本搜索工具，但在客户端升级、环境改动后，它可能突然从 PowerShell 的可执行搜索路径中消失。

这次是一次比较典型的“只报 command not found”问题：PowerShell 返回 rg : The term 'rg' is not recognized...，却难以快速判断是软件没装、PATH 失效，还是会话缓存导致。

问题点

从现场行为看有三类风险点：

1. 当前会话无法发现 rg.exe；
2. 之前处理方案依赖了固定路径，缺少迁移弹性；
3. 后续执行链条未加入足够的命令可用性兜底。

因此修复策略是将重点放在“命令恢复 + …