k1tbyte/Wand-Enhancer

一款开源的互操作性工具，旨在扩展本地客户端配置并改善 Wand 应用的 UX。

## 👾 使用安全吗？ 是的。本项目完全开源，任何人都可以审计代码。它严格在本地运行，不需要互联网访问，也不会发起任何网络请求。它只是通过调整本地客户端设置来增强您的用户体验。 ## 💫 改进了哪些功能？ ✅ 本地环境配置管理
✅ 针对新客户端版本的自动兼容性调整
✅ 高级布局和主题自定义（仅限客户端）
✅ AI 功能
✅ 远程 Web 面板（移动端远程连接）
## 🌐 远程 Web 面板 WandEnhancer 包含一个内置的**远程 Web 面板**，允许您直接通过手机控制应用功能。 ### 快速开始： 1. 确保您的 PC 和手机连接在**同一个 Wi-Fi 网络**下。 2. 将鼠标悬停在 WandEnhancer 顶部栏的 **Connect** 按钮上。 3. 使用手机相机扫描显示的**二维码**。 ### 故障排除与远程访问： - **页面无法加载？** 首先，确保您的 PC 和手机连接到**同一个本地网络**。部分路由器和访客 Wi-Fi 网络会启用客户端隔离/AP 隔离，这会阻止同一 SSID 下的设备互相访问。如果仍然无法加载，请检查 Windows 防火墙，并允许本地网络在 TCP 端口 `3223` 上的入站流量。如果 Windows 将您的连接标记为**公用**，将其切换为**专用**也会有所帮助。 - **使用移动数据或不同的网络？** 如果您想通过移动数据（LTE/5G）或从完全不同的网络使用该面板，可以使用 [Tailscale](https://tailscale.com/) 或类似的 VPN 工具。 ## 👀 如何使用？ 本仓库不发布官方编译的二进制文件。请使用 GitHub Actions 从您自己的 fork 构建可执行文件。 1. 登录 GitHub 并 fork 本仓库。 2. 打开您的 fork，转到 **Actions** 标签页，如果 GitHub 提示，请启用 workflows。 3. 选择 **Build executable** workflow。 4. 点击 **Run workflow**，保持默认分支，并开始运行。 5. 等待 workflow 完成，打开已完成的运行，并下载 artifact。 6. 解压 artifact zip 文件并运行 `WandEnhancer.exe` 以应用本地客户端修改。 *操作步骤如下：* https://github.com/user-attachments/assets/7966cabe-0aa6-424d-8c2f-981ad91e0f91 ## 🧩 自定义脚本 您可以在补丁阶段将自己的 JavaScript 注入到 Wand 中，以调整或修复客户端 UI 中的问题。这会复用远程 Web 面板使用的渲染器注入机制，因此需要启用 **Remote Web Panel** 补丁。 **如何添加脚本** - 在补丁对话框中，添加一个或多个 `.js` 文件（仅接受已存在的 `.js` 文件），**或者** - 将 `.js` 文件放入放置在 patcher 可执行文件旁边的 `renderer-scripts/` 文件夹中。 然后像往常一样打补丁——您的脚本将被打包到客户端中，并在 Wand 的窗口内运行。 **运行机制** - 每个脚本都在 Wand 的渲染器中运行（拥有完整的 DOM 访问权限，以及 Node 的 `require`）。 - 它经过了封装，因此抛出的错误会被记录下来，且永远不会导致 Wand 崩溃。 - 它可能在每次启动时运行**不止一次**（在加载时和稍后不久再次运行），因此请使用全局标志来保护只需执行一次的操作。 - 提供了一个小型的 `WandEnhancer` 辅助程序：`WandEnhancer.log(...)`、`WandEnhancer.remoteUrl`、`WandEnhancer.apiVersion`。 **简单示例** (`hello.js`) ``` // Injected scripts can run multiple times — guard one-time setup. 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 }); } ``` ## 🛠️ 如何从源码构建 在 Windows 上从源码构建需要本地开发环境。 ### 环境要求 - `CMake` - `Node.js` 和 `pnpm` - `Visual Studio 2022` 或带有 `MSBuild` 的 `Build Tools for Visual Studio 2022` - Visual Studio 的 `Desktop development with C++` 工作负载 - .NET Framework 4.8 桌面生成工具 / 目标包 ### 构建步骤 1. 克隆本仓库。 2. 安装上述要求，并确保 `cmake`、`pnpm` 和 `MSBuild` 可用。 3. 在命令提示符或 PowerShell 中运行 `build.cmd`。 构建脚本将安装 Web 面板依赖项，构建前端，使用 CMake 编译原生辅助程序，还原 NuGet 包，并构建 WPF 解决方案。 ## ❓ 问答 - **为什么 GitHub Releases 中没有 `.exe` 文件？** - 官方发布有意仅包含说明。该项目不再分发预编译的可执行文件，因为未签名或自行构建的补丁工具经常被重新上传、错误标记并被第三方扫描软件标记。请改用 GitHub Actions 从您自己的 fork 构建可执行文件。 - **我在哪里可以下载可执行文件？** - 在运行 **Build executable** workflow 后，从您自己 fork 的 **Actions** artifact 中下载。请勿从 YouTube 视频简介、随机镜像站、Discord 附件或 issue 评论中下载 `.exe` 文件。 - **为什么 Windows Defender 或 SmartScreen 会对我的构建发出警告？** - GitHub Actions 的 artifact 是未签名的且不常见的，因此即使代码是直接从您的 fork 构建的，Windows 也可能会发出警告。请审查源代码，验证 workflow 日志，并且仅运行您自己构建的二进制文件。 - **我可以使用其他人构建的二进制文件吗？** - 可以，但您应将其视为不受信任的。本仓库无法验证或支持第三方构建版本。 - **这会将数据发送到任何地方吗？** - 桌面端打补丁的工作完全在您的机器上本地进行。远程 Web 面板由您的 PC 在您的本地网络上提供。 ## 🖼️ 截图  ## 📜 许可证 本项目基于 Apache-2.0 协议授权 - 详情请参阅 [LICENSE](LICENSE.md) 文件。

标签：Bash脚本, macOS, MITM代理, Web面板, 互操作性, 客户端增强, 数据可视化, 本地配置, 游戏辅助, 用户体验