Hydra 游戏扫描：5 个默认目录 + Steam 库自动发现，不用逐个填路径

Hydra 游戏扫描：5 个默认目录 + Steam 库自动发现，不用逐个填路径

【免费下载链接】hydraHydra Launcher is an open-source gaming platform created to be the single tool that you need项目地址: https://gitcode.com/GitHub_Trending/hy/hydra

把游戏加入 Hydra 库最烦人的部分，从来不是点"添加"，而是在资源管理器里一层层翻出每个游戏的安装路径，再手动填进设置里。游戏一多，这件事就成了负担。Hydra 内置了游戏扫描功能：你指定几个根目录，它递归遍历子文件夹，把找到的游戏可执行文件直接写入库中，省去逐个填写路径的环节。

工作原理

Hydra 的扫描逻辑集中在 src/main/events/library/scan-installed-games.ts。它先按"默认目录 + 你手动添加的目录"展开扫描范围，再递归列出每个根目录下的文件，把文件名（小写化后）与内置的已知游戏可执行文件目录逐一比对；命中后解析出安装位置，写入本地库，同时拉取该游戏的标题、图标等元数据。

功能拆解

自动模式：默认能扫到什么

Windows 上的扫描弹窗默认是自动模式，你什么都不用选。它的范围由三部分拼成：

const SCAN_DIRECTORIES = [ String.raw`C:\Games`, String.raw`D:\Games`, String.raw`C:\Program Files (x86)\Steam\steamapps\common`, String.raw`C:\Program Files\Steam\steamapps\common`, String.raw`D:\SteamLibrary\steamapps\common`, ];

这 5 个基础路径之外，Hydra 还会读取 Steam 配置里的 libraryfolders，把每个 Steam 库路径下的steamapps\common一并纳入，再加上你在 Hydra 里设置的下载目录。重叠的目录会自动去重，同一个根目录不会被扫两次。

手动模式：扫描范围如何扩展

游戏装在非标准位置（比如E:\MyGames）时，切到手动模式。弹窗里的"添加文件夹"支持多选，可以加入任意多个根目录；遍历是递归的，所有子文件夹都会被检查。递归过程中，_commonredist、directx、dotnet这类运行时目录，以及vcredist、dxsetup、setup.exe、crashreportclient.exe等运行时文件会被直接跳过，不会误判成游戏入口。

扫描结果如何进入游戏库

扫描完成后 Hydra 会发一条本地通知，点开就进入 Library 页面的扫描结果弹窗。结果分三类：

• 已入库的游戏：之前加进库但没有可执行路径的，会被补上路径，触发云存档自动同步；
• 新发现的游戏：直接写入你的库，标题和封面来自目录数据，按每批 4 个并发处理；
• 无法确定的匹配：同一个 exe 名被多款游戏占用时，弹窗列出候选游戏让你点选确认，也可以整批跳过。

进阶配置

扫描弹窗里只有几个选项，按需调整即可。Windows 上"自动 / 手动"两个模式可自由切换；非 Windows 系统默认手动模式，没有自动选项，因为基础路径列表是 Windows 专属的。"添加到库"复选框默认勾选，取消后扫描只查找、不写入。扫描是长时间任务，进行中可以随时取消，不会污染已有结果。

常见问题

Q：某个游戏一直没被扫到？扫描匹配的是 exe 的文件名，依赖 Hydra 的已知可执行文件目录。被重命名过的启动器、或文件名与目录中任何已知条目都对不上的游戏，都不会被识别。改用手动模式把游戏根目录加进来，再确认 exe 没被改名，是最直接的排查路径。

Q：一个 exe 对应多款游戏，弹窗一直在等我确认？这是模糊匹配：候选列表里哪个是真正在跑的，Hydra 不会替你猜。逐个点选确认后统一入库；拿不准的候选直接点跳过，不影响其他游戏的扫描结果。

Hydra 的游戏扫描把"找路径"这件事收敛成了一次目录选择：机制简单，入口在 Library 页顶部的扫描按钮，行为细节可以对照 扫描模块源码 逐段确认。

【免费下载链接】hydraHydra Launcher is an open-source gaming platform created to be the single tool that you need项目地址: https://gitcode.com/GitHub_Trending/hy/hydra