修改前先退出和备份

参数较多，部分设置不直接出现在界面中。先通过“打开存储所在的位置”找到实际 guiConfigs，备份整个文件夹，再正常退出客户端后编辑。

JSON 中布尔值写 true / false，数字不加引号，字符串需要双引号。不要把示例片段覆盖成整个配置文件；只修改现有文件中的对应字段。不同版本的字段可能变化，先确认当前文件里存在该项。

guiConfigs 文件说明

这些文件用途不同，不能全部作为普通 JSON 编辑。迁移时保留整个目录比单独复制一个文件更完整。

文件用途与编辑方式
guiNConfig.json客户端设置；退出应用后编辑
guiNDB.db配置数据库；不要直接用文本编辑器修改
pac.txtWindows PAC JavaScript 脚本
Mixin.yamlmihomo 配置混入内容，使用 YAML
GUID 命名文件完整自定义配置，从客户端打开对应项编辑

客户端参数与默认值

以下是 Wiki 列出的隐藏参数。默认值只说明未调整时的行为，修改后需重新启动并检查功能。

参数作用 / 默认值
MainColumnItem.Name配置列表列名称，保留现有名称
MainColumnItem.Width列宽；-1 隐藏该列
MainColumnItem.Index列显示顺序
GuiItem.EnableLog客户端日志开关，默认 true
ClashUIItem.EnableMixinContent启用 mihomo Mixin.yaml，默认 false
HysteriaItem.HopInterval端口跳跃间隔，单位秒
SpeedTestItem.SpeedTestPageSize每批测试数量，默认 1000
SpeedTestItem.SpeedTestDelayInterval两批测试之间等待秒数，默认 1
UIItem.HideColumnIpInfo隐藏 IP 信息列，默认 false

KcpItem 与 GrpcItem

这两组对应 Xray 传输配置。应从当前客户端已有对象修改，不要把核心原生配置直接当作 guiNConfig 的完整结构。

mKCP 使用 UDP 传输；mtu 控制包大小，tti 是发送间隔，uplinkCapacity / downlinkCapacity 用 MB/s 表示容量。新核心已改变部分旧字段，header / seed 的旧写法不能无条件套用。

gRPC 的 serviceName 与服务端匹配，authority 控制请求 authority；idle_timeout 为发起健康检查前的空闲秒数，health_check_timeout 为检查超时。过短的检查周期可能被服务端关闭连接；不要为了“更快”把所有超时设为最小。

Mux4RayItem 与 Mux4SboxItem

Mux 将多条逻辑连接复用在较少的底层连接上，主要减少建连开销，不保证提高下载速度。Xray 的 concurrency 控制每条连接的复用数量；xudpConcurrency 控制 UDP 聚合，xudpProxyUDP443 可选择 reject、allow、skip。

sing-box 的 protocol 可选 smux、yamux、h2mux。max_connections / min_streams 与 max_streams 是互斥的调度方式，不要全部同时设置非零值。padding 和 brutal 需要服务端及版本支持。7.25.6 可优先使用核心设置界面中的 Mux 控件。

Fragment4RayItem

该对象对应 Xray freedom 出站的分片设置。packets 选择要处理的数据包范围或 TLS ClientHello，length 控制分片长度，interval 控制分片间隔。它不是所有核心通用的设置，也不能保证改善网络。

代理链、传输方式和核心版本都会影响实际效果。修改后先检查生成配置，再用同一目标对比；出现异常时关闭分片，回到已知可用配置。

PAC 与 Mixin 的生效范围

pac.txt 只影响支持 PAC 的 Windows 应用；返回 DIRECT 的请求不进入核心。Mixin.yaml 用来合并 mihomo 自定义内容，只有启用 EnableMixinContent 才生效。

YAML 对缩进敏感，重复键或类型不符可能让核心拒绝加载。修改前保留原文件，启动后查看最终配置与日志；若仅修改 GUI 普通路由却启用了完整模板，应同时检查模板是否覆盖了这些设置。

验证改动与恢复

保存后先验证 JSON / YAML 语法，再启动客户端。确认目标设置生效、核心无错误，并进行一次新连接测试。

启动失败时退出应用，用备份恢复修改的文件或通过客户端还原备份。不要同时修改数据库、核心文件与多个参数组，否则很难定位哪项改动导致错误。

日志与复现