【millennium插件】steam游戏珍藏馆，装订你的steam游戏画廊

468482

本文为 其乐用户(UID:468482) 发布的原创文章，转摘前请联系该用户获得许可

游戏珍藏馆 · GameVault

• Millennium 插件 v0.17.0
• 把本地 Steam 库与家庭共享游戏装订成一本可翻阅、可分析的珍藏馆。
• 安装使用前提： steam客户端安装Millennium才能使用本插件
  

下载地址： 蓝凑云下载 - 0.17版本

它做什么

• 库菜单直达：Steam 库顶栏的 `Library` 下拉菜单里多一项「★ 游戏珍藏馆」
  

  （Steam 刚重启时入口要等十几秒才随菜单渲染出现，期间右下角有一个圆形浮动入口可直接点开全屏；
  全屏页与菜单页共用同一份数据和筛选状态，不会重置）

• 一键开玩：hover 卡片浮出「▶ 开始游玩 / 安装游玩」，双击卡片等效触发；
  

  未安装的游戏会唤起 Steam 安装确认

• 封面海报墙：600×900 竖版海报；缺竖版资源时自动换横版（糊化同图垫底 + 完整显示），
  

  **版式切换**：竖版海报墙 ⇄ 横板横幅墙（460×215 header 比例），筛选条一键切换、重启记住；
  **尺寸四档**：小 / 中 / 大 / 特大（110~260px），列数与滚动批量联动，重启记住上次档位；
  **两个版式各记各的尺寸**：竖/横版的卡位比例差 3.2 倍，同名档在两种版式下是两套像素表；
  切版式时自动切回你上次在那个版式选的档位

• 内容类型净化：自动区分游戏 / 试玩 / 软件 / 视频 / 原声，筛选条按类型收口径（默认「游戏」），卡片带类型徽标，
  

  

• 九个虚拟分册：全部 / 已安装 / 家庭共享 / **付费入库 / 免费开玩** / 最近游玩 / 吃灰库 / 时长殿堂 / 从未启动
  

  （吃灰 / 时长殿堂等规则只作用于游戏口径；视频 / 原声 / 软件不进付费/免费分册）

• 页签分两组：前组是三个独立页面（Steam 分类 / 系列收藏 / 库存分析），排在最前；
  

• Steam 分类画廊：读取客户端云存储收藏夹（只读不写），分类卡片墙，一键「仅付费」或「仅免费」，作用在所有分册之上
  

  「全部游戏 + 仅付费」才是 Steam 资料里那个真实游戏数（免费游戏不计入）

• 数据分析（专用仪表板）：8 张 KPI 指标卡 + 内容构成条 + 时长分档环图（按游戏数/按时长双模）+ 五维玩家画像雷达 + 最近两周在玩 + 活跃度分层 + 时长集中度曲线 + 近 12 个月足迹
• 滚动加载：按尺寸档位自适应批量（90/60/40/28），9000+ 游戏也不卡；首屏自动铺满视口、滚到底自动续批，切版式/切筛选时回到顶部；
  

安装
把整个 `GameVault` 文件夹放进：
<Steam 安装目录>/millennium/plugins/
放完确认这一层是通的（`plugin.json` 必须**直接**在 `GameVault/` 里，别多套一层）：

```
millennium/plugins/GameVault/plugin.json
millennium/plugins/GameVault/.millennium/Dist/index.js
millennium/plugins/GameVault/backend/main.lua
```

完全退出 Steam → 重启 → 在 **设置 → Millennium → 插件** 里启用「游戏珍藏馆」。
首次使用约需 1 分钟后台判定「免费 / 付费游戏」，期间可以正常浏览，之后走本地缓存。
升级、验收、排障、卸载、回滚的完整说明安装包内见 `docs/INSTALL.md`。

使用
库顶部 `Library` 菜单 → **★ 游戏珍藏馆**。

| 重新采集 | 重新读一遍 Steam 内存中的库（装了新游戏后不用重启 Steam） |
| 诊断 | 把插件运行环境与库样本写到 `plugins/GameVault/data/gv-diagnose.json`，出问题时用它 |

数据从哪来
**游戏本体数据全部来自 Steam 客户端自己**，不读你的游戏存档、不上传任何东西；
只有「封面」和「免费/付费」这两类**商店元数据**需要联网问 Steam 官方接口：

- 游戏列表、名称、时长、最近游玩 → Steam 的 `appStore`（AppOverview）
- 家庭共享归属 → AppOverview 的共享标记 / 归属账号
- 封面 → Steam 官方 CDN（`cdn.cloudflare.steamstatic.com` / `shared.akamai` / `shared.fastly`，
  新旧两代路径都探）；缺资源的游戏会向 Steam 官方商店接口
  （`IStoreBrowseService/GetItems`）查一次原生封面地址并缓存
- 免费 / 付费 → 同一个 `IStoreBrowseService/GetItems` 的 `is_free` 字段，每批 180 款、
  后台串行解析一次后落盘缓存（客户端本地不存价格，这是唯一权威来源）

卸载
删掉 `millennium/plugins/GameVault` 整个目录，并从 `millennium/config/config.json` 的
`plugins.enabledPlugins` 里移除 `"GameVault"`。
插件不改动 Steam 的任何文件，删掉即干净。