Skip to content

阅读须知:客户端与控件命名

本页覆盖编辑器的常规配置项:界面构建变体、品牌色系、启动与连接行为、延迟显示、公告弹出,以及基础的元素隐藏开关。

其中「界面元素隐藏开关」这一类的控件全是 开关(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 文本。

颜色类选项不在这里

本页没有颜色值输入项。客户端的点状配色(流量条、按钮、图标等若干指定位置的颜色)属于需要对接码解锁的扩展能力,已独立成栏,见 功能字段与取值

启动、连接与运行行为

这一节集中放客户端的运行行为开关。其中 autoConnectOnStartupautoTestAfterLogindnsOverrideDefaultlogFileEnabled 只在 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 才生效的支持矩阵,都在 自定义功能 这一栏。

相关页面

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