SteamTools / Watt Toolkit 使用教程与清单入库指南
掌握在 SteamTools 与 Watt Toolkit (原 Steam++) 中生成与安装 .lua 脚本及 key.vdf 清单的完整流程，支持 Windows、macOS Whisky 与 Steam Deck 掌机。
四步极速入库流程
步骤 1：检索游戏并下载已验证清单包
在 SteamToolsApp.com 搜索栏中输入您想要的游戏（支持游戏名称或纯数字 App ID）。点击「下载 ZIP 解锁全套包」，即可获取包含 .lua 脚本与 key.vdf 分卷解密密钥的完整压缩包。
步骤 2：解压文件至 SteamTools 指定目录
解压下载的 ZIP 压缩包，将 <appId>_public.lua 文件复制到 SteamTools 安装目录下的 plugins/lua/ 文件夹中，将 key.vdf 密钥文件复制到 data/ 文件夹中。
步骤 3：先启动 SteamTools 桌面客户端
启动 SteamTools (Watt Toolkit) 桌面应用程序。确认本地清单路由引擎启动就绪，右下角本地网络钩子状态指示灯转为常亮绿色。
步骤 4：启动官方 Steam 客户端并同步
打开官方 Steam 桌面客户端。Steam 将自动识别本地清单描述符，游戏将立即出现在您的游戏库中，可直接从 Valve 官方高速 CDN 节点开始下载与畅玩。
SteamTools 工作运行原理
无需复杂技术配置，不到 2 分钟即可完成任意游戏的本地清单同步。
1. 检索与生成
在上方生成器中输入任意 Steam App ID 或游戏名称，秒级编译纯净的 Lua 脚本与 Depot 密钥。
2. 解压放入插件目录
解压下载的 ZIP 压缩包，将 .lua 文件移动至 SteamTools 的 plugins/lua/ 目录，key.vdf 放入 data/ 目录。
3. 启动并同步入库
启动 SteamTools 客户端后打开 Steam，游戏将自动同步显示在您的 Steam 本地库中，即可高速下载与畅玩。
多操作系统环境安装与配置详解
针对 Windows 10/11、Steam Deck 掌机、macOS 及 Linux 发行版提供原生目录映射与故障排查方案。
Windows 10 / 11 原生环境部署
在 Windows 系统中，SteamTools（Watt Toolkit）通过本地轻量代理建立管道。请遵循标准放置路径：
C:\Program Files (x86)\SteamTools\plugins\lua\<appId>_public.luaC:\Program Files (x86)\SteamTools\data\key.vdf💡 Windows 避坑与安全提示
- 初次启动出现 Windows Defender 提示时，点击“更多信息” ➔ “仍要运行”。软件开源无毒，误报属于通用行为启发式检测机制。
- 必须保持顺序：先启动 SteamTools 并确认右下角状态指示灯转为常绿，然后再打开官方 Steam 客户端。
Lua 脚本核心参数与清单语法深度解析
SteamToolsApp 为每款游戏生成的清单数据包均包含经过语法优化的高性能 Lua 配置表，在客户端启动时由本地代理钩子实时解析。深入理解这些核心参数有助于进阶用户自定义分支与 DLC 配置：
授权指示器：通知本地客户端钩子对该游戏主包及其关联的所有子分卷 (Sub-depots) 进行统一预授权，免除繁琐的手动权限分配。
清单 GID 映射表：精确绑定 64 位全局唯一清单标识符与对应的 Depot ID，锁定稳定可靠的正式发行版本。
分卷声明列表：罗列游戏主执行程序、高清材质贴图、多语言语音包以及全部 DLC 扩展内容的 Depot ID 编号。
AES-256 密钥集合：提供各加密分卷对应的 256 位底层解密秘钥，供 Steam 客户端向官方 CDN 请求数据块时直接解密。
常见错误与故障排查矩阵
错误现象：“清单不可用”或“连接超时”
此情况通常发生在 SteamTools 尚未完全建立本地 HTTP 路由管道前就提前启动了 Steam。解决办法：在任务管理器中彻底退出 Steam，右键以管理员身份启动 SteamTools，确认指示灯为常亮绿色后，再重新打开 Steam 客户端。
错误现象：新发布游戏或大版本更新后提示“无许可证”
对于近期刚上架的全新大作或经历大版本热更新的游戏，Valve 可能会轮换分卷清单哈希或加密密钥。请重新访问 SteamToolsApp.com 搜索对应的 App ID，下载全套最新 ZIP 压缩包并覆盖旧文件以获取最新的安全哈希。
入库前检查清单与安全合规规范
切勿在 Steam 处于下载或运行状态时复制注入 Lua 脚本。在启动 SteamTools 服务前，请确保系统托盘中的 Steam 进程已完全退出。
确保下载的脚本文件名与 Steam 商店链接中的纯数字 App ID 严格一致，防止分卷与解密密钥发生混淆。
SteamTools 采用无侵入本地清单描述重构，绝不向游戏主内存注入动态链接库。对于竞技排位服务器，建议使用官方正版接入。
本地游戏存档与配置存放在系统的 AppData 或“我的文档”标准目录中，更新清单或切换版本绝不会丢失任何游戏存档数据。
您需要了解的一切常见解答
Q:什么是 SteamTools？它与 Watt Toolkit (Steam++) 有什么区别？
SteamTools、Steam++ 和 Watt Toolkit 是同一款开源工具软件在不同发展阶段的名称。本站生成的 .lua 脚本与 key.vdf 密钥文件完全通用，您可以在本站直接下载最新的官方正版安装包。
Q:使用 SteamTools 生成的清单安全吗？
非常安全。SteamToolsApp 仅生成开源纯文本 Lua 脚本与标准 key.vdf 配置文件，不要求提供 Steam 密码、令牌或 API Key，且不注入修改任何系统底层 DLL。
Q:下载后的 .lua 和 key.vdf 文件应该放在哪里？
解压下载的 ZIP 压缩包，将 <appId>_public.lua 放入 SteamTools 安装目录下的 plugins/lua/ 文件夹，将 key.vdf 放入 data/ 文件夹，重启 SteamTools 与 Steam 即可。
Q:SteamTools 是否支持 macOS 和 Steam Deck 掌机？
完全支持！SteamTools 为 macOS（适配 M1/M2/M3/M4 Apple Silicon 和 Intel）提供原生及 Whisky 方案，并为 Linux 与 Steam Deck (SteamOS 3.0+) 提供原生便携包。
Q:复制文件后为什么 Steam 库中没有显示游戏？
请确认已完全退出后台的 Steam 与 SteamTools 并重新启动，且确保 Steam 处于已登录状态。检查 .lua 脚本命名是否与游戏 App ID 保持一致。