SteamTools 插件完整使用指南

本文面向希望把"搜索 -> 下载 -> 导入 -> 验证"流程一次打通的用户。内容覆盖目录结构、Lua 文件意义、自动入库策略与排错建议。

1. 为什么以 Lua 作为入库载体

在方舟助手中,Lua 文件承担“可执行配置描述”的角色。相比手动填充参数,Lua 方案更易复用、可追踪,也便于你对历史版本做差异比对。建议在本地建立 backup-lua 目录保存已验证文件,避免后续覆盖。

2. 推荐目录布局

  • Steam/config/stplug-in/:插件实际读取目录。
  • Steam/config/stplug-in/archive/:手动备份目录。
  • Steam/config/stplug-in/logs/:你自定义的日志留存目录(可选)。

每次导入前建议检查同名旧文件,避免历史配置与新配置混用。

3. 标准导入流程

  1. 在方舟助手搜索目标游戏,确认 AppID。
  2. 下载 Lua 配置并核对文件大小是否正常。
  3. 移动到插件目录,重启 Steam。
  4. 若站点支持自动入库,可授权目录后直接写入,减少手动复制步骤。

4. 常见误区

  • 误把“下载成功”当成“入库成功”:目录错误时会导致插件无法读取。
  • 长期复用旧 Lua:上游数据变更后旧配置可能失效,建议按需更新。
  • 高频重复点击下载:可能触发限流,反而延长处理时间。

5. 维护建议

为保证稳定性,建议每周进行一次目录巡检:删除无效旧文件、整理备份并记录近期失败 AppID。若某个 AppID 连续失败,请在反馈工单中附带错误码与发生时间,便于后台快速定位缓存或上游资源状态。