【提示】关于GUI.for.Clash更新核心后无法运行的解决方案

报错信息: 提示引用的资源文件不在SAFE_PATHS内

解决方案: 启用并运行滚动发行插件

参考滚动更新日志

GUI.for.Cores 【v1.9.8】 已发布

- 标题栏的滚动发行标志不再由 GUI 提供，改为【滚动发行】插件提供

- 插件中心新增按 Tag 分类

- 首页支持展示大于 4 个配置

- Plugins.picker api 的选项值支持任意数据类型

- 弹窗支持最大化，编辑表单时可避免尺寸变化

- 配置编辑界面左上角标题名支持下拉选择步骤

- 解决部分弹窗在小尺寸窗口下出现双滚动条问题

- 更多的组件与细节优化

注：此前使用 v1.9.8-alpha rolling-release 版本的用户升级后版本号可能会显示为 v1.9.7，解决方案：删除程序目录 data/rolling-release，重载 GUI 界面

GUI.for.Cores 滚动更新日志

由于 sing-box 1.12.0 已成为最新的稳定版本，GUI.for.SingBox 对于Stable分支的配置生成已不再兼容 1.11.x 版本。

注：请使用【滚动发行】插件完成升级。

对于使用最新版本GUI，但是停留在 sing-box 1.11.x 的用户，可添加以下兼容性代到配置的脚本中：

const onGenerate = async (config) => {
  const DnsServer = {
    Local: 'local',
    Hosts: 'hosts',
    Tcp: 'tcp',
    Udp: 'udp',
    Tls: 'tls',
    Https: 'https',
    Quic: 'quic',
    H3: 'h3',
    Dhcp: 'dhcp',
    FakeIP: 'fakeip'
  }

  const generateDnsServerURL = (dnsServer) => {
    const { type, server_port, path, server, interface: _interface } = dnsServer
    let address = ''
    if (type == DnsServer.Https) {
      address = `https://${server}${server_port ? ':' + server_port : ''}${path ? path : ''}`
    } else if (type == DnsServer.H3) {
      address = `h3://${server}${server_port ? ':' + server_port : ''}${path ? path : ''}`
    } else if (type == DnsServer.Dhcp) {
      address = `dhcp://${_interface}`
    } else if (type == DnsServer.FakeIP) {
      address =
        'fake-ip://' +
        (dnsServer.inet4_range ? dnsServer.inet4_range : '') +
        (dnsServer.inet6_range ? (dnsServer.inet4_range ? ',' : '') + dnsServer.inet6_range : '')
    } else if (type === DnsServer.Hosts) {
      address = 'hosts'
    } else if (type === DnsServer.Local) {
      address = 'local'
    } else {
      address = `${type}://${server}${server_port ? ':' + server_port : ''}`
    }
    return address
  }

  config.dns.rules.unshift({
    action: 'route',
    server: config.route.default_domain_resolver.server,
    outbound: 'any'
  })
  delete config.route.default_domain_resolver
  config.dns.servers = config.dns.servers.map((server) => {
    const isFakeIP = server.type === DnsServer.FakeIP
    if (isFakeIP) {
      config.dns.fakeip = {
        enabled: true,
        inet4_range: server.inet4_range,
        inet6_range: server.inet6_range
      }
    }
    let detour = server.detour
    if (!detour) {
      const isSupportDetour = [
        DnsServer.Local,
        DnsServer.Tcp,
        DnsServer.Udp,
        DnsServer.Tls,
        DnsServer.Quic,
        DnsServer.Https,
        DnsServer.H3,
        DnsServer.Dhcp
      ].includes(server.type)
      isSupportDetour && (detour = config.outbounds.find((v) => v.type === 'direct')?.tag)
    }
    return {
      tag: server.tag,
      address: isFakeIP ? 'fakeip' : generateDnsServerURL(server),
      address_resolver: server.domain_resolver,
      detour: detour
    }
  })
  config.dns.rules = config.dns.rules.filter((rule) => rule.ip_accept_any === undefined)
  config.dns.rules.forEach((rule) => {
    delete rule.strategy
  })
  return config
}

插件发布 【点击波纹效果】

插件ID：plugin-global-click-ripple-effect

插件说明：增加全局点击波纹效果。

通用插件

插件发布 【TrafficMonitor】

插件ID：plugin-traffic-monitor

插件说明：这是一个用于显示当前网速、CPU及内存利用率的桌面悬浮窗软件，并支持任务栏显示，支持更换皮肤。

通用插件

注：仅支持Windows系统

GUI.for.Cores 【v1.9.9】 已发布

- 概览页控制器节点列数可调整

- 弹窗支持 ESC 键关闭

- 已兼容 sing-box 1.12.0+ 核心，并且不再兼容 1.11.x 版本

- 修复：动态开启 TUN，错误生成 route_address 字段问题

- 修复：结束进程出现 no child process 问题

- 插件 API 变更：所有 Bridge 相关的 API 采用大驼峰命名，传参也是

- 关于页面新增 Bridge 版本号显示

Bridge 版本号说明：

正常情况下，此版本号和 UI 版本号相同，如果不相同，说明滚动发行出错，需要删除 data/rolling-release 目录，重启 APP 后 再到关于页面更新

关于 sing-box 的版本说明：

生成的配置已不再兼容之前版本，详见：https://t.me/GUI_for_Cores_Channel/291

GUI.for.Cores 滚动更新日志

- 策略组延迟测试支持取消
- 修复计划任务日志面板出现的卡死问题
- 设置中新增「禁用动画」选项
- GUI.for.SingBox 默认配置的路由规则新增 icmp 分流
- 首页控制器的鼠标滚动灵敏度支持自定义（范围：1–6）
- 核心 PID 存储位置调整：由 user.yaml 改为 data/xxx/pid.txt [1]
- 插件 API 调整 [2]

[1] PID 存储位置调整

原本存放于 user.yaml，现改为独立的 pid 文件：

- sing-box → data/sing-box/pid.txt
- mihomo → data/mihomo/pid.txt

此更改避免了核心程序启动/停止时对 user.yaml 文件的写入操作

[2] 插件 API 调整

获取核心是否在运行、PID

// 旧
Plugins.useAppSettingsStore().app.kernel.pid
Plugins.useAppSettingsStore().app.kernel.running

// 新
Plugins.useKernelApiStore().running
Plugins.useKernelApiStore().pid

插件发布 【重复节点移除】

插件ID：plugin-duplicate-proxies-removal

插件说明：订阅更新时候移除重复的节点（根据节点{地址:端口}匹配）Supported by: lancelotly

插件Tag：节点处理

通用插件

GUI.for.Cores 滚动更新日志

- 优化了 Select 与 Dropdown 组件

- 支持加载本地语言文件

为了保持 GUI 本体的轻量化、可维护性与可扩展性，本版本仅内置 中文 与 英文 两种语言。同时，支持动态加载本地语言文件，文件目录为 data/locales，格式为 JSON，例如：data/locales/zh-CN.json。

原有的多语言文件已上传到文档仓库：语言文件

插件发布 【一键导入订阅助手】

插件ID：plugin-subscribe-in-one-click

插件说明：运行此插件，帮助你使用机场的一键导入订阅功能。

插件Tag：提升体验、功能扩展

通用插件、仅适用于Windows

同时废弃插件
- 注册Clash协议到注册表
- 注册SingBox协议到注册表

GUI.for.Cores 【v1.10.0】 已发布

- 修复 设置-内核 检测远程版本时，内存瞬时占用高的问题

- 优化 Switch、Radio 组件，以便适配多语言的展示效果

- 计划任务不再使用 GO 实现，改为纯前端实现，cron 表达式写法不变

- 移除检测 CPU 指令集等级 相关库及代码，mihomo 核心默认总是下载 -v3 版本

注：如果你的 CPU 在运行 mihomo 时报错，请留言反馈，后续或在【滚动发行】中增加解决方案

GUI.for.Cores 【v1.11.0】 已发布

- 配置【混入】支持 YAML 与 JSON 两种格式

- 新增 Plugins.ProcessMemory(pid) API 用于获取进程内存占用

- 支持显示核心真实内存占用（包含共享内存,所以比任务管理器显示的略大），设置里开启

已增加解决方案，使用【滚动发行】插件升级。

插件发布 【导入 sing-box 配置】

插件ID: plugin-import-configuration-to-gui

插件说明： 将完整的 sing-box 配置导入到 GUI 中。Supported by: 泡泡茶壶

插件Tag: 实用工具、功能扩展、提升体验

GUI.for.SingBox插件

GUI.for.Cores 滚动更新日志

- 首页 快速开始 支持自定义名称

- 控制器中节点过滤更换输入方式

- 配置、订阅页面头部支持自定义操作

参考：自定义操作API，target值：profiles_header、subscriptions_header

GUI.for.Cores 滚动更新日志

- 启动页面 LOGO 加载更快

- 新增统一配置插件入口：设置 - 插件

- 插件配置新增 UI 组件：MultipleSelect

- 日志、连接面板的【添加到规则集】支持自动创建不存在的规则集

- 修复一些配置生成错误的问题

- 优化部分 UI 组件

GUI.for.Cores 【v1.13.0】 已发布

- 新增对自定义 WebView2 Runtime 的支持

- 系统代理新增 Proxy Bypass List 支持

自定义 WebView2 Runtime 的使用场景与使用方法：

使用场景：
当部分 Windows 用户的系统 WebView2 Runtime 版本过高或过低，导致出现 「WebView2 Runtime Error」报错时，可使用自定义 Runtime 解决。

使用方法：
1、下载固定版本的 WebView2 Runtime（软件兼容版本：141.0.3537.71）

2、放到软件目录

data/WebView2/

示例：

data/WebView2/Microsoft.WebView2.FixedVersionRuntime.141.0.3537.71.x64.cab

3、重启软件即可生效

插件发布 【全局热键】

插件ID: plugin-hotkey-api-bridge

插件说明：请配合【RESTful-Api v1】插件使用。

插件Tag: 功能扩展、提升体验

通用插件，仅适用于Windows

GUI.for.Cores 【v1.14.0】 已发布

- 提升核心结束/重启速度

- 提升创建 HTTP 服务的速度

- 规则编辑新增【插入点】功能

- 核心管理界面增加“打开内核文件所在目录”按钮

- 优化核心启动后的系统代理状态更新逻辑

- 订阅功能支持设置请求超时时间

GUI.for.Cores 滚动更新日志

- 新的设置页面

- 配置、订阅、规则集变更时显示重启核心按钮（右下角）

- 修复时间显示错误问题

- GUI.for.Clash 规则集编辑改为纯文本编辑

请使用【滚动发行】插件完成升级