如果你经常使用 Wand(WeMod) ,又希望对客户端的界面、布局、主题以及部分本地功能进行扩展,那么 k1tbyte/Wand-Enhancer 是一个比较有意思的开源项目。
它并不是传统意义上的 Web 服务,而是一个面向 Windows 桌面端 Wand 客户端的本地增强工具 。项目主要使用 C# / .NET 构建,同时包含一个可选的 Remote Web Panel,可以通过手机浏览器在局域网或 VPN 环境中控制 Wand。(github.com)
先说明一点:这个项目不能像普通 PHP/Node 项目一样"部署到云服务器后直接运行"。 核心补丁器需要修改 Windows 本机的 Wand 安装,所以真正适合服务器的部分主要是源码构建、CI/CD、代码托管和远程开发环境 。Remote Web Panel 则可以利用网络环境进行远程访问,但官方明确不建议直接暴露到公网。(github.com)
一、Wand-Enhancer 是什么?
简单理解:

Wand / WeMod
↓
本地客户端
↓
Wand-Enhancer
↓
本地修改 / 功能增强
↓
增强后的 Wand
官方将项目定义为:
Advanced UX and interoperability extension for Wand (WeMod)。
目前主要功能包括:
- 本地环境配置管理
- 新版本兼容性调整
- 布局与主题自定义
- AI Features
- Remote Web Panel
- 自定义 JavaScript
- 移动端远程控制
二、它不是一个普通的"服务器软件"
这一点非常关键。
很多 GitHub 项目都可以:
GitHub
↓
Linux VPS
↓
Docker
↓
Web
但是 Wand-Enhancer 不一样。
它需要:
Windows
↓
Wand 安装目录
↓
本地补丁
↓
Wand Electron Client
所以如果你直接把它部署到:
Ubuntu
Debian
Rocky Linux
服务器上,并不能得到一个可以正常使用的 Wand 客户端。
官方目前的构建要求也是围绕 Windows + Visual Studio / .NET 来设计的。(github.com)
三、那为什么还可以使用云服务器?
云服务器比较适合放在:
开发环境
而不是:
最终运行环境
例如:
莱卡云
│
┌───────┴────────┐
↓ ↓
Git Repo CI / Build
│ │
└───────┬────────┘
↓
Build Artifact
│
↓
Windows PC
│
Wand-Enhancer
│
↓
Wand
也就是说:
服务器负责开发、构建和保存代码,Windows 电脑负责最终运行。
四、官方目前不提供预编译 EXE
这是这个项目非常重要的一点。
项目 README 明确警告:
官方 GitHub Releases 不提供
.exe文件。
目前 Release 主要发布:
Release Notes
用户需要:
Fork
↓
Sync fork
↓
GitHub Actions
↓
Build executable
↓
下载 Artifact
然后在自己的 Windows 环境运行。(github.com)
所以网上看到:
WandEnhancer.exe
并不应该直接认为就是官方版本。
项目作者甚至特别提醒,有人利用 YouTube 教程、第三方网站散布恶意程序。(github.com)
五、目前最新版本已经到了 2.0.0.0
当前 GitHub Release 页面显示:
2.0.0.0 是最新正式版本,发布时间为 2026 年 9 月 5 日。 (github.com)
这一版本有比较大的架构调整:
旧版本
version.dll
↓
新版本
Launcher
↓
启动 Wand
↓
应用补丁
↓
Wand 子进程
官方说明:
- 移除了 bundled
version.dllproxy; - 移除了 native helper;
- 不再需要 CMake;
- 不再需要 Visual Studio C++ workload;
- WandEnhancer 现在作为 Wand launcher entry point;
- 启动 Wand 时自动进入增强流程。
所以网上很多针对 1.0.x 的教程,现在可能已经过时。
六、现在构建反而简单了一些
早期版本需要:
CMake
Node.js
pnpm
Visual Studio
C++
.NET Framework
而 2.0.0.0 已经移除了:
CMake
Visual Studio C++ workload
官方 Release 明确说明 native helper 和 CMake build step 已经删除。(github.com)
当前构建环境主要还是:
Windows
Node.js
pnpm
Visual Studio / MSBuild
.NET Framework 4.8
七、源码构建流程
官方 README 给出的基本流程是:
git clone https://github.com/k1tbyte/Wand-Enhancer.git
然后:
打开 Wand-Enhancer.sln
↓
Visual Studio / Rider
↓
Restore NuGet
↓
Build
或者直接运行:
build.cmd
项目提供:
build.cmd
build.ps1
build.sh
等构建脚本。(github.com)
八、如果用服务器做开发环境
这里可以采用:
莱卡云 VPS
│
├── Git
├── Node.js
├── pnpm
├── 项目源码
└── CI
然后:
本地 Windows
│
│ SSH / Git
↓
莱卡云
│
↓
GitHub
│
↓
Windows Build Runner
│
↓
Artifact
不过需要注意:
Linux VPS 本身不能直接完成完整的 Windows WPF/.NET Framework 构建。
因此不要把普通 Ubuntu VPS 当成完整构建机。
九、更合理的是"Linux VPS + GitHub Actions"
这个项目官方本身就推荐:
GitHub Fork
↓
GitHub Actions
↓
Build executable
所以比较合理的架构是:
莱卡云
│
↓
代码开发 / Git
│
↓
GitHub
│
↓
GitHub Actions Windows Runner
│
↓
WandEnhancer Artifact
│
↓
你的 Windows 电脑
这样实际上比购买一台 Windows 云服务器更加方便。
十、如果一定要 Windows 云服务器
也可以:
Windows Server
↓
Visual Studio Build Tools
↓
MSBuild
↓
Node.js
↓
pnpm
↓
Wand-Enhancer
但这种情况下需要确认:
Windows Server
.NET Framework 4.8
MSBuild
Desktop Build Tools
是否都能够正常安装。
因此:
Linux 云服务器 → 适合源码管理、开发、辅助服务
Windows 云服务器 → 才适合完整 Windows 构建
十一、Remote Web Panel 才是服务器网络比较有价值的部分
Wand-Enhancer 有一个:
Remote Web Panel
可以:
手机
↓
浏览器
↓
Remote Web Panel
↓
WandEnhancer
↓
Wand
官方 Quick Start 的方式是:
PC
+
手机
↓
同一个 Wi-Fi
↓
WandEnhancer
↓
扫描 QR Code
默认 Remote Panel 使用:
TCP 3223
并通过 HTTP/WebSocket 提供服务。(github.com)
十二、Remote Web Panel 的原理
大概是:
手机
│
Browser
│
HTTP/WS
│
↓
Windows PC :3223
│
WandEnhancer
│
↓
Wand
所以它不是:
手机
↓
云服务器
↓
Wand
而是:
手机
↓
Windows PC
↓
WandEnhancer
↓
Wand
十三、如果手机不在同一个网络怎么办?
官方 README 给出的解决方式是:
Tailscale
或者类似 VPN。
架构:
手机
│
│ VPN
↓
Tailscale
│
↓
Windows PC
│
:3223
↓
WandEnhancer
这样即使:
手机
=
5G
而:
电脑
=
家庭宽带
也可以建立连接。
官方明确推荐使用 Tailscale 或类似 VPN 来实现不同网络之间的 Remote Panel 访问。(github.com)
十四、为什么不建议直接把 3223 暴露到公网?
因为官方 README 已经明确警告:
HTTP
+
3223
+
No pairing code
也就是说,只要一个人能够访问:
你的公网 IP:3223
就可能看到面板并控制当前 trainer。
因此官方明确要求:
只在可信 LAN / VPN 环境使用,绝不要直接暴露到 Internet。 (github.com)
这一点非常重要。
十五、所以莱卡云更适合做 VPN 中转基础设施
如果你确实需要远程访问,可以采用:
手机
│
│ Tailscale
↓
莱卡云 / 网络节点
│
↓
Windows PC
│
:3223
↓
WandEnhancer
不过如果 Windows PC 和手机都可以直接加入 Tailscale,那么其实不需要 VPS 做中转。
只有在:
复杂 NAT
企业网络
无法安装 Tailscale
自定义网络架构
等情况下,服务器才可能承担额外的网络角色。
十六、WandEnhancer 还支持自定义 JS
这是项目比较强大的功能之一。
可以把:
*.js
注入 Wand 的 renderer。
例如:
renderer-scripts/
│
├── ui.js
├── theme.js
└── custom.js
然后:
WandEnhancer
↓
Patch
↓
JS
↓
Wand Renderer
官方说明这些脚本拥有:
DOM access
+
Node require
权限。(github.com)
十七、自定义脚本权限很高
官方特别提醒:
Scripts run with the same privileges as the Wand client.
也就是说不要随便安装:
GitHub
↓
陌生 JS
↓
复制进去
因为这些脚本运行在 Wand renderer 环境中,并具有较高权限。(github.com)
正确方式:
源码
↓
阅读
↓
确认逻辑
↓
测试
↓
再注入
十八、可以把自定义脚本放进服务器 Git 仓库
如果你经常维护自己的 Wand UI:
莱卡云
│
└── wand-scripts/
│
├── theme.js
├── layout.js
└── ui.js
然后:
Git
↓
版本管理
↓
Windows
↓
同步
↓
WandEnhancer
这样可以保存:
v1
v2
v3
而不是修改以后没有备份。
十九、特别适合做自己的主题
例如:
Wand
↓
WandEnhancer
↓
Custom JS
↓
CSS
↓
Theme
可以调整:
背景
颜色
布局
按钮
字体
卡片
间距
所以如果你本身比较喜欢研究桌面 UI,这个项目的扩展性还是不错的。
二十、但是要注意客户端更新
Wand 是 Electron 应用。
客户端更新以后:
Wand vX
↓
内部结构变化
↓
原来的 patch
↓
可能失效
这也是为什么项目一直需要做:
Compatibility
Adjustments
官方最近的 1.0.9.3 就修复了新 Wand 构建导致 Remote Web Panel 不再正常工作的问题,并改成动态解析内部名称。(github.com)
所以:
Wand 更新 ≠ WandEnhancer 一定立即兼容。
二十一、2.0.0.0 正好解决了一些启动问题
当前 2.0.0.0 的重要改动就是:
version.dll proxy
↓
删除
改成:
Wand Launcher
↓
启动
↓
Patch
↓
Electron children
官方表示这个调整解决了部分增强后 Wand 无法启动的问题。(github.com)
所以如果你准备研究源码:
建议直接以 2.0.0.0 的代码和文档为准。
二十二、服务器上可以做什么?
如果按照"莱卡云 + WandEnhancer"来设计,我建议服务器主要承担:
1. Git
源码
↓
Git
↓
版本控制
2. 开发环境
VSCode / SSH
↓
修改 JS / 配置
3. 自动化
Git Push
↓
CI
↓
Windows Build
4. 文件存储
Scripts
Themes
Configs
Documentation
而:
Wand
WandEnhancer
依然运行在 Windows 客户端。
二十三、推荐一个比较合理的架构
GitHub
│
Actions CI
│
↓
Windows Build
│
Artifact
│
↓
┌──────────────┐
│ Windows PC │
│ │
│ Wand │
│ ↑ │
│ Enhancer │
└──────┬───────┘
│
Tailscale
│
┌────────┴────────┐
↓ ↓
手机 莱卡云
其中:
莱卡云
=
开发 / Git / 辅助网络节点
而:
Windows PC
=
真正运行 WandEnhancer
这是比"直接在 VPS 上部署 WandEnhancer"合理得多的方案。
二十四、服务器配置不用高
如果莱卡云只是:
Git
+
Node.js
+
脚本
+
开发环境
+
小型辅助服务
那么:
2 vCPU
2~4GB RAM
40GB SSD
基本足够。
如果还运行:
Docker
CI Runner
多个项目
可以考虑:
4 vCPU
8GB RAM
80GB SSD
但 WandEnhancer 本身不需要 GPU 云服务器。
二十五、如果主要做源码开发
可以:
莱卡云
│
├── Git
├── Node.js
├── pnpm
├── Wand-Enhancer
├── renderer-scripts
└── themes
然后本地:
Windows
↓
Git Pull
↓
Visual Studio
↓
Build
↓
Test
服务器和 Windows 工作站各自负责自己擅长的事情。
二十六、如果主要想远程控制 Wand
建议:
Windows PC
│
├── Wand
├── WandEnhancer
└── Remote Web Panel :3223
│
↓
Tailscale
│
↓
手机
不要:
Internet
↓
公网 IP:3223
↓
WandEnhancer
因为官方已经明确说明 Remote Panel 没有 pairing code,而且可以控制当前 trainer。(github.com)
二十七、如果确实需要跨网络
可以:
手机
│
Tailscale
│
↓
Windows PC
│
3223
│
↓
WandEnhancer
如果你的网络结构比较复杂,再考虑:
手机
↓
Tailscale
↓
莱卡云
↓
网络中转
↓
Windows PC
但能 P2P 就尽量 P2P,不需要为了一个 3223 端口额外增加复杂的网络层。
二十八、还有一个非常重要的安全问题
项目本身会修改:
Wand
本地安装文件,而且还涉及 Electron renderer 注入。
因此建议:
源码
↓
自己编译
↓
自己检查
↓
自己运行
而不是:
YouTube
↓
"WandEnhancer 最新版"
↓
.exe
↓
直接运行
官方 README 已经明确提醒存在冒充项目名称传播恶意程序的情况。(github.com)
二十九、项目许可证也要看清楚
当前 GitHub 仓库显示:
Apache-2.0。 (github.com)
因此如果你:
Fork
↓
修改
↓
重新发布
建议按照 Apache-2.0 的要求处理:
License
NOTICE
Copyright
等事项。
三十、如果想做自己的版本
其实可以:
k1tbyte/Wand-Enhancer
↓
Fork
↓
自己的 GitHub
↓
修改
↓
GitHub Actions
↓
自己的 Build
然后:
Windows
↓
下载自己构建的 Artifact
↓
测试
这种方式也符合项目官方当前推荐的构建方式。(github.com)
三十一、最终推荐的服务器方案
如果你就是想把这个项目和莱卡云结合起来,我建议不要写成:
"莱卡云服务器运行 WandEnhancer"
而是采用更加实际的:
莱卡云
│
┌─────────┼─────────┐
↓ ↓ ↓
Git Dev Scripts
│
↓
GitHub
│
↓
Windows Actions
│
↓
Build Artifact
│
↓
Windows PC
│
┌────┴────┐
↓ ↓
Wand WandEnhancer
│
Remote Panel
│
Tailscale
│
↓
手机
这样整个架构就比较顺畅。
三十二、如果只是个人使用
最简单:
Windows 11
│
├── Wand
└── WandEnhancer
│
Remote Panel
│
Tailscale
│
手机
莱卡云只作为:
Git / 开发 / 备份
即可。
三十三、如果是开发者
推荐:
莱卡云
↓
Git
↓
源码
↓
GitHub
↓
Actions
↓
Windows Build
↓
Artifact
↓
本地测试
这样甚至不需要购买 Windows 云服务器。
三十四、如果是团队协作
可以:
GitHub
│
├── Source
├── Issues
├── Releases
└── Actions
│
↓
Windows Build
莱卡云:
CI 辅助
+
脚本
+
文档
+
测试环境
Windows:
最终运行
形成比较清晰的职责划分。
总结
k1tbyte/Wand-Enhancer 和前面那些纯 Web / AI 项目不太一样。
它本质是一个:
Wand(WeMod)Windows 客户端本地增强工具。
目前支持:
本地配置管理
版本兼容调整
UI / Theme
AI Features
Remote Web Panel
自定义 JS
并且最新正式版本已经是 2.0.0.0 ,新版移除了 version.dll proxy、native helper 和 CMake 构建要求,并改用 launcher 方式应用补丁。(github.com)
因此如果你想搭建它,不要把它当成普通的 Linux VPS Web 项目。