连接与操作故障排查

设备离线或没有出现

1. 确认当前工作区和设备组正确；受邀成员还需检查组访问授权。
2. 在目标设备上检查电源、网络和设备客户端是否运行，临时模式的程序是否已退出。
3. 确认安装内容来自当前设备组，查看安装是否报告下载或服务错误。
4. 等待状态更新；如果设备刚被移除或停用，联系管理员确认是否需要重新安装。

不确定安装流程时，返回Windows、macOS或Linux / BSD指南。反复创建重复设备记录通常不能解决连接问题。

桌面黑屏或无法输入

• **没有画面：**确认设备提供图形会话，尝试选择正确显示器；Mac 还要检查屏幕录制授权。
• **有画面但不能控制：**检查桌面控制权限；Mac 同时检查辅助功能授权。
• **输入不生效：**先让远程画面获得焦点，确认本机浏览器没有截获快捷键。
• **画面延迟：**检查两端网络，降低画面质量后重新观察。

系统权限修改后，按提示重启客户端并重新连接。不要仅根据旧会话判断新授权是否生效。

文件或终端被拒绝

检查文件读取、文件写入或终端权限，而不只检查桌面是否可用。文件操作还受目标目录访问权限和工具传输上限限制。

连接断开后，先检查远程结果再重试：上传可能已经完成一部分，命令也可能仍在运行。MCP 文件覆盖提示摘要不匹配时，重新读取并确认文件内容，不要跳过冲突检查。

Chat 或 MCP 无法操作

内置 Chat 检查是否启用、模型是否可用、工作区余额、Chat 设备组及成员权限。第三方 MCP 客户端则检查实际服务地址、Key 有效期、工具 scope 和客户端来源状态。

能连接 MCP 但缺少工具时，刷新工具列表并检查密钥权限。旧截图或会话已到期时重新获取，不要连续重发相同请求。MCP 配置步骤和访问密钥提供了详细说明。

提交有用的问题描述

如果问题持续，打开工单支持，附上以下信息：发生时间与时区、目标操作系统、浏览器或客户端版本、操作步骤、预期结果、实际提示，以及是否影响所有设备。

可以附上去除敏感内容后的错误截图。不要提交完整 Key、安装命令中的组连接信息、密码或无关文件内容。管理员可结合操作记录和安全审计核对同一时间的事件。