企业官网建设流程全解析

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 是一款开源游戏库管理工具（Electron + React 实现），除了商店目录和成就，还内置本地游戏扫描：

• 自动发现：按可执行文件特征表比对磁盘上的游戏，而不是让你逐台输入安装目录
• 元数据补全：匹配成功即自动拉取标题、封面等商店资料写入库内
• 双路工作：既能给库里已有的游戏补上丢失的路径，也能发现库外的新游戏
• 可中断、可定制：扫描在后台运行，随时可取消，支持追加自定义目录

默认的扫描范围写死在这段常量里，即 Hydra 启动扫描时会先行遍历的目录列表：

const SCAN_DIRECTORIES = [ "C:\\Games", "D:\\Games", "C:\\Program Files (x86)\\Steam\\steamapps\\common", "C:\\Program Files\\Steam\\steamapps\\common", ];

从启动扫描到确认入库

打开扫描入口

1. 进入 Library 页面，顶部操作区会出现 Scan Games 按钮
2. 点击按钮，弹出扫描设置弹窗，确认要扫描的范围

扫描范围由默认目录和自定义目录两部分拼成。默认部分除上面列出的常见盘符外，还会自动读取你本机的 Steam 库文件夹和 Hydra 的下载目录。

处理非标准安装路径

游戏装在非典型位置时，在弹窗中通过 additionalDirectories 追加自定义目录即可，递归扫描会逐层深入子文件夹，无需指定到具体游戏目录。

查看结果并完成入库

1. 扫描期间可随时取消，不会打断前台操作
2. 完成后 Hydra 发一条本地通知，列出"新增几项、补链几项"，通知会带openScanModal参数直接打开扫描弹窗
3. 对多个游戏指向同一个 exe 的歧义项，在弹窗里手动指定归属
4. 确认无误后关闭弹窗，所有游戏进入库内，图标、封面、商店资料随之到位

进阶：这些选项值得调

• includeDefaultDirectories 开关：关掉后只扫你手动加的目录，适合只想扫某个盘的情况
• addGamesToLibrary 开关：关闭时只给已有游戏补路径，不往库里塞新游戏
• 递归去重：目录树自动去重并跳过 Redist、公共重定向包一类无关文件夹
• 匹配策略：Hydra 不靠扩展名盲扫，而是维护一张已知游戏可执行文件表，按文件名精确比对；多个候选时用 game-executable-ranking.ts 的路径特征打分；文件夹名和游戏名一致时也可直接锁定归属
• 通知参数：?openScanModal=true会直接拉起扫描弹窗，方便从别处跳回来处理结果

排错清单

• 现象：扫不到某款游戏→ 路径不在默认或自定义范围内，或游戏 exe 被改名 → 把该盘符加入自定义目录，确认可执行文件未被重命名后重扫
• 现象：扫描很慢→ 递归遍历整个目录树，大库首次需要数分钟 → 减少扫描范围，或等系统空闲时执行
• 现象：多个游戏指向同一个 exe→ Hydra 不会瞎猜，会放进歧义列表等你指定 → 在结果弹窗中手动选择归属
• 现象：重复入库→ 同一可执行文件路径只会被认领一次，其余跳过 → 无需处理，属预期行为

这套机制适合本地游戏多、装盘习惯随意的 Windows 玩家：从盘符到库条目，路径、元数据、入库一次完成，不用手工维护。

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