Roxi先确认项目维护状态
NekoRay 官方 README 已明确写明不再维护。Throne 是另一个项目，提供桌面客户端与自己的导入、路由和备份说明；本文以桌面为范围。不要把安卓 NekoBox 的备份、旧 NekoRay 数据库与 Throne 配置视为可以直接互换的同一格式。
建立可回退的迁移副本
- 在旧程序正常停止代理和 TUN，备份旧配置目录并记下自己的规则与端口。先不要卸载旧程序。
- 从 Throne 官方 Releases 选择匹配系统的安装包，在独立目录/数据位置启动。按其安装文档处理权限，不把旧核心文件手工塞进新目录。
在新程序重新建立订阅
先在 Roxi 网站登录自己的账户，打开订阅区域，复制“第三方客户端”订阅地址。不要复制官网首页、邀请链接或浏览器地址栏里的登录地址。客户端不附送节点；套餐、流量、到期时间和设备限制以账户页为准。
把原 /sub/个人标识 改为 /sub/nodes/个人标识，得到明确的 Base64 节点列表。它只包含节点，不附带这个客户端的完整分流配置。
下面的 /sub/... 仅表示原链接中的路径。保留账户提供的域名、个人标识和查询参数；只替换一次路径，不把示例占位符当作真实地址，也不要重复加成 /sub/clash/clash/。已有专用链接时直接使用。不要将订阅 URL 发给公共转换站。
- 打开订阅/分组管理，新增 URL 分组并更新；普通订阅使用节点列表，不先迁移整个旧数据库。
- 选择一个节点启动，桌面先验证系统代理；确有不读取系统代理的应用时，再测试 TUN。
- 逐条迁移自己确实需要的规则。新旧项目即使使用 sing-box，也可能有不同的生成配置和内核版本。
什么时候可以卸载旧程序
只有在日常目标、国内网站、订阅更新和一次正常退出都验证成功后，再考虑移除旧程序。迁移失败先关闭新程序的接管，然后启动原版本配合原备份恢复；不要让旧程序读取新版本改写后的数据。
怎样确认真正连通
- 确认这次更新成功、节点数大于零，并选中了刚导入的配置。更新失败时可能仍在使用旧缓存，不能只看列表里还有节点。
- 固定一个节点，访问实际要用的网站或应用，再查看连接或日志中的目标、规则与出口。延迟数字、VPN 图标和“已启动”都不能单独证明业务成功。
- 同时检查一个平时可直连的网站；随后断开连接，确认基础网络恢复。只在全局模式可用时回到规则排障，不把全局作为长期修复。
失败后按层排查，保留可恢复的配置
| 现象 | 先核对 | 下一步 |
|---|---|---|
| 下载失败或 401 / 403 | 订阅地址、账户状态、设备限制和当前网络 | 回账户复制新地址；看响应说明，不连续重复导入 |
| 解析失败 / 节点为零 | 下载到的是 YAML、JSON、节点列表还是登录网页 | 换成本文指定格式，保留错误字段名与客户端版本 |
| 能启动但目标打不开 | 当前节点、规则、DNS 和请求日志 | 换一条兼容节点做对照，勿删除 TLS 校验 |
| 停止后不能直连 | 系统代理、其他 VPN、断线阻止设置 | 先在客户端正常停止接管，再退出；恢复改动前设置 |
求助只提供系统与客户端/核心版本、失败阶段、发生时间和脱敏日志。升级前备份本地规则；订阅更新会替换远程内容，个性化设置尽量放在客户端支持的覆写或本地规则里。