让 AI 逆向一条「mod 下载链路」：从假下载器到 SteamCMD 批量拉取

让 AI 逆向一条"mod 下载链路"：从假下载器到 SteamCMD 批量拉取

摘要：为了给非 Steam 版的游戏装上整套 mod，我和 AI 一起从识别假下载器开始，先后穷举排除多种下载方案，逆向第三方站点的分段 API，最后用 SteamCMD 匿名登录做到了 85/86 批量下载成功。本文还原这条排查与逆向链路，以及每一步为什么会失败。

背景

很多人玩的游戏不是从 Steam 客户端订阅的——自然也就拿不到创意工坊（Workshop）的自动下载。当你想装一个"全 DLC mod 整合包"时，最常见的现实是：网上到处是"一键下载器"，但大多不靠谱。

这次的痛点是：要给游戏装一整套 mod 合集，需要稳定、批量、可复现地把上百个 mod 拉下来，而 Steam 客户端根本不会为这个账号下载订阅内容。花大量时间一个个手动下不现实。

正文

第一步：先搞清"为什么客户端不下订阅"

在动手找下载工具前，先确认基线：手动装基础 mod 是没问题的（把 mod 解压到游戏 mod 目录、改 ModsConfig.xml 即可）。真正卡住的是能不能批量。

于是目标明确为：找到一个能批量下载 Workshop 内容的通道。接下来就进入"穷举-排除"阶段。

第二步：穷举并排除假下载器

市面上形形色色的"Workshop 下载器"大多名不副实。我们逐个试、逐个排除：

方案	结果
网页版第三方下载站	多为假下载/套壳，实际下不到真正的 mod 文件
各种"一键下载"脚本	指向私有 API，key 已过期或根本无效
逆向第三方站点的分段 API	分析出三段请求，但关键 key 过期，无法稳定使用

这一段最大的收获不是"找到了什么"，而是如何快速判定一个下载器是假的：看它是否真的返回 mod 的原始文件、是否可复现、是否依赖随时会过期的短命 key。短命 key = 不能进入生产链路。

第三步：转向 SteamCMD 匿名批量

排除上面所有方案后，AI 提出了 SteamCMD——Valve 官方的命令行工具。关键洞察是：很多整合包 mod 是公开的，SteamCMD 可以用匿名身份（anonymous login）直接通过 Workshop 的 appid 把 mod 内容拉下来，不依赖任何个人订阅权限。

做法要点：

# 匿名登录
login anonymous

# 用 workshop item 的 appid 下载对应项目
workshop_download_item <app_appid> <workshop_id>

# 批量：写脚本循环传入 workshop id 列表

实操结果：85/86 个 mod 批量下载成功，只有 1 个失败（通常是 id 过期或被隐藏）。这个成功率对大多数整合包来说已经足够可用，失败的单个项可单独手动处理。

踩坑记录

• 别迷信"一键下载器"：很多页面看似能下，实际返回的是伪造文件或短命链接。判断标准永远是"能否稳定复现 + 是否返回原始文件"。
• 第三方 API 的分段 key 会过期：逆向出来后当天能用，第二天 key 失效就白搭。不适合作为长期方案。
• SteamCMD 匿名也有失败项：个别 mod 需要登录可见或已被隐藏，匿名拉不到，属于可接受的尾部噪音。
• Windows 下 \ 反斜杠会被 bash 转义：命令里的路径改成单引号 + 正斜杠（如 'C:/Users/.../mods'），否则会 unexpected EOF。

总结

这条链路最终的答案其实很简单：抛弃所有第三方下载器，回归官方的 SteamCMD 匿名批量下载。它可靠、可批量、不需要订阅权限，80+ 的成功率足以支撑一套整合包。

下一步值得做的：把 mod 清单的抓取也自动化（直接从整合包的说明/配置还原 id 列表），让"给清单 → 出全套 mod"变成一个一条命令可复现的流水线。