Steam游戏命令行界面

用于浏览和发现您Steam库中游戏的行命令界面。可按游戏时长、评价、Deck兼容性、类型和标签进行筛选。

安装

npm install -g steam-games-cli

设置

1. 从以下网址获取Steam网络API密钥：https://steamcommunity.com/dev/apikey
2. 配置命令行界面：

steam config set-key YOUR_API_KEY
steam config set-user YOUR_STEAM_ID

命令

个人资料

steam whoami               # Profile info and library stats
steam whoami --json

游戏库

steam library              # List all games
steam library --limit 10   # Limit results
steam library --json       # JSON output for scripting

标签与类型（即时）

steam tags                 # List all 440+ Steam tags
steam tags --json
steam genres               # List all genres
steam genres --json

筛选选项

游戏时长

steam library --unplayed                    # Never played
steam library --min-hours 10                # At least 10 hours
steam library --max-hours 5                 # Less than 5 hours
steam library --deck                        # Played on Steam Deck

评价（1-9级）

steam library --reviews very-positive       # Exact category
steam library --min-reviews 7               # Score 7+ (Positive and above)
steam library --show-reviews                # Show review column

等级分类：好评如潮 (9)，特别好评 (8)，好评 (7)，多半好评 (6)，褒贬不一 (5)，多半差评 (4)，差评 (3)，特别差评 (2)，差评如潮 (1)

Steam Deck兼容性

steam library --deck-compat verified        # Verified only
steam library --deck-compat playable        # Playable only
steam library --deck-compat ok              # Verified OR Playable
steam library --show-compat                 # Show Deck column

标签与类型

steam library --tag "Roguelike"             # Filter by tag
steam library --genre "Strategy"            # Filter by genre
steam library --show-tags                   # Show tags column

排序

steam library --sort name                   # Alphabetical (default)
steam library --sort playtime               # Most played first
steam library --sort deck                   # Most Deck playtime first
steam library --sort reviews                # Best reviewed first
steam library --sort compat                 # Best Deck compat first

AI代理工作流

本命令行界面通过流融合与早期终止机制，专为AI代理优化。

第一步：发现可用标签/类型（即时）

steam tags --json
steam genres --json

第二步：使用组合条件筛选游戏库

# Unplayed Deck Verified roguelikes with good reviews
steam library --unplayed --deck-compat verified --tag "Roguelike" --min-reviews 7 --limit 10 --json

# Well-reviewed strategy games under 5 hours
steam library --max-hours 5 --genre "Strategy" --min-reviews 8 --limit 5 --json

# Trading games playable on Deck
steam library --tag "Trading" --deck-compat ok --limit 10 --json

性能说明

• 本地筛选条件（游戏时长、未玩过的）首先应用 - 即时生效
• 远程筛选条件（评论、Deck兼容性、标签）针对每个游戏并行获取
• 提前终止：达到限制后即停止
• 优先使用本地筛选条件以最小化API调用

使用示例

用户：“我的Steam Deck上应该玩什么？”

steam library --deck-compat verified --min-reviews 7 --sort playtime --limit 10

用户：“我有哪些 Roguelike 类游戏？”

steam library --tag "Roguelike" --show-tags --limit 20

用户：“有哪些评价很高但我还没玩过的游戏？”

steam library --unplayed --min-reviews 8 --sort reviews --limit 10 --show-reviews

用户：“我总共有多少游戏？”

steam whoami

用户：“哪些策略游戏能在 Deck 上运行？”

steam library --genre "Strategy" --deck-compat ok --show-compat --limit 15

用户：“有哪些可用的标签？”

steam tags --json

输出格式

• 默认：彩色表格
• --plain：纯文本列表
• --json：用于脚本/AI代理的JSON格式