名称： steam
描述： 浏览、筛选和发现 Steam 库中的游戏。可按游戏时长、评测、Steam Deck 兼容性、类型和标签进行筛选。适用于用户询问其 Steam 游戏、推荐游戏、或 Steam Deck 兼容游戏时。
主页： https://github.com/mjrussell/steam-cli
元数据：
clawdbot:
emoji: "🎮"
requires:
bins: ["steam"]
env: ["STEAM_API_KEY"]

Steam 游戏命令行工具

用于浏览和发现您 Steam 库中游戏的命令行工具。支持按游戏时长、评测、Deck 兼容性、类型和标签进行筛选。

安装

npm install -g steam-games-cli

设置

1. 从 https://steamcommunity.com/dev/apikey 获取 Steam Web API 密钥。
2. 配置命令行工具：
   bash steam config set-key 你的_API_密钥 steam config set-user 你的_STEAM_ID

命令

个人资料

steam whoami               # 显示个人资料信息和库统计
steam whoami --json        # 以 JSON 格式输出

游戏库

steam library              # 列出所有游戏
steam library --limit 10   # 限制结果数量
steam library --json       # 以 JSON 格式输出，便于脚本处理

标签与类型（即时查询）

steam tags                 # 列出所有 440+ 个 Steam 标签
steam tags --json
steam genres               # 列出所有游戏类型
steam genres --json

筛选选项

游戏时长

steam library --unplayed                    # 从未玩过的游戏
steam library --min-hours 10                # 至少 10 小时的游戏
steam library --max-hours 5                 # 少于 5 小时的游戏
steam library --deck                        # 在 Steam Deck 上玩过的游戏

评测（1-9 分制）

steam library --reviews very-positive       # 精确匹配评测类别
steam library --min-reviews 7               # 评分 7 分及以上（正面及以上）
steam library --show-reviews                # 显示评测列

评测类别： overwhelmingly-positive (9), very-positive (8), positive (7), mostly-positive (6), mixed (5), mostly-negative (4), negative (3), very-negative (2), overwhelmingly-negative (1)

Steam Deck 兼容性

steam library --deck-compat verified        # 仅已验证游戏
steam library --deck-compat playable        # 仅可玩游戏
steam library --deck-compat ok              # 已验证或可玩游戏
steam library --show-compat                 # 显示 Deck 兼容性列

标签与类型

steam library --tag "Roguelike"             # 按标签筛选
steam library --genre "Strategy"            # 按类型筛选
steam library --show-tags                   # 显示标签列

排序

steam library --sort name                   # 按名称字母顺序（默认）
steam library --sort playtime               # 按游戏时长降序
steam library --sort deck                   # 按 Deck 游戏时长降序
steam library --sort reviews                # 按评测评分降序
steam library --sort compat                 # 按 Deck 兼容性降序

AI 代理工作流

本命令行工具针对 AI 代理进行了优化，支持流式融合和提前终止。

步骤 1：发现可用标签/类型（即时）

steam tags --json
steam genres --json

步骤 2：使用组合条件筛选游戏库

# 未玩过的、Deck 已验证的、评测良好的 Roguelike 游戏
steam library --unplayed --deck-compat verified --tag "Roguelike" --min-reviews 7 --limit 10 --json

# 评测优秀、时长少于 5 小时的策略游戏
steam library --max-hours 5 --genre "Strategy" --min-reviews 8 --limit 5 --json

# 可在 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：JSON 格式，适用于脚本或 AI 代理