故障排查
按错误现象排查登录、连接、任务执行和文件传输问题。
登录失败、会话过期或反复跳转时怎么办？
先按错误类型判断，再从当前页面或桌面重新发起一次完整登录。
电脑断开连接，或 Agent 连不上怎么办？
分别恢复桌面或 CLI，再检查原任务、所选环境和执行错误。
浏览器显示登录成功，但没有回到桌面应用怎么办？
使用当前认证完成页的回跳入口，失效后从桌面重新开始。
为什么桌面提示必须更新后才能登录？
旧版缺少当前登录能力时，需要更新应用，不能靠修改回跳地址恢复。
安装包下载失败、无法打开或版本选错时怎么办？
先核对官方入口和目标架构，再区分下载、系统安装与登录问题。
自动更新失败，或者重启后仍像旧版本怎么办？
区分检查、下载、安装和重启阶段，保留当前任务后再恢复。
桌面应用已经打开或登录，为什么 Agent 仍显示电脑不可用？
登录、连接就绪和任务权限是独立条件，先恢复当前所选电脑。
点击“复制命令”没有成功，或粘贴后只有占位符怎么办？
使用复制按钮生成完整命令，区分准备失败和剪贴板失败。
终端提示找不到 node、npx 或 hackcat-local 怎么办？
先修复目标终端的运行环境，再按设置中的标准命令启动。
Local Agent 提示令牌无效或被拒绝，应该怎样恢复？
重新取得当前账户命令，必要时重置凭据并恢复受影响连接。
Local Agent 提示缺少或无效的服务地址怎么办？
重新复制当前设置生成的完整命令，不从旧文章拼接后端参数。
网站能打开，但 Local Agent 一直连接中继或超时怎么办？
区分网页访问与持续命令连接，检查目标电脑的网络和代理路径。
终端提示连接数达到上限，应该重置令牌吗？
这类错误表示命令连接容量受限，先停止重复启动并按提示稍后重试。
为什么服务器提示 Local Agent 多次无响应并停止连接？
连接记录存在不代表命令仍能响应，先重启客户端并核对原任务。
电脑休眠、切换网络后，桌面一直重连怎么办？
先恢复目标机器和网络，再触发桌面连接恢复并查看原任务。
明明有电脑在线，为什么仍提示所选电脑不可用？
可用连接与当前选择不同，恢复旧任务时尤其要核对目标机器。
项目提示需要连接桌面，或绑定目录无法使用怎么办？
目录项目要求合适的桌面环境，先核对连接与真实路径。
Agent 已连接，但运行工具提示 command not found 怎么办？
检查目标主机的工具安装、路径与执行用户，不把工具错误当作连接错误。
同一条命令在本地终端能跑，Agent 中却报语法错误怎么办？
先确认 Agent 实际使用的 shell，再修正参数、引用和路径。
本地文件或命令提示 Permission denied，应该怎样处理？
先识别系统权限与桌面文件连接错误，避免无依据提权或重复写入。
本地 Agent 能运行命令，为什么浏览器自动化仍不可用？
本机浏览器能力依赖实际安装，连接成功不代表浏览器工具已准备好。
页面提示离线时，输入草稿会丢失吗，怎样恢复发送？
保留当前设备上的文字草稿，恢复网络后先重连再确认任务状态。
回复或电脑面板不再更新，怎样判断任务是否还在运行？
先恢复实时显示并查看原任务，避免把输出中断当作执行结束。
审批卡片一直重连，或者允许操作后没有响应怎么办？
先恢复审批会话，再提交一次明确决定，不用完全访问绕过连接错误。
点击停止后任务仍有输出，怎样确认停止是否成功？
停止请求可能失败或遇到运行切换，不能把按钮变化当成所有操作已撤销。
附件显示上传失败，什么时候可以直接重试？
根据失败类型选择重试、重新添加或先解决权限与文件问题。
上传提示文件或图片过大，切换 Agent 就一定能解决吗？
区分 Ask、Agent 和图片处理限制，按实际任务缩小文件。
一次添加太多附件，为什么只有部分文件出现？
附件数量按当前模式和已添加文件计算，逐项核对后分批处理。
桌面选过的本地文件后来找不到，或读取失败怎么办？
检查源文件位置、执行机器和连接状态，再重新添加正确文件。
Agent 说生成了文件，但无法预览或下载怎么办？
区分生成、提供文件和打开链接三个阶段，只恢复失败的部分。