Wand-Enhancer 安装与配置完整指南:从零跑通 Wand(WeMod)增强工具
【免费下载链接】Wand-EnhancerAdvanced UX and interoperability extension for Wand (WeMod) app项目地址: https://gitcode.com/GitHub_Trending/we/Wand-Enhancer
Wand-Enhancer 是一款针对 Wand(WeMod)客户端的开源增强工具,它能本地修改 Wand 客户端配置,提供 Pro 激活、关闭更新、远程 Web 面板等能力。本文带你完成环境自检、源码构建和首次补丁配置,全程约 15 分钟。
场景切入:谁需要它
如果你在用 Wand(WeMod)客户端,但被广告、自动更新或遥测打扰,或者想用手机在局域网内遥控 Wand 的 Web 面板,Wand-Enhancer 就是干这个的。它纯本地运行,不发起任何网络请求,改的只是你电脑上的客户端文件。官方不发布预编译 .exe,所有产物都需自己构建。
开始前的环境自检清单
在动手前先对照下表核对自己的环境(构建仅支持 Windows):
- Windows 操作系统,已安装 Wand(WeMod)客户端
- Visual Studio 2022(或 Build Tools 2022),勾选「Desktop development with C++」工作负载,含 MSBuild
- .NET Framework 4.8 桌面开发组件 / 目标包
- CMake,命令行执行
cmake --version有版本号输出 - Node.js 与 pnpm,执行
pnpm --version可正常返回 - Git,用于拉取源码
技术栈一句话说明:主程序是 C# WPF(.NET Framework),Web 面板是 TypeScript + React 风格代码(Preact 别名运行),另有 CMake 编译的原生 asar fuses 辅助模块。
安装步骤:拉取 → 构建 → 拿到产物
第一步:拉取代码
打开 PowerShell 或命令提示符,执行:
git clone https://gitcode.com/GitHub_Trending/we/Wand-Enhancer cd Wand-Enhancer你会看到克隆进度,完成后目录下应有Wand-Enhancer.sln、web-panel/、build.cmd等文件。
第二步:执行一键构建
在仓库根目录运行:
build.cmd脚本会依次完成六步:pnpm install装依赖 → 构建 Web 面板 → CMake 编译 asar-fuses-bypass 原生模块 → NuGet 还原 → MSBuild 编译解决方案。全部成功时,你会看到绿色的Build completed successfully (Release)。
第三步:找到可运行产物
构建成功后,到WandEnhancer/bin/下的 Release 输出目录,找到WandEnhancer.exe即可运行。
首次运行与基础配置
- 指向 Wand 安装目录:启动
WandEnhancer.exe后,在Folder path一栏填 Wand 安装目录,通常是%LocalAppData%\WeMod\app-<版本号>。识别成功会看到绿色[SUCCESS] WeMod directory found和[INFO] Ready for patching。 - 选择补丁类型:补丁类型定义在 WandEnhancer/Models/PatchConfig.cs,包括 Pro 激活、禁用更新、禁用遥测、F12 开发者工具、Remote Web Panel。按需勾选后点
Patch执行。 - 配置 Remote Web Panel:开启该补丁后,手机与 PC 连同一 Wi-Fi,鼠标悬停顶部栏
Connect按钮,用手机扫码即可在手机上打开面板。面板监听默认端口3223,相关实现见 web-panel/bridge/src/。
常见问题排查
Q1:git clone 失败或速度慢?换网络或稍后重试;也可以确认命令行中git --version正常。拉取成功后再进入构建环节。
Q2:build.cmd 报Required command not found in PATH: cmake/pnpm?说明 CMake 或 pnpm 没装好,或安装后没重开终端。补装后重新执行build.cmd,该脚本会自动检查所有依赖(见 build.ps1 开头的命令解析逻辑)。
Q3:运行 exe 时 Windows Defender / SmartScreen 报警?正常现象——自己构建的二进制没有签名。官方 FAQ(README.md 的 Q&A 章节)明确说明:只运行自己构建的产物,不要从 YouTube 描述、第三方镜像下载来路不明的 .exe。
下一步
- 阅读 web-panel/README.md:了解 Web 面板的本地开发方式,
pnpm dev后可在http://localhost:4173/预览面板。 - 参考 AGENTS.md 中 Custom scripts 相关说明,往 exe 旁放
renderer-scripts/目录注入你自己的 JS 脚本。 - 关注 CHANGELOG.md 了解各版本修复,遇到与 Wand 新版本不兼容的补丁时先查这里。
【免费下载链接】Wand-EnhancerAdvanced UX and interoperability extension for Wand (WeMod) app项目地址: https://gitcode.com/GitHub_Trending/we/Wand-Enhancer
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考