Steam游戏库智能筛选专家

Steam游戏库命令行管理工具，支持按游玩时长、评价、Steam Deck兼容性及标签筛选，帮助用户快速发现想玩的游戏。

基本信息

• 技能名称?Steam Games CLI
• 中文名称?Steam游戏库智能筛选专家
• 作者?mjrussell
• 分类?专业技能
• 版本?0.4.0
• 标签?gaming, steam, cli, game-library, steam-deck, recommendation, filtering

使用方法

使用说明
核心用法
Steam Games CLI 是一款面向 Steam 玩家的命令行工具，用于浏览、筛选和发现个人游戏库中的游戏。用户需先配置 Steam Web API 密钥和 Steam ID，即可通过简洁的命令查询库中游戏。
主要功能模块：

1. 基础信息查询 ： steam whoami 查看个人资料与库统计， steam library 列出全部游戏
2. 多维度筛选 ：支持按游玩时长（未玩过、最少/最多小时数）、用户评价（1-9分制）、Steam Deck 兼容状态（Verified/Playable）、游戏标签（440+）和类型进行过滤
3. 智能排序 ：可按名称、游玩时长、Deck游玩时长、评价或兼容性排序
4. AI优化输出 ：提供 --json 格式便于脚本和AI代理处理，支持流式融合和早终止优化
   典型使用场景：
   寻找适合 Steam Deck 的高分未玩游戏
   按特定标签（如"Roguelike"）快速定位游戏
   筛选短时长精品游戏或长期投入的佳作
   显著优点
   精准筛选能力 ：组合过滤条件极为强大，可一次性应用多个维度（如"未玩过的、Deck验证通过的、评价8分以上的独立游戏"）
   Steam Deck 原生支持 ：专门针对掌机用户设计，兼容状态查询实用
   性能优化 ：本地过滤优先执行，远程API并行获取，带结果限制时自动早终止
   开发者友好 ：JSON输出、纯文本模式、环境变量配置，易于集成到自动化工作流
   潜在缺点与局限性
   依赖外部API ：需自行申请 Steam Web API 密钥，且受Steam API速率限制
   非官方工具 ：由社区开发者维护，存在API变更导致功能失效的风险
   功能边界 ：仅支持读取库信息，无法启动游戏、修改库或进行购买操作
   网络依赖 ：评价、标签、Deck兼容等数据需联网获取，离线功能受限
   适合人群
   Steam Deck 用户寻找优化游戏体验
   拥有大量游戏、需要"发现"未玩佳作的重度玩家
   希望用脚本自动化游戏库管理的开发者/极客用户
   游戏推荐场景下的AI代理集成
   常规风险
   API密钥泄露风险 ：Steam API密钥需妥善保管，硬编码或共享可能导致账户风险
   隐私暴露 ：库数据包含个人游戏偏好和游玩时长，分享输出时需注意脱敏
   数据准确性 ：依赖Steam商店数据更新，可能存在标签缺失或兼容状态滞后
   服务可用性 ：Steam API服务不稳定时工具可能失效