Skip to content

Releases: Sagisawa/GBF-Accelerator

Release list

v2.4.0 - 传输架构代际跃迁与Android重新修补管线

v2.4.0 - 传输架构代际跃迁与Android重新修补管线 Latest
Latest

Choose a tag to compare

View all tags
@Sagisawa Sagisawa released this 30 Sep 18:51
v2.4.0
4552227

GBF Accelerator v2.4.0 发布说明 (Release Notes)

发布日期：2026-10-01
版本定位：传输架构代际跃迁，从整块下载升级为实时响应，引入 Stream-Through 流式边下边传与内存元数据索引，大幅降低大素材 TTFB、I/O 与内存开销
发布包：

  • Windows：GBF_Accelerator_v2.4.0_GUI.zip
  • macOS：GBF_Accelerator_v2.4.0_macOS_universal2.zip
  • Android (Root / LSPosed 模块)：GBF_Accelerator_v2.4.0_Xposed_arm64.apk

v2.4.0 是一次针对静态资源缓存与传输链路的深度优化，同时完善了 Android 移动端修补工作流。

过去版本采用整包下载完成后再交付的机制，对于未命中缓存的大体积素材（立绘大图、BGM 音频、战斗动画等），浏览器必须等待代理将上游文件完整接收并检验落盘后才能收到响应。本版本引入 Stream-Through（流式边下边传）机制，上游数据到达后持续向浏览器流式推送，使冷请求的首字节响应时间（TTFB）不再受文件整体体积制约；同时配合分级缓冲、大文件直读与内存元数据索引，大幅减少高并发下的磁盘 I/O 抖动与瞬时内存分配。

Android 端则新增已修补包检测与自动还原管线，支持普通 APK 与 Split APK，让已被旧版核心修补过的安装包可以直接拖入重新修补并无缝升级至最新核心。

📥 下载与使用

Windows 用户

  1. 下载 GBF_Accelerator_v2.4.0_GUI.zip，解压即用；
  2. 旧版本升级：
    • 方式一（推荐，控制台一键更新）：在控制台版本卡片直接点击【一键下载新版安装包】，SHA-256 校验通过后点击【立即更新并重启】平滑升级；
    • 方式二（手动替换）：退出正在运行的旧版程序，直接使用压缩包内的 GBF_Accelerator.exe 覆盖替换原有文件即可；原有的 cache 缓存目录与 config.json 自动继承。

macOS 用户

  1. 下载 GBF_Accelerator_v2.4.0_macOS_universal2.zip（Universal 2 双架构，原生兼容 Intel 与 Apple Silicon Macs）；
  2. 解压后将 GBF_Accelerator.app 拖入系统的【应用程序】（Applications）文件夹覆盖；
  3. 解除安全拦截（首次运行必须）：
    打开终端执行以下命令清除系统隔离属性： 
    xattr -cr /Applications/GBF_Accelerator.app
  4. 启动后程序自动打开内嵌 Web 控制台。

Android 用户

  • 免 Root 用户：
    1. 在 PC 端打开控制台，切换至【Android 浏览器修补】页面；
    2. 支持直接拖入官方原版或已被旧版核心修补过的安装包，系统会自动识别并提示【重新修补 / 升级核心】；
    3. 点击制作后自动还原未注入核心的原版并注入最新版加速引擎；
    4. 生成安装包后传至手机安装（或通过 USB 调试【一键安装到手机】）即可使用。
  • 已 Root / LSPosed 用户：
    • 可直接下载下方附件中的 GBF_Accelerator_v2.4.0_Xposed_arm64.apk 安装并在 LSPosed 管理器中激活模块，勾选官方原版 SkyLeap 或 Via 浏览器即可直接打开使用，无需修改或重打包宿主 APK。

网络环境与 ACGPower 说明：

  • 手机端内嵌核心默认以直连模式（direct_mode=true）运行，配合主流基于 TUN 网卡的网络工具（如 Clash、v2rayNG、Sing-box、网易UU加速器、奇游、岛风go 等）均可正常使用；
  • 暂不支持安卓版 ACGPower (acgp)：由于安卓端 ACGPower 并非标准 IP 隧道，而是通过 tun2socks 重定向到本地代理且每次启动随机分配动态端口，无法做透明直连转发。若在手机上使用 ACGPower，建议直接使用其官网提供的定制版 SkyLeap 客户端。

多浏览器切换注意事项（Android 进程冻结机制）：
Android 系统后台管理机制（cgroup v2 freezer）会在应用退入后台后冻结挂起其所有子进程（包括内嵌的 Go 加速核心），且应用私有沙盒相互隔离。若您在同一设备上安装了多个适配浏览器（如 SkyLeap 与 Via），在切换浏览器前，请务必在多任务界面中将前一个浏览器彻底上滑关闭，避免后台被冻结的核心占用 8124 端口导致新浏览器请求未响应。

校验和 (SHA-256 Checksums)

资产文件名 大小 SHA-256 校验和
GBF_Accelerator_v2.4.0_GUI.zip 4.08 MB D85F0D397AA8F44B6F09833DAC3FE334ED7361A4DFB6E1839FF642ACFF639161
GBF_Accelerator_v2.4.0_macOS_universal2.zip 7.95 MB E4EBE07D8CE839EAB2AE3B77EFF52AE6FF51404362B49E85CA0B1B35918C7C7A
GBF_Accelerator_v2.4.0_Xposed_arm64.apk 4.65 MB 2C21E5EBB424E0111BD71D5235677BC2935DB7242112E18A7071A83A07F17E96

🚀 核心更新

⚡ Stream-Through 流式缓存传输

重新优化静态资源从上游到浏览器的完整传输链路：

  • Cache Miss Stream-Through（冷请求流式交付）：
    缓存未命中时，静态资源无需等待上游完整下载即可开始向浏览器交付；数据随到随传，前台响应与后台落盘缓存进一步解耦，明显改善大体积素材的首字节等待时间（TTFB）；
  • 分级缓冲策略（Tiered Buffering）：
    小型资源继续使用高效批量处理；中等体积资源采用内存流式管道传输；超大资源按需使用安全临时文件承载，避免单个大文件请求产生过大的瞬时内存占用；
  • Verified Large-Asset Direct Streaming（已验大文件直接流式读取）：
    已完成完整性验证的磁盘大体积缓存可直接以流式读取交付，避免将整个文件重复加载至 RAM 内存；
  • HEAD / Conditional Request Fast Path（极速元数据路径）：
    对 HEAD 与协商缓存条件请求（304）优先使用元数据短路响应，无需读取完整正文即可完成判定，减少无意义的磁盘 I/O。

🧠 Cache / Disk Cache 性能与并发优化

  • Disk Metadata Index（内存元数据索引）：
    引入内存中的磁盘元数据索引，消除磁盘缓存命中时的额外元数据读取与文件探测，进一步降低冷命中的本地处理开销；
  • SLRU 准入治理与 RAM 预算解耦：
    大体积静态文件默认不再进入基础 SLRU 内存缓存，避免频繁挤占高频小资源；而 RAM Boost ResidentPool 仍可在统一内存预算范围内按需常驻热点素材；
  • 锁竞争优化与 GC 压力降低：
    优化高并发场景下的读写锁竞争，减少缓存保存过程中的不必要计算与临时对象分配，降低运行时 GC 停顿；
  • 缓存完整性联合校验与回退：
    读取磁盘缓存时严格校验文件大小与修改时间，发生缓存文件异常时安全回退至正常 Cache Miss 流程。

📱 Android 已修补 APK 自动还原与重新修补

彻底解决移动端面对已被 LSPatch 修补过的安装包无法直接升级核心或再次修补的痛点：

  • 已修补包自动特征识别：
    Patcher 会自动嗅探 APK 内部的 LSPatch 特征，精准识别是否已包含核心、修补类型、内嵌 Origin APK 以及原始应用 Package Name 与真实版本信息，并在控制台清晰展示；
  • 自动还原并重新修补：
    检测到已修补安装包后，无需用户手动解包、导出、重命名后再次导入，程序自动流式提取原始 APK 并完成完整性校验，直接无缝使用当前核心重新修补并升级；
  • Split APK 分包原生结构恢复：
    支持普通 APK 与 Split APK 分包，通过解析原始 AXML Manifest 精确恢复 base 与 split 身份；
  • 单层解包与安全兜底：
    严格限制仅允许自动解包一层，杜绝嵌套修补风险；全面内置 Zip Slip 路径穿越防御与 CRC-32 损坏完整性校验。

🛡️ 稳定性与透明性

本版本继续严格遵循安全治理不变量：

  • 动态游戏 API 原样透明转发，业务 Header 与 Body 零修改；
  • POST / PUT / DELETE 状态变更请求绝对零重试；
  • 静态资源缓存保持 Akamai CDN 原始字节流，无任何反检测伪装；
  • 后台 Prefetch 主动避让前台请求；
  • 日志与遥测采用有界、非阻塞方式，不阻塞代理数据面；
  • Windows、macOS、Linux、Android 继续保持平台架构隔离。

🧪 测试矩阵 (Test Matrix)

测试项 (Test) 状态 (Status) 说明
go test -count=1 ./... PASS 覆盖 cache、proxy、control、patcher、updater、sysproxy 等全部核心包（14 个包全绿通过）
go vet ./... PASS 静态代码分析与语法合规检查通过，零告警
go test -race ./... PASS CGO+GCC 真实环境并发竞态检测通过，覆盖 patcher、control、proxy、cache、config 核心包，零数据竞态
npm run build PASS React 18 SPA 生产编译与静态资源嵌入打包通过
Stream-Through 流式传输测试 PASS 验证冷请求边下边传、首字节即时推送、前台响应与后台落盘解耦
分级流式缓冲与内存控制 PASS 验证小体积批量、中体积内存流式管道与超大体积临时文件安全承载，杜绝突发内存峰值
Verified 大文件直读回归 PASS 验证已验磁盘大文件零 RAM 拷贝流式直出及文件异常安全回退 Cache Miss
Disk Metadata Index 内存索引 PASS 验证元数据常驻内存索引，消除二次磁盘读取，HEAD 与 304 极速短路响应
LSPatch 识别与 Origin APK 还原 PASS 验证已修补包特征探测、Manifest 解析、流式提取原始 APK 及 Split APK 分包身份恢复
单层解包防御与完整性自愈 PASS 验证严格单层解包限制（防嵌套）、Zip Slip 路径穿越防御与 CRC-32 损坏回退
跨平台交叉编译 PASS Windows (amd64) / Linux (amd64) / macOS (amd64 & arm64) 编译通过

🧭 验证边界 (Verification Boundaries)

已验证 (Verified)

  • Windows 桌面端：Windows 11 真实桌面环境，单二进制内嵌 SPA、独立窗口运行、系统代理托管与托盘生命周期。
  • Stream-Through 与缓存管线：冷请求分块即时流式推送、磁盘元数据常驻内存索引、高并发大文件直读与 304 快速短路。
  • Android 端实机验证：在 Android 16 (ARM64) 真机（b0f42695）上验证伴生模块安装运行、SkyLeap 宿主成功拉起独立 Go Core v2.4.0 守护进程、本地 8124 / 8125 双端口监听与网络代理正常工作；验证旧版独立模块（v2.3.0）存在时宿主防劫持逻辑生效，优先使用内嵌 2.4.0 核心。
  • macOS Universal 2 胖二进制：由真实 macOS 环境完成 arm64 与 amd64 双架构 lipo 合成，完整包含 .app 目录结构与 Info.plist，包体积 7.95 MB。
  • Android 修补管线：普通 APK 与 Split APK 自动识别已修补特征、流式提取原版、AXML 身份识别及重新注入当前核心。

未验证 (Unverified / Environment Dependent)

  • 跨物理设备 Wi-Fi 复杂拓扑：局域网共享模式下，跨物理设备通信受用户本地路由器 AP 隔离、多级子网及防火墙规则影响，需用户在本地网络实测。
  • Android 定制 ROM 多样性：不同手机品牌定制系统（如 HyperOS、OriginOS、ColorOS、HarmonyOS 等）对 WebView 的深度定制与后台省电策略差异，需在具体真机上实际体验。
  • macOS 实机 Gatekeeper：macOS 发布包首次运行仍需用户执行 xattr -cr 清除系统安全隔离属性。
Assets 5
Loading

v2.3.0 - 全局 RAM 激进缓存加速、实时日志多词高亮与预取优化

v2.3.0 - 全局 RAM 激进缓存加速、实时日志多词高亮与预取优化

Choose a tag to compare

View all tags
@Sagisawa Sagisawa released this 29 Sep 11:38
v2.3.0
0a79225

GBF Accelerator v2.3.0 发布说明 (Release Notes)

发布日期：2026-09-29
版本定位：SLRU 缓存完善、全局 RAM Boost 统一预算与 Prefetch 死链过滤
发布包：

  • Windows：GBF_Accelerator_v2.3.0_GUI.zip
  • macOS：GBF_Accelerator_v2.3.0_macOS_universal2.zip
  • Android (Root / LSPosed 模块)：GBF_Accelerator_v2.3.0_Xposed_arm64.apk

v2.3.0 在现有 Go 原生架构基础上，进一步完善 SLRU 分段缓存机制，引入 RAM Boost 激进内存缓存与统一内存预算管理，增加后台 Prefetch 对 404/410 失效素材的动态过滤抑制，优化 Web 控制台实时日志多词检索与平台按键自适应，并加固测试内存隔离与工具链路径锚定。

📥 下载与使用

Windows 用户

  1. 下载 GBF_Accelerator_v2.3.0_GUI.zip，解压即用；
  2. 旧版本升级：
    • 方式一（推荐，控制台一键更新）：在控制台版本卡片直接点击【一键下载新版安装包】，SHA-256 校验通过后点击【立即更新并重启】平滑升级；
    • 方式二（手动替换）：退出正在运行的旧版程序，直接使用压缩包内的 GBF_Accelerator.exe 覆盖替换原有文件即可；原有的 cache 缓存目录与 config.json 自动继承。

macOS 用户

  1. 下载 GBF_Accelerator_v2.3.0_macOS_universal2.zip（Universal 2 双架构，原生兼容 Intel 与 Apple Silicon Macs）；
  2. 解压后将 GBF_Accelerator.app 拖入系统的【应用程序】（Applications）文件夹覆盖；
  3. 解除安全拦截（首次运行必须）：
    打开终端执行以下命令清除系统隔离属性： 
    xattr -cr /Applications/GBF_Accelerator.app
  4. 启动后程序自动打开内嵌 Web 控制台。

Android 用户

  • 免 Root 用户：
    1. 在 PC 端打开控制台，切换至【Android 浏览器修补】页面；
    2. 准备好官方原版 SkyLeap 安装包（或系统 WebView 浏览器 APK），拖入页面即可一键检测依赖并注入加速核心；
    3. 将生成的安装包传至手机安装（若手机连接电脑开启了 USB 调试，可直接点击控制台的【一键安装到手机】）；
    4. 安装后在手机上直接打开修补版浏览器即可使用，无需后台常驻。
  • 已 Root / LSPosed 用户：
    • 可直接下载下方附件中的 GBF_Accelerator_v2.3.0_Xposed_arm64.apk 安装并在 LSPosed 管理器中激活模块，勾选官方原版 SkyLeap 或 Via 浏览器即可直接打开使用，无需修改或重打包宿主 APK。

网络环境与 ACGPower 说明：

  • 手机端内嵌核心默认以直连模式（direct_mode=true）运行，配合主流基于 TUN 网卡的网络工具（如 Clash、v2rayNG、Sing-box、网易UU加速器、奇游、岛风go 等）均可正常使用；
  • 暂不支持安卓版 ACGPower (acgp)：由于安卓端 ACGPower 并非标准 IP 隧道，而是通过 tun2socks 重定向到本地代理且每次启动随机分配动态端口，无法做透明直连转发。若在手机上使用 ACGPower，建议直接使用其官网提供的定制版 SkyLeap 客户端。

多浏览器切换注意事项（Android 进程冻结机制）：
Android 系统后台管理机制（cgroup v2 freezer）会在应用退入后台后冻结挂起其所有子进程（包括内嵌的 Go 加速核心），且应用私有沙盒相互隔离。若您在同一设备上安装了多个适配浏览器（如 SkyLeap 与 Via），在切换浏览器前，请务必在多任务界面中将前一个浏览器彻底上滑关闭，避免后台被冻结的核心占用 8124 端口导致新浏览器请求未响应。

校验和 (SHA-256 Checksums)

资产文件名 大小 SHA-256 校验和
GBF_Accelerator_v2.3.0_GUI.zip 4.04 MB 885FBF66B2D990FFC45559BE459E6B88008E99D934432C4C2B13C9C70F3C6318
GBF_Accelerator_v2.3.0_macOS_universal2.zip 7.87 MB 5921EE50E0B4A7DAC20C9D7D8B938CB362FA9C68A8AA916E6B4FC2AC3E47D4D5
GBF_Accelerator_v2.3.0_Xposed_arm64.apk 4.61 MB 1A76F3F257233125698911A1E6AC48007DF5CCD576A179D4466BE9040D4C14A1

🚀 主要更新

⚡ SLRU 缓存完善与全局 RAM Boost 统一预算

针对拥有充裕内存的桌面设备，进一步加固 SLRU 分段缓存准入并引入全新 RAM Boost 内存缓存机制：

  • 按需自选开启：RAM Boost 功能属于可选增强项，用户可根据设备硬件与需求选择开启；平时不开启时本地磁盘缓存已足够迅速，开启后主要进一步消除磁盘 I/O 抖动，将素材响应时间进一步稳定缩短约几毫秒 (几 ms)；
  • 统一内存预算管辖：重构 RAM 预算调度器，建立全生命周期统一内存配额管理，防止分段缓存与激进缓存并发争抢；
  • RAM Boost 全量预热与常驻：支持将高频战斗、立绘等热点素材常驻在超低延迟 RAM 中，提升切页与重复战斗加载流畅度；
  • 低内存安全停止守卫 (Low-Memory Stop Guard)：引入系统可用内存水线探测；当宿主物理内存低于安全阈值时，自动中止预热或跳过激进缓存，坚决杜绝因激进预载引发系统 OOM；
  • 并发生命周期与状态平滑切换：全面加固 Boost 启动、执行与重载时的并发状态机，保障在途读写不被意外中断。

🛡️ Prefetch 404/410 失效素材过滤与防请求风暴

针对官方 Akamai CDN 上因历史更迭已失效的死链素材，优化后台预取引擎调度：

  • DeadFilter 动态失效表：内置有界 LRU 失效素材过滤器，当 Prefetch 探测到上游返回 404 Not Found 或 410 Gone 时，自动记入过滤表并指数退避；
  • 消除重复请求风暴：阻止后续 bundle 再次解析出相同失效路径时对上游发起无效请求，大幅净化控制台日志并降低跨海请求开销；
  • 业务透明穿透不污染：DeadFilter 严格仅作用于后台 Prefetch 异步管线；前台用户的真实业务请求 100% 直连上游，绝不短路拦截。

📊 实时日志多词高亮与 macOS 原生键位自适应

进一步提升 Web 控制台排查定位与交互体验：

  • 多关键词独立高亮匹配：日志检索框支持以空格分割多个关键词（如 quest json），系统将分别独立高亮各关键词匹配项，直观凸显复合条件；
  • macOS 原生快捷键自适应：日志搜索自适应 macOS 原生规范快捷键（Cmd+G 跳转下一项、Cmd+Shift+G 跳转上一项），并根据客户端操作系统动态显示按键图标（⌘ 与 F3）；
  • 快捷键冲突消除：彻底修复浏览器原生 Ctrl+F / Cmd+F 与应用内日志搜索的事件捕获冲突。

🛠️ Android 浏览器修补工具相对路径锚定

  • 工作目录漂移修复：修复 Android Patcher 工具对相对输出路径（如 ./output）的解析逻辑，严格将其锚定在应用程序根基准目录下，避免在不同启动路径或跨平台桌面快捷方式下导致输出目录漂移。

🛡️ 稳定性与透明性

本版本继续严格遵循安全治理不变量：

  • 动态游戏 API 原样透明转发，业务 Header 与 Body 零修改；
  • POST / PUT / DELETE 状态变更请求绝对零重试；
  • 静态资源缓存保持 Akamai CDN 原始字节流，无任何反检测伪装；
  • 后台 Prefetch 主动避让前台请求；
  • Windows、macOS、Linux、Android 各平台严格保持架构隔离。

🧪 测试矩阵 (Test Matrix)

测试项 (Test) 状态 (Status) 说明
go test -count=1 ./... PASS 覆盖 cache、proxy、control、patcher、updater、sysproxy 等全部核心包（15 个包全绿）
go vet ./... PASS 静态代码分析与语法合规检查通过，零告警
npm run build PASS React 18 SPA 生产编译与静态资源嵌入打包通过
Boost 测试密闭内存隔离 PASS 隔离宿主物理内存读取，避免测试运行对宿主机物理内存产生压力与测试污染
低内存停止守卫回归测试 PASS 验证系统低内存水线下 RAM Boost 主动停止且不引发异常
DeadFilter 404/410 过滤回归 PASS 验证死链素材抑制、查表零内存分配（0 allocs/op）及前台真实请求 100% 穿透不受阻
SLRU 缓存准入与淘汰回归 PASS 验证前台直入保护段、后台预载首进试用段、防止热点素材被挤占
跨平台交叉编译 PASS Windows / Linux / macOS (amd64 & arm64) 编译通过

注：Windows 本地宿主环境未启用 CGO，并发竞争检测（-race）由 GitHub Actions Ubuntu CI 流程覆盖；测试严格遵循诚信法则，未弱化或删除任何既有断言。

🧭 验证边界 (Verification Boundaries)

已验证 (Verified)

  • Windows 桌面端：Windows 10 / 11 真实桌面环境、RAM Boost 激进内存缓存生命周期、独立控制台窗口居中与几何记忆、Edge FRE 欢迎弹窗屏蔽、系统代理托管与托盘生命周期。
  • Web 控制台：单二进制内嵌 SPA、实时网络与代理日志多关键词独立高亮检索、macOS 原生快捷键响应与字符字形自适应。
  • 缓存与预取管线：SLRU 来源感知分段保护、Prefetch 404/410 失效素材动态过滤与指数退避。
  • macOS 与 Linux 交叉编译：各平台目标架构可执行文件与交叉编译二进制构建无报错。

未验证 (Unverified / Environment Dependent)

  • 跨物理设备 Wi-Fi 复杂拓扑：局域网共享模式下，跨物理设备通信受用户本地路由器 AP 隔离、多级子网及防火墙规则影响，需用户在本地网络实测。
  • Android 定制 ROM 多样性：不同手机品牌定制系统（如 HyperOS、OriginOS、ColorOS、HarmonyOS 等）对 WebView 的深度定制与后台省电策略差异，需在具体真机上实际体验。
  • macOS 实机 Gatekeeper：macOS 发布包首次运行仍需用户执行 xattr -cr 清除系统安全隔离属性。
Loading

v2.2.0 - Android客户端支持、分段缓存优化与高频请求调度

v2.2.0 - Android客户端支持、分段缓存优化与高频请求调度

Choose a tag to compare

View all tags
@Sagisawa Sagisawa released this 25 Sep 19:47
v2.2.0
15e4ac8

GBF Accelerator v2.2.0 发布说明 (Release Notes)

发布日期：2026-09-26
版本定位：移动端架构支持、分段缓存优化与高频请求调度
发布包：

  • Windows：GBF_Accelerator_v2.2.0_GUI.zip
  • macOS：GBF_Accelerator_v2.2.0_macOS_universal2.zip
  • Android (Root / LSPosed 模块)：GBF_Accelerator_v2.2.0_Xposed_arm64.apk

v2.2.0 在现有 Go 原生架构基础上，进一步完善移动端使用方式，并继续优化本地缓存与高频请求路径。

📥 下载与使用

Windows 用户

  1. 下载 GBF_Accelerator_v2.2.0_GUI.zip，解压即用；
  2. 旧版本升级：
    • 方式一（推荐，控制台一键更新）：可在控制台版本卡片直接点击【一键下载新版安装包】，SHA-256 校验通过后点击【立即更新并重启】平滑升级；
    • 方式二（手动替换）：退出正在运行的旧版程序，直接使用压缩包内的 GBF_Accelerator.exe 覆盖替换原有文件即可；原有的 cache 缓存目录与 config.json 自动继承。

macOS 用户

  1. 下载 GBF_Accelerator_v2.2.0_macOS_universal2.zip（Universal 2 双架构，原生兼容 Intel 与 Apple Silicon Macs）；
  2. 解压后将 GBF_Accelerator.app 拖入系统的【应用程序】（Applications）文件夹覆盖；
  3. 解除安全拦截（首次运行必须）：
    打开终端执行以下命令清除系统隔离属性： 
    xattr -cr /Applications/GBF_Accelerator.app
  4. 启动后程序自动打开内嵌 Web 控制台。

Android 用户

  • 免 Root 用户：
    1. 在 PC 端打开控制台，切换至【Android 浏览器修补】页面；
    2. 准备好官方原版 SkyLeap 安装包（或系统 WebView 浏览器 APK），拖入页面即可一键检测依赖并注入加速核心；
    3. 将生成的安装包传至手机安装（若手机连接电脑开启了 USB 调试，可直接点击控制台的【一键安装到手机】）；
    4. 安装后在手机上直接打开修补版浏览器即可使用，无需后台常驻。
  • 已 Root / LSPosed 用户：
    • 可直接下载下方附件中的 GBF_Accelerator_v2.2.0_Xposed_arm64.apk 安装并在 LSPosed 管理器中激活模块，勾选官方原版 SkyLeap 或 Via 浏览器即可直接打开使用，无需修改或重打包宿主 APK。

网络环境与 ACGPower 说明：

  • 手机端内嵌核心默认以直连模式（direct_mode=true）运行，配合主流基于 TUN 网卡的网络工具（如 Clash、v2rayNG、Sing-box、网易UU加速器、奇游、岛风go 等）均可正常使用；
  • 暂不支持安卓版 ACGPower (acgp)：由于安卓端 ACGPower 并非标准 IP 隧道，而是通过 tun2socks 重定向到本地代理且每次启动随机分配动态端口，无法做透明直连转发。若在手机上使用 ACGPower，建议直接使用其官网提供的定制版 SkyLeap 客户端。

多浏览器切换注意事项（Android 进程冻结与沙盒隔离）：

  • Android 系统的后台管理机制（cgroup v2 freezer）会在应用退入后台后冻结挂起其所有子进程（包括内嵌的 Go 加速核心）。
  • 同时，Android 严格隔离应用私有沙盒目录，其他浏览器无法跨权限读取已启动核心的本地根证书。
  • 因此，若您在同一台手机上安装了多个适配浏览器（例如同时使用了 SkyLeap 和 Via）：
    在从一个浏览器切换到另一个浏览器前，请务必在手机的多任务卡片界面中将前一个浏览器彻底“上滑划掉”（完全关闭退出），避免前一个浏览器在后台被系统冻结后，其占用的核心端口（8124）无法响应新浏览器的加速请求导致卡死转圈。

校验和 (SHA-256 Checksums)

资产文件名 SHA-256 校验和
GBF_Accelerator_v2.2.0_GUI.zip 61196EFB82883131C5BBDC04FD3358414D59E796AD931279F8FCBCAD6398809E
GBF_Accelerator_v2.2.0_macOS_universal2.zip AEC6F5A9E8C9EBD6720DE5E9D1A568CC378DD459066F1B82BE6149A450579B59
GBF_Accelerator_v2.2.0_Xposed_arm64.apk 4FEA9EF015F46994255A28E62C69678C7FA4380D34A083A842225CF832B30757

🚀 主要更新

📱 Android 客户端支持

新增基于 Go Core 的 Android 客户端架构，可在 Android 设备上直接运行本地加速核心。

  • 用户自行嵌入（不分发修改版 APK）：
    本工具不分发任何经过修改的第三方浏览器安装包。用户需在 PC 控制台【Android 浏览器修补】页面中，自行选择本地已有的官方原版安装包进行一键嵌入修补；
  • 支持的浏览器类型：
    • 优先推荐官方 DeNA SkyLeap；
    • 亦支持其他基于 Android 系统原生 WebView 的轻量浏览器（如 Via、X 浏览器等）；
    • 注：独立 Chromium / Gecko 内核浏览器（如 Chrome、Kiwi、Firefox 等）暂不支持；
  • 免 Root 与模块接入双支持：支持控制台一键全自动打包注入（免 Root 安装即用），同时亦支持 LSPosed / Xposed 模块方式接入；
  • 移动端默认资源与流量保护：
    考虑到移动设备 RAM 容量限制及移动蜂窝网络状况，Android 端默认关闭了“内存缓存 (RAM Cache)”与“后台预加载 (Prefetch)”，以磁盘缓存与本地透明转发为主，优先保障低发热、低内存占用与流量安全；
  • 本地独立与生命周期管理：
    静态素材使用 RAM + 磁盘双层缓存，动态 API 保持透明转发；运行时配置与缓存均使用应用私有目录，卸载后自动清理。Android 端与桌面端继续保持平台隔离。

⚡ 缓存与高频请求性能优化

继续针对 v2.1.1 之后的缓存热路径进行优化：

  • RAM Cache 引入分段 LRU（SLRU）缓存策略；
  • 后台 Prefetch 使用独立的缓存准入策略，减少冷数据对热点素材的挤占；
  • Prefetch 与前台请求共享 SingleFlight，减少同一素材的重复上游请求；
  • 优化磁盘缓存冷命中路径，减少不必要的文件状态检查；
  • 优化高并发缓存访问与锁竞争；
  • 增加更多并发、Prefetch、缓存边界及性能回归测试。

这些优化主要针对已经积累缓存后的重复加载、频繁切图以及连续战斗场景，进一步降低本地处理开销。

🖥️ Windows 控制台体验优化

  • 优化独立控制台窗口的位置与尺寸恢复；
  • 启动时根据当前显示器工作区调整窗口位置，避免跨屏或被任务栏遮挡；
  • 减少 Edge App 模式首次运行时的额外提示干扰；
  • 保持原有 Windows 托盘、系统代理及证书流程不变。

🛡️ 稳定性与透明性

本版本继续保持既有核心行为：

  • 动态游戏 API 原样透明转发；
  • POST / PUT / DELETE 等状态变更请求不进行重试；
  • 静态缓存保持原始字节，不修改游戏素材；
  • 后台 Prefetch 主动避让前台请求；
  • 日志与遥测采用有界、非阻塞方式，不阻塞代理数据面；
  • Windows、macOS、Linux、Android 继续保持平台隔离。

🧪 测试矩阵 (Test Matrix)

测试项 (Test) 状态 (Status) 说明
go test -count=1 ./... PASS 覆盖 cache、proxy、control、patcher、updater、sysproxy 等全部核心包
go vet ./... PASS 静态代码分析与语法合规检查通过，零告警
npm run test (vitest) PASS 前端控制台组件单元测试全量通过
npm run build PASS React 18 SPA 编译与静态资源嵌入打包通过
SLRU 缓存准入与淘汰回归 PASS 验证前台真实请求直入受保护段、后台预载首进试用段、防止热点击穿
SingleFlight 前后台统一调度 PASS 验证同一素材上游请求严格=1、等待者感知、前台取消不强杀后台网络
Disk Cache 冷命中开销验证 PASS 减少冗余文件系统状态检查，二进制缓存文件保持 100% 向后兼容
Android 工具链自检与校验 PASS Java 运行时探测、LSPatch Jar 校验、模块校验与 ADB 探测通过
跨平台交叉编译 PASS Windows / Linux / macOS (amd64 & arm64) 编译通过

注：Windows 本地宿主环境未启用 CGO，并发竞争检测（-race）由 GitHub Actions Ubuntu CI 流程覆盖；测试严格遵循诚信法则，未弱化或删除任何既有断言。

🧭 验证边界 (Verification Boundaries)

已验证 (Verified)

  • Windows 桌面端：Windows 10 / 11 真实桌面环境、独立控制台窗口居中与几何记忆、Edge FRE 欢迎弹窗屏蔽、系统代理托管与托盘生命周期。
  • Web 控制台：单二进制内嵌 SPA、Android 浏览器修补面板交互、依赖检测与 ADB 设备自动发现。
  • 缓存与调度链路：SLRU 来源感知分段保护、前后台在途任务复用、高并发读写锁竞争基准测试。
  • macOS 与 Linux 交叉编译：各平台目标架构可执行文件与交叉编译二进制构建无报错。

未验证 (Unverified / Environment Dependent)

  • 跨物理设备 Wi-Fi 复杂拓扑：局域网共享模式下，跨物理设备通信受用户本地路由器 AP 隔离、多级子网及防火墙规则影响，需用户在本地网络实测。
  • Android 定制 ROM 多样性：不同手机品牌定制系统（如 HyperOS、OriginOS、ColorOS、HarmonyOS 等）对 WebView 的深度定制与后台省电策略差异，需在具体真机上实际体验。
  • macOS 实机 Gatekeeper：macOS 发布包首次运行仍需用户执行 xattr -cr 清除系统安全隔离属性。
Loading

v2.1.1 - 基于 Go 原生架构的持续性能优化、缓存加速与稳定性维护

v2.1.1 - 基于 Go 原生架构的持续性能优化、缓存加速与稳定性维护

Choose a tag to compare

View all tags
@Sagisawa Sagisawa released this 23 Sep 10:46
v2.1.1
b843439

GBF Accelerator v2.1.1 发布说明 (Release Notes)

发布日期：2026-09-23
版本定位：基于 Go 原生架构的持续性能优化、缓存加速与稳定性维护
发布包：

  • Windows：GBF_Accelerator_v2.1.1_GUI.zip
  • macOS：GBF_Accelerator_v2.1.1_macOS_universal2.zip

v2.0 完成 Go 原生核心重构后，后续版本持续围绕缓存、并发、Prefetch 及请求处理路径进行优化。

本次 v2.1.1 集中收敛 2.1.0 之后的一系列底层优化，进一步降低本地静态资源处理开销。

📥 下载与使用

Windows 用户

  1. 下载 GBF_Accelerator_v2.1.1_GUI.zip，解压即用；
  2. 旧版本升级：
    • 方式一（推荐，控制台一键更新）：若当前运行 v2.1.0，可在控制台版本卡片直接点击【一键下载新版安装包】，SHA-256 校验通过后点击【立即更新并重启】平滑升级；
    • 方式二（手动替换）：退出正在运行的旧版程序，直接使用压缩包内的 GBF_Accelerator.exe 覆盖替换原有文件即可；原有的 cache 缓存目录与 config.json 自动继承。

macOS 用户

  1. 下载 GBF_Accelerator_v2.1.1_macOS_universal2.zip（Universal 2 双架构，原生兼容 Intel 与 Apple Silicon Macs）；
  2. 解压后将 GBF_Accelerator.app 拖入系统的【应用程序】（Applications）文件夹覆盖旧版；
  3. 解除安全拦截（首次运行必须）：
    打开终端执行以下命令清除系统隔离属性： 
    xattr -cr /Applications/GBF_Accelerator.app
  4. 启动后程序自动打开内嵌 Web 控制台。

校验和 (SHA-256 Checksums)

资产文件名 SHA-256 校验和
GBF_Accelerator_v2.1.1_GUI.zip BBC62FCE0D64B0A62FAE93C9746A403FEEBB143F179F189A56786039C8236429
GBF_Accelerator_v2.1.1_macOS_universal2.zip 048CE179CEE8DFCEF052B7C4366AC81014094FDDB9DD6315AAB98542E6F9372C

🚀 主要更新内容

1. 游戏体验优化

本次更新主要体现在已经缓存到本机的资源重复加载场景：

  • 页面切换、返回已访问页面时更加利落；
  • 已缓存的图片、脚本及其他静态资源响应更快；
  • 连续战斗、频繁切换游戏界面时，重复资源请求的本地处理开销更低；
  • 对已经积累较完整缓存的用户，整体效果更加明显。

注：本次更新主要优化本地缓存与请求处理效率，不直接改变 GBF 服务器的网络 RTT。

2. Go 原生架构持续性能优化

基于 v2.0 的 Go 原生核心架构，继续针对高频请求路径进行优化：

  • 无锁配置快照读取：优化配置状态读取，引入原子不可变快照，减少高频访问中的同步开销（Lock-free reads）；
  • 静态资源路径防抖：优化静态资源路径规范化，减少重复字符串处理；
  • 低开销请求响应路径：优化缓存请求与响应路径，降低本地处理开销；
  • 架构纯粹性保持：保持纯 Go、跨平台及现有双平面架构不变。

3. RAM / Disk Cache 性能优化

  • 优化 RAM Cache 高并发访问路径及 SingleFlight 分片，降低并发锁竞争；
  • 优化 Disk Cache 元数据与缓存查找；
  • 优化负缓存结构及查找效率，并修复缓存保存后的负缓存清理问题；
  • 优化已规范化 Header 的快速处理路径；
  • 优化缓存资源响应，减少中间对象构造；
  • 进一步优化 RAM Cache Hit 热路径，消除重复 Host 解析及临时内存分配。

本次最新优化后，内部高并发 Benchmark 中：

  • RAM Cache 热路径：5 allocs/op → 0 allocs/op（零额外内存分配）
  • 16 Worker 基准下：159.2 ns/op → 120.0 ns/op

注：以上数据为本地微基准测试，用于衡量 GBF Accelerator 自身的请求处理开销，不代表实际游戏网络延迟。

4. Prefetch 与请求处理优化

  • 优化 Prefetch 中重复路径规范化，降低后台预取任务的额外处理开销；
  • 保持前台请求优先与后台平滑预取机制；
  • 减少静态资源请求中的重复解析。

5. 稳定性与业务透明性

  • 保持动态 API 原样透明转发；
  • 不修改动态请求参数、Cookie 及核心业务接口处理逻辑；
  • 不新增额外上游请求；
  • 保持现有缓存目录及配置兼容性；
  • 保持备用上游、Prefetch 及现有代理工作方式；
  • 保持 Windows、Linux、macOS 多平台支持。

🧪 测试矩阵 (Test Matrix)

测试项 (Test) 状态 (Status) 说明
go test -count=1 ./... PASS 覆盖全部 13 个 Go 核心包单元测试与集成测试，全量通过
go vet ./... PASS 静态代码分析与语法合规检查通过，零告警
npm run test (vitest) PASS 前端单元测试全量通过
npm run build PASS React SPA 编译与静态资源打包通过
Proxy fastpath regression PASS 静态资源快速命中路径功能与边界断言全量通过
Concurrency benchmark audits PASS 缓存、遥测与代理高并发基准测试审计通过

注：当前 Windows 构建宿主缺少 GCC / CGO 环境，Race detector（-race）未在本地执行，并发竞争检测已委托 CI 流程验证。

🧭 验证边界 (Verification Boundaries)

已验证 (Verified)

  • Windows 10 / 11 桌面环境：PE 二进制编译、Windows PE 图标嵌入、manifest 清单配置、WinINet 系统代理托管、更新助手与控制台交互。
  • macOS Universal 2 打包：双架构 Bundle 目录结构完整，Info.plist、高清 icns 图标、分流脚本均打包合规。
  • Linux 交叉编译：Linux amd64 / arm64 交叉编译无头模式（nogui）编译无告警。
  • 控制台交互：Web 控制台各项指标展示、日志流与更新弹窗正常。

未验证 (Unverified)

  • 跨物理设备 Wi-Fi E2E：不同独立硬件物理设备之间的实际无线通信受路由器 AP 隔离与具体防火墙规则影响，需用户在本地实际拓扑环境中验证。
Loading

v2.1.0 - 自动更新与自动重启、备用上游故障转移、Windows Root CA 证书流程修复

v2.1.0 - 自动更新与自动重启、备用上游故障转移、Windows Root CA 证书流程修复

Choose a tag to compare

View all tags
@Sagisawa Sagisawa released this 22 Sep 09:10
v2.1.0
355b2c4

GBF Accelerator v2.1.0 发布说明 (Release Notes)

发布日期：2026-09-22
版本定位：一键自动更新与自动重启、备用上游自动故障转移、Windows Root CA 证书引导与安装流程加固
发布包：

  • Windows：GBF_Accelerator_v2.1.0_GUI.zip
  • macOS：GBF_Accelerator_v2.1.0_macOS_universal2.zip

📥 下载与使用

Windows 用户

  1. 下载 GBF_Accelerator_v2.1.0_GUI.zip，解压即用；
  2. 旧版本升级（从 v2.0.0 或更早版本升级）：
    • 退出正在运行的旧版程序，直接使用压缩包内的 GBF_Accelerator.exe 替换原有程序文件即可；
    • 原有的 cache 缓存目录与 config.json 配置文件完全兼容并自动继承，无需重新配置；
    • 说明：自动下载与平滑重启为 v2.1.0 新增功能。升级至 v2.1.0 后，未来发布新版本时即可在控制台直接使用【一键下载与自动重启】。

macOS 用户

  1. 下载 GBF_Accelerator_v2.1.0_macOS_universal2.zip（Universal 2 双架构，原生兼容 Intel 与 Apple Silicon Macs）；
  2. 解压后将 GBF_Accelerator.app 拖入系统的【应用程序】（Applications）文件夹覆盖旧版；
  3. 解除安全拦截（首次运行必须）：
    打开终端执行以下命令清除系统隔离属性： 
    xattr -cr /Applications/GBF_Accelerator.app
  4. 启动后程序自动打开内嵌 Web 控制台，首次运行若尚未安装根证书将自动引导完成钥匙串根证书信任与分流设置。

校验和 (SHA-256 Checksums)

资产文件名 SHA-256 校验和
GBF_Accelerator_v2.1.0_GUI.zip AF76F2FEB19B9A8593A78BD5FC5D193094E404F1DDACD4D23021D761AB39B216
GBF_Accelerator_v2.1.0_macOS_universal2.zip 62FABE349FC71F39A010663F6EBA823EB5E7E98AD23ACA1726E4430B05825605

🌟 主要更新内容

1. 一键自动更新与平滑重启 (Self-Update & Seamless Restart)

  • 官方 Release 双重校验：控制台支持直接检查官方 GitHub Releases 并下载与当前平台匹配的正式更新包；内置 SHA-256 哈希指纹校验与压缩包归档结构完整性校验，杜绝因网络丢包或中间劫持导致的损坏包写入。
  • 平滑自更新助手：下载并通过校验后，可一键触发独立更新助手进行文件替换并自动重启主程序；控制台同步提供实时下载进度、取消任务、一键打开下载目录手动解压等全流程支持。
  • 并发与路径安全防护：更新任务包含全局互斥锁防重入、临时文件安全清理、路径越界防护及失败自动回滚逻辑。

2. 备用上游代理与自动故障转移 (Upstream Failover & Auto Recovery)

  • 高可用双上游拓扑：在现有主上游代理基础上，新增可选的备用上游代理配置（支持 HTTP / HTTPS / SOCKS5）。
  • 硬故障即时切换：当主上游遭遇 TCP 建连拒绝、超时断开等不可达故障时，代理引擎即时转移至备用上游，保障游戏会话连接不中断。
  • 多维健康监测与软故障判定：支持配置连续失败次数与延迟容忍阈值；当主上游持续出现严重延迟或丢包时安全触发故障转移。
  • 自动探测回切机制：在设定的冷却周期后，看门狗后台异步健康探测主上游可用性，确认恢复后平滑回切至主上游。
  • 零干扰合规设计：该功能默认关闭，不影响既有单上游使用习惯；直连模式下自动屏蔽，严格遵循业务透明与零侵入规范。

3. Windows Root CA 证书流程加固与首启引导

  • 首次启动智能引导：启动时智能检测当前操作系统根证书存储，若尚未信任本机 Root CA，控制台自动弹出安装引导，降低新手配置门槛。
  • 恢复 Windows 原生确认对话框：根证书安装恢复 Windows 原生系统安全确认机制，由系统弹出证书指纹与信任确认，确保流程可审计且合规。
  • 修复注销后的重复安装行为：改用系统证书存储接口执行精确注销，避免旧证书残留状态导致后续重新安装时跳过系统安全确认。
  • 详细故障诊断信息：若证书安装过程遇到系统策略或权限异常，完整保留 certutil 返回代码与错误信息并记入日志，同时在界面展示 Root CA SHA-1、SHA-256 与证书存储位置。

4. 稳定性、测试与发布工程加固

  • 故障转移看门狗回归测试：新增针对备用上游网络抖动、并发切换、看门狗探针竞争与恢复机制的完整自动化回归测试。
  • 自更新端到端验证：补齐更新包 SHA-256 校验、解压校验、目录逃逸防御与进程自杀重启模拟测试。
  • 前端工具链集成测试：新增 vitest 测试框架，覆盖证书引导与平台判定等前端辅助函数测试。

🧪 测试矩阵 (Test Matrix)

测试项 (Test) 状态 (Status) 说明
go test -count=1 ./... PASS 覆盖全部 13 个 Go 核心包单元测试与集成测试，全量通过
go vet ./... PASS 静态代码分析与语法合规检查通过，零告警
npm run test (vitest) PASS 前端单元测试 6/6 全部通过
npm run build PASS React SPA 编译与静态资源打包通过
Failover watchdog regression PASS 故障转移硬连接失效、延迟超标、并发与冷却恢复回归测试通过
Self-update verification PASS 自动更新 SHA-256 校验、临时文件管理与路径安全测试通过
Windows cert install diagnostic PASS Windows Root CA 证书状态检测、安装引导与注销流程测试通过

注：当前 Windows 构建宿主缺少 GCC / CGO 环境，Race detector（-race）未在本地执行，并发竞争检测已委托 CI 流程验证。

🧭 验证边界 (Verification Boundaries)

已验证 (Verified)

  • Windows 10 / 11 桌面环境：PE 二进制编译、Windows PE 图标嵌入、manifest 清单配置、WinINet 系统代理托管、更新助手启动与 Root CA 流程验证。
  • macOS Universal 2 打包：双架构 Bundle 目录结构完整，Info.plist、高清 icns 图标、分流脚本均打包合规。
  • Linux 交叉编译：Linux amd64 / arm64 交叉编译无头模式（nogui）编译无告警。
  • 控制台交互：Web 控制台自动更新弹窗、备用上游配置面板、证书诊断与日志流展示正常。

未验证 (Unverified)

  • 跨物理设备 Wi-Fi E2E：不同独立硬件物理设备之间的实际无线通信受路由器 AP 隔离与具体防火墙规则影响，需用户在本地实际拓扑环境中验证。
Loading

v2.0.0 - Go原生重构、双平面拓扑与Web控制台

v2.0.0 - Go原生重构、双平面拓扑与Web控制台

Choose a tag to compare

View all tags
@Sagisawa Sagisawa released this 20 Sep 14:32
v2.0.0
2655a9b

GBF Accelerator v2.0.0 发布说明 (Release Notes)

发布日期：2026-09-20
版本定位：Go 原生引擎重写、双平面拓扑隔离、内嵌 React SPA 控制台与跨平台加固
发布包：

  • Windows：GBF_Accelerator_v2.0.0_GUI.zip
  • macOS：GBF_Accelerator_v2.0.0_macOS_universal2.zip

📥 下载与使用

Windows 用户

  1. 下载 GBF_Accelerator_v2.0.0_GUI.zip，解压即用；
  2. 旧版本升级直接替换 GBF_Accelerator.exe 即可，原有 cache 目录与 config.json 自动继承，无需重新配置。

macOS 用户

  1. 下载 GBF_Accelerator_v2.0.0_macOS_universal2.zip（Universal 2 双架构，原生支持 Intel 与 Apple Silicon Macs）；
  2. 解压后将 GBF_Accelerator.app 拖入系统的【应用程序】（Applications）文件夹；
  3. 解除安全拦截（首次运行必须）：
    打开终端执行以下命令清除系统隔离属性： 
    xattr -cr /Applications/GBF_Accelerator.app
  4. 启动后程序自动打开内嵌 Web 控制台（支持 Chromium App Mode 独立窗口），首次启动将自动引导完成钥匙串根证书信任与系统 PAC 代理配置。

校验和 (SHA-256 Checksums)

资产文件名 SHA-256 校验和
GBF_Accelerator_v2.0.0_GUI.zip 603E74EBAA5BFA603E4FEC4CC251FD3E9F82521134E88A56E9B2EF10A821CF63
GBF_Accelerator_v2.0.0_macOS_universal2.zip 24A7C4E07A34AEA1309231A27C1370CBBD228F00BD43368665ECE5EF3DEDE8DD

🌟 主要更新内容

1. Go 原生引擎全面重构

  • 零 Python 运行时依赖：核心代理引擎完成 Go 原生重构，交付为单静态二进制文件，内存占用显著降低，并发调度能力与运行稳定性进一步增强。
  • 数据面与控制面双端口隔离：采用代理数据平面（默认 :8124）与管理控制平面（默认 :8125）双端口独立拓扑；控制平面内置 DNS Rebinding 与 CORS 来源白名单校验。
  • 局域网共享与热重载隔离：数据平面（:8124）支持随 allow_lan 配置在 127.0.0.1 与 0.0.0.0 之间无缝热重载（采用 Close-Listen-Rollback 事务机制）；局域网设备所需的根证书、PAC 脚本与落地页由 :8124 直接提供；管理控制平面（:8125）坚决保持 127.0.0.1 本地回环监听，杜绝局域网越权调用管理接口。
  • 现代化内嵌 Web 控制台：基于 React 18 + Vite 开发的管理界面编译后经 Go embed 内置于单二进制产物中，零外部依赖，支持深色/浅色模式、实时性能指标图表与日志流。

2. 核心网络与代理管道加固

  • API / Asset 物理连接池隔离：动态游戏 API 采用专用 HTTP/1.1 Keep-Alive 连接池，静态素材走 Akamai CDN 专用 HTTP/2 多路复用连接池，杜绝协议降级与握手阻塞。
  • 双重约束安全重试：所有涉及状态变更的写请求（POST/PUT/DELETE）强制零重试（maxAttempts = 1）；只读 GET 请求仅限白名单安全路径重试，杜绝技能双发与状态不一致。
  • 有界非阻塞遥测机制：日志与状态推送采用有界非阻塞通道，队列满载时安全丢弃日志，确保管理控制台活动绝不阻塞代理核心数据面。

3. 跨平台适配与发布工程严格化

  • macOS 原生 .app 打包与分流指引：macOS 发布包提供标准 .app Bundle 目录结构（包含 Info.plist、高分辨率 icns 图标与分发说明）；控制台路由引导内置 SmartProxy / ZeroOmega 4 步分流指引，无缝兼容 Clash TUN 虚拟网卡模式。
  • Windows 原生集成与图标嵌入：Windows 原生可执行文件内置完整 7 规格高清应用图标与 PE 版本元数据（FileVersion: 2.0.0.0）；提供受控的 Windows 防火墙一键放行适配操作（限定为 Private / LocalSubnet / TCP），不越权开放公网。
  • 系统调用平台隔离：抽离 Windows、macOS 与 Linux 原生目录选择至平台适配层，清除公共包中 Windows 专有属性依赖，实现全平台交叉编译 100% 通过。
  • 移动端全流程图文指引：局域网落地页（:8124/）与 Web 控制台弹窗同步集成详尽的根证书安装步骤、iOS 证书信任设置开关与 Wi-Fi 代理分流图文说明。
  • 构建脚本发布合同加固：构建脚本严格约束 macOS Universal 2 必须在具备 lipo 工具的环境下生成，缺失或合并失败时直接报错中断，坚决不产出伪装的单架构 Universal2 包。

🖼️ 界面预览

Web 控制台主面板 实时网络与转发日志
Web 控制台主面板 实时网络与转发日志
移动端跨设备连接指引 (控制台) 局域网移动端引导页 (手机浏览器)
移动端连接指引 局域网移动端引导页

🔒 事务与安全边界 (Transaction & Security Boundaries)

明确界定双平面监听策略与暴露边界，守住核心安全红线：

  • 8124 = 数据平面 (Data Plane)
    • 默认监听：127.0.0.1
    • 开启局域网共享（AllowLAN = true）时：动态重载至 0.0.0.0
    • 承载职责与公开资源：
      • HTTP / HTTPS 游戏透明代理与流量分流
      • /ca.crt（本地自签根证书下载）
      • /proxy.pac（PAC 自动代理脚本）
      • 局域网移动端接入引导向导页
  • 8125 = 控制平面 (Control Plane)
    • 监听策略：永远严格绑定 127.0.0.1，绝不暴露至局域网（Never exposed to LAN）
    • 承载职责：
      • 管理控制台 React SPA 前端资源
      • 系统管理与配置变更 REST API（/api/config、/api/status、/api/app/quit 等）
      • 实时性能与连接 SSE 遥测流
      • 内置 DNS Rebinding 防护与 Host / Origin 白名单严格校验

🔄 配置热重载行为 (Configuration Hot-Reload Pipeline)

系统配置热重载（POST /api/config/apply）遵循严格的四阶段强事务流水线：

[Candidate] (候选配置生成与字段校验)
    ↓
[Commit] (内存配置原子提交与磁盘持久化)
    ↓
[Listener Rebind] (网络监听强事务重载: 8124 / 8125 端口与 Host 切换)
    ↓
[Post-Commit Runtime Sync] (非监听运行时副作用生效: 缓存目录/RAM 上限/PAC 代理/自启)

异常故障原子回滚保障

  • Rebind 阶段失败（如目标端口被占用）：
    • 自动回滚至旧 Listener；
    • 配置状态保持未修改（Config unchanged）；
    • 向调用端返回失败错误。
  • Save/Commit 阶段失败（如磁盘写保护或 I/O 错误）：
    • 自动回滚已重绑的 Listeners 至原端口与原监听地址；
    • 内存配置立即还原为旧配置（Memory config restored）；
    • 磁盘文件保持原样（Config on disk unchanged）；
    • 彻底阻断 Post-Commit 运行时副作用（sysproxy 不执行、startup 不执行、cache runtime 不切换）。

💡 语义规范：cfgMgr.Update() 仅用于安全的内存就地原子更新；cfgMgr.Commit() 承载包含磁盘落盘校验、两端监听联动与强事务回滚保障的完整语义。

🧪 测试矩阵 (Test Matrix)

测试项 (Test) 状态 (Status) 说明
go test -count=1 ./... PASS 覆盖全部 13 个 Go 核心包单元测试，无缓存全量通过
go test -race -count=1 ./... PASS 并发竞争检测（CI / CGO 环境）
go vet ./... PASS 静态代码分析与语法合规检查通过，零告警
Proxy → Control rollback PASS 代理端口重绑成功但控制端口重绑失败时，代理端口与监听地址原子回滚
Save failure rollback PASS 磁盘配置持久化失败时两端 Listener 均回滚，且完全阻断 Post-Commit 运行时副作用
Existing connection survival PASS 监听地址动态重载期间，已建立的 HTTP Keep-Alive 连接平滑存活不受打断
Real LAN interface socket E2E PASS 真实物理/虚拟网卡局域网 IP（非 loopback）端到端 Socket 拨号与 HTTP 交付通过
Control-plane LAN isolation PASS AllowLAN=true 时物理 LAN-IP 访问 8125 端口严格连接拒绝，守住安全红线

🧭 验证边界 (Verification Boundaries)

已验证 (Verified)

  • Windows：Windows 10 / 11 真实桌面环境、WinINet 系统 PAC 代理自动托管、系统托盘常驻与 Chromium App Mode 独立窗口。
  • Linux cross-build：Linux amd64 与 arm64 交叉编译无头运行（nogui）。
  • Darwin amd64 cross-build：macOS Intel 架构二进制编译与符号表验证。
  • Darwin arm64 cross-build：macOS Apple Silicon (M 系列) 架构二进制编译与符号表验证。
  • 本机真实 LAN interface：非 loopback 真实局域网 IP（物理 NIC / 虚拟网卡）端到端 Socket 监听、连接与数据链路验证。
  • macOS 实机 Universal2 / Gatekeeper：Universal 2 双架构包实机加载、xattr -cr 隔离属性清除与运行验证。

未验证 (Unverified)

  • 跨物理设备 Wi-Fi E2E：不同物理硬件设备（如真实独立手机与电脑）通过无线 Wi-Fi 路由器的端到端真机联调（受各家庭/企业路由 AP 隔离与复杂防火墙策略影响，需在具体网络拓扑下实机验证）。

⚔️ 特别寄语 (Easter Egg)

🌟 P.S.：马上光团了，祝大家画面流畅、FA 不翻车、多出极星器和沙漏，早点打完早点下班！各位光古战场加油！✨

Loading

v1.8.1 - 修复静态协商缓存断连跳更新卡死与 GUI 提示优化

v1.8.1 - 修复静态协商缓存断连跳更新卡死与 GUI 提示优化

Choose a tag to compare

View all tags
@Sagisawa Sagisawa released this 19 Sep 04:43
v1.8.1
90f123f

GBF Accelerator v1.8.1 发布说明 (Release Notes)

发布日期：2026-09-19
版本定位：协商缓存 304 响应标头解耦热修复、解决跳更新卡死问题与 GUI 提示修正
发布包：

  • Windows：GBF_Accelerator_v1.8.1_GUI.zip
  • macOS：GBF_Accelerator_v1.8.1_macOS_universal2.zip

📥 下载与使用

Windows 用户

  1. 前往 Releases 下载 GBF_Accelerator_v1.8.1_GUI.zip，解压即用；
  2. 旧版本升级只需替换 GBF_Accelerator.exe，原有 cache 缓存与 config.json 自动继承。

macOS 用户

  1. 前往 Releases 下载 GBF_Accelerator_v1.8.1_macOS_universal2.zip（Universal 2 双架构通用包）；
  2. 解压并将 GBF_Accelerator.app 替换至系统的【应用程序】（Applications）文件夹；
  3. 如遇 Gatekeeper 拦截，打开终端执行一次 xattr -cr /Applications/GBF_Accelerator.app 即可放行。

🛠️ 主要修复内容

1. 协商缓存 304 标头安全解耦与防崩溃 (Hotfix)

  • 故障排查：在 v1.8.0 修复“关闭浏览器强缓存配置时严格不注入标头”的逻辑后，代理底层静态素材 304 协商响应中因硬编码读取 Cache-Control，在未开启该功能（或老配置继承）时抛出 KeyError: 'Cache-Control'，导致连接被强制中断并在游戏更新时频繁卡死。
  • 防御性重构：新增 _build_304_headers() 构造器，对 RAM 缓存命中与磁盘缓存命中的 304 协商响应头进行解耦与安全取值，严格遵循 RFC 规范，彻底消除标头缺失时抛出异常的隐患。
  • 回归测试覆盖：新增 Test 76 自动化测试，全面覆盖关闭浏览器强缓存场景下的 RAM/Disk 协商缓存请求。

2. GUI 界面文案与提示优化

  • 纠正误导性提示：将性能设置中“启用浏览器强缓存与渲染留存”的文字由历史残留的“（...，默认关闭）”更新修正为“（仅对版本化静态资源注入 immutable，推荐开启）”，消除配置歧义。
Loading

v1.8.0 - macOS 原生支持、历史缓存安全轮转与跨平台更新适配

v1.8.0 - macOS 原生支持、历史缓存安全轮转与跨平台更新适配

Choose a tag to compare

View all tags
@Sagisawa Sagisawa released this 18 Sep 06:28
v1.8.0
fcaf896

GBF Accelerator v1.8.0 发布说明 (Release Notes)

发布日期：2026-09-18
版本定位：macOS 原生平台支持、历史缓存安全轮转、Windows 代理冲突检测与跨平台更新适配
发布包：

  • Windows：GBF_Accelerator_v1.8.0_GUI.zip
  • macOS：GBF_Accelerator_v1.8.0_macOS_universal2.zip

📥 下载与使用

Windows 用户

  1. 下载 GBF_Accelerator_v1.8.0_GUI.zip，解压即用；
  2. 旧版本升级直接替换 GBF_Accelerator.exe 即可，原有 cache 目录与 config.json 自动继承，无需重新配置。

macOS 用户

  1. 下载 GBF_Accelerator_v1.8.0_macOS_universal2.zip（Universal 2 双架构，原生支持 Intel 与 Apple Silicon Macs）；
  2. 解压后将 GBF_Accelerator.app 拖入系统的【应用程序】（Applications）文件夹；
  3. 解除安全拦截（首次运行必须）：
    由于开源软件未购买商业开发者证书，首次运行会被系统 Gatekeeper 拦截。请打开 Mac 自带的【终端】执行以下命令放行： 
    xattr -cr /Applications/GBF_Accelerator.app
    (或在系统拦截弹窗后，前往【系统设置】->【隐私与安全性】底部点击【仍要打开】)；
  4. 启动后程序常驻顶部 Menu Bar 菜单栏，首次启动将自动引导完成钥匙串根证书信任与系统 PAC 代理配置。

🌟 主要更新内容

1. macOS 原生平台支持

  • 原生菜单栏常驻：基于 Cocoa/AppKit 构建 macOS 状态栏图标（Menu Bar item），支持一键启停、代理模式切换、PAC 地址复制与配置重载。
  • 钥匙串证书自动信任：首次启动自动检测自签 Root CA 并通过 security 写入登录钥匙串完成信任；退出时支持干净注销。
  • networksetup PAC 自动配置：集成 networksetup 自动写入当前活动网卡的 PAC 代理配置，退出程序时自动复原，不残留失效代理。
  • LaunchAgents 开机自启：支持在 macOS 下自动生成并注册 ~/Library/LaunchAgents plist 配置。
  • 双平台界面隔离：macOS 专用自适应 Scrollable Canvas 仅在 Darwin 平台初始化，Windows 平台 100% 保持原生自适应紧凑卡片布局，杜绝跨平台 GUI 回归。

2. 历史版本缓存安全瘦身与轮转

  • 跨版本素材目录归档与轮转：游戏素材版本更迭时，对长期未命中的旧版本素材目录提供安全扫描与清理机制，有效控制磁盘膨胀。
  • 完整性防护：清理范围严格限制在静态缓存内，前台活动素材与当前活跃版本 100% 保持完整。

3. Windows 系统代理冲突检测与提醒

  • 外部代理抢占检测：启动与运行中检测系统代理配置；若被 Clash / v2rayN 等外部代理工具覆盖或修改，弹出温和提示并支持一键恢复。
  • 防断网自愈保护：在外部工具意外退出或注册表键值被改动时提供诊断信息，避免出现浏览器断网。

4. 自动更新器跨平台感知与 Universal 2 优先匹配

  • 跨平台资源过滤：客户端检查更新时自动识别当前操作系统，Windows 客户端自动过滤 macOS 压缩包，macOS 客户端自动过滤 Windows 安装包。
  • Universal 2 优先策略：macOS 客户端检查新版本时，优先匹配 universal2 双架构通用安装包；若不存在则平滑回退至常规 macOS 安装包。

5. 更多改进与修复

  • Linux / 命令行模式支持：新增无 GUI 模式与自动化证书安装脚本（详见 docs/MAC_LINUX_NOGUI.md）；
  • 缓存配置修复：修复当在配置中手动关闭 enable_browser_cache 时部分头未完全生效的问题；
  • 接口重试精细化：进一步收敛网络断连重试范围至严格只读幂等接口，写请求保持绝对 0 重试。

❤️ 特别致谢

感谢 @toooonyy 在 #5 中提出的跨平台构想，并在 #6 中为 macOS / Linux (nogui) 模式与证书配置指南搭建的基础，启发并促成了本次 v1.8.0 跨平台版本的落地！

Loading

v1.7.2 - 前台素材优先调度、预加载解耦防卡顿与启动优化

v1.7.2 - 前台素材优先调度、预加载解耦防卡顿与启动优化

Choose a tag to compare

View all tags
@Sagisawa Sagisawa released this 16 Sep 15:18
v1.7.2
5f469df

GBF Accelerator v1.7.2 发布说明 (Release Notes)

发布日期：2026-09-16
版本定位：前台素材优先调度、预加载解耦与启动预热调优
发布包：GBF_Accelerator_v1.7.2_GUI.zip

版本概述

v1.7.2 主要针对进入副本或页面切换时的素材加载体验进行优化。本版本将静态素材的引用扫描从前台请求路径解耦至后台队列，并增加前台素材优先调度机制；同时将启动预热上限调整至 1500 项，缩短冷启动磁盘扫描耗时。

主要更新内容

1. 前台素材优先调度与 QoS 避让

  • 前台请求优先保障：增加前台活动素材计数。当浏览器正在拉取前台画面与战斗素材时，后台预加载任务主动暂停，优先保障前台请求带宽与连接资源。
  • 调度平滑缓冲：前台请求结束后增加短时冷却平滑，避免后台预加载立即恢复引发瞬时突发流量。

2. 预加载发现流水线异步解耦

  • 引用扫描异步入队：素材响应返回浏览器后，引用扫描逻辑异步投递至有界后台队列（容量 32），不阻塞当前响应管道。
  • 磁盘状态检查卸载至线程池：本地磁盘缓存命中状态检查移至后台工作线程池执行，减少慢速磁盘 I/O 对代理主事件循环的阻塞影响。
  • URL 规范化与背压控制：统一域名小写并剥离动态 query 参数去重；当预加载队列满载时安全丢弃低优先级任务，防止任务堆积。

3. 启动预热项调整

  • 预热上限调整（6000 → 1500 项）：优先加载核心 JS/CSS、字体及高频 UI/图标，减少启动时非必要素材的扫描开销。
  • 启动耗时优化：启动阶段的磁盘扫描时间由 ~7.5 秒降低至 1.5 ~ 2.5 秒，缓解启动初期磁盘读写压力。
  • 新增配置项 "ram_warmup_max_items": 1500，支持在 config.json 中按需微调。

4. 稳定性与状态规范化

  • 端口绑定竞争修复 (#4)：优化监听端口探测与绑定逻辑，减少端口残留时的等待重试开销。
  • 隔离区匹配精准化：收敛历史补丁识别特征，仅在异常语法上下文中判定，避免误判正常脚本。
  • 协程状态操作收敛：规范内部集合与计数器生命周期，统一在主事件循环中调度，符合 asyncio 规范。
  • 可观测性增强：磁盘缓存读取日志增加耗时显示（CACHE-DISK (Xms)），预加载队列日志增加扫描与磁盘检查耗时统计。
  • 自动化测试扩充：回归测试用例扩充至 69 项（100% 通过），覆盖有界背压、优先级时间轴及异常自愈。

性能与架构说明

  • 多级缓存架构：内存热点缓存（RAM Cache）+ 本地持久化缓存（SSD/HDD）。
  • 双通道隔离：动态 API 专属 HTTP/1.1 长连接池，静态素材 Akamai CDN 独立 HTTP/2 多路复用通道。
  • 请求合并与防击穿：SingleFlight 机制合并高并发同名静态素材请求，减少重复回源。

升级指引

  1. 从 Release 页面下载 GBF_Accelerator_v1.7.2_GUI.zip；
  2. 解压并将 GBF_Accelerator.exe 替换原有文件；
  3. 原有 cache 缓存目录与 config.json 配置自动继承，无需重新配置。
Loading

v1.7.1 - 客户端内置更新、托盘挂起低CPU与透明代理维护

v1.7.1 - 客户端内置更新、托盘挂起低CPU与透明代理维护

Choose a tag to compare

View all tags
@Sagisawa Sagisawa released this 16 Sep 08:53
v1.7.1
adc5523

GBF Accelerator v1.7.1 发布说明 (Release Notes)

发布日期：2026-09-16
版本定位：行为透明化、客户端体验与稳定性维护更新
发布包：GBF_Accelerator_v1.7.1_GUI.zip

🌟 版本概述

GBF-Accelerator v1.7.1 是 1.7 系列的重要维护与体验提升版本。本版本进一步收敛了代理自身的行为边界，提升与官方资源、动态 API 及历史缓存的兼容性；同时整合了自 1.7.0 以来的一系列客户端体验优化（内置更新下载、日志导出、托盘 0% CPU 占用等），并修复了托盘退出生命周期问题。

本版本完整保留 1.7.0 的核心加速架构（RAM Cache、Disk Cache、API/素材物理双连接池、长连接复用），保持原有加速表现。

🚀 主要更新内容

1. 🌐 透明代理与行为规范化

  • 动态请求标准透传：游戏动态 API、官方心跳（/ob/r）及报错请求恢复标准原样透传，不再由代理生成本地响应。
  • 静态脚本原始内容交付：静态 JavaScript 脚本保持逐字节原版交付，不再对前端代码进行额外修改。
  • 响应标头精简：移除发送给浏览器的内部调试 Header（如 X-Proxy-*），调试与耗时数据仍完整保留在本地 GUI 与实时日志窗口中。
  • 后台预加载标头规范：优化后台 Prefetch 标头与资源预热兼容性，采用合规标准浏览器 UA，仅携带必要协议信息。

2. ⚡ 客户端交互与体验升级

  • 内置一键下载更新：检测到新版本后，支持在客户端内直接发起下载，提供实时百分比进度条，下载完成后可一键在文件资源管理器中定位安装包。
  • 实时日志查看器增强：
    • 优化日志着色排版与分类标签过滤；
    • 增加便捷快捷键操作（如快速聚焦检索、快捷复制行）；
    • 支持将当前过滤后的网络与转发日志一键导出保存为本地文件。

3. 🔋 功耗与性能深度优化

  • 托盘最小化低 CPU 占用：主窗口最小化至系统托盘后，自动挂起 GUI 界面的定时刷新循环，后台挂机期间 CPU 占用降至约 0.0%。
  • 精准 RAM 内存预热重构：重构启动时的静态资源预热逻辑，优先扫描并装载当前活跃版本及高频核心 UI 资源，提升冷启动效率，避免无效内存占用。

4. 📦 缓存兼容性与自愈

  • 旧版缓存无缝兼容：推荐 1.7.0 用户直接覆盖升级，现有 cache 目录与 config.json 配置保持良好兼容，无需重新下载素材，无需清空缓存。
  • 历史修改文件自动恢复：检测到包含旧版修改特征的历史 JS 文件时，自动隔离备份至 .quarantine 并重新拉取官方原版，不影响正常缓存复用。
  • 保持缓存自愈能力：继续保留 Magic Bytes 文件头完整性校验与损坏缓存“一键体检自愈”能力。

5. 🛠️ 稳定性与问题修复

  • 修复托盘退出生命周期：完善 Windows 托盘菜单“彻底退出”控制流程，确保托盘图标即时注销、系统 PAC 代理复原、GUI 窗口销毁与后台进程退出。
  • 网关超时可观测性增强：详细区分记录上游超时类型（ConnectTimeout 连接超时 / ReadTimeout 读取超时）及具体消耗毫秒。
  • PAC 规则精简：移除对非 GBF 相关统计域名的额外接管，专注于官方游戏主站、CDN、Steam 专用 CDN 与 Mobage 授权全链路。
  • 自动化测试扩充：集成测试用例扩充至 54 项并全部通过，全面覆盖透传保真、资源一致性与托盘生命周期。

⚡ 性能说明

核心加速机制全部保留，保持原有加速性能：

  • 本地 RAM Cache（内存 0ms 热点命中）
  • SSD/HDD 磁盘持久化缓存
  • 动态 API 独立长连接池（省去 TCP+TLS 重复握手延迟）
  • 静态素材 HTTP/2 多路复用与 SingleFlight 请求合并

本版本主要调整代理行为边界和兼容性，不改变核心缓存与连接复用架构，升级后维持原有性能表现。

📦 升级指引

  1. 从 Release 页面下载 GBF_Accelerator_v1.7.1_GUI.zip；
  2. 解压并将 GBF_Accelerator.exe 替换原有文件即可；
  3. 原有 cache 缓存目录与 config.json 配置自动继承，无需任何额外重新配置。
Loading