Wand-Enhancer：如何搭建一套远程开发与测试环境

k1tbyte/Wand-Enhancer 是一个针对 Wand 客户端的本地增强项目，主要涉及客户端兼容调整、界面与主题、自定义脚本，以及 Remote Web Panel 等功能。项目本身采用 Apache-2.0 许可证。

如果准备自己研究或维护这个项目，更合理的方式不是把 Wand-Enhancer 直接部署到 Linux 云服务器运行，而是把云服务器作为代码、开发和协作环境，Windows 环境负责最终构建与运行。

一、项目适合什么环境？

Wand-Enhancer 的核心运行方式是：

复制代码

Windows PC
   │
   ├── Wand
   │
   └── Wand-Enhancer
          │
          ├── Client Patch
          ├── Theme
          ├── Custom JS
          └── Remote Web Panel

项目源码本身是 Windows/.NET 方向，官方构建流程涉及 Visual Studio、MSBuild、Node.js、pnpm 等。

所以：

Linux VPS ≠ WandEnhancer 最终运行环境。

但 Linux VPS 很适合承担：

复制代码

Git
源码管理
开发环境
脚本
备份
CI 辅助
远程开发

二、比较推荐的整体架构

可以采用：

复制代码

                 GitHub
                    │
                    │
             ┌──────┴──────┐
             ↓             ↓
        莱卡云 Linux     Windows PC
             │             │
          Git/SSH          │
             │             ↓
             │       Visual Studio
             │             │
             │             ↓
             │       Wand-Enhancer
             │             │
             │             ↓
             │           Wand
             │
             └────源码同步────┘

这样服务器主要承担开发基础设施，而不会强行让 Linux 去运行 Windows 桌面程序。

三、项目现在的构建方式

目前仓库的构建脚本是：

复制代码

build.cmd
build.ps1

其中 build.cmd 最终调用：

复制代码

build.ps1

而 build.ps1 会依次处理：

复制代码

web-panel dependencies
        ↓
web-panel build
        ↓
native component
        ↓
NuGet restore
        ↓
MSBuild
        ↓
WandEnhancer

当前构建脚本仍然包含 CMake 和 native component 构建步骤，所以如果你看到一些旧文章说"完全不需要 CMake"，要以当前仓库的实际构建脚本为准。

四、Windows 构建环境

建议准备：

复制代码

Windows 10 / 11
Visual Studio 2022
.NET Framework 4.8
Node.js
pnpm
CMake
Git

Visual Studio 需要能够提供：

复制代码

MSBuild
C++ Build Tools
Desktop development
.NET Framework targeting pack

当前 build.ps1 会主动检查：

复制代码

cmake
pnpm
Visual Studio
MSBuild
dumpbin

缺少其中关键组件时会直接终止构建。

五、源码获取

Windows 上：

复制代码

git clone https://github.com/k1tbyte/Wand-Enhancer.git
cd Wand-Enhancer

然后：

复制代码

.\build.cmd

也可以：

复制代码

powershell -ExecutionPolicy Bypass -File .\build.ps1

默认构建配置为：

复制代码

Release

官方当前也是建议从自己的 Fork 通过 GitHub Actions 构建，而不是从第三方网站下载别人编译好的 EXE。

六、为什么不建议直接下载别人提供的 EXE？

项目官方目前不发布官方预编译 EXE。

推荐流程是：

复制代码

GitHub
 ↓
Fork
 ↓
Sync fork
 ↓
Actions
 ↓
Build executable
 ↓
Artifact
 ↓
Windows

原因很简单：

复制代码

别人编译的 EXE
      ↓
你无法确认源码
      ↓
无法确认构建过程
      ↓
无法确认是否被修改

而自己 Fork：

复制代码

源码
 ↓
自己的仓库
 ↓
GitHub Actions
 ↓
构建日志
 ↓
Artifact

可追溯性更好。官方 README 也明确要求用户优先使用自己的 Fork 构建。

七、莱卡云服务器可以放什么？

如果你已经有一台 Linux VPS，可以建立：

复制代码

/opt/wand-enhancer/
│
├── source/
├── scripts/
├── themes/
├── renderer-scripts/
├── docs/
└── backups/

用于保存：

复制代码

源码
自定义 JS
主题
配置
文档
测试记录

例如：

复制代码

cd /opt
git clone https://github.com/k1tbyte/Wand-Enhancer.git

以后：

复制代码

cd /opt/Wand-Enhancer
git pull

即可同步最新源码。

八、如果你经常修改 Custom Scripts

项目支持自定义 .js：

复制代码

renderer-scripts/

例如：

复制代码

renderer-scripts/
├── theme.js
├── layout.js
└── custom-ui.js

构建/打补丁时，这些脚本可以进入 Wand 的 renderer 环境。官方说明自定义脚本运行时拥有与 Wand 客户端相同的权限，因此只应该使用自己审查过的脚本。

这时候服务器就非常适合做：

复制代码

Git
 ↓
renderer-scripts
 ↓
版本控制
 ↓
Windows
 ↓
测试

例如：

复制代码

theme-v1.js
theme-v2.js
theme-v3.js

都可以保留修改记录。

九、Remote Web Panel 是另一个重要功能

Wand-Enhancer 自带：

Remote Web Panel

可以让手机或另一台电脑访问 Wand 的控制面板。

基本结构：

复制代码

手机
 │
 │ HTTP / WebSocket
 ↓
Windows PC
 │
 │ :3223
 ↓
Wand-Enhancer
 │
 ↓
Wand

当前默认 Remote Panel 使用：

复制代码

TCP 3223

官方明确建议手机和电脑首先处于同一个可信局域网。

十、如果人在外面怎么办？

例如：

复制代码

手机
=
5G

电脑
=
家庭宽带

不要直接：

复制代码

公网 IP:3223

官方明确警告 Remote Web Panel 使用普通 HTTP，而且没有 pairing code；任何能够访问该端口的人都可能查看面板并控制当前 trainer。

因此更适合：

复制代码

手机
 │
Tailscale / VPN
 │
 ↓
Windows PC
 │
3223
 ↓
WandEnhancer

十一、这时候莱卡云可以作为网络基础设施

如果你的网络比较复杂，可以：

复制代码

手机
 │
VPN
 │
 ↓
莱卡云
 │
 │ 网络连接
 ↓
Windows PC
 │
3223
 ↓
WandEnhancer

不过如果手机和 Windows PC 本身就可以直接使用 Tailscale：

没有必要强行让莱卡云参与数据转发。

服务器更适合承担：

复制代码

Git
开发
备份
辅助网络

而不是为了一个 Remote Panel 把所有流量都绕到 VPS。

十二、为什么我更建议"云服务器 + Windows 本地"

因为 Wand-Enhancer 的核心任务是：

复制代码

读取 Wand
 ↓
修改本地 app
 ↓
备份
 ↓
Patch
 ↓
启动 Wand

这些操作最终还是发生在 Windows。

而服务器更擅长：

复制代码

Git
SSH
长期运行
文件保存
自动化
CI

所以两边分工：

环境	主要用途
莱卡云 Linux	Git、源码、脚本、备份、远程开发
GitHub	版本控制、Actions
Windows	编译、Patch、运行 Wand
手机	Remote Web Panel

这样最合理。

十三、如果你想做自动构建

可以直接利用 GitHub Actions：

复制代码

修改代码
   ↓
git push
   ↓
GitHub Actions
   ↓
Windows Runner
   ↓
build.cmd
   ↓
Artifact

甚至可以做到：

复制代码

push
 ↓
自动构建
 ↓
自动测试
 ↓
构建产物

当前仓库的 CI 已经包含 Web 回归、类型检查、构建验证等流程。

十四、当前版本的兼容性处理也有变化

当前项目已经加入：

复制代码

Auto-patch after Wand updates

也就是 Wand 更新后，如果之前开启了自动应用补丁，下一次启动时可以重新应用对应 Patch。

另外，当前 Patch Engine 已经从简单的正则匹配逐渐转向结构化定位：

复制代码

旧：
Regex signature

现在：
Structural anchors

这样 Wand 只是重新压缩/混淆代码时，不一定会立即导致 Patch 失效。

十五、2.0.0.0 是一个重要版本

当前仓库的 Changelog 显示：

2.0.0.0 --- 2026-09-05

这一版本进行了比较明显的架构调整，包括：

复制代码

version.dll proxy
        ↓
移除

native helper
        ↓
移除

CMake build step
        ↓
官方 Changelog 表述为移除

并改成：

复制代码

Wand Launcher
      ↓
WandEnhancer
      ↓
Patch
      ↓
Wand Electron Processes

同时增加了更新后自动重新应用 Patch 等功能。

不过需要注意，当前仓库最新构建脚本仍然出现 CMake/native helper 相关步骤 ，因此如果你实际编译遇到 CMake 检查，应以你当前 checkout 的 build.ps1 为准，而不要完全照搬旧版 Changelog 的描述。

十六、日志现在也更加完善

当前版本会记录：

复制代码

launcher.log

其中可以看到：

复制代码

Electron process
renderer
gpu-process
network service
exit code
crash code
patch status

并且会保留：

复制代码

launcher.prev.log

方便判断：

复制代码

Wand 为什么没启动
哪个 Patch 出问题
哪个 Electron 进程失败

这对于排查版本兼容问题很有用。

十七、服务器可以集中保存这些日志

例如：

复制代码

莱卡云
│
└── wand-logs/
      ├── machine-01/
      ├── machine-02/
      └── machine-03/

Windows：

复制代码

launcher.log
     ↓
同步
     ↓
服务器

如果你维护多台测试电脑，这样会非常方便。

不过日志里可能包含环境信息，所以应该控制访问权限，不要直接放在公网 Web 目录。

十八、如果只是一台电脑，不需要复杂服务器

个人使用可以直接：

复制代码

Windows PC
│
├── Wand
├── WandEnhancer
└── Tailscale
      │
      ↓
     手机

莱卡云：

复制代码

Git
+
Backup

就够了。

没必要为了 WandEnhancer 本身额外搭建：

复制代码

数据库
Docker
Redis
Nginx
GPU

十九、如果是开发多个版本

则可以：

复制代码

莱卡云
│
├── branch-main
├── branch-dev
├── branch-ui
└── branch-remote

Windows：

复制代码

main
 ↓
测试

dev
 ↓
测试

ui
 ↓
测试

这样修改 Remote Panel 时不会影响稳定版本。

二十、服务器配置其实不用高

如果莱卡云只是：

复制代码

Git
+
源码
+
JS
+
日志
+
备份

二十一、一个比较完整的实践方案

如果你准备长期维护自己的 Wand-Enhancer 版本，可以：

复制代码

                  GitHub
                     │
              ┌──────┴──────┐
              ↓             ↓
           Source         Actions
              │             │
              │       Windows Runner
              │             │
              │             ↓
              │          Build
              │             │
              │             ↓
              │          Artifact
              │             │
              └──────┬──────┘
                     ↓
                Windows PC
                     │
              ┌──────┴──────┐
              ↓             ↓
             Wand      WandEnhancer
                            │
                      Remote Panel
                            │
                         Tailscale
                            │
                            ↓
                           手机

莱卡云则作为：

复制代码

Git / SSH / Backup / Dev

节点。

二十二、如果你想让服务器参与开发

可以直接：

复制代码

Windows
 ↓
VS Code Remote SSH
 ↓
莱卡云
 ↓
Wand-Enhancer source

修改：

复制代码

web-panel/
renderer-scripts/
docs/

然后：

复制代码

git commit
git push

再通过 Windows Build Runner 构建。

这样你可以把源码长期放在服务器，不需要每次都重新上传压缩包。

二十三、最值得注意的几个坑

① 不要从第三方下载 EXE

官方没有把预编译 EXE 作为普通 Release 下载提供。

② 不要直接开放 3223

Remote Panel 没有 pairing code，官方明确禁止直接暴露公网。

③ 不要随便使用第三方 JS

自定义脚本与 Wand 客户端拥有相同权限。

④ Wand 更新后要检查 Patch

客户端结构变化可能导致 Patch 需要调整。

⑤ 云服务器不要硬跑 Windows GUI

Linux VPS 更适合源码、Git、开发和辅助服务；Wand 本体还是应该放在 Windows 环境。

二十四、最终的推荐部署方式

如果你的目标是研究、修改和长期维护 Wand-Enhancer，我建议直接采用：

复制代码

莱卡云 Linux VPS
│
├── Git
├── Wand-Enhancer Source
├── renderer-scripts
├── Themes
├── Documentation
└── Backup
          │
          ↓
       GitHub
          │
          ↓
    GitHub Actions
          │
          ↓
   Windows Build Runner
          │
          ↓
      Build Artifact
          │
          ↓
     Windows PC
          │
      ┌───┴────┐
      ↓        ↓
     Wand   Enhancer
               │
          Remote Panel
               │
           Tailscale
               │
               ↓
              手机

这种方式的优点是职责清晰、成本低、方便更新：Linux 云服务器不用承担 Windows GUI 程序运行，Windows 只负责真正的 Wand 测试和 Patch，GitHub 负责版本与构建，Remote Panel 则通过可信局域网或 VPN 使用。

如果只是个人测试，2 核 / 2～4GB / 40GB 左右的莱卡云 Linux VPS 就足够承担源码和开发环境；真正需要提高配置的是你放在服务器上的其他业务，而不是 Wand-Enhancer 本身。

目前项目最新 Changelog 已经进入 2.0.0.0，并对启动器、Patch Engine、自动更新后的重新应用、日志以及 Remote Panel 做了较大调整，所以如果准备搭建，建议直接以当前 master 的源码和构建脚本为准，而不要继续使用网上针对 1.0.x 的旧教程。