WandEnhancer：开源互操作性工具，提升Wand应用用户体验！-尧图网络科技

WandEnhancer：开源互操作性工具

WandEnhancer 是一款开源的互操作性工具，旨在扩展本地客户端配置，提升 Wand 应用程序的用户体验。

重要通知

本项目没有官方的 YouTube 教程、指南，也没有预构建的可执行文件供下载。目前没有展示如何安装或使用此工具的官方视频。一些诈骗者利用本项目的名称制作虚假教程，并在视频描述中植入恶意软件或密码窃取程序。官方 GitHub 发布内容仅包含发布说明，没有 .exe 文件。如果你从 YouTube 链接、随机网站或第三方镜像下载了 .exe 文件或压缩包，那并非来自本项目。我们对第三方下载内容不承担责任。

使用安全性

可以放心使用。本项目完全开源，任何人都能审核代码。它严格在本地运行，无需联网，也不会发起任何网络请求，只是调整本地客户端设置来提升用户体验。

功能改进

本地环境配置管理
新客户端版本自动兼容性调整
高级布局和主题定制（仅客户端）
AI 功能
远程 Web 面板（移动设备远程连接）

远程 Web 面板

WandEnhancer 内置了远程 Web 面板，让你能直接通过手机控制应用功能。

快速启动：确保你的电脑和手机连接到同一 Wi-Fi 网络。将鼠标悬停在 WandEnhancer 顶部栏的“连接”按钮上，用手机摄像头扫描显示的二维码。
故障排除与远程访问：如果页面无法加载，首先要确保电脑和手机连接到同一本地网络。部分路由器和访客 Wi-Fi 网络开启了客户端隔离/AP 隔离功能，会阻止同一 SSID 下的设备相互访问。若仍无法加载，可检查 Windows 防火墙，允许本地网络的 TCP 端口 3223 接收入站流量。若 Windows 将你的连接标记为“公共网络”，将其切换为“专用网络”也可能有所帮助。若使用移动数据或不同网络，可使用 Tailscale 或类似的 VPN 工具。

使用方法

本仓库不发布官方编译的二进制文件。你可以使用 GitHub Actions 从自己的分支构建可执行文件。具体步骤如下：

登录 GitHub 并分叉本仓库。
打开你的分支，进入“Actions”选项卡，若 GitHub 提示，需启用工作流。
选择“Build executable”工作流。
点击“Run workflow”，保持默认分支，然后开始运行。
等待工作流完成，打开已完成的运行，下载生成的文件。
解压文件，运行 WandEnhancer.exe 以应用本地客户端修改。

自定义脚本

你可以在打补丁时将自己的 JavaScript 脚本注入 Wand，以调整或修复客户端 UI 中的问题。这与远程 Web 面板使用的渲染器注入方式相同，因此需要启用远程 Web 面板补丁。

添加脚本方法：在补丁对话框中添加一个或多个 .js 文件（仅接受已存在的 .js 文件），或将 .js 文件拖放到补丁程序可执行文件旁边的 renderer-scripts/ 文件夹中。然后像往常一样打补丁，你的脚本将被打包到客户端并在 Wand 窗口内运行。
脚本运行方式：每个脚本在 Wand 的渲染器中运行（拥有完整的 DOM 访问权限，还可使用 Node require）。脚本经过包装，抛出的错误会被记录，且不会导致 Wand 崩溃。每次启动时脚本可能运行多次（加载时和加载后不久），因此要使用全局标志来保护一次性操作。可使用一个小型的 WandEnhancer 辅助工具：WandEnhancer.log(...)、WandEnhancer.remoteUrl、WandEnhancer.apiVersion。

最小示例（hello.js）

javascript// 注入的脚本可能运行多次，使用全局标志保护一次性设置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 });}

脚本与 Wand 客户端具有相同的权限，仅添加你信任且理解的脚本。

从源代码构建

在 Windows 上从源代码构建需要本地开发环境。

要求：CMake、Node.js 和 pnpm、Visual Studio 2022 或 Visual Studio 2022 构建工具（含 MSBuild）、具备 C++ 工作负载的 Visual Studio 桌面开发、.NET Framework 4.8 桌面构建工具/目标包。
构建步骤：克隆本仓库，安装上述要求的工具，确保 cmake、pnpm 和 MSBuild 可用。从命令提示符或 PowerShell 运行 build.cmd。构建脚本会安装 Web 面板依赖项、构建前端、使用 CMake 编译原生辅助工具、恢复 NuGet 包并构建 WPF 解决方案。

常见问题解答

为什么 GitHub Releases 中没有 .exe 文件？官方发布仅包含说明，不再分发预构建的可执行文件。因为未签名或自行构建的补丁工具会被反复重新上传、错误标记，并被第三方扫描程序标记。建议使用 GitHub Actions 从自己的分支构建可执行文件。
在哪里下载可执行文件？运行“Build executable”工作流后，从自己分支的 Actions 生成文件中下载。不要从 YouTube 描述、随机镜像、Discord 附件或问题评论中下载 .exe 文件。
为什么 Windows Defender 或 SmartScreen 会对我的构建发出警告？GitHub Actions 生成的文件未签名且不常见，即使代码直接从你的分支构建，Windows 也可能发出警告。你可以审查源代码，验证工作流日志，仅运行自己构建的二进制文件。
能否使用他人构建的二进制文件？可以，但应将其视为不可信文件。本仓库无法验证或支持第三方构建。
是否会将数据发送到其他地方？桌面补丁工作在本地机器上进行，远程 Web 面板在本地网络的电脑上提供服务。