故障排查
先记录问题发生时间、电脑名称、当前页面和完整错误文字。不要为了截图暴露密码、Token、私钥或用户数据。
电脑创建或启动
排查前先打开电脑详情的「面板」，这里同时显示运行状态、电源、通信、到期时间和配置；大部分问题的第一步都是确认页面状态而不是重复点按钮。
长时间停留在创建中
- 在订单中确认付款是否已经被服务端确认；
- 刷新电脑列表，避免重复提交购买；
- 查看页面是否显示失败、退款或重试入口；
- 记录订单号和电脑名称后联系客服。
电脑运行但通信中断
先等待短暂恢复，再刷新状态。不要在通信异常时连续提交重建、安装或文件操作。若重启电脑，当前进程和终端连接会中断。
终端和工作台
终端断开
使用页面的“重新连接”。如果电脑已经关机、重启、停机或会话内 Shell 已退出，原进程可能无法恢复。
文件没有显示最新内容
确认编辑器已经保存，重新打开文件并检查是否有其他设备同时修改。恢复备份或 Git 操作也可能改变磁盘内容。
Git 导入失败
检查 HTTPS 地址、仓库权限和凭据是否有效。不要把凭据嵌入 URL。若选择保存凭据，保存失败会使导入整体失败，应按错误提示重新处理。
CLI Store
按钮不可用
确认电脑已启动、通信正常，并且当前电脑通信服务支持该应用。已下架应用不能新安装。
下载文件长度或摘要不一致
这是制品完整性校验失败，常见原因是上游发布文件发生变化或下载不完整。等待平台重新校验并发布配方后再重试，不要绕过校验。
卸载按钮不可用
页面显示“手动安装”的应用不由 CLI Store 管理，需要使用原安装方式卸载。
端口和预览
检测不到端口
确认服务仍在运行、端口正确，并监听电脑可访问的地址。启动后刷新端口列表。
页面打开慢
分别检查电脑负载、服务首屏构建、依赖的外部接口和本地网络。预览链路不能消除应用自身的构建或接口等待时间。
WebSocket 或热更新失败
检查开发服务器是否信任预览域名、是否使用正确协议，以及应用是否把地址固定成了本地回环地址。
支付、续费和退款
支付后状态没有变化
先在订单中等待服务端确认，不要重复付款。保留平台订单号和付款时间。
自动续费没有成功
检查余额、自动续费开关、电脑当前阶段和站内消息。邮件未到达不能证明续费成功。
退款没有到账
查看订单中的退款状态和资金去向。渠道处理中需要等待；超过页面说明时间后再联系客服。
Desktop
登录后没有返回客户端
确认使用系统浏览器完成了当前客户端发起的授权，并允许系统打开客户端。不要重复使用旧授权页面。
客户端升级失败
保存文件后重新检查网络和磁盘空间，只使用官网当前安装包。不要从第三方地址下载安装包覆盖。
仍未解决
按联系客服准备必要信息。客服不会索要密码、验证码、私钥或完整密钥。