Steam 清单与 Lua 蓝图极速使用教程
从清单下载、解压放置到 Steam 客户端一键识别的完整步骤。支持 Windows 11、macOS Whisky 与 Steam Deck 掌机环境。
第 1 步：检索目标游戏并下载数据包
在 ManiLuaHub.com 首页输入游戏名称（如黑神话）或 App ID（如 2358720），点击「下载 ZIP 全套包」获取包含 .lua 与 key.vdf 的归档文件。
第 2 步：解压文件至对应插件目录
解压下载的 ZIP 压缩包：将 <appId>_public.lua 文件移至 plugins/lua/ 目录；将 key.vdf 移至 data/ 目录。
第 3 步：先启动客户端工具
双击运行桌面端管理工具（如 SteamTools），确认本地清单代理钩子已就绪，状态指示灯为绿色正常。
第 4 步：启动 Steam 客户端完成同步
启动官方 Steam 客户端。Steam 将自动识别挂载的清单，游戏直接出现在「库」中，可直接从 Valve 官方服务器下载。
遇到 Steam 社区 101/105 错误，或游戏下载断流限速？
国内访问 Steam 边缘节点及 Manifest 清单常遭网络波动。推荐搭配 雷神加速器， 按分钟精准计费、时长不用随时可暂停，告别月卡浪费，畅享满速下载与极低联机延迟。
多平台运行环境配置详解
适配 Windows 10/11、macOS Whisky 与 Steam Deck 掌机系统的详细路径。
Windows 10 / 11 原生环境配置
在 Windows 操作系统中，客户端工具作为后台请求挂钩服务运行。请确保您的安全软件（如 Windows Defender）将解压目录列入信任白名单。
存放 Lua 清单脚本的默认路径为：C:\Program Files (x86)\SteamTools\plugins\lua\。请确保文件名称格式为 <appId>_public.lua。
macOS (Apple Silicon M1~M4 与 Intel 芯片)
Mac 用户可在专用的 Whisky 或 CrossOver 容器中运行 Windows 版 Steam。创建一个 64 位 Windows 10 容器，安装 Windows Steam 客户端，并将脚本部署在同一容器内。
虚拟容器内部对应路径：drive_c/Program Files (x86)/SteamTools/plugins/lua/。
Steam Deck 掌机 (SteamOS 3.0+ 桌面模式)
长按 Steam Deck 电源键选择「切换至桌面模式 (Switch to Desktop)」。下载 Linux 独立原生包并解压至 <code className="text-violet-300 font-mono bg-black/40 px-2 py-0.5 rounded">~/.steamtools/</code>。
将下载的清单文件复制到 ~/.steamtools/plugins/，执行同步脚本，随后切回游戏模式即可通过手柄畅玩。
关于 ManiLuaHub 的常见问题解答
Q:什么是 ManiLuaHub 开源清单中心？
ManiLuaHub 是全球透明的 Steam 游戏清单与 Lua 蓝图开放数据枢纽。全库索引 62,288 个 AppID 分支，为开源客户端、Modder 与开发者提供免 Key 的在线源码审查、Depot 分卷树透视与 OpenAPI 服务。
Q:ManiLuaHub 生成的 Lua 蓝图与 key.vdf 是否安全？
100% 安全。ManiLuaHub 仅输出经过 SHA-256 哈希校验的纯文本 Lua 脚本与标准 key.vdf 配置文件，不请求任何 Steam 密码、令牌或 API Key，无系统 DLL 注入风险。
Q:下载后的 .lua 脚本与 key.vdf 应该放在哪里？
解压下载的 ZIP 归档包：将 <appId>_public.lua 放入客户端 plugins/lua/ 目录，将 key.vdf 放入 data/ 目录，重启客户端与 Steam 即可完成分卷挂载。
Q:开发者如何调用公开的 OpenAPI 接口？
ManiLuaHub 提供免认证公开端点：GET /api/v1/manifest/:appId（获取 JSON 元数据）、GET /api/files/:appId/lua（获取纯文本脚本）、GET /api/files/:appId/zip（获取完整打包文件）。
Q:ManiLuaHub 是否支持 macOS 与 Steam Deck 掌机？
完全支持！所有生成的 .lua 与 key.vdf 文件严格采用 POSIX LF 换行符标准，完美兼容 Windows 11、macOS Whisky/CrossOver 以及 Steam Deck (SteamOS 3.0+)。
Q:ManiLuaHub 与 GitHub ManifestHub 仓库的关系是什么？
ManiLuaHub 的数据底层直连 github.com/manilua-hub/ManifestHub3 官方 62,288 个分支，保持 24 小时实时双向哈希审计，确保分卷信息时刻最新。