Roxi适用条件与准备
适用于使用 mihomo 的桌面 GUI.for.Clash。先从官方指南进入 Releases，按系统和架构选包，完整解压到可写目录。关闭其他客户端的系统代理和 TUN，保留原配置作为回退。进入设置的内核页，确认能显示内核版本；没有核心时先按官方入口下载。
用明确的 Clash 格式导入
先登录 Roxi 账户复制自己的第三方订阅链接。下文路径只替换原链接中的 /sub/ 部分一次，保留域名、个人标识及全部查询参数；不要把“个人标识”当真值，也不要把官网首页或登录页当订阅。已有对应格式的专用链接时直接使用。
将个人链接改成 /sub/clash/个人标识，输出应为完整 mihomo YAML。GUI 会把订阅与自己生成的运行配置分开维护；名字相似并不代表把远程文件原封不动地直接运行。
- 在“概览 → 快速开始”填入自己的链接并保存；随后检查订阅是否本轮更新成功、节点是否非空。
- 在配置页确认有一份配置关联到刚导入的订阅。若手工创建配置，代理组必须引用订阅或节点；只有订阅条目而没有关联组，仍可能无节点可选。
- 选中要运行的配置并启动内核，再手动开启系统代理。首次先验证系统代理，确有需要时再按当前平台的授权流程使用 TUN。
决定谁维护规则，避免更新覆盖
| 方式 | 适合的需求 | 更新时注意 |
|---|---|---|
| 使用订阅内的代理组和分流规则 | 希望沿用服务方给出的完整规则 | 官方说明自动生成的配置可能被订阅更新覆盖 |
| GUI 自建配置并引用订阅 | 自己管理策略组和规则 | 更新节点后检查引用；不要直接改运行时生成文件 |
先备份一份已验证配置，再在另一份配置里尝试规则。若更新后自定义项消失，检查自己是否修改了自动生成配置；这与订阅 URL 失效不同。运行文件由 GUI 再生成，长期修改应放在其配置管理入口。
按失败阶段排查
| 现象 | 下一步 |
|---|---|
| 核心版本空白 | 检查核心下载和路径，不先换节点 |
| 订阅有节点、代理组却为空 | 核对配置是否关联该订阅，是否出现循环引用 |
| 已启动但浏览器无请求记录 | 确认系统代理开关和实际监听端口 |
| 订阅刷新后规则变化 | 恢复备份，重新决定使用远程规则还是本地配置 |
验收与恢复
- 固定一个节点，访问实际需要的网站，同时在日志或连接列表核对目标、命中规则和最终出口。VPN 图标、端口监听和延迟数字都不能单独证明目标访问成功。
- 再访问一个平时可直连的网站，记录是否受影响；停止接管后重试，确认正常网络恢复。一次只改一项，记录客户端与核心版本、网络和错误发生时间。
先关闭系统代理/TUN，再停止核心并退出。若要恢复旧客户端，确认新客户端已停止接管后再启动旧版本，不同时让两个程序争用同一端口。
只分享脱敏后的失败阶段、字段名和日志摘要。订阅 URL、二维码、节点认证信息和导出的配置都可能包含凭据，不要发送到公开群或公共转换网站。本文依据官方资料与项目接口整理，未进行真机连接实测。