Wand-Enhancer —— WeMod 应用的高级用户体验与互操作性增强扩展

这是什么

k1tbyte/Wand-Enhancer 是一个面向 Wand 客户端的开源扩展工具，主语言为 C#，在 GitHub 上已收获约 6566 颗星。它不提供官方预编译的可执行文件，所有功能通过本地配置修改和脚本注入实现，完全在用户本地运行，无需联网，也不发送任何网络请求。项目定位为“互操作性工具”，旨在增强 Wand 应用的本地端用户体验，并允许用户通过远程网页面板在手机上操控部分功能。

⚠️ 重要安全提示：官方 GitHub 仓库不发布任何 .exe 文件，所有 Releases 仅包含发行说明。网络上存在冒充该项目的诈骗视频，在描述中放置恶意软件。用户必须从自己 Fork 的仓库中通过 GitHub Actions 构建二进制文件，或从源码自行编译。

解决的问题

Wand 客户端本身可能在某些场景下存在体验短板，例如：新版本配置不兼容、界面布局无法满足个人偏好、缺少本地化的脚本扩展机制、无法在移动设备上便捷地控制桌面端功能。Wand-Enhancer 通过以下方式解决这些问题：

• 消除安全风险：通过完全开源、本地执行、无网络请求的设计，让用户能够审计代码并自行构建，避免第三方预编译包可能携带的恶意代码。
• 绕过官方限制：Wand 客户端本身可能不支持深度的界面定制或脚本注入，本项目通过补丁机制注入 JavaScript，使开发者能修改 UI 行为、监听事件、修复 Bug。
• 填补移动端控制空白：内置远程网页面板，让手机可以连接桌面端 Wand，实现跨设备操作，无需依赖云端服务。
• 自动化适配：当 Wand 发布新版本时，自动调整本地配置以保证兼容性，减少手动修复的麻烦。

核心功能

1. 本地环境配置管理
   修改 Wand 的本地客户端设置（如路径、缓存、权限等），并提供版本兼容性自动调整。

2. 布局与主题定制（客户端侧）
   通过注入 CSS/JS 或直接修改客户端配置文件，改变界面布局、颜色、字体等，所有修改仅影响本地。

3. AI 功能
   具体描述未在 README 中展开，但项目明确列出“AI Features”作为功能之一，推测可能通过脚本注入或调用本地 AI 模型实现（需用户自行探索）。

4. 远程网页面板（Remote Web Panel）
   桌面端开启一个本地 HTTP 服务（端口 3223），在同一个局域网内，手机扫描桌面端显示的二维码即可访问控制面板。支持通过 Tailscale 等 VPN 实现跨网络访问。

5. 自定义 JavaScript 注入
   用户可以在补丁过程中注入一个或多个 .js 文件，这些脚本会运行在 Wand 的渲染进程中，拥有完整的 DOM 访问权限和 Node.js require 能力。脚本被安全包裹，不会导致客户端崩溃，并提供了 WandEnhancer.log()、WandEnhancer.remoteUrl、WandEnhancer.apiVersion 等辅助接口。

6. 自动化构建与集成
   提供 GitHub Actions workflow，用户 Fork 后一键运行即可生成二进制文件；同时支持本地开发环境构建（依赖 CMake、Node.js、pnpm、Visual Studio 2022 或 Build Tools + .NET Framework 4.8）。

亮点 / 与同类相比

• 零网络依赖，完全本地化：同类工具往往需要云端中转或向外部发送数据，而 Wand-Enhancer 所有操作都在本地完成，远程面板也仅在局域网内自建服务，隐私保护更彻底。
• 安全审计友好：项目明确拒绝分发预编译二进制，强制用户自行构建，虽然增加了上手门槛，但杜绝了第三方篡改的风险。这一点在开源工具中较为罕见，但有效打击了恶意重打包行为。
• 灵活的自定义脚本框架：与 Wand 客户端的深度集成能力（渲染进程内执行 JS、支持 MutationObserver、全局标志防重复执行）相比许多只能改配置的同类工具，提供了更大的扩展空间。
• 跨设备控制面板：通过 QR 码连接，无需配对或登录账号，移动端可直接操控桌面端功能，体验接近原生应用内嵌的远程控制。
• 主动安全警示：项目在 README 开头用醒目警告提示无官方视频、无预编译 exe，并提供了防诈骗指南，这在开源项目中并不多见，体现了对用户安全的负责态度。

适合谁用 / 上手

目标用户：

• Wand 客户端用户，希望自定义界面主题、布局或注入额外功能。
• 开发者或技术爱好者，愿意通过自己构建二进制文件来确保安全。
• 移动办公场景下需要从手机控制桌面的用户（需维护在同一局域网或 VPN）。
• 对开源审计有要求、不希望客户端“联网”的用户。

上手步骤（推荐方式：使用 GitHub Actions 构建）：

1. Fork 仓库：登录 GitHub，Fork k1tbyte/Wand-Enhancer。
2. 启用 Actions：在 Fork 的仓库中进入 Actions 标签页，启用 workflows。
3. 运行构建：选择 Build executable workflow，点击 Run workflow（保持默认分支），等待完成。
4. 下载产物：进入完成的任务，下载 artifact（zip 包），解压得到 WandEnhancer.exe。
5. 执行补丁：运行 WandEnhancer.exe，它会自动应用本地客户端修改。如需注入自定义脚本，可将 .js 文件放在 renderer-scripts/ 目录下，或通过补丁对话框添加。

替代方式（本地开发环境）：在 Windows 上安装 CMake、Node.js、pnpm、Visual Studio 2022（含 C++ 桌面开发工作负载和 .NET Framework 4.8 目标包），克隆仓库后运行 build.cmd。

注意：如果使用他人构建的二进制（包括从第三方下载），请视为不可信，本项目不对此类使用方式提供支持也不承担安全责任。