外观
阅读须知:客户端与控件命名
本页覆盖编辑器的常规配置项:界面构建变体、品牌色系、启动与连接行为、延迟显示、公告弹出,以及基础的元素隐藏开关。
其中「界面元素隐藏开关」这一类的控件全是 开关(checkbox),勾选即隐藏对应界面元素。
为方便查找,这里按功能重新划分小节,而不是照搬编辑器里的原始分组名。
阅读前需要了解一点:
- 两个客户端:
Xboard-Mihomo_sub(老客户端)与NexGen Client React(新客户端),各自有一套编辑器。有些配置项只在一端提供,本页每项都会标明。
界面风格与布局
这一节决定客户端打包出来长什么样:用新 UI 还是旧 UI、新 UI 用哪套品牌色系,以及首页面板的默认排布。
UI 构建变体
- 控件:下拉选择
决定打包后的客户端使用哪一套界面入口。默认为旧 UI;只有选择新 UI 后,重新打包出来的客户端才会使用新入口。编辑器提供 legacy(旧 UI)与 new(新 UI)两个选项。
提示
该选项影响的是打包产物,改动后需要按 软件打包 重新构建并分发客户端,已经装在用户手机上的旧客户端不会自动切换入口。
新 UI 品牌色系
- 控件:下拉选择
仅新 UI 使用。缺少该字段或填入无效值时,客户端按绿色处理。可选值为 green(绿色)、blue(蓝色)、purple(紫色)、orange(橙色)、teal(青绿色)、cyan(青色)、rose(玫红色)、indigo(靛蓝色)。
提示
如果不想让用户自己换色,可以同时开启下文的「隐藏品牌色系切换入口」,首页就会固定使用这里选定的品牌色。
首页面板布局
- 控件:下拉选择
设置首页面板的默认布局。编辑器提供 default(默认布局)和 layout1(布局 1,订阅置顶)两个选项。
注意
该选项只会写入配置文件,客户端内不提供切换入口,打包后即按配置固定,用户无法在客户端里自行改回。
显示加速后 IP 信息
- 控件:开关
开启后,首页加速按钮下方会显示当前公网 IP;关闭后隐藏「检测中」「超时」和 IP 文本。
颜色类选项不在这里
本页没有颜色值输入项。客户端的点状配色(流量条、按钮、图标等若干指定位置的颜色)属于需要对接码解锁的扩展能力,已独立成栏,见 功能字段与取值。
启动、连接与运行行为
这一节集中放客户端的运行行为开关。其中 autoConnectOnStartup、autoTestAfterLogin、dnsOverrideDefault、logFileEnabled 只在 NexGen React 编辑器里提供。
启动后自动连接代理
- 控件:开关
开启后,桌面端启动时会使用上次记住的节点并自动开启代理。旧配置缺少该字段时按关闭处理。
登录后自动测速并选择最低延迟节点
- 控件:开关
开启后,登录成功并加载分流组后会自动测速主策略节点,并切换到延迟最低的节点。旧配置缺少该字段时按关闭处理。
默认启用 DNS 覆写
- 控件:开关
开启后,新安装的客户端或尚未保存本地设置的客户端会默认启用应用内置 DNS 配置。旧配置缺少该字段时按关闭处理。
记录应用日志文件
- 控件:开关
关闭后停止写入应用日志文件,但不影响必要的控制台输出和系统诊断日志。
延迟显示调整
- 控件:开关
「延迟显示调整」的总开关,与下面的 延迟降低百分比 配套使用:开启后,测速结果显示的延迟值会按设定百分比下调。
延迟降低百分比
- 控件:数字
- 取值范围:
0~90 - 默认值:
0 - 示例:
0
测速后显示的延迟值会按这里配置的百分比降低。兼容旧写法 latency_reduction: 90,保存时会统一改写为新格式。
公告与提示
首页自动弹出公告
- 控件:开关
启用后,进入软件首页且存在可见公告时,会自动打开公告详情。
自动弹出最小间隔(小时)
- 控件:数字
- 取值范围:
0~ 不限 - 默认值:
24 - 示例:
24
以小时为单位,控制 首页自动弹出公告 的触发间隔,默认 24 小时。
界面元素隐藏开关
这一类开关的控件全部是 开关(checkbox),勾选即隐藏对应界面元素,但分散在两个客户端的不同分组里,字段和标签也很相似。下表先做速查汇总,后面再按同样顺序逐项列出完整字段和说明。
| 界面标签 | 作用 |
|---|---|
| 隐藏流量详情标签页 | 隐藏流量详情标签页和页面 |
| 隐藏节点状态 | 不显示节点在线/离线状态与筛选 |
| 隐藏第三方客服入口 | 隐藏登录后的第三方客服组件入口,不影响 Telegram 频道入口 |
| 隐藏品牌色系切换入口 | 隐藏新 UI 首页的品牌色系调色板按钮,继续使用已配置的固定品牌色 |
| 隐藏邀请推广页面 | 隐藏左侧或底部导航里的邀请推广入口 |
| 显示专用节点 | 显示专用节点入口与页面,需面板为 SSPanel-Metron |
| 隐藏连接卡片当前节点标签 | 只隐藏连接状态卡片里节点名称上方的「当前节点」文本 |
| 隐藏页面顶部标题文案 | 隐藏各页面顶部的标题与描述,保留占位避免布局错位 |
| 隐藏购买套餐速率 | 套餐卡片和购买详情里都不再显示速率信息 |
隐藏流量详情标签页
- 控件:开关
启用后,将隐藏流量详情标签页和页面。
隐藏节点状态
- 控件:开关
启用后,不显示节点在线/离线状态与筛选。
隐藏第三方客服入口
- 控件:开关
开启后隐藏登录后的第三方客服组件入口,不影响 Telegram 频道入口。
老客户端只有新 UI 会读这个开关
老客户端打包成旧 UI 时,客服入口由另一套条件决定,并不读这个开关——设了不会改变界面。新客户端没有这个限制。
隐藏品牌色系切换入口
- 控件:开关
开启后隐藏新 UI 首页的品牌色系调色板按钮,客户端继续使用 新 UI 品牌色系 里选定的固定品牌色。旧 UI 本来就没有这个按钮,因此旧 UI 下不受影响。
注意
这一项在 sspanel-uim 分支的两端客户端里都没有实现,用该分支打包时设了也不会生效。
隐藏邀请推广页面
- 控件:开关
开启后隐藏左侧或底部导航里的邀请推广入口,直接访问该页面也会回到首页。
注意
老客户端只有新 UI 会读这一项:旧 UI 的邀请入口是无条件显示的,打包成旧 UI 时设了不会改变界面。新客户端两套 UI 都生效,没有这个限制。
显示专用节点
- 控件:开关
开启后显示专用节点入口与页面,默认关闭并隐藏。客户端还要求面板本身是 SSPanel-Metron——判定条件是「面板支持 且 开关打开」,只开开关不会有入口。
注意
这一项只在面向 SSPanel-Metron 面板的 sspanel-metron 分支里实现,打包时「源码分支」必须选对,否则客户端里根本没有专用节点页面。老客户端还只有新 UI 会读它,打包成旧 UI 时设了同样不生效。
两个键名指的是同一项
编辑器保存档案时会把 showDedicatedNodes 这类旧写法归一化合并到新字段,所以在档案里看到两个键名中的哪一个都属正常,不要手工去改档案里的字段。
隐藏连接卡片当前节点标签
- 控件:开关
开启后只隐藏连接状态卡片里节点名称上方的「当前节点」文本,不影响节点名称本身。
注意
这一项只有新客户端支持,老客户端没有实现,设了也不生效;而且在新客户端里只对旧 UI 生效,打包成新 UI 时设了同样不生效。
隐藏页面顶部标题文案
- 控件:开关
开启后隐藏购买套餐、节点状态、实时连接等页面顶部的标题和描述文案,但保留原有占位,避免布局错位。
注意
与上一项相同:只有新客户端支持,老客户端没有实现;且只在新客户端的旧 UI 生效,打包成新 UI 时设了不生效。
隐藏购买套餐速率
- 控件:开关
开启后套餐卡片和购买详情里都不再显示速率信息。
注意
这一项在 sspanel-uim 分支的两端客户端里都没有实现,用该分支打包时设了不会生效。
更多自定义功能在专门的栏目里
配色、登录窗口套餐状态拦截、购买页优惠码、节点解析、邀请与注册这些需要用对接码解锁的扩展能力, 以及它们在哪个客户端、哪套 UI 才生效的支持矩阵,都在 自定义功能 这一栏。