修改前先退出和備份

參數較多，部分設置不直接出現在界面中。先通過“打開存儲所在的位置”找到實際 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 語法，再啓動客戶端。確認目標設置生效、核心無錯誤，並進行一次新連接測試。

啓動失敗時退出應用，用備份恢復修改的文件或通過客戶端還原備份。不要同時修改數據庫、核心文件與多個參數組，否則很難定位哪項改動導致錯誤。

日誌與復現