跳转到主要内容
MCP · RemoteCommand

代理离线和 MCP 连接故障排查

排查设备离线、npx 缺失、OAuth 登录失败、MCP 连接问题以及被权限策略阻止的命令。

设备显示离线时

确认本地代理进程仍在运行且网络可用。检查代理版本及账户中的设备状态。必要时使用同一个操作系统账户重启代理。离线设备无法执行新的远程请求。

npx -y @lhtsoft/remotecommand-agent@latest doctor
指南

使用步骤

  1. 设备显示离线时

    确认本地代理进程仍在运行且网络可用。检查代理版本及账户中的设备状态。必要时使用同一个操作系统账户重启代理。离线设备无法执行新的远程请求。

  2. 重启或更新代理

    完成正在运行的任务后按 Ctrl+C 停止代理。使用最初注册设备时的操作系统账户重新运行最新版本。不要在同一设备上同时启动两个代理。已有的注册信息可以继续使用。

    npx -y @lhtsoft/remotecommand-agent@latest run
  3. 命令被拦截或缺少 npx

    COMMAND_BLOCKED 可能是设备策略正确拦截操作的结果,请检查权限配置及允许的文件夹。若找不到 npx,请安装 Node.js LTS,重新打开终端并检查 node 与 npm 是否可运行。

    node --version
    npm --version

通过只读请求验证

请 AI 助手调用 list_devices,选择在线设备,然后读取允许目录中的文件。设备在线并不代表获得终端执行权限。操作被拒绝时应检查设备策略,而不是绕过限制。

list_devices

常见问题

命令被阻止或 npx 无法运行时怎么办?

COMMAND_BLOCKED 可能是设备策略正确拦截操作的结果,请检查权限配置及允许的文件夹。若找不到 npx,请安装 Node.js LTS,重新打开终端并检查 node 与 npm 是否可运行。

下一步

安装并连接