🌊 Wuwa Mod Fixer

一个用于修复由于游戏更新导致的模组失效等问题的工具。

English Readme | 中文说明

📖 使用方法

前往 发布页 下载适合的可执行文件： - Wuwa_Mod_Fixer（推荐大多数用户）：图形界面版本，双击打开，选择或拖入 Mod 文件夹，点击“开始修复”即可。同时也支持通过命令行参数直接调用。 - wuwa-mod-cli：轻量无界面的独立纯命令行版本，适合习惯终端操作或集成到第三方自动化工具的用户。

✨ 主要功能

• 自动化修复：自动识别资源哈希变动并进行替换。
• 回滚管理：修复前自动创建备份，内置回滚功能，可随时恢复到修改前的原始状态。
• 跨平台支持：支持 Windows 与 Linux。
• 双模式运行：支持直观的图形界面，也支持交互式控制台菜单与直接命令行调用。

🚀 命令行参数

程序支持以下启动参数（桌面版与纯命令行版通用）：

示例：

# 以控制台交互模式运行
./wuwa-mod-cli
# 或桌面版：
./Wuwa_Mod_Fixer --cli

# 一键修复指定 Mod
./wuwa-mod-cli --path "D:\Mods\MyMod"

# 一键修复 + 启用 Rendering 3.3 修复 + 应用稳定纹理
./wuwa-mod-cli --path "D:\Mods\MyMod" --rendering-33 --stable-texture

# 一键修复 + 补全贴图状态 + 联网获取最新配置
./wuwa-mod-cli --path "D:\Mods\MyMod" --derived-hashes --online

# 一键修复 + 使用指定配置文件
./wuwa-mod-cli --path "D:\Mods\MyMod" --config "D:\Configs\config.json"

# 回滚最近一次修复
./wuwa-mod-cli --path "D:\Mods\MyMod" --rollback

# 输出 JSON 格式流式进度（第三方工具集成）
./wuwa-mod-cli --path "D:\Mods\MyMod" --format json

🛠️ 开发与打包

确保你已安装 Rust 环境以及 Node.js (推荐 20.x 及以上版本)。

安装依赖

npm install
npm install --prefix src-ui

本地运行

npm run tauri dev

编译打包

# 编译打包图形界面桌面端 (Windows / Linux)
npm run tauri build

# 编译独立纯命令行版本
cargo build --release -p wuwa-mod-cli

对于 Linux 系统，打包桌面版前需确保安装了 Tauri 相关的系统依赖，如 libwebkit2gtk-4.1-dev, build-essential, curl, wget, file, libssl-dev, libayatana-appindicator3-dev, librsvg2-dev 等。

Sponsors

Free code signing on Windows provided by SignPath.io, certificate by SignPath Foundation