配置说明
基础信息
Steam API Key
- 访问 Steam 开发者页面
- 登录你的 Steam 账号
- 填写域名，可以填写博客域名
- 同意 Steam Web API 使用条款
- 点击「注册」获取 API Key
请妥善保管 API Key，不要公开泄露。
Steam ID
Steam ID 是 17 位数字，例如 76561198000000000。
- 个人资料 URL 为
https://steamcommunity.com/profiles/76561198000000000时，数字部分就是 Steam ID - 个性 URL 如
https://steamcommunity.com/id/xxx需要通过 SteamID.io 等工具转换为 SteamID64
Steam 隐私设置
插件需要读取公开的 Steam 资料和游戏详情。请在 Steam 隐私设置中确认：
- 我的个人资料：公开
- 游戏详情：公开
如果「游戏详情」不是公开，游戏库、最近游玩和成就数据可能无法获取。
基本配置
| 配置项 | 说明 | 默认值 |
|---|---|---|
| Steam API Key | Steam Web API 密钥 | 必填 |
| Steam ID | 17 位 SteamID64 | 必填 |
| 缓存过期时间（分钟） | 仅用于按需查询数据，如文章中的游戏卡片详情 | 10 |
| 活跃信息刷新间隔（分钟） | 后台预热「资料 + 最近游玩」的间隔 | 10 |
| 库藏信息刷新间隔（分钟） | 后台预热「游戏库 + 徽章」的间隔 | 60 |
| API 请求超时时间（秒） | 后台拉取数据和验证配置时的超时时间 | 8 |
修改 API Key、Steam ID、代理、语言、是否包含免费游戏等会影响缓存数据的配置后，需要点击「刷新缓存」或等待下一轮后台预热。游戏卡片详情等按需数据则按「缓存过期时间」重新拉取。
页面配置
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 页面标题 | /steam 页面标题 |
Steam 游戏库 |
| 每页显示数量 | /steam 游戏库每页显示数量 |
12 |
| 游戏库总数量限制 | 游戏库最多展示数量，0 表示不限制 | 50 |
| 最近游玩显示数量 | 最近游玩区域展示数量 | 5 |
| 显示最近游玩成就进度 | 最近游玩缓存刷新时补全成就进度 | 关闭 |
| 点击游戏卡片跳转 Steam 商城 | 卡片点击后打开 Steam 商店 | 关闭 |
| 包含免费游戏 | 游戏库是否包含玩过的免费游戏 | 开启 |
| 隐藏的游戏 | 按 AppID 隐藏指定游戏 | 空 |
成就进度
开启「显示最近游玩成就进度」后，插件会在刷新最近游玩缓存时调用成就 API，并把结果一起写入缓存。页面读取缓存时不会逐个游戏重新请求成就 API。
这会增加后台预热耗时和 Steam API 调用量。最近游玩数量较多或 API Key 容易限流时，可以关闭此项或调大「活跃信息刷新间隔」。
隐藏游戏
隐藏游戏支持直接填写 AppID 或粘贴商店链接，例如：
730https://store.steampowered.com/app/730/
隐藏只影响前端展示和当前统计计算，不会修改 Steam 账号数据。
徽章配置
游戏徽章会自动作为游戏徽章显示。系统徽章、活动徽章等可通过 Badge ID 配置自定义图片和名称。
| 配置项 | 说明 |
|---|---|
| Badge ID | Steam 徽章 ID，可从徽章页面 URL 获取 |
| 徽章名称 | 自定义显示名称，可选 |
| 图片 URL | 自定义徽章图片地址 |
统计配置（热力图）
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 启用游戏时长追踪 | 开启后每小时追踪游戏时长变化 | 关闭 |
| 数据保留天数 | 每日记录保留天数 | 365 |
| 在页面显示热力图 | 是否在 /steam 页面显示热力图 |
关闭 |
| 显示天数 | 热力图展示跨度 | 365 |
| 颜色主题 | steam / github / fire / purple | Steam 蓝色 |
| 显示图例 | 是否显示颜色图例 | 关闭 |
| ECharts JS 地址 | 热力图依赖脚本地址，可换成自有 CDN | BootCDN |
Steam API 不提供历史每日数据，热力图只能从启用后开始记录。首次启用后需要等待下一次定时追踪，或手动点击「手动追踪时长」。
编辑器配置
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 暗色模式选择器 | 游戏卡片检测主题暗色模式的 CSS 选择器 | html.dark |
| 游戏显示语言 | 名称、描述与价格货币语言 | 自动 |
「游戏显示语言」作用于两个场景：
- 页面列表：游戏库和最近游玩按 Halo 后台首选语言，所有访客共享同一份列表缓存
- 游戏卡片：按访客浏览器语言或指定语言请求详情
修改语言后，页面列表需要刷新缓存或等待下一轮后台预热；游戏卡片详情按缓存 TTL 生效。
代理配置
HTTP 代理
配置代理主机和端口后，Steam Web API 与 Store API 请求会通过该 HTTP 代理访问。
自定义 API 地址
自定义 API 地址用于替换 Steam API 的基础地址。代理服务需要透传路径、查询参数和响应体，并支持：
/ISteamUser/*/IPlayerService/*/ISteamUserStats/*/IStoreBrowseService/*/api/appdetails
图片加速
| 配置项 | 说明 |
|---|---|
| 游戏图标地址模板 | 用 {appid} 和 {hash} 拼接 Steam 图标地址 |
| 游戏图片加速域名 | 替换封面、图标、头像 URL 的域名部分，路径保持不变 |
封面来自 GetItems 或 appdetails 返回的真实地址，路径可能包含内容哈希。配置 CDN/反代时请保留原始路径。
刷新缓存
点击「刷新缓存」会清空内存缓存，并在后台触发一次「活跃信息」和「库藏信息」预热。刚刷新后页面可能短暂没有数据，预热完成后恢复。
页面列表数据的新鲜度由「活跃信息刷新间隔」和「库藏信息刷新间隔」控制；「缓存过期时间」只控制游戏卡片详情等按需查询数据。