GUI.for.SingBox 升级后，先到核心管理看本地 sing-box 版本，再决定是否更新核心。界面程序、核心二进制、生成的 JSON 配置是三个对象；只换 GUI 安装包，不能据此认定核心已更新或旧配置已经适配。

v1.27.0 发布页标注的发布时间是 2026 年 9 月 7 日 UTC。正文只有 GitHub Actions 自动生成发布的说明，没有功能清单。下面按这个固定标签的桌面源码讲操作，不把已有功能算成新增；未在 Windows、macOS、Linux 的具体系统版本上安装实测。

核心管理里，本地和远程版本看哪个？

打开设置的“核心管理”。sing-box 与 Alpha 分别有本地、远程版本；本地表示已安装的核心，远程表示更新查询结果。不要拿远程数字当成当前正在运行的版本。核心版本组件也把更新与重启做成不同按钮。

没有依赖内测功能时，选“切换版本”中的 Stable。确实需要 Alpha 支持的配置字段时才选 Alpha，并保留原配置。运行中点击另一分支会触发重启，安排在可以短暂中断连接的时候。下载完成后，按界面提示重启核心，并重新查看本地版本。

这里的齿轮入口叫“运行时配置”，里面是环境变量和运行参数，并非节点或路由编辑器。正常管理配置时不必改启动参数；想修改规则，应回到配置页对应的路由设置。

遇到下面的状态，用对应入口处理：

看到的现象更可能混淆的对象要看的位置
GUI 已升级，本地核心号没变界面与核心版本核心管理的本地版本
Alpha 已下载，启动的仍是 Stable下载与分支选择切换版本中选中的卡片
编辑器字段与预览不同编辑输入与生成结果生成配置并查看
更新订阅后改动消失自动接管与手工配置配置卡片的自动标记

订阅导入后，怎样变成一份配置？

在订阅页点“添加”，按来源选 HTTP 或文件。远程来源填“远程链接”；本地来源填“本地路径”。“保存路径”是保存位置，不能用它代替来源。表单还提供手动管理类型，适合自行维护节点，而不是把远程地址藏在名称里。

接着到配置页点“添加”，填写名称。编辑器依次提供通用、入站、出站、路由、DNS、混入和脚本设置。在“出站设置”引用已有订阅，补好需要的策略组、路由与 DNS 后保存。只有订阅列表出现节点，还不能说明这份配置已引用它们。

如果配置卡片带“自动”标记，它由订阅接管，更新可能覆盖修改。准备定制时，可先通过右键“更多 → 复制并粘贴”保留副本，再改副本。这里讨论管理关系；若来源本身是 Clash YAML 等其他格式，另看订阅格式迁移，不要只改扩展名。

“编辑配置源文件”为何不等于最终配置？

配置页菜单源码提供了两个不同入口。右键配置卡片，进入“更多 → 生成配置并查看”，会生成 JSON；“生成配置到剪切板”便于保存当前结果作对照。

“编辑配置(源文件)”也展示 JSON，但它并非直接打开运行中的文件。该编辑器生成内容时，关闭稳定版兼容处理、插件、混入与脚本处理；保存时再把 JSON 恢复为 GUI 的配置结构。因此，在这里找不到混入后的值，不足以判定混入失效。

要核对分流，查看生成结果的 outbounds 是否包含目标节点，以及 route、dns 的引用是否对应。若字段在生成后变了，按实际启用的插件、混入优先级和脚本查来源。生成器源码先组装基础配置，再经过稳定版兼容入口、插件、混入、脚本。不过该标签的兼容函数为空，不能指望选择 Stable 自动改写不兼容字段。混入优先级决定同名字段谁覆盖谁，脚本还可继续修改结果。

启动以后，再看写入磁盘的文件

对选中的配置执行“使用此配置启动/重启”。核心管理的文件夹按钮可以打开核心所在目录，避免凭其他客户端的路径猜位置。源码中的相对路径如下，实际绝对位置取决于程序工作目录：

data/sing-box/config.json
data/sing-box/sing-box.log

启动源码会重新生成配置，调用启动前插件，再写入 config.json。写入时还会设定缓存文件路径并加上生成标记，所以预览与磁盘文件可能不同。查看文件中的目标出站和规则，再读同目录日志；启动错误应对应到这份文件，而不是订阅下载原文。

“生成配置并查看”只调用生成器，不会执行 sing-box 的配置校验。能显示 JSON 不代表当前核心接受全部字段，也不代表 DNS 或出站连通；启动报错仍要读日志。

别把手工修改生成文件当成长期修复。下次启动生成会覆盖它。把修改放回配置编辑、混入或脚本入口，重新生成后再看差异。若错误明确指向旧 DNS 字段，转到旧 DNS 配置迁移，这里不另给一套字段替换表。

换核心后启动失败，如何恢复？

如果只切了分支，切回原分支并选回原配置。若刚更新核心，核心管理在备份存在时显示“回滚到上一版本”；这个按钮恢复核心文件，不会同时恢复你修改过的配置，所以副本仍然有用。

恢复后确认本地版本、选中的配置和日志是否对应。核心能启动但流量去向不符合预期时，继续按路由与日志排查检查实际连接。不要为了消除启动报错，把同一份配置同时换核心、改 DNS、重建订阅。