鸣潮Steam启动助手使用指南

简介

WutheringWavesSteamHelper（鸣潮 Steam 助手）是一款通过生成必要的配置文件，让玩家可以通过 Steam 客户端启动和管理国服鸣潮的工具。支持官方启动器与 WeGame 两种版本的鸣潮，并可在两者之间自由切换。

v2.0.0 起，程序从底层框架到界面设计进行了完整重写，迁移至 WinUI 3 / Windows App SDK，采用原生 Fluent Design 风格，自动适配深色/浅色主题，并新增了自动更新检查、开发者选项等功能。

主要功能

自动检测 Steam 安装路径：程序启动时自动查找 Steam 位置，无需手动配置。
自动检测 Steam 游戏库路径：支持多个游戏库的识别与选择。
自动获取 BuildID 和 Manifest：通过 SteamDB API 自动拉取最新游戏版本信息。
自动生成游戏配置文件：自动生成 appmanifest_3513350.acf 等必要文件。
一键从 Steam 端启动国服鸣潮：配置完成后可直接通过 Steam 库启动游戏。
WeGame 版支持：自动识别 WeGame 版鸣潮路径（注册表检测），支持生成 WeGame 结构的启动命令。切换时新增确认弹窗，防止误操作。
版本切换：界面内可在官方启动器与 WeGame 之间一键切换，切换时自动验证对应版本是否已安装。
自动更新检查：启动时后台静默检查更新，自动探测 GitHub 连通性（3 秒超时），失败则切换镜像站，对国内用户友好。发现新版本时标题栏右上角显示蓝色提示按钮。支持强制更新模式与手动检查更新。
设置持久化：路径、Steam ID、BuildID、Manifest、版本选择、开发者模式等设置自动保存至本地，下次启动自动填入。
打开官方启动器：一键自动搜索并启动国服鸣潮 launcher.exe。
禁止多开：同一用户会话内只允许运行一个实例，重复启动时自动聚焦已有窗口。
侧边栏导航：采用 NavigationView 侧边栏导航 + 内容区布局，预留碧蓝档案、尘白禁区等游戏入口（敬请期待）。
开发者选项：隐藏调试面板，支持 Debug 模式（本地服务器更新检查）、测试版渠道、一键打开设置文件目录。
设置页面：独立设置页，含开发者模式切换、更新通知卡片、关于/帮助/源码链接入口。

系统要求

Windows 操作系统（Windows 10 / 11，基于 x64）
.NET 8.0 运行时
Windows App SDK（WinUI 3 运行时）
已安装 Steam 客户端
Steam 游戏库内已入库鸣潮游戏
（可选）已安装 WeGame 版鸣潮（如需使用 WeGame 模式）

使用说明

1. 启动程序

运行 WutheringWavesSteamHelper.exe，程序会自动尝试检测您的 Steam 安装路径和游戏库路径。如果您之前使用过本工具，已保存的设置（路径、Steam ID、BuildID 等）会自动填入。程序启动时会在后台静默检查更新，如发现新版本，标题栏右上角会显示蓝色"发现新版本"提示按钮，点击可跳转至设置页查看详情并下载。

2. 配置路径

Steam 安装路径

自动检测：程序启动时会自动检测，通常为 C:\Program Files (x86)\Steam。
手动选择：如果自动检测失败，点击"浏览"按钮手动选择 Steam 安装目录（包含 steam.exe 的文件夹）。程序会验证所选目录中 steam.exe 是否存在。
重新检测：点击"自动检测"按钮可重新检测路径。

SteamLibrary 路径

自动检测：程序会读取 Steam 的 libraryfolders.vdf 文件，自动检测所有游戏库。
多库选择：如果检测到多个游戏库，会弹出选择对话框，让您选择要使用的库。
手动选择：点击"浏览"按钮手动选择游戏库目录（包含 steamapps 文件夹的目录）。程序会验证所选目录中 steamapps 子目录是否存在。

3. 选择游戏版本

在"版本切换"卡片中选择您要使用的鸣潮版本：

官方启动器：使用库洛官方启动器安装的鸣潮。
WeGame：使用 WeGame 平台安装的鸣潮。切换到 WeGame 版本时，会弹出确认弹窗提示「WeGame 版本需要使用官方启动器修复才可使用」，弹窗默认高亮取消按钮防止误操作。用户取消后自动回退至官方版。

程序启动时会根据本机安装情况自动预设版本选项。切换时会自动验证对应版本是否已安装，若未安装则自动拨回。

4. 输入 Steam ID

在"Steam ID (SteamID64)"文本框中输入您的 Steam ID。

💡 如何获取 Steam ID？

访问 SteamID.io 或 SteamDB Calculator。
输入您的 Steam 个人资料链接。
复制 steamID64（纯数字格式）。

5. 获取 BuildID 和 Manifest

点击"从 SteamDB 获取 BuildID 和 Manifest"按钮，程序会自动从 SteamDB API 获取最新的游戏版本信息。操作期间按钮会自动禁用，防止重复点击，完成后恢复可用状态。

如果自动获取失败，请手动操作：

访问鸣潮 SteamDB 页面。
找到 public 分支的 BuildID。
找到 Depot 3513351 的 ManifestID。
手动填入对应的文本框。

6. 生成配置

点击"生成配置并创建快捷方式"按钮，程序会自动完成以下操作：

创建 steamapps 目录（如果不存在）。
生成 appmanifest_3513350.acf 配置文件（LauncherPath 正确指向 steam.exe）。
创建 steamapps/common/Wuthering Waves 目录。
创建空的 Wuthering Waves.exe 文件（若已存在则静默跳过）。

💡 关于覆盖提示

若 appmanifest_3513350.acf 文件已存在，程序会弹出确认对话框询问是否覆盖，防止误操作；而 EXE 文件已存在时将静默跳过，无需重复操作。

7. 在 Steam 中填入启动命令

重启 Steam 客户端。
在游戏库中找到"Wuthering Waves"。
点击工具中的蓝色按钮获取命令（程序会根据您选择的版本自动生成对应的启动命令）。
在启动选项处填入刚刚复制的命令。
点击"更新"或直接启动游戏。

8. 打开官方启动器（可选）

如需直接打开国服鸣潮官方启动器，可点击工具中的"打开官方启动器"按钮，程序会自动搜索并启动 launcher.exe。

9. 检查更新

程序启动时会在后台自动检查更新。如需手动检查，可前往设置页面点击"手动检查更新"按钮。程序会自动探测 GitHub 连通性（3 秒超时），若无法连通则自动切换至镜像站，对国内网络环境友好。

发现新版本时，标题栏右上角会显示蓝色"发现新版本"提示按钮，点击可跳转到设置页查看更新说明与"立即下载"按钮。若服务器推送了强制更新，将显示全屏遮罩并禁用所有导航，直到完成下载。

设置页面

v2.0.0 新增独立设置页面，可通过侧边栏导航进入，包含以下选项：

开发者模式：展开隐藏的调试面板，包含 Debug 模式切换、设置文件路径显示及一键打开所在目录。
Debug 模式：开发者模式下可见，启用后更新检查使用本地服务器（127.0.0.1:9090），方便本地调试。
测试版渠道：开发者模式下可见，从 preview 分支拉取 version.json，获取测试版更新通知。
语言选项：界面已预留繁体中文、英语、日语选项，功能开发中。
更新通知卡片：发现新版本时显示，包含更新说明与"立即下载"按钮。
关于 / 帮助 / 源码：快捷链接入口。

注意事项

⚠ 重要提示

v2.0 不兼容 v1.x：v2.0.0 为完整重写版本，与 v1.x 不具备向下兼容性。建议直接使用最新版本。
首次使用：首次添加后，Steam 会显示游戏需要更新，这是正常现象。
Steam ID：请确保输入正确的 Steam ID，否则可能导致游戏无法正常识别。
网络连接：自动获取 BuildID 和 Manifest 需要网络连接。更新检查会自动在 GitHub 和镜像站之间切换。
Steam 运行状态：操作前建议关闭 Steam 客户端（包括托盘图标），完成后再启动。
版本切换：切换官方启动器与 WeGame 版本时，请确保对应版本的鸣潮已安装在本机，否则切换会自动拨回。切换到 WeGame 时会弹出确认弹窗。
禁止多开：工具不支持同时运行多个实例。如果重复启动，将自动聚焦到已有窗口。
设置自动保存：您的路径、Steam ID、开发者模式等设置会自动保存至 %AppData%\WutheringWavesSteamHelper\settings.json，下次启动时自动载入。
强制更新：当服务器推送 forceUpdate 时，程序将显示全屏遮罩并禁用导航，必须前往下载新版本后才能继续使用。

常见问题

Q：生成配置后 Steam 库中依旧显示下载游戏？

A：请完全退出 Steam（包括托盘图标），然后重新启动 Steam 客户端。

Q：提示"未找到 steam.exe"？

A：请确保选择的是 Steam 的安装目录，而不是游戏目录。正确的路径应包含 steam.exe 文件。

Q：自动获取 BuildID 失败怎么办？

A：可以手动访问 https://steamdb.info/app/3513350/depots/ 查看并手动填写相关信息。

Q：切换到 WeGame 版本后提示未安装？

A：请确认您已通过 WeGame 平台下载并安装了鸣潮。程序通过注册表检测 WeGame 版安装路径，若未安装则无法切换。

Q：切换 WeGame 时弹出确认提示是怎么回事？

A：v2.0.1 新增了确认弹窗，提示您「WeGame 版本需要使用官方启动器修复才可使用」。这是为了防止误操作，取消后会自动回退至官方版。

Q：如何清除已保存的设置？

A：删除 %AppData%\WutheringWavesSteamHelper\settings.json 文件，下次启动程序将恢复默认状态。也可在开发者模式中查看设置文件路径并一键打开所在目录。

Q：为什么无法同时打开两个程序窗口？

A：工具启用了单实例限制，同一用户会话内只允许运行一个实例。重复启动时会自动聚焦到已有窗口。

Q：标题栏出现"发现新版本"按钮？

A：说明程序检测到了更新版本。点击该按钮可跳转到设置页查看更新说明并下载最新版本。

Q：程序无法连接 GitHub 检查更新？

A：程序会自动在 3 秒超时后切换至镜像站获取更新信息，国内用户无需额外操作。您也可以前往设置页手动检查更新。

Q：如何开启开发者模式？

A：在设置页面中找到"开发者模式"开关并启用。启用后可看到 Debug 模式、测试版渠道等高级选项。

技术说明

框架：.NET 8.0 WinUI 3（Windows App SDK）
开发者：iRyougi
游戏 AppID：3513350
主要 Depot：3513351
UI 架构：NavigationView 侧边栏导航 + ContentFrame 页面切换，Fluent Design 风格，自动适配深色/浅色主题
DPI 适配：PerMonitorV2 DPI 自动缩放，支持高分辨率屏幕
窗口尺寸：1100×780，固定大小
版本管理：AppInfo.cs 作为版本信息单一真相来源，version.json 托管于 GitHub 支持远程更新推送
更新检查：后台静默检查，自动探测 GitHub 连通性并回退至镜像站，支持 forceUpdate 强制更新模式
设置存储：基于 System.Text.Json 的设置读写，保存至 %AppData%\WutheringWavesSteamHelper\settings.json
多游戏配置：GameConfig.cs 数据类，包含 GameConfigs.All 静态列表
单实例控制：Program.cs 中通过 Mutex 实现，SetForegroundWindow 聚焦已有窗口
对话框：使用 WinUI 3 ContentDialog 替代 WinForms MessageBox
文件选择器：使用 FolderPicker / FileOpenPicker 替代 WinForms 文件对话框
日志：ObservableCollection + CollectionChanged 自动滚动

资源与链接

帮助文档：https://www.iryougi.com/index.php/wutheringwavessteamhelper/
GitHub 仓库：https://github.com/iRyougi/WutheringWavesSteamHelper

版本规划

版本	状态	说明
1.0.0	已发布	首个正式版本（WinForms）
1.1.0	已发布	UI 重构、WeGame 支持、设置持久化
2.0.0	已发布	全面重构至 WinUI 3，更新检查系统、开发者选项、界面重设计
2.0.1	已发布	WeGame 切换确认提示、测试版渠道优化、构建输出管理
2.1.0	计划中	多游戏支持（碧蓝档案、尘白禁区等）、多语言支持