返回首页

常见问题

SteamTools.games 更长、更深入的 FAQ：它做什么、不做什么，以及出问题怎么修。

最近更新: 2026-06-29

首页的 FAQ 块回答了被问得最多的六个问题。本页是更长的版本——包括每月出现几次的提问、边界情况、以及那些用过几次生成器之后仍然会让人困惑的东西。如果你的问题不在这里，Discord 是最快拿到真实答案的渠道。

一句话讲清楚 SteamTools.games 是什么？

一个免费的、基于浏览器的工具，用于产出 SteamTools 解锁指定 App ID 所需的 manifest 与 lua 文件。它是 Steam 公开 API 之上的薄薄一层，不会改动你电脑上的任何游戏文件。

这个站和 SteamTools、SteamDB、Valve 有关系吗？

没有。本站由社区成员独立运营。Steam 名称、SteamTools 名称、SteamDB 名称归各自所有者所有，我们仅在合理使用范围内做说明性引用。

SteamTools 已经有生成器了，为什么还要做这个站？

SteamTools 官方的生成器挂在一个第三方域名上，这些年可靠性出过问题。SteamTools.games 当时是作为更稳的替代品搭起来的。两边产出的文件等价；本站的目标是更快、更稳定、更透明。

怎么找到我已拥有游戏的 App ID？

三种可靠方式，按推荐顺序：

  1. 从商店 URL：打开游戏的商店页，复制 /app/ 后下一条 / 前的数字。比如 https://store.steampowered.com/app/400/Portal/ -> 400。
  2. 从 SteamDB：搜游戏，看 SteamDB 应用页顶部链回规范商店 URL 的那个链接，复制里面的数字。
  3. 从本地 Steam 安装目录：每个已装游戏在 steamapps 目录下都有一份 appmanifest_<APPID>.acf。文件名里的数字就是 App ID。

有一个完整的演示在另一页。

生成器为什么返回 "App not found in the Steam store"？

四种最常见的原因，按频率排序：

  1. 数字错了。 多数情况是你给的是 package ID、depot ID 或 build ID，不是 App ID。和规范商店 URL 对照一下。
  2. 区域锁定的应用。 生成器目前查询 cc=us。如果应用只在某个特定区域销售，查询就会返回空。
  3. 下架应用。 SteamDB 仍保留记录，但 appdetails 已经不再返回它。SteamTools 没法工作在已下架的应用上。
  4. 笔误。 前导零、尾部空格、千分位分隔符——任何一种都会触发这个错误。

生成器为什么返回 429？

生成器对 POST /api/generate 强制每个 IP 之间至少 1.5 秒的间隔。请求频率超过这个值，会拿到 429，响应头里带 Retry-After。Steam 上游自身也限速。遇到这种情况，等 5–10 秒再试就行。

如果你要脚本化调用 API，正确的姿势是指数退避，封顶 10 秒。这里没有"API key"、没有高级档位——所有客户端都是同一个限速。

服务安全吗？会保存我的数据吗？

服务不要注册、不设追踪 cookie、不把搜索历史写盘。短期处理的数据只有搜索关键词和你点中的那个 App ID，且只用一次。服务器日志每 14 天滚动清理。完整细节见隐私政策。

为什么文件叫 *.lua，里面有什么？

Lua 文件是一段小脚本，告诉 SteamTools 这个 app 要加载哪些 depot。里面只有两行：一行注册 App ID 和它的 depot 解密密钥，一行让 SteamTools 拿到该 depot 的具体 build。完整拆解在manifest 文件详解页。

能不能脚本化调用 API？

可以。两个端点：

  • GET /api/search?query=<name-or-appid> —— 返回最多 5 条匹配的 JSON。
  • POST /api/generate，JSON body { "appId": "<id>", "branch": "<optional>" } —— 返回 manifest URL、lua URL、校验过的游戏名和图片、简短的步骤说明。

两个端点都受 IP 限速（search 300 ms、generate 1.5 s）。这里没有 API key、没有配额上限，IP 上唯一的限制就是这个限速。请不要以高于 1.5 s/次的频率脚本化调用。

我能在自己的网站里嵌入这个生成器吗？

端点是一个公开的、无需鉴权的 JSON API。只要你尊重限速，可以从自己的前端调用它。站点没有除默认值之外的 CORS 策略；如果你碰到 CORS 问题，给 Discord 留个言。

首页"最近"那一栏到底是干嘛的？

它从单个 localStorage key（steamtools.recent.v1）读取，渲染你最近 30 天生成过的 App ID。没有任何东西会上传到服务端。随时可以在浏览器的站点数据里清掉。

我发现了一个 bug / 生成器对某个 app 给的结果不对，怎么办？

最快的渠道是 Discord。丢过来 App ID、你用的 URL、以及你期望发生什么，版主会把它转给对的人。大多数问题一小时内会进入处理流程。

有没有办法支持这个项目？

没有捐款页面、没有 Patreon、没有周边。本站由一小群社区成员自费维护，规模刻意保持得小，所以成本几乎可以忽略。如果你想支持，最有用的事情是在 Discord 报 bug，以及把本站告诉其他 SteamTools 用户。

"热门游戏"那一栏为什么缺一些游戏？

热门游戏由一小群版主策展，每月更新一次。如果你觉得应该有的某个游戏没在里面，给 Discord 留言，下次刷新的时候大概率会加上。

服务挂了会怎样？

会在博客发通知，并在首页挂横幅。如果服务长时间不可用，Discord 里会有一条置顶消息指向可用的替代品。

本站规模小到单个维护者可以在全新 VPS 上十分钟内重新部署，所以长时间中断不太可能。短时间的抖动确实偶尔有——多数时候是因为 Steam 自己的 API 状态不好；那种情况会自行恢复。