Game Library - 跨平台游戏库查询（含中文名）
统一查询 Steam 和 Epic Games 游戏库，自动显示中文游戏名。
已配置平台
| 平台 | 用户 | CLI |
|---|---|---|
| Steam | steam |
|
| Epic | legendary |
首次使用前，请将上述占位符替换为你自己的 Steam ID 和 Epic 账号名。 Steam CLI 需要设置
STEAM_API_KEY环境变量。 Epic 平台使用 legendary CLI，需先pip install legendary-gl并登录。
核心脚本
bash {skill_dir}/scripts/game_query.sh <command> [options]
命令一览
| 命令 | 说明 |
|---|---|
stats |
跨平台游戏库统计 |
list |
列出所有平台游戏（含中文名） |
search <关键词> |
跨平台搜索（支持中文名搜索） |
unplayed |
列出未玩过的游戏 |
recommend |
推荐高分未玩游戏 |
steam [opts] |
直接调用 Steam CLI（透传参数） |
epic |
列出 Epic 游戏库（含中文名） |
cn-update |
更新中文名缓存（从 Steam API 批量获取） |
cn-update-xhh |
从小黑盒补充中文名（无需 API Key） |
duplicates |
查找跨平台重复游戏 |
help |
显示帮助 |
中文名机制（双源）
中文名来自两个数据源，互补覆盖：
- Steam API（
l=schinese参数） — 覆盖约 33% 的游戏 - 小黑盒网页版（
api.xiaoheihe.cn/game/share_game_detail） — 无需 API Key，覆盖约 87% 的游戏
- 先运行
cn-update（Steam API），再运行cn-update-xhh（小黑盒补充） - 最终缓存到
cn_names_cache.json - 游戏同时显示中文名和英文名，如：
黑神话：悟空（Black Myth: Wukong） - 无独立中文名的游戏只显示英文名
- 搜索同时匹配中文名和英文名
- 定期运行两个更新命令刷新缓存
中文名工具脚本
# 更新中文名缓存（Steam API，约 7-8 分钟）
python3 {skill_dir}/scripts/cn_names.py update
# 从小黑盒补充（无需 API Key，约 1 分钟）
python3 {skill_dir}/scripts/xhh_cn_names.py
# 查询单个游戏中文名
python3 {skill_dir}/scripts/cn_names.py lookup "Darkest Dungeon"
# 导出所有中英文映射
python3 {skill_dir}/scripts/cn_names.py export
示例
# 查看统计
bash {skill_dir}/scripts/game_query.sh stats
# 搜索跨平台（支持中文关键词）
bash {skill_dir}/scripts/game_query.sh search 悟空
bash {skill_dir}/scripts/game_query.sh search borderlands
# Steam 高级筛选（透传 steam CLI 参数）
bash {skill_dir}/scripts/game_query.sh steam --unplayed --tag "Roguelike" --min-reviews 7 --limit 10
直接使用 Steam CLI
Steam CLI 功能更丰富，需要精细筛选时直接使用：
steam library --unplayed --min-reviews 7 --deck-compat verified --limit 10
steam tags --json
steam genres --json
steam whoami
注意事项
- Epic 平台没有公开的游玩时长/评价 API，功能受限（仅能列出游戏库）
- 脚本自带 1 小时数据缓存，避免频繁 API 调用；需要刷新时删
/tmp/game-library-cache/ - 中文名缓存更新：
cn-update约 7-8 分钟（按游戏数 × 1.5s 限速），cn-update-xhh约 1 分钟（0.3s/个），建议每周运行一次 - 小黑盒网页版不需要 API Key，直接爬取页面 title 标签获取中文名
- Legendary CLI 安装：
pip install legendary-gl，然后legendary auth登录