dsh-which

你在终端里敲下 node 或 npm，命令会跑起来，却没人告诉你真正执行的是哪一份安装、PATH 里还有哪些同名副本被悄悄跳过。这类错位往往无声发生：全局旧版压在本地新版前面，Windows 上的 .cmd 垫在真实二进制前面，或者文件在 PATH 里却因为没有可执行位而被 shell 直接走过。dsh-which 做的是命令解析取证，而不是再跑一遍 which——它按与 shell 相近的规则重算解析结果，说明「会跑谁」「谁被遮蔽」「PATH 本身长什么样」，并在需要时对比各副本的版本是否一致。

插件把解析逻辑做成可注入文件系统的纯函数，便于用 fixture 验证，也避免「用正在被怀疑的解析器去解释解析器」的怪圈。内置命令会标明 builtin，不会误把 PATH 里的同名文件当成答案；在 Windows 上会尊重 PATHEXT 顺序。工具面覆盖单命令解析（which_resolve）、PATH 条目体检（which_path）、环境一页总览（which_env）、目录脚本与全局解析对照（which_sweep）以及多副本版本探测（which_probe）。探测默认关闭，因为会拉起子进程；插件也不改 PATH、不写文件，只负责把证据讲清楚。

适合在 Harness 里排查「明明装了却像没装」「版本对不上」「脚本目录和全局命令同名」的维护者与插件作者，尤其在 Windows 与跨平台 PATH 混用时，需要看见被跳过的那一行诊断而不只是「找到的第一个文件」。