当前位置：首页 > news >正文

WeMod增强工具技术架构实现方案：基于ASAR解包与运行时注入的客户端增强方案

news 2026/6/16 15:45:36

WeMod增强工具技术架构实现方案：基于ASAR解包与运行时注入的客户端增强方案

【免费下载链接】Wand-EnhancerAdvanced UX and interoperability extension for Wand (WeMod) app项目地址: https://gitcode.com/gh_mirrors/we/Wand-Enhancer

Wand-Enhancer是一个基于ASAR文件解包和运行时注入技术的WeMod客户端增强工具，通过修改本地客户端配置文件实现Pro功能解锁、禁用自动更新、关闭遥测数据等高级功能。该工具采用C#和C混合编程架构，结合正则表达式模式匹配与动态代理DLL注入技术，在不破坏原始数字签名的前提下实现客户端功能扩展。

技术架构解析

核心组件架构

Wand-Enhancer采用三层架构设计，包含前端用户界面层、核心业务逻辑层和底层系统集成层：

前端界面层：基于WPF框架实现，提供直观的补丁操作界面
业务逻辑层：处理ASAR文件解包、JavaScript代码修改、配置管理
系统集成层：包含ASAR文件处理库和FUSE绕过工具

关键技术实现原理

ASAR文件处理机制

ASAR是Electron应用使用的归档格式，Wand-Enhancer通过自研的AsarSharp库实现对ASAR文件的完整解包和重新打包：

// ASAR文件提取核心代码 public void Patch() { // 创建备份文件 if (!File.Exists(_backupPath)) { File.Copy(_asarPath, _backupPath); } // 解包ASAR文件 AsarExtractor.ExtractAll(_asarPath, _unpackedPath); // 应用JavaScript补丁 PatchAsar(); // 重新打包ASAR文件 new AsarCreator(_unpackedPath, _asarPath, new CreateOptions { Unpack = new Regex(@"^static\\unpacked.*$") }).CreatePackageWithOptions(); }

JavaScript代码动态修改

工具通过正则表达式匹配目标函数，实现精确的代码替换：

private string ApplyJsPatch(string fileName, string js, EnhancerConfig.PatchEntry patch, EPatchType patchType) { var matches = patch.Target.Matches(js); if (matches.Count == 0) { return js; } // 动态解析字段名称 if (patch.Resolver != null) { string resolvedField = patch.Resolver.Handler(matches[0].Value); patch.Patch = patch.Patch.Replace(patch.Resolver.Placeholder, resolvedField); } // 应用补丁 string newJs = patch.Target.Replace(js, patch.Patch); File.WriteAllText(fileName, newJs); return newJs; }

补丁方法对比分析

静态补丁模式技术实现

静态补丁直接修改ASAR文件内容，实现永久性的功能修改：

技术优势：

无需运行时依赖，修改后客户端可独立运行
修改直接写入文件，重启后依然有效
实现简单，无需复杂的运行时环境

技术限制：

破坏Electron应用的数字签名验证
可能触发安全软件的误报
热键功能可能失效
不支持自动适配新版本

运行时补丁模式技术实现

运行时补丁通过DLL注入技术，在客户端启动时动态修改内存：

核心技术组件：

代理DLL注入：通过version.dll实现DLL劫持
FUSE绕过机制：修改Electron FUSE配置，禁用ASAR完整性验证
内存补丁：在运行时动态修改JavaScript执行环境

技术优势：

保持原始文件完整性，不破坏数字签名
完整保留所有热键功能
自动适配新版本客户端
更高的安全软件兼容性

配置参数详解

补丁类型定义

public enum EPatchType { ActivatePro = 1, // 激活Pro功能 DisableUpdates = 2, // 禁用自动更新 DisableTelemetry = 4, // 禁用遥测数据 DevToolsOnF12 = 8 // F12打开开发者工具 }

正则表达式补丁配置

Pro功能激活补丁的核心配置：

new PatchEntry { Name = "getUserAccount", Target = new Regex(@"getUserAccount\(\)\{.*?return\s+this\.#\w+\.fetch\(\{.*?\}\)\}", RegexOptions.Singleline), Patch = "getUserAccount(){return this.#<service_name>.fetch({endpoint:\"/v3/account\",method:\"GET\",name:\"/v3/account\",collectMetrics:0}).then(response=>{response.subscription={period:\"yearly\",state:\"active\"};return response;})}" }

FUSE绕过技术深度解析

Electron FUSE机制

Electron FUSE（Feature Usage Statistics）是Electron框架的安全特性，用于控制应用行为。Wand-Enhancer通过C语言编写的FUSE绕过工具禁用ASAR完整性验证：

BOOL disable_asar_integrity(void) { // 查找FUSE数据结构 FuseWire* wire = find_fuse_wire(0); if (!wire) wire = find_fuse_wire(4); // 验证版本兼容性 if (wire->version != FUSE_VERSION_SUPPORTED) { return FALSE; } // 修改FUSE状态 unsigned char* target = &wire->fuses[FUSE_ASAR_INTEGRITY_VALIDATION]; if (*target == FUSE_STATE_REMOVED) { return TRUE; } // 应用补丁 return patch_fuse(target); }

内存搜索算法

static FuseWire* find_fuse_wire(int offset) { char* base = (char*)GetModuleHandleA(NULL); IMAGE_DOS_HEADER* dos = (IMAGE_DOS_HEADER*)base; IMAGE_NT_HEADERS* nt = (IMAGE_NT_HEADERS*)(base + dos->e_lfanew); // 在PE映像中搜索FUSE标记 for (DWORD64* p = (DWORD64*)start; p < (DWORD64*)end; p++) { if (p[0] == SENTINEL_PART1 && p[1] == SENTINEL_PART2 && p[2] == SENTINEL_PART3 && p[3] == SENTINEL_PART4) { return (FuseWire*)p; } } return NULL; }