k1tbyte / Wand-Enhancer

查看原文 / View Original 编辑 / Edit

k1tbyte / Wand-Enhancer

WandEnhancer is an open-source interoperability tool designed to extend local client-side configurations and improve the UX of the Wand application. WandEnhancer 是一款开源互操作性工具，旨在扩展本地客户端配置并改善 Wand 应用程序的用户体验。

🚨 IMPORTANT NOTICE: THIS PROJECT HAS NO OFFICIAL YOUTUBE TUTORIALS, GUIDES, OR PREBUILT EXECUTABLE DOWNLOADS. 🚨 🚨 重要提示：本项目没有任何官方 YouTube 教程、指南或预编译的可执行文件下载。 🚨

There are no official videos showing how to install or use this tool. Scammers are creating fake tutorials using this project’s name and placing malware/password stealers in the video descriptions. Official GitHub releases contain release notes only, not .exe files. If you downloaded an .exe or archive from a YouTube link, a random website, or a third-party mirror, you did not get it from this project. We are not responsible for third-party downloads. 目前没有任何官方视频演示如何安装或使用此工具。诈骗者正在利用本项目名称制作虚假教程，并在视频描述中植入恶意软件或密码窃取程序。官方 GitHub 发布页面仅包含发行说明，不提供 .exe 文件。如果您从 YouTube 链接、随机网站或第三方镜像下载了 .exe 或压缩包，那并非来自本项目。我们不对第三方下载内容负责。

👾 Is it safe to use? Yes. This project is entirely open-source, allowing anyone to audit the code. It operates strictly locally, does not require internet access, and makes zero network requests. It simply adjusts local client settings to enhance your user experience. 👾 使用安全吗？ 是的。本项目完全开源，允许任何人审计代码。它严格在本地运行，不需要互联网访问，且不会发起任何网络请求。它仅调整本地客户端设置以提升您的用户体验。

💫 What features are improved? 💫 哪些功能得到了改进？

  • ✅ Local environment configuration management
  • ✅ 本地环境配置管理
  • ✅ Automated compatibility adjustments for new client versions
  • ✅ 针对新客户端版本的自动兼容性调整
  • ✅ Advanced layout and theme customization (Client-side only)
  • ✅ 高级布局和主题自定义（仅限客户端）
  • ✅ AI Features
  • ✅ AI 功能
  • ✅ Remote web panel (Remote Connect on mobile)
  • ✅ 远程 Web 面板（手机远程连接）

🌐 Remote Web Panel 🌐 远程 Web 面板

WandEnhancer includes a built-in Remote Web Panel allowing you to control app features directly from your phone. WandEnhancer 包含一个内置的远程 Web 面板，允许您直接通过手机控制应用程序功能。

Quick Start: Ensure both your PC and phone are on the same Wi-Fi network. Hover over the Connect button in the top bar of WandEnhancer. Scan the displayed QR code with your phone’s camera. 快速入门： 确保您的电脑和手机处于同一 Wi-Fi 网络下。将鼠标悬停在 WandEnhancer 顶部栏的“Connect”按钮上，使用手机摄像头扫描显示的二维码。

Troubleshooting & Remote Access: Page isn’t loading? First, ensure both your PC and phone are connected to the same local network. Some routers and guest Wi-Fi networks enable client isolation/AP isolation, which blocks devices on the same SSID from reaching each other. If it still does not load, check Windows Firewall and allow inbound traffic on TCP port 3223 for your local network. If Windows marked your connection as Public, switching it to Private can also help. 故障排除与远程访问： 页面无法加载？首先，确保您的电脑和手机连接到同一个局域网。部分路由器和访客 Wi-Fi 启用了客户端隔离/AP 隔离，这会阻止同一 SSID 下的设备相互通信。如果仍然无法加载，请检查 Windows 防火墙，并允许局域网的 TCP 3223 端口入站流量。如果 Windows 将您的连接标记为“公用”，将其切换为“专用”也可能有帮助。

Using mobile data or a different network? If you want to use the panel over mobile data (LTE/5G) or from an entirely different network, you can use Tailscale or similar VPN tools. 使用移动数据或其他网络？ 如果您想通过移动数据 (LTE/5G) 或完全不同的网络使用该面板，可以使用 Tailscale 或类似的 VPN 工具。

👀 How to use? 👀 如何使用？

This repository does not publish official compiled binaries. Build your own executable from your own fork using GitHub Actions. 本仓库不发布官方编译好的二进制文件。请使用 GitHub Actions 从您自己的分支（Fork）构建可执行文件。

  1. Sign in to GitHub and fork this repository.
  2. 登录 GitHub 并 Fork 本仓库。
  3. Open your fork, go to the Actions tab, and enable workflows if GitHub asks you to.
  4. 打开您的分支，进入 Actions 选项卡，如果 GitHub 提示，请启用工作流。
  5. Select the Build executable workflow. Click Run workflow, keep the default branch, and start the run.
  6. 选择“Build executable”工作流。点击“Run workflow”，保持默认分支，并开始运行。
  7. Wait for the workflow to finish, open the completed run, and download the artifact.
  8. 等待工作流完成，打开已完成的运行记录，并下载构建产物（Artifact）。
  9. Extract the artifact zip and run WandEnhancer.exe to apply local client modifications.
  10. 解压产物压缩包并运行 WandEnhancer.exe 以应用本地客户端修改。

🧩 Custom scripts 🧩 自定义脚本

You can inject your own JavaScript into Wand at patch time to tweak or fix things in the client UI. This reuses the same renderer injection the Remote Web Panel uses, so it requires the Remote Web Panel patch to be enabled. 您可以在打补丁时将自己的 JavaScript 注入 Wand，以调整或修复客户端 UI。这复用了远程 Web 面板所使用的渲染器注入技术，因此需要启用远程 Web 面板补丁。

How to add a script: In the patch dialog, add one or more .js files (only existing .js files are accepted), or Drop .js files into a renderer-scripts/ folder placed next to the patcher executable. Then patch as usual — your scripts are bundled into the client and run inside Wand’s window. 如何添加脚本： 在补丁对话框中，添加一个或多个 .js 文件（仅接受现有的 .js 文件），或者将 .js 文件放入补丁程序旁边的 renderer-scripts/ 文件夹中。然后像往常一样打补丁——您的脚本会被打包进客户端并在 Wand 窗口内运行。

How it runs: Each script runs inside Wand’s renderer (full DOM access, plus Node require). It is wrapped so a thrown error is logged and never crashes Wand. It may run more than once per launch (on load and again shortly after), so guard one‑time work behind a global flag. 运行方式： 每个脚本都在 Wand 的渲染器内运行（拥有完整的 DOM 访问权限，以及 Node require）。脚本经过封装，因此抛出的错误会被记录，且不会导致 Wand 崩溃。脚本在每次启动时可能会运行多次（加载时及稍后），因此请使用全局标志来保护仅需执行一次的任务。

🛠️ How to build from source 🛠️ 如何从源码构建

Building from source on Windows requires a local development environment. 在 Windows 上从源码构建需要本地开发环境。

Requirements: 要求：

  • CMake
  • Node.js and pnpm
  • Visual Studio 2022 or Build Tools for Visual Studio 2022 with MSBuild
  • Visual Studio Desktop development with C++ workload
  • .NET Framework 4.8 desktop build tools / targeting pack

Build steps: 构建步骤：

  1. Clone this repository.
  2. 克隆本仓库。
  3. Install the requirements above and make sure cmake, pnpm, and MSBuild are available.
  4. 安装上述要求，并确保 cmake、pnpm 和 MSBuild 可用。
  5. Run build.cmd from Command Prompt or PowerShell. The build script installs the web panel dependencies, builds the frontend, compiles the native helper with CMake, restores NuGet packages, and builds the WPF solution.
  6. 从命令提示符或 PowerShell 运行 build.cmd。该构建脚本会安装 Web 面板依赖项、构建前端、使用 CMake 编译原生辅助程序、还原 NuGet 包并构建 WPF 解决方案。

❓ Q&A ❓ 问答

  • Why is there no .exe in GitHub Releases? Official releases are notes-only on purpose. The project no longer distributes prebuilt executables because unsigned or self-built patching tools are repeatedly reuploaded, mislabeled, and flagged by third-party scanners. Build the executable from your own fork using GitHub Actions instead.
  • 为什么 GitHub Releases 中没有 .exe 文件？ 官方发布页面仅包含说明是有意为之。本项目不再分发预编译的可执行文件，因为未签名或自构建的补丁工具经常被重新上传、错误标记并被第三方扫描器拦截。请改用 GitHub Actions 从您自己的分支构建可执行文件。
  • Where do I download the executable? From your own fork’s Actions artifact after running the Build executable workflow. Do not download .exe files from YouTube descriptions, random mirrors, Discord attachments, or issue comments.
  • 我在哪里下载可执行文件？ 在运行“Build executable”工作流后，从您自己的分支的 Actions 产物中下载。请勿从 YouTube 描述、随机镜像、Discord 附件或 Issue 评论中下载 .exe 文件。
  • Why does Windows Defender or SmartScreen warn about my build? The GitHub Actions artifact is unsigned and uncommon, so Windows may warn even when the code was built directly from your fork. Review the source, verify the workflow logs, and only run binaries you built yourself.
  • 为什么 Windows Defender 或 SmartScreen 会对我的构建发出警告？ GitHub Actions 的产物未经过签名且不常见，因此即使代码是直接从您的分支构建的，Windows 也可能会发出警告。请审查源码、验证工作流日志，并仅运行您自己构建的二进制文件。
  • Can I use a binary built by someone else? You can, but you should treat it as untrusted. This repository cannot verify or support third-party builds.
  • 我可以使用别人构建的二进制文件吗？ 可以，但您应将其视为不可信。本仓库无法验证或支持第三方构建版本。
← 返回新闻列表 / Back to news list