Wand-Enhancer 完整上手指南:5 步搭好 WeMod 增强环境并连上手机远程控制面板
【免费下载链接】Wand-EnhancerAdvanced UX and interoperability extension for Wand (WeMod) app项目地址: https://gitcode.com/GitHub_Trending/we/Wand-Enhancer
每天打开 WeMod 调试游戏参数时,你是否也幻想过这样的场景:不用守在电脑前,躺在沙发上用手机就能切换配置、微调数值?Wand-Enhancer 就是为此而生的开源 WeMod 增强工具——免费、纯本地运行,不仅能自动适配客户端新版本、注入自定义脚本,还内置了手机远程控制面板,相当于把游戏调试台装进了口袋。这篇教程会用 5 个闯关式步骤,带你从零完成环境搭建,并附上完整的排错清单。
一个典型玩家的烦恼,正是这个项目的起点
老周是个单机游戏重度玩家,几乎每晚都用 WeMod 调参数。但他的烦恼清单越来越长:
- WeMod 每次更新后,他辛苦保存的界面配置经常被打回原形;
- 躺在床上想改个数值,必须爬起来跑到电脑前;
- 想要某些顺手的小功能(比如按 F12 直接开调试面板),默认客户端根本不提供;
- 官方客户端的默认界面和交互,总感觉差那么点意思。
Wand-Enhancer 的定位,恰好就是"把 WeMod 变得更好用"。它不是外挂,也不碰游戏进程,而是以开源、本地的方式增强 Wand 客户端本身。项目用一句话概括自己的使命:为 Wand 应用扩展本地客户端配置、改善使用体验的互操作性工具。
它能为你带来什么:六项核心能力速览
在动手之前,先用一分钟搞清这套工具的价值。它主要围绕六个方向做增强:
- 本地环境配置管理:把常用配置固化到本地,客户端更新后仍能保持你的使用习惯;
- 版本自动适配:检测到 WeMod 新版本后,自动调整补丁策略,减少"一更新就失效"的尴尬;
- 界面与主题定制:纯客户端侧的布局与主题改造,不动任何云端数据;
- AI 功能增强:解锁更顺手的 AI 相关体验;
- 手机远程面板:同一局域网内,用手机扫码即可远程操作,这是最亮眼的功能;
- 自定义脚本注入:允许你往 Wand 窗口里注入自己的 JavaScript,实现任意 UI 微调。
如果你只想记住一句话:这是一个能让你"按自己的方式"使用 WeMod 的免费开源工具。
动手前必读:三条避坑须知
这部分非常重要,请先读完再操作。项目反复强调的安全红线,值得每个新手先了解。
1. 官方不发布任何现成安装包
项目刻意不在发布页提供.exe文件。网上打着 Wand-Enhancer 旗号的"一键安装包""视频教程下载链接",很可能是骗子捆绑的恶意程序。请记住:官方渠道只有源码,可执行文件需要你自己构建。
2. 补丁前会自动备份,可随时回滚
打补丁时,工具会把 Wand 的app.asar备份为app.asar.backup(对应的app.asar.unpacked目录也有备份)。这意味着即使补丁出问题,你也能恢复原始文件,不会把客户端搞坏。
3. 只运行你自己构建的二进制
项目明确表示:无法验证、也不支持第三方构建的版本。最稳妥的做法,就是按下面关卡 1 的方式,从你自己的 fork 里构建。
关卡 1:从源码构建你自己的可执行文件
这是整个流程里最"技术"的一步,但其实全程点鼠标即可完成,完全不需要写代码。
方式 A:用仓库自带的 Actions 流水线(推荐,无需本地环境)
- 登录代码托管平台,把
Wand-Enhancer仓库 fork 到你的账号下; - 打开你 fork 后的仓库,进入Actions标签页(如果平台询问,先启用工作流);
- 选择名为Build executable的工作流;
- 点击Run workflow,保持默认分支,启动构建;
- 等流水线跑完,进入本次运行记录,下载构建产物(artifact);
- 解压压缩包,你会得到一个
WandEnhancer.exe——这就是属于你自己的、可审计的版本。
方式 B:本地构建(适合想折腾源码的玩家)
如果你更愿意在本地编译,仓库根目录的build.cmd一条命令就能完成全部构建。它内部会自动安装面板依赖、编译前端、用 CMake 编译原生辅助模块、还原 NuGet 包并构建 WPF 解决方案。本地环境需要准备:
- CMake
- Node.js 与 pnpm
- Visual Studio 2022(或带 MSBuild 的 Build Tools),并勾选"使用 C++ 的桌面开发"工作负载
- .NET Framework 4.8 桌面开发工具
克隆命令:
git clone https://gitcode.com/GitHub_Trending/we/Wand-Enhancer关卡 2:首次启动与安装路径检测
双击WandEnhancer.exe,你会看到一个深色主题的简洁窗口。它做的第一件事,就是自动扫描并定位本机的 WeMod 安装目录。
界面上有两个关键的状态提示值得读懂:
- 绿色提示框
[SUCCESS] WeMod directory found at ...:说明已自动找到 WeMod 目录,可以继续; - 白色提示框
[INFO] Ready for patching.:说明工具已就绪,等待你点击 Patch 按钮。
如果自动检测失败怎么办?手动指定安装目录即可。WeMod 通常安装在:
C:\Users\你的用户名\AppData\Local\WeMod\app-版本号把路径填进Folder path输入框,工具会再次校验路径有效性(补丁配置类 WandEnhancer/Models/PatchConfig.cs 在设置路径时会做合法性检查,路径无效会直接报错)。
关卡 3:勾选你想要的增强项并执行补丁
点击 Patch 后,会弹出补丁选项窗口(对应源码 WandEnhancer/View/Popups/PatchVectorsPopup.xaml)。这里的每一项都是一个可独立开关的"补丁向量",你可以按需勾选:
| 补丁项 | 作用 | 建议 |
|---|---|---|
| ActivatePro | 激活客户端 Pro 相关本地特性 | 大多数用户的核心诉求 |
| DisableUpdates | 停用客户端更新,避免补丁被新版本覆盖 | 追求稳定可选 |
| DisableTelemetry | 关闭遥测上报,减少无谓的网络行为 | 注重隐私必选 |
| DevToolsOnF12 | 按 F12 直接打开开发者工具 | 折腾脚本时很好用 |
| RemoteWebPanelPreview | 注入远程面板桥接模块 | 想用手机控制必选 |
此外,补丁配置还支持AutoApplyPatches(自动应用补丁)选项,开启后下次运行可减少重复操作。
点击确认后,工具会读取 Wand 的app.asar包,替换关键逻辑并写入补丁。全部修改都在本地完成,全程没有任何网络请求。补丁完成后重启 WeMod 客户端即可生效。
想深入理解补丁逻辑的读者,可以阅读核心引擎 WandEnhancer/Core/Enhancer.cs:它基于 AsarSharp 解析包结构,先备份再逐项应用补丁,并对文件内容做多重校验。
关卡 4:把手机变成你的第二块屏幕
这是 Wand-Enhancer 最让人惊喜的功能——Remote Web Panel 手机远程控制面板。配合"RemoteWebPanelPreview"补丁,你可以在手机上直接操作 Wand 里的模组开关、数值滑块,甚至远程调整游戏参数。
连接只需三步:
- 确保电脑和手机连接同一个 Wi-Fi;
- 在 WandEnhancer 顶栏悬停 Connect 按钮,界面会显示一个二维码;
- 用手机相机扫码,即可在浏览器里打开控制面板。
这个面板以卡片式布局展示各类模组:可以开关 Super Speed、Fly Mode 这类物理功能,拖动滑块微调重力、跳跃高度等数值,还能给常用模组打星标收藏,体验相当流畅。
连接不上?按这个顺序排查:
- 确认在同一局域网:部分路由器的访客网络会开启"AP 隔离",同一 Wi-Fi 下的设备互相访问被阻断,换成主网络再试;
- 检查 Windows 防火墙:需要放行 TCP 端口
3223的入站流量(仅限本地网络); - 切换网络类型:如果 Windows 把你的连接标记为"公用",改成"专用"通常能解决;
- 跨网络使用:如果你在外网(4G/5G)也想访问,可以搭配 Tailscale 之类的虚拟组网工具,把手机和电脑拉进同一个虚拟局域网。
关卡 5:注入你自己的脚本(进阶玩法)
如果你懂一点前端知识,Wand-Enhancer 还留了一个相当开放的入口:自定义脚本注入。你可以在打补丁时把.js文件一起打进去,脚本会运行在 Wand 的渲染进程里,拥有完整的 DOM 访问权限和 Node 的require能力。
添加脚本有两种方式:
- 在补丁对话框中直接添加一个或多个
.js文件(只接受已存在的.js文件); - 把
.js文件放进与可执行文件同目录的renderer-scripts/文件夹里。
项目还内置了三个小工具:WandEnhancer.log(...)用于输出日志、WandEnhancer.remoteUrl获取远程面板地址、WandEnhancer.apiVersion读取 API 版本。一个最小示例:
if (!globalThis.__helloScriptInstalled) { globalThis.__helloScriptInstalled = true; WandEnhancer.log("Hello from my custom script!", WandEnhancer.remoteUrl); new MutationObserver(() => { const dialog = document.querySelector("ux-dialog:not([data-seen])"); if (dialog) { dialog.setAttribute("data-seen", "1"); WandEnhancer.log("A dialog opened."); } }).observe(document.documentElement, { childList: true, subtree: true }); }两个经验之谈:
- 脚本每次启动可能执行不止一次(加载时和稍后各一次),一次性逻辑记得用全局标志守卫,就像上面的
__helloScriptInstalled; - 脚本出错不会拖垮 Wand:它被包裹在安全外壳里,抛出的异常只会被记录而不会导致客户端崩溃。
安全提醒:注入脚本拥有与 Wand 客户端相同的权限,请只运行你信任、能看懂的代码。
常见问题速查清单
| 问题 | 原因 | 解决办法 |
|---|---|---|
| 找不到可下载的 exe | 官方刻意不发布安装包 | 按关卡 1 用 Actions 自己构建 |
| Windows 提示未知发布者 | 产物未签名且来源少见 | 核对是你自己 fork 构建的产物后再运行 |
| 手机打开面板显示空白 | 网络隔离或端口未放行 | 参考关卡 4 的排查顺序 |
| WeMod 更新后增强失效 | 客户端文件结构变化 | 用备份恢复后,对最新版本重新打补丁 |
| 想用别人编译好的版本 | 来源不可控 | 不建议,项目无法验证第三方构建 |
现在,轮到你了
回顾一下这趟旅程:你先是了解了一个典型玩家每天都会遇到的痛点,认识了 Wand-Enhancer 的六项核心能力;接着完成了三条安全须知的学习,然后依次闯过五个关卡——构建自己的可执行文件、完成目录检测、勾选补丁项、连接手机远程面板、尝试自定义脚本。
如果你已经跃跃欲试,下一步只需三步:
- fork 仓库并触发 Build executable 流水线,拿到属于自己的
WandEnhancer.exe; - 运行工具、确认目录检测成功,勾选你需要的补丁项并执行;
- 重启 WeMod 验证效果,再花一分钟用手机扫码体验远程面板。
需要说明的是,本项目是第三方增强工具,仅用于教育、研究与本地互操作性目的,所有修改都在本地完成,用于自定义客户端界面与功能,不涉及任何云端绕过。请遵守 Wand 官方的服务条款,合理使用。
如果你在折腾过程中发现了新的玩法,欢迎把经验分享回社区——无论是问题反馈、文档翻译还是代码贡献,这个开源项目一直对所有人敞开大门。祝你玩得开心,调参愉快!
【免费下载链接】Wand-EnhancerAdvanced UX and interoperability extension for Wand (WeMod) app项目地址: https://gitcode.com/GitHub_Trending/we/Wand-Enhancer
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考