Agent 已连接，但运行工具提示 command not found 怎么办？
检查目标主机的工具安装、路径与执行用户，不把工具错误当作连接错误。
确认执行发生在预期机器
先核对环境选择器，再让 Agent 报告实际系统和工作目录。一个工具在你的浏览器电脑或云端存在，不代表选中的远程主机也已安装。命令已返回“找不到”通常说明执行链路已经返回结果，此时反复重连或重置令牌不一定有帮助，应该先定位缺少的是哪个可执行程序。
核对安装与启动环境
确认目标机器上工具是否已安装，以及启动 Desktop 或 CLI 的用户能否访问它。不同 shell、用户路径或运行入口可以看到不同程序；不要直接复制另一平台的命令语法。先用只读方式检查可执行位置与版本，避免为了确认工具是否存在就运行会修改系统或访问大量目标的操作。
决定安装、替代还是换环境
工具确实缺失时，可以选择已安装的替代方式、具备依赖的可用机器，或明确授权安装所需工具。安装前检查来源、权限和影响范围；连接应用不保证预装全部安全工具，也不应默认通过管理员身份解决所有缺失问题。补齐条件后重试小步骤，再继续原任务，避免重复已经完成的部分。