Steam 清单、Lua 蓝图与安全常见问题解答
为您详细解答关于 6.2万 清单索引、安全机制、更新同步、多平台配置与 OpenAPI 调用的全部细节。
Q1:什么是 ManiLuaHub 开源清单中心？
ManiLuaHub 是全球透明、开放的 Steam 游戏清单与 Lua 蓝图数据枢纽。全库索引 62,288 个 AppID 分支，为开源客户端、Modder 与开发者提供免 Key 的在线源码审查、Depot 分卷树透视与 OpenAPI 服务。
Q2:ManiLuaHub 生成的 Lua 蓝图与 key.vdf 是否安全？
100% 安全。ManiLuaHub 仅输出经过 SHA-256 哈希校验的纯文本 Lua 脚本与标准 key.vdf 配置文件，不请求任何 Steam 密码、令牌或 API Key，无系统 DLL 注入风险。
Q3:ManiLuaHub 如何与 Steam 官方游戏更新保持同步？
当游戏开发商推送新补丁或 DLC 时，Valve 会更新分卷清单的 GID 与散列值。我们的自动化系统每 24 小时与 GitHub ManifestHub 仓库保持双向校验同步。游戏更新后，只需在 ManiLuaHub 重新下载最新包覆盖即可。
Q4:Lua 脚本与 key.vdf 文件的技术区别是什么？
.lua 脚本是客户端识别游戏结构（AppID、分卷号、分支名与 DLC 映射）的蓝图指令；key.vdf 则记录了对应分卷的 AES-256 解密密钥。二者配合使用，实现免重构的分卷挂载。
Q5:使用 ManiLuaHub 是否需要申请 Steam Web API Key？
不需要。ManiLuaHub 100% 免费开放，无需注册 API Key，无需登录 Steam 账号，无任何隐私收集或后台遥测。
Q6:开发者如何调用公开的 OpenAPI 接口？
ManiLuaHub 提供免认证公开端点：GET /api/v1/manifest/:appId（获取 JSON 元数据）、GET /api/files/:appId/lua（获取纯文本脚本）、GET /api/files/:appId/zip（获取完整打包文件）。全接口支持 CORS 跨域。
Q7:Windows 10/11 系统下如何安装清单？
解压下载的 ZIP 压缩包：将 <appId>_public.lua 放入客户端 plugins/lua/ 目录，将 key.vdf 放入 data/ 目录。先启动客户端工具，确认状态为绿色就绪，再启动 Steam 即可在库中看到游戏。
Q8:macOS 苹果电脑如何使用 Whisky 或 CrossOver 运行？
在 macOS（支持 M1/M2/M3/M4 Apple Silicon 和 Intel）上，在安装了 Steam 的 Whisky 或 CrossOver 容器中运行客户端，将文件放置在虚拟盘符 drive_c/Program Files (x86)/SteamTools 目录下，先开客户端再开 Steam。
Q9:Steam Deck 掌机 (SteamOS) 如何配置清单？
长按电源键切换到「桌面模式」，下载客户端 Linux 便携包解压至 ~/.steamtools/，将清单文件放置在 plugins/ 目录并运行同步，切回「游戏模式」即可原生畅玩。
Q10:放入文件后 Steam 库中没有显示游戏怎么排查？
请排查：(1) Steam 是否未完全退出后台；(2) 脚本命名是否严格为 <appId>_public.lua；(3) 客户端代理钩子是否在 Steam 启动前已就绪。
Q11:如何提交缺失的 AppID 或贡献新清单？
所有 62,288 个分支均托管在 github.com/manilua-hub/ManifestHub3 开源仓库，欢迎社区开发者提交 Pull Request 或 Issue。
Q12:如何完全卸载或重置已安装的清单？
只需在 plugins/lua/ 目录删除对应的 .lua 脚本，并在 data/key.vdf 中删除该游戏对应的行，重启 Steam 即可完全清除本地清单记录。