Hydra 游戏库自动扫描指南：一键发现已安装的游戏

Hydra 游戏库自动扫描指南：一键发现已安装的游戏

【免费下载链接】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 Launcher 是一款开源的一站式游戏平台，它的扫描引擎会遍历你 PC 上已有的游戏目录，把找到的可执行文件与社区维护的已知游戏清单做比对，命中的游戏会自动补上封面、标题等元数据并入库，全程不用手动登记路径。

扫描引擎到底在做什么

理解原理之后，你就知道它为什么"扫得到"或"扫不到"。整个流程分三层：

1. 遍历：对每个扫描根目录做递归遍历，跳过常见的可再发行依赖目录，收集全部文件；
2. 比对：把文件名与社区维护的已知游戏可执行文件清单（如各游戏的xxx.exe名）逐一匹配；
3. 落库：命中的可执行文件如果对应库中已有条目，就只补全路径（linked）；如果是新游戏，则拉取商店元数据后创建条目（added）；当一个 exe 可能属于多款游戏时，不会擅自决定，而是留给你手动选择。

核心实现位于 src/main/events/library/scan-installed-games.ts，有兴趣追细节可以直接读这份源码。

开启扫描：从按钮到结果

搞清楚机制后，实际触发它只需要几秒。

进入 Library 页面，点击顶部工具栏的同步图标按钮（悬停提示为 "Scan PC for installed games"），扫描窗口随即打开：

• Windows 上默认是Automatically模式，直接使用内置目录；其他系统默认Manually，需要自己添加文件夹；
• 保持 "Add games found to my library" 勾选，点击Start Scan；
• 扫描过程中可以关掉窗口——提示文案写得很明确："You can close this modal, you will receive a notification once it's done."，完成后通知Scanning for games finished successfully会把你带回 Library 并自动打开结果窗口；
• 中途改变主意可以用红色Cancel Scan按钮中止，扫描任务支持按 requestId 精确取消。

自动模式与自定义目录怎么配

如果你的游戏没装在默认位置，就要用手动模式来指定范围了。

Automatically 模式的目录来源不只是几个写死的固定路径，还包括 Steam 实际配置的所有库文件夹以及 Hydra 的下载目录：

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`, ];

Manually 模式则在窗口内操作：点击Add folder选择文件夹（支持多选，可一次挂多个根目录），不想要的目录点右侧 × 移除。引擎内部还会做一层去重——如果某个根目录是另一个根目录的子目录，会被自动折叠，避免重复遍历，这也是"嵌套游戏盘"可以放心加整个盘符的原因。

结果页的三类输出怎么处理

扫描结束后的窗口不是一个简单的"全部通过"，结果会分成三种，处理方式各不相同：

• Added：新发现的游戏，直接带封面入列表；
• Linked：你库里早已存在、但一直没填可执行路径的游戏，这次补上了路径；
• Ambiguous：提示 "We found N executables that could belong to more than one game"，列出候选游戏让你为每个 exe 点选归属，确认后点Add selected，不想处理的可Skip these跳过，未选择的项目不会入库。

确认无误后点Close即可；窗口还提供Scan Again，清空当前结果重新跑一轮，适合装完新游戏后的增量扫描。

扫不到游戏？按这个顺序排查

先说结论：检测依赖社区维护的已知游戏清单，官方自己都注明 "may be outdated, so some games might not be found"，所以漏扫不等于功能坏了。按下面顺序检查通常能定位问题：

1. 路径不在范围内：确认游戏目录是否落在某个扫描根目录之下，不在就用 Manually 模式补一个自定义文件夹；
2. exe 被改名过：匹配基于文件名比对，把game.exe改成别的名字基本等于隐身；
3. 候选过多被降级：同一个 exe 名被超过 40 款游戏声明时（清单里叫 unnamed 路径），引擎会放弃自动命名、转入 Ambiguous 处理，留意结果页里那一组待选项；
4. 目录过大：首次全盘扫描耗时较长，建议挑空闲时段跑，或缩小根目录数量；目前版本没有"排除某子目录"的开关，控制范围的方式就是选对根目录。

一句话总结：把 Hydra 游戏扫描当作"库的自动补全器"来用——默认路径交给它自动跑，非标准目录手动补一刀，剩下的交给结果页的三个分支，本地游戏管理基本就不再是手工活。

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