ww-manager 2.0.6

鸣潮命令行管理器

WutheringWaves CLI Manager

鸣潮命令行管理器

  

专为 Linux 用户打造的《鸣潮》客户端命令行管理工具。 结合了 完整的下载/校验功能 与 秒级服务器切换 技术。一旦完成“烘焙”，即可在官服 (CN)、B服 (Bilibili) 之间瞬时切换，无需重新下载庞大的游戏文件。

国际服因为包体差异不支持快速切换。

最新版本经过测试，兼容 Windows11。

此版本目前有一个较严重bug，部分用户有游戏剧情过场动画、文本丢失的情况，待解决。

🔥 增量更新

🚧 正在开发测试中

feat/predownload 分支为待验证的分支，提供全量预下载功能，使用前请确保您了解自己在做什么；

增量更新因技术有限尚未实现，欢迎PR🙏！

✨ 核心功能

• 🚀 秒级切换 (checkout)：利用差异文件重命名替换，在不同服务器间瞬间切换。
• 🛠️ 智能修复 (sync)：校验全量文件 MD5，自动修复损坏文件，下载缺失资源。
• 📦 完整下载 (download)：从零开始下载任一服务器的纯净客户端。
• 💾 自动记忆：自动记录游戏路径，一次设置，永久生效。
• ⚡️ 现代化 CLI：基于 Typer 构建，支持自动补全和帮助信息。
• 👯 并行下载: 使用多线程并行下载，避免 CDN 节点降速，支持断点续传。

🔧 安装指南

本工具推荐使用 uv 进行安装和管理。

1. 安装 uv (如果尚未安装)

• Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

• Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

安装完需要重启终端应用环境变量。

2. 安装本工具

• 方式一: 从本地源码构建

  克隆仓库代码到本地

  git clone https://github.com/timetetng/wutheringwaves-cli-manager.git
  cd wutheringwaves-cli-manager
  

  在源码目录下执行：

  uv tool install .
  

• 方式二: 从远程构建

  终端直接输入:

  uv tool install git+https://github.com/timetetng/wutheringwaves-cli-manager
  

• 方式三: 从 PyPI 源安装

  uv tool intall ww-manager
  

安装完成后，你就可以在终端的任意位置直接使用 ww 命令了！

3. 更新/卸载

• 更新工具

  • 从本地源码构建安装:

  # 从本地源码构建，更新时需拉取最新源码
  git pull
  # 在源码目录下执行，重新构建工具
  uv tool install . --force
  

  • 远程或 PyPI 安装:

  uv tool upgrade ww-manager
  

• 卸载工具

  uv tool uninstall ww-manager
  

📖 使用说明

首次运行

第一次运行时，你需要指定游戏路径（只需指定一次，后续会自动记忆）：

# 创建安装目录(如果你还没有创建游戏目录)
mkdir -p "$HOME/Games/WutheringWaves"
# 初始化路径
ww -p "$HOME/Games/WutheringWaves" status

》-p、--path 参数用于指定安装路径。

常用命令

1. 查看状态 (status)

检查当前游戏目录属于哪个服务器，以及版本号。

ww status

2. 快速切换服务器 (checkout)

这是最常用的功能。秒级切换服务器（仅限官/b服）。

# 切换到 Bilibili 服
ww checkout bilibili

# 切换到 官服
ww checkout cn

# 切换到 国际服（需要完整下载）
ww checkout global

注意：如果切换后提示“文件缺失”，请运行 ww sync 进行下载修复。

v2.0 开始，将会自动校验并补全文件, --force-sync 仅用于需要时，手动强制同步。

3. 同步与修复 (sync)

每次游戏版本更新后，或者切换服务器后发现文件缺失时使用。它会联网校验所有文件并下载更新。

ww sync

4. 下载完整客户端 (download)

如果你还没有游戏，可以使用此命令从零开始下载。

# 下载完整的官服客户端到当前目录（或配置的默认目录）
ww download cn

5. 获取抽卡记录链接 (log)

可以一键获取抽卡链接，用于导入小程序或者鸣潮机器人。

# 使用前需点开 唤取-唤取记录 以更新日志文件
ww log

-o、--open: 获取链接并跳转打开。

💡 最佳实践：如何打造“全家桶”

要实现完美的秒级切换，你需要下载共用的游戏本体到一个目录中。

1. 下载基础客户端： 如果你还没有游戏，先下载一个完整的（例如官服）：

   ww --path "/path/to/Game" download cn
   

2. “烘焙”其他服务器： 现在切换到 B 服，并强制执行同步来下载 B 服独有的文件：

   ww checkout bilibili
   

3. 享受切换： 现在你已经拥有了“全家桶”。

   • 想玩官服 -> ww checkout cn
   • 想玩B服 -> ww checkout bilibili
   • 版本更新 -> ww sync

🎮 启动游戏 (Linux)

本工具仅负责文件管理。启动游戏推荐使用 Steam + Proton。

如果你熟悉 Linux，你可以参考项目中的 run_ww.sh 脚本并添加 .desktop 文件绕过 Steam 启动，或者按照以下步骤通过 Steam 启动：

1. Steam 设置：

   • 添加“非 Steam 游戏”，指向 /Client/Binaries/Win64/Client-Win64-Shipping.exe。
   • 在兼容性中强制使用 GE-Proton (参考项目LutheringLaves 或下面的指南下载并配置最新 GE-Proton )。

2. 启动参数： 在 Steam 启动选项中添加：

   steamdeck=1
   

致谢

灵感来源于以下优秀项目：

• WutheringWavesTool
• LutheringLaves
• Wuthering-Waves-Official-Bilibili
• GE-Proton: 下载最新版本的 GE-Proton 并解压到 ~/.local/share/Steam/steamapps/common/ 目录下，启动 Steam，在属性-兼容性中能找到下载的 GE-Proton 即说明配置成功。

接下来该做什么？

如果有任何报错或者建议，随时通过 issue 告诉我！