Repository navigation
Steam Import ZH
将你的 Steam 游戏库导入 Tonkatsu Box。游戏会与 IGDB 数据库进行匹配，同时带上游玩时长与状态跟踪。
| Steam 数据 | Tonkatsu Box |
|---|---|
| 拥有的游戏 | 匹配到 IGDB 的游戏 |
| 游玩时长 | 保存为用户备注（「Steam: 2.1h」） |
| 最近游玩日期 | 保存为「最近活动」日期 |
| 游玩时长 > 0 的游戏 | 状态为「进行中」 |
| 未游玩的游戏 | 状态为「未开始」 |
| 未匹配的游戏 | 加入愿望单 |
| DLC、原声、试玩 | 自动过滤 |
- IGDB API 密钥：用于把 Steam 游戏匹配到 IGDB 数据库。设置 IGDB
- Steam Web API 密钥：在 steamcommunity.com/dev/apikey 免费获取
- Steam ID（64 位）：在 steamidfinder.com 查找你的 ID
- 公开的 Steam 个人资料：你的游戏库必须可见
- 在 Tonkatsu Box 中进入 设置 → 导入 → Steam 游戏库
- 输入你的 Steam API 密钥
- 输入你的 Steam ID（64 位）
- （可选）勾选 记住凭据，把 API 密钥和 Steam ID 保存在本地，下次打开表单时会自动填好。取消勾选后再开始导入，会清除已保存的这对凭据。
- 选择目标收藏：
- 新建收藏：创建「Steam Library」
- 使用现有收藏：从下拉列表中选择
- 点击 导入
导入过程中你会看到：
- 当前阶段（获取游戏库、匹配游戏）
- 带当前 / 总数计数的进度条
- 正在匹配的游戏名称
- 实时计数：已导入、已加入愿望单、已更新
对你 Steam 游戏库中的每一款游戏：
- 应用按游戏名称在 IGDB 中搜索
- 它会挑选最佳匹配：完全同名 > 部分字符串匹配 > 第一个结果
- 如果找到，游戏会以 PC 平台加入收藏
- 如果找不到，游戏会连同媒体类型提示保存到你的 愿望单
导入到现有收藏时：
- 已在收藏中的游戏会被 更新（而非跳过）：
- 游玩时长备注会刷新为最新数据
- 「最近活动」日期会根据 Steam 的「最近游玩」更新
- 状态只会从「未开始」升级到「进行中」（绝不会把「已完成」或「已弃置」降级）
- 愿望单条目会去重：同名的现有未解决条目不会重复添加
IGDB 有每秒 4 次请求的限制。导入器会自动加入延时以保持在限制之内。200 款游戏的游戏库大约需要 1 到 2 分钟。
- 你可以重新导入以更新游玩时长数据，现有项目会被更新而不会重复
- 被过滤为 DLC / 原声 / 试玩的游戏不会出现，这是根据游戏名称自动判断的
- 如果没有设置 IGDB 连接，导入界面顶部会出现警告