WandEnhancer：把 Wand 的本機修改與 LAN 面板分開檢視

WandEnhancer 改動的是哪裡

README 將 WandEnhancer 描述為延伸本機端設定與改善 Wand 使用體驗的互通工具。 .NET patcher 修改選定的 Wand 安裝檔案，bundled version.dll proxy 則由 Wand 載入，在 Wand 自身程序內調整 Electron 的 ASAR integrity fuse byte。素材沒有說它會注入其他程序，因此不能把這項機制擴大解讀為通用的程序注入器。

這個邊界很重要：Wand 本身仍是線上應用程式，建置工具會還原宣告的依賴，工具本身則不會聯絡更新或遙測服務。這表示本機修改與 Wand 的線上流量是兩個不同問題，審查時要分別記錄。

專案核對 0：請在 k1tbyte-wand-enhancer-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。

Remote Web Panel 的網路條件

Remote Web Panel 讓手機控制 WandEnhancer 的功能。README 的快速路徑是讓電腦與手機處於同一 Wi-Fi，將滑鼠移到頂端列的 Connect 按鈕，再掃描顯示的 QR code。面板使用 TCP 3223 的純 HTTP，並透過 HTTP/WebSocket 提供控制入口。

它沒有 pairing code，能連到該埠的人就能查看面板並控制目前的 trainer。客戶端隔離、訪客 Wi-Fi、Windows Firewall 或 Public 網路設定都可能阻擋連線；README 建議在可信 LAN 或 VPN 使用，不能把 3223 直接暴露到網際網路。

專案核對 1：請在 k1tbyte-wand-enhancer-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。

GitHub Actions 建置路徑

專案不發布官方編譯好的 exe。README 要求使用者 fork 儲存庫、執行 Sync fork、在 Actions 啟用 workflow，選取 Build executable，執行預設分支的工作流，完成後下載 artifact，解壓後執行 WandEnhancer.exe。這條路徑也解釋了為何 Releases 只有 release notes。

自行建置並不等於自動可信。產物未簽署，Windows Defender 或 SmartScreen 可能提出警告；應保留 fork、workflow run、artifact 與雜湊，並先在隔離環境處理選定的 Wand 安裝。

專案核對 2：請在 k1tbyte-wand-enhancer-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。

自訂 renderer-scripts 的能力

使用者可在 patch 時加入既有的 .js 檔案，也可把檔案放進 patcher 旁的 renderer-scripts/ 目錄。腳本會在 Wand renderer 中執行，擁有完整 DOM 存取與 Node require；WandEnhancer.log、WandEnhancer.remoteUrl、WandEnhancer.apiVersion 也可使用。

腳本可能在同一次啟動中執行多次，因此 README 的範例以 globalThis.__helloScriptInstalled 作為一次性旗標。腳本與 Wand client 享有相同權限，只能加入自己信任且看得懂的內容，錯誤雖會被記錄並避免使 Wand 崩潰，這不會消除腳本本身的權限風險。

專案核對 3：請在 k1tbyte-wand-enhancer-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。

Windows 原始碼建置的依賴

Windows 建置需要 CMake、Node.js、pnpm、Visual Studio 2022 或其 Build Tools、MSBuild，以及 .NET Framework 4.8 desktop build tools 或 targeting pack，並要啟用 Desktop development with C++ workload。指令列步驟是 clone 儲存庫、安裝依賴，確保 cmake、pnpm 與 MSBuild 可用，再從 Command Prompt 或 PowerShell 執行 build.cmd。

build.cmd 會安裝 web panel 依賴、建置前端、以 CMake 編譯 native helper、還原 NuGet 套件，最後建置 WPF solution。缺少其中一項時，失敗原因可能出現在不同階段，應保留完整輸出，不要只以 exe 是否出現判定建置成功。

專案核對 4：請在 k1tbyte-wand-enhancer-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。

採用前的具體檢查 · k1tbyte wand enhancer

第一次測試應使用自己的 fork 與 build executable workflow，記下 artifact 雜湊，確認 WandEnhancer.exe 的來源與 workflow run 一致。接著在隔離 Windows 帳戶中對測試用 Wand 安裝執行 patch，觀察被修改的檔案、version.dll 載入狀態與回復方式。

第二階段只在受控 LAN 開啟 Remote Web Panel，檢查 3223 的待聽狀態、手機能否透過 QR code 連線，以及防火牆是否只允許本機網段。同步觀察 Wand API/CDN 流量，確認 bearer token 與 installation-path 欄位沒有出現在面板協定中。任何未能由 README 或測試觀察證實的能力，都不應列入採用承諾。

WandEnhancer 的面板測試還要核對 Windows Firewall、Public 或 Private 網路設定，以及 3223 埠是否只對可信網段開放。對 renderer-scripts/ 的每個腳本保留原始檔，檢查 globalThis 旗標是否避免重複安裝，並確認腳本沒有把不必要的資料寫入網路。這些檢查直接對應 README 的操作與限制。 WandEnhancer 的面板測試還要核對 Windows Firewall、Public 或 Private 網路設定，以及 3223 埠是否只對可信網段開放。對 renderer-scripts/ 的每個腳本保留原始檔，檢查 globalThis 旗標是否避免重複安裝，並確認腳本沒有把不必要的資料寫入網路。這些檢查直接對應 README 的操作與限制。

專案核對 5：請在 k1tbyte-wand-enhancer-deep-analysis 的 README、設定檔或命令輸出中確認這一節描述的具體行為，並把檔案路徑、參數名稱、平台條件與錯誤結果分開記錄。這些觀察可用來判斷功能是否真的符合目前流程，也能在升級後定位差異。素材未列出的性能或安全承諾，不應自行補上。

build.cmd 輸出如何判讀

執行 build.cmd 後，應把前端建置、CMake native helper、NuGet 還原與 WPF solution 的輸出分開保存。這能確認失敗發生在哪一個依賴階段，也能讓後續重跑與比較更有依據。

編輯結論

WandEnhancer 適合能在 Windows 上自行建置、審查未簽署執行檔，並把 3223 埠限制在可信 LAN 或 VPN 的使用者。不適合把第三方 exe 當成官方發佈物，或需要網際網路直接暴露控制面板的人。先從自己的 fork 執行 Build executable workflow，再檢查產物雜湊、Windows 防火牆規則、面板連線與 Wand API/CDN 流量，確認範圍後才決定是否採用。 本專案核對項目1應依 README 的實際入口和版本標籤保存輸出，並以專案名稱、命令或檔案路徑標記，避免把未說明的行為當成保證。另應把 build.cmd 的 CMake、NuGet 與 WPF 階段分開記錄，這些階段失敗時的輸出可直接對應 Windows 建置依賴，不能只看是否產生 WandEnhancer.exe。

官方來源

1. Official documentation
2. Official README
3. Project repository
4. Release notes