GUI.for.Clash 升级后要处理订阅，先保存完整数据目录，再把全局插件、订阅筛选、单条订阅脚本按顺序检查。v1.27.0 中，插件重命名发生在筛选之前；把筛选条件写成原节点名，可能会得到空列表。

v1.27.0 发布包应该换哪一个？

官方 Release 于 2026 年 9 月 7 日 UTC 发布，说明只有自动生成发布的文字，没有列出具体改动。下文依据该标签源码讲当前用法，不把插件能力说成本版新增。

Windows 提供 windows-386、windows-amd64、windows-arm64；macOS 提供 darwin-amd64、darwin-arm64；Linux 提供 linux-amd64、linux-arm64，均为 ZIP。按本机系统和架构选择，保留原压缩包及可执行程序。

这是 GUI-for-Cores 桌面发布包的文档教程，未运行客户端实测，也未指定实测系统或 Mihomo 内核版本。应用版本与内核版本分别记录；软件关系可参照 GUI.for.Clash 客户端介绍。

退出应用后，把哪些文件留下？

复制可执行程序旁的整个 data，不要只保存节点 YAML。它还包含 plugins.yaml、subscribes.yaml、profiles.yaml 和 user.yaml，以及插件源码、订阅文件和内核。只留订阅文件，恢复时可能丢失插件设置与配置引用。

macOS 要额外注意：该版后端源码 按可执行文件名决定目录：默认程序名对应 ~/Library/Application Support/GUI.for.Clash，程序侧的 data 指向这里。若改过可执行文件名，目录末级也会变化；已有 data 时需检查实际链接目标。备份目录内容，不能只复制链接。备份含订阅凭据，发给别人排错前按配置脱敏指南处理。

插件中心的来源会随版本锁定吗？

进入插件页的「插件中心」，打开「插件源」。固定标签的默认值 有 General 与 GUI.for.Clash 两项，分别指向 Plugin-Hub 仓库 main 分支的 generic.json 与 gfc.json。所以安装 v1.27.0，并不代表插件目录也停留在发布日。

核对来源名称、地址和启用开关，再更新列表并选择插件。插件源里的「恢复为默认值」只重置来源列表，不会还原已经安装的插件和配置。来源地址若填错，应在这里修正，反复替换应用 ZIP 不能修复这个字段。装入后查看卡片「源码」和触发器：处理订阅要对应「更新订阅时」，修改最终配置则是「生成配置时」。不要给现成插件随意增加触发器，源码未实现相应函数时会执行失败。记录插件版本，并留一份当前源码，应用降级不会替你恢复插件代码。

如果订阅返回 Base64，源码会先交给插件处理；插件执行后还残留 Base64 标记，就会提示添加「节点转换」插件。已有标准 YAML 节点数组则不应仅因升级就额外装转换插件。这个分支发生在筛选之前，改名称正则不能解决转换缺失。

重命名、筛选和脚本究竟谁先执行？

订阅更新源码 给出了次序：读取内容，运行全局订阅插件，再对非手动订阅执行名称与协议筛选、添加前缀，随后分配节点标识、按条件重建内置规则配置，更新流量、到期时间及节点列表等元数据，最后执行单条订阅脚本并按类型保存。

全局插件执行器 逐个等待插件返回节点数组，下一插件接着处理这个结果。重命名和过滤组合使用时，前一个插件的输出就是后一个插件的输入。

更新后的表现对应处理环节具体改哪里
原名字能匹配，现在节点为零插件先改名，名称筛选后执行订阅表单「包括名称」改为处理后的名称
不能按刚添加的前缀筛选前缀晚于筛选用加前缀前的名字匹配
改名了，但代理组引用不对单条脚本晚于内置规则配置处理检查脚本改名与配置引用是否一致

订阅表单中点开「更多」，才会显示名称、协议筛选和代理前缀。

例如全局插件把 Hong Kong 改成 HK，「包括名称」继续填旧名称便可能过滤掉节点。反过来，在单条订阅脚本里改名，前面的筛选已经完成，不能期待它倒过来影响筛选结果。

单条订阅脚本怎样恢复默认？

打开目标订阅卡片菜单中的「脚本」，先另存旧代码。要暂时取消这条订阅的自定义处理，可使用该版 DefaultSubscribeScript 的原样返回逻辑：

const onSubscribe = async (proxies, subscription) => {
  return { proxies, subscription }
}

本地文件订阅还要分清「本地路径」和「保存路径」。该版只在两者不同时写出处理后的文件；两者相同不会覆盖源文件。想比较处理前后内容，给输出另设路径，保留原文件。手动类型也不会经过表单中的名称筛选和前缀处理，不能直接套用远程订阅的结果。

这是 JavaScript 订阅脚本示例，不是全局插件模板。全局插件返回数组，单条脚本返回对象。保存脚本后更新这条订阅，比较节点数、名称及「保存路径」中的 proxies。检查 YAML 结构可接着看订阅节点字段说明。

配置被覆盖时，退回哪个状态？

启用「使用订阅内的策略组和分流规则」时，更新订阅会重建关联配置。源码保留原配置名、密钥、混入与脚本等指定字段，但不能据此认为手工调整的代理组和规则也都会留下。

长期自定义分流时，关闭该选项，另建配置引用订阅；在确认新配置引用正确前保留旧配置。仅脚本出错，就恢复脚本、停用相关插件并重新更新。如果需要回到升级前的完整状态，退出应用，把当前目录另存，再恢复原程序及成套数据备份。最后核对配置引用、节点名称和插件版本，不能只看窗口里显示的应用版本号。