客户端配置导入失败

保存来源与原文件，再开始导入

配置可能来自账号页面、下载文件或系统分享。先记录来源页面与取得时间，不要把配置密钥贴到聊天或反馈表单。保留原文件可避免多次编辑后无法判断格式变化。

能选中文件不代表格式已被接受

系统文件选择器只证明应用取得读取机会。客户端随后可能因格式、编码、字段或版本不匹配而拒绝。完整记录提示文字，返回配置页核对支持方式，不要随意删除看不懂的字段。

导入成功与连接成功仍然不同

导入后出现条目只说明客户端保存了配置。连接还依赖账号状态、目标服务、系统网络权限和当前网络。若导入成功但连接失败，应转到异常排查，不要反复导入相同文件。

过期与撤销需要回到受信来源

部分配置或授权信息可能有有效期或被更新。遇到明确过期、撤销或未授权提示时，应从受信账号页面重新取得，而不是修改设备时间或复制别人的配置。

回退要恢复已知状态

导入前记录原有可用条目，失败时删除本次新增项并恢复原状态。反馈只需要设备、客户端版本、取得方式和非敏感错误文字；不要上传配置原文。

一个最小的导入现场

导入前保留当前可用条目，记录客户端版本和文件来源。执行一次导入后，只记录客户端明确显示的结果，不连续选择多个文件。若提示格式错误，回到来源核对取得方式；若提示权限不足，检查系统是否允许应用读取所选位置。

文件被接受后，先核对条目名称和必要字段是否出现，再测试连接。连接失败不应反复编辑原文件。向支持反馈时提供设备、版本和错误文字即可，配置原文与密钥应留在受信账号环境中。

同一文件再次导入前先看结果

客户端已有相同条目时，再次导入可能覆盖、复制或拒绝，行为取决于应用实现。先查看当前条目与提示，不用重复导入测试。

如果需要替换，先核对账号可以重新取得配置，并保留一个可回退状态。系统文件选择器的完成只表示选择动作结束，不等于客户端已经接受内容。

配置文件的保存边界

配置原文可能包含连接地址、账号标识或密钥，不适合放入公开截图。排查时只记录文件类型、取得方式和客户端返回的错误。

需要重新取得时，从受信账号页面操作。不要让第三方替你修改未知字段，也不要用别人的配置判断自己的账号状态。移除配置前还要确认恢复来源仍然可用，并保存客户端显示的条目名称作为备份。

导入记录不包含秘密

可以写下文件类型、取得时间、客户端版本和错误文字。配置正文、订阅地址、令牌与密钥不进入截图或公开反馈。