NexGen Client 使用说明

外观

这是什么 ​

编辑器里除了左侧分类导航的常规配置项，还有一个「自定义功能配置」面板。收进这个面板的功能有一个共同点：一部分用户需要，但不适合对所有用户默认开放——例如零散位置的点状配色、登录窗口的套餐状态拦截、购买页优惠码的显隐、节点来源与显示范围、邀请与注册绑定。它们不摆在常规配置项里，而是用对接码按需放行。

页面上给你的提示是：输入对接码并验证通过后，才会显示可用的自定义功能。

你的情况会看到什么
拿到了对接码输入并验证后，只显示你这个码被授权的功能，你自己决定开哪几项
没有对接码面板里不显示任何可配置的功能项——看不到，也就改不了（这是正常现象，不是面板坏了）

动手前先看两件事

  • 同一个功能在两个客户端上未必都能用。 先扫一眼下面的支持矩阵，避免配了却没有效果。
  • 面板里改完只是写进当前档案，要重新打包才会体现在客户端产物里，见软件打包。

对接码怎么用 ​

对接码从哪来：它不在这里注册或申请，而是发给你激活码的那个人在管理后台按「功能组」配好后下发给你的。一个功能组由名称、对接码和一组功能组成，所以：

  • 不同的对接码解锁的功能不一样：别人能开的不代表你能开。
  • 一个对接码对应一组功能：一个码里可能同时包含配色类和开关类两种能力，也可能只有其中一种。
  • 没拿到码就是没被授权，需要联系发码的人开通，自己在这里是试不出来的。

操作步骤：

  1. 先选好要操作的档案。 这个面板针对某一个档案操作，不是全局设置。左侧还没选档案就点验证，会提示 请先在左侧选择要操作的配置档案。
  2. 输入对接码并验证。 在「对接码」输入框里填入拿到的码（占位提示 请输入后台设置的对接码），然后点 验证对接码。验证期间会显示 正在校验对接码并读取当前公共配置...，稍等一下，不要重复点。
  3. 看验证结果，逐项开关后保存。 通过后提示形如 对接码验证通过：已授权 N 项，已开启或配置 M 项，下面随即出现你这个码授权的功能项。面板里只会显示当前对接码已绑定的功能，其余功能不出现，也就不可能被误改。页面上写得很明确：只会显示当前对接码已绑定的功能。保存后会直接写入当前档案对应的公共 YAML 配置。
  4. 重新打包。 保存进档案只是第一步，必须重新打包，改动才会体现在客户端产物里；已经发出去的旧安装包不会自动变，见软件打包。

验证通过后，按钮会变成 重新验证对接码——将来换了新码，点它重新填、重新验证即可。验证过的码会在当前浏览器会话里记住，不用每步都重填。

成功、失败与各种状态提示 ​

界面提示什么情况怎么办
请输入对接码后再展开自定义功能页没填码就点了验证先把码填进「对接码」输入框
请先在左侧选择要操作的配置档案还没选档案先在左侧选中要操作的档案
正在校验对接码并读取当前公共配置...正在验证等它跑完，不要重复点
对接码验证通过：已授权 N 项，已开启或配置 M 项验证成功下面会出现该码授权的功能项，逐项开关后保存
验证失败: <原因>码不对，或这个码没有被授权先核对有没有输错、有没有多余空格；确认无误就找发码的人核实
后台还没有为该自定义功能配置任何可用的自定义功能组，请先到管理后台系统设置中新增。发码方还没配好任何功能组这不是你能处理的，找发码的人
请输入对接码后再读取当前配置读取配置前没填码先填码再读取
请先验证对接码并展开自定义功能页，再保存公共配置没验证就点了保存先完成验证，再保存

管理员登录有什么不同

如果你的账号是管理员权限，这个面板不需要对接码：打开就直接显示全部功能，并提示 当前为管理员登录，可直接查看和保存；普通用户则需要先输入对接码并验证。 其他账号看到的仍是上面那套「输入对接码 → 验证 → 只看授权项」的流程。

支持矩阵 ​

「老客户端」指 Xboard-Mihomo_sub，「新客户端」指 NexGen Client React；新 UI 和 旧 UI 是每个客户端自己的两套界面，同一个功能在两套界面里的生效情况可能不一样，所以下表分开标出。

支持情况以各客户端的默认分支为准。你打包时选的「源码分支」会带来这些差异：

分支与默认分支的差异
sspanel-malio与默认分支一致
sspanel-metron额外实现 SSPanel 节点页面解析（仅老客户端如此）
sspanel-uim少若干项（下表标「uim 无」的那些）

下表单元格里：「uim 无」= 该功能在 sspanel-uim 分支未实现；「metron 分支」= 只有 sspanel-metron 分支才有。

功能作用老客户端 Xboard-Mihomo_sub新客户端 NexGen Client React
流量条自定义替换客户端流量进度条的颜色支持（仅旧 UI）不支持
公告弹窗图标背景自定义替换公告弹窗里图标底部的背景色支持（仅旧 UI）不支持
官网按钮图标自定义替换订阅页官网图标的颜色支持（仅旧 UI）不支持
刷新按钮图标自定义替换订阅页刷新图标的颜色支持（仅旧 UI）不支持
公告按钮图标自定义替换订阅页公告图标的颜色支持（仅旧 UI）不支持
登录按钮颜色自定义替换登录按钮的颜色支持（新 UI / 旧 UI 都生效）不支持
套餐订阅按钮颜色自定义替换套餐列表「订阅」按钮的颜色支持（仅旧 UI）不支持
套餐筛选按钮颜色自定义替换套餐列表上方筛选标签的颜色支持（新 UI / 旧 UI 都生效）不支持
邀请码文本颜色自定义替换邀请码文字的颜色支持（仅旧 UI）不支持
邀请码卡片背景颜色自定义替换邀请码卡片的底色支持（仅旧 UI）不支持
可用佣金卡片背景颜色自定义替换「可用佣金」卡片的底色支持（仅旧 UI）不支持
邀请统计总邀请图标颜色自定义替换邀请统计里「总邀请」的图标颜色支持（仅旧 UI）不支持
邀请统计返佣比例图标颜色自定义替换邀请统计里「返佣比例」的图标颜色支持（仅旧 UI）不支持
邀请统计总佣金图标颜色自定义替换邀请统计里「总佣金」的图标颜色支持（仅旧 UI）不支持
登录窗口套餐状态拦截无套餐、已到期或流量用尽的用户登录时被提示，并可前往官网处理支持（两套 UI）支持（两套 UI）
节点弹窗仅显示主策略节点选择节点弹窗直接显示主策略组节点，不再先显示其他分流组支持（仅新 UI）支持（新 UI / 旧 UI 都生效）
隐藏购买页优惠码购买套餐页默认隐藏优惠码区域及输入框支持（两套 UI）支持（两套 UI · uim 无）
SSPanel 节点页面解析节点列表改从 SSPanel 的节点页面解析支持（metron 分支，默认开启）支持（自动回退，不是开关）
注册邀请绑定把邀请码预置进这份客户端，用户注册时自动带上——用于给不同推广者分发各自的专属客户端支持（仅旧 UI）支持（两套 UI）
自定义邀请链接让邀请页能展示完整注册链接——用你自己指定的地址拼，不暴露后端地址支持（两套 UI）支持（两套 UI · uim 无）

字段怎么填、默认值与取值范围是多少，以及哪几项开启后必须补填配套内容才能保存，见 功能字段与取值。

必须知道的坑 ​

SSPanel 节点页面解析只有 metron 分支的客户端才读

这一项只在面向 SSPanel-Metron 面板的 sspanel-metron 分支里实现。

老客户端在这个分支里读这个开关且默认开启；新客户端虽然也有这个能力，但不读开关，行为固定为「API 优先、拿不到时自动回退到页面解析」。

那批配色只有老客户端支持，而且绝大多数只在旧 UI 生效

新客户端 NexGen Client React 完全没有这套点状配色机制，配了不会有任何效果。老客户端里也只有「登录按钮颜色」和「套餐筛选按钮颜色」在新 UI 也生效，其余各项只作用于旧 UI。

这些颜色定的是用户装好后的默认观感，不是锁死外观——用户在自己的设备上仍可在客户端内自行调整配色；它们也只覆盖零散几处位置，整体换肤靠的是常规配置项里的「品牌色系」预设（这一项只对新客户端的新 UI 生效，其旧 UI 颜色是写死的），详见界面行为、布局与隐藏项。

「节点弹窗仅显示主策略节点」在老客户端只对新 UI 有意义

这一项在老客户端只有新 UI 的节点选择弹窗实现了过滤，旧 UI 不受影响；新客户端两套 UI 都生效。

节点列表显示不全或为空时，可以照上面「SSPanel 节点页面解析」那条路径排查是哪一层断了；两条都拿不到通常是面板侧的接口或页面本身的问题。更多排查思路见常见问题。

相关页面 ​

本文档依据 Xboard-Mihomo-builds 源码整理

NexGen Docs