steam

🎮 Steam 游戏库智能管家

编辑精选

基于 Steam API 的游戏库管理工具,支持按游玩时长、评价和 Steam Deck 兼容性筛选,助你快速发现心仪游戏。

收藏
4.2k
安装
1.6k
版本
v0.4.0
CLS 安全性认证2026-05-03
点击查看完整报告 >

使用说明

Steam Games CLI 是一款专为 Steam 玩家设计的命令行工具,通过对接 Steam 官方 Web API,为用户提供高度灵活的游戏库浏览与智能筛选能力。不同于 Steam 客户端的基础浏览功能,该工具支持基于游玩时长、用户评价、Steam Deck 兼容性等多维度的精准过滤,并针对 AI Agent 场景优化了 JSON 输出格式,使游戏推荐和工作流自动化成为可能。

核心用法围绕 steam 命令展开,主要分为配置查询、库浏览和智能筛选三大类。用户首先需配置 Steam API Key 和用户 ID,随后可通过 steam library 查看完整游戏库,或使用 --unplayed--min-hours 等参数筛选特定游玩状态的游戏。工具支持 9 级评价过滤(从"差评如潮"到"好评如潮"),并可按 440+ 个 Steam 标签或类型精准定位游戏。特别针对 Steam Deck 用户,--deck-compat 参数可快速筛选出"已验证"或"可玩"的掌机适配游戏。对于 AI Agent,工具提供了流式融合和早期终止机制,通过 --json 输出支持脚本化处理。

显著优点在于其多维度交叉筛选能力和对 Steam Deck 生态的深度支持。玩家可以组合"未玩过+Deck 已验证+评价 8 分以上+Roguelike 标签"等复杂条件,瞬间从数百款游戏中找到目标。性能优化方面,工具优先应用本地过滤器(如游玩时长),仅对必要数据发起 API 请求,大幅提升了响应速度。此外,纯文档型的实现方式使其具备极高的透明度和可审计性。

潜在缺点主要涉及部署门槛和来源可信度。该技能本身为纯文档,但实际运行依赖外部 steam CLI 工具,用户需自行通过 npm 安装并配置 Steam API Key,对非技术用户不够友好。来源方面,项目托管于个人开发者账号(T3 等级),缺乏组织背书和明确的开源许可证声明。此外,筛选功能受限于 Steam API 的速率限制和可用性,在网络不稳定时体验可能受影响。

该工具最适合拥有庞大 Steam 游戏库(数百款以上)的重度玩家,特别是 Steam Deck 掌机用户,以及需要自动化游戏推荐流程的内容创作者。对于希望系统化管理"待玩清单"(Pile of Shame)的玩家,其"未玩过+高评价"组合筛选尤为实用。

使用风险主要包括 API Key 的安全管理和数据隐私。Steam API Key 属于敏感凭证,需妥善保管避免泄露。虽然工具本身不收集数据,但通过 Steam API 获取的游戏数据受 Steam 隐私政策约束。此外,作为个人维护项目,长期更新和支持的稳定性存在不确定性,建议用户关注上游 CLI 工具的版本更新。

安全解读

核心用法

Steam Games CLI 是一款面向Steam玩家的命令行游戏库管理工具,通过Steam官方Web API获取用户游戏数据,支持多维度筛选与发现功能。

主要功能模块

| 模块 | 功能说明 |
|------|---------|
| `whoami` | 查看用户资料与库统计 |
| `library` | 浏览全部游戏,支持分页与JSON输出 |
| `tags` / `genres` | 列出Steam全部440+标签与类型 |

筛选能力(组合使用)

  • 游戏时长--unplayed / --min-hours / --max-hours / --deck(Deck游玩时长)
  • 评价等级:1-9级评分体系,从"好评如潮"到"差评如潮"
  • Steam Deck兼容verified(完美支持)、playable(可玩)、ok(两者皆可)
  • 标签/类型:精确匹配Steam官方标签体系
  • 排序方式:名称、游玩时长、Deck时长、评价、兼容性

典型应用场景

# Deck上玩什么:高评价且验证过的游戏
steam library --deck-compat verified --min-reviews 7 --sort playtime

# 挖掘未玩的高分Roguelike
steam library --unplayed --tag "Roguelike" --min-reviews 8 --sort reviews

显著优点

1. AI Agent优化设计:流式融合+提前终止机制,本地筛选优先执行,大幅减少API调用
2. 组合筛选灵活:支持时长、评价、Deck兼容、标签的四重交叉筛选

3. 输出格式友好:彩色表格/纯文本/JSON三模态,适配终端阅读与脚本集成

4. 纯文档型Skill:零代码执行风险,所有功能依赖用户本地安装的CLI工具

局限性与注意事项

  • 依赖外部CLI:需自行安装steam-games-cli(npm包)并配置Steam API Key
  • API密钥管理:Steam API Key为个人敏感凭证,需妥善保管
  • 网络依赖:评价、Deck兼容、标签数据需实时请求Steam服务器
  • 无持续维护信号:GitHub仓库未明确声明开源许可证

适合人群

  • Steam库游戏数量庞大、难以决策"玩什么"的玩家
  • Steam Deck用户寻找验证兼容的游戏
  • 习惯命令行工具、偏好精准筛选而非算法推荐的用户
  • 需要将游戏数据集成到自动化工作流的开发者

常规风险

  • 凭证泄露风险:API Key若配置在环境变量或命令历史中,存在意外暴露可能
  • API调用限制:Steam Web API存在速率限制,频繁筛选可能触发限制
  • 数据时效性:游戏评价与Deck兼容状态为请求时点快照,非实时同步

steam 内容

手动下载zip · 2.0 kB
SKILL.mdtext/markdown
请选择文件