Steam 好友管理器 (Steam Friend Manager) 使用手册
版本：1.3.3
适用页面：https://steamcommunity.com/*/friends*
作者：SmallFork & SmallRob & Antigravity
开源许可：MIT
📦 概述
Steam 好友管理器 是一款针对 Steam 好友列表页面（/friends）的增强型用户脚本。它在原生页面的基础上，注入了丰富的信息增强和统计功能，帮助您全面管理好友关系、追踪好友动态、分析社交数据，并集成了家庭组分析、个人游戏库管理、绝版游戏检测等强大工具。
脚本完全在本地运行，通过 Steam Web API 和页面数据获取信息，所有数据均缓存在本地（IndexedDB），不会外传。
✨ 主要功能
| 功能模块 |
简要说明 |
| 好友列表增强 |
在原始好友卡片上显示：好友天数、国家/地区旗帜、VAC/开发者封禁状态、Steam 等级、在线状态及游戏信息 |
| 好友管理浮窗 |
一体化面板（好友总览 + 深度大盘），支持搜索、筛选、排序、导出 CSV/JSON |
| 好友总览 |
KPI 卡片（好友总数、游戏中、在线、离线、新好友、国家数、VAC封禁、开发者封禁、已删除好友），以卡片网格展示所有好友，点击可筛选 |
| 深度大盘（社交仪表盘） |
好友游戏时长排行、热门游戏分布（环形图）、游戏时长热力图、游戏总数排行、好友数排行，数据自动缓存 |
| 家庭组分析 |
获取家庭成员、共享游戏库，展示贡献分布（堆叠柱状图）、增长曲线、入库动态、月度饼图、成员洞察（活跃度、共同游戏矩阵、雷达图）、愿望单、精品游戏检测、系列游戏分组 |
| 个人游戏库 |
统计总游戏数、总时长、平均时长、未玩游戏数；查看最近游玩、游玩时长分布、Top 20 游戏；入库历史时间线（支持家庭共享日期修正）；绝版收藏检测与筛选 |
| 好友库存对比 |
点击好友卡片上的对比按钮，可查看好友的最近游玩、游玩时长 Top15、入库动态、共同好友、绝版游戏、共同游戏、好友独有、我的独有等 |
| 绝版游戏检查 |
从云端绝版数据库检测游戏库中的绝版游戏，支持按类型筛选、排序和分页 |
| 共同好友查询 |
批量查询共同好友数量，支持智能并发池，自动处理限流，可缓存结果 |
| VAC/等级查询 |
批量刷新好友 VAC 封禁状态和 Steam 等级，缓存结果 |
| 数据导出 |
好友列表、家庭组游戏、个人游戏库等均可导出为 CSV 或 JSON |
| 快捷键支持 |
一键打开各浮窗和常用操作（详见后文） |
🖥️ 界面与使用指南
1️⃣ 安装与首次加载
- 在 Tampermonkey 或 Violentmonkey 中安装脚本后，访问您的 Steam 好友页面（如
https://steamcommunity.com/profiles/7656119xxxxxxx/friends/）即可生效。
- 首次加载时，脚本会自动在页面底部添加三个浮动按钮（从左到右）：好友管理（蓝色）、个人游戏库（紫色）、家庭组（橙色）。
- 如果尚未配置 Steam Web API Key，脚本会自动打开好友管理面板的“设置”标签页，引导您注册 API Key。
2️⃣ 好友列表页面增强
脚本会在原始好友卡片上叠加以下信息（无需打开任何浮窗）：
- 好友天数：显示成为好友的天数（如“3天”、“120天”、“3年”），颜色随天数变化（新好友红色，老友蓝色）。
- 国家/地区旗帜：显示好友所在国家的旗帜。
- VAC/开发者封禁状态：使用盾牌图标表示 VAC 封禁（红色）或开发者封禁（橙色），悬停显示详情。
- Steam 等级：显示在好友头像左下角。
- 在线状态及游戏：在卡片下方显示在线状态或正在玩的游戏名。
此外，原生好友卡片背景会根据封禁状态改变颜色（无封禁为绿色渐变，VAC 封禁为红色，开发者封禁为橙色）。
3️⃣ 好友管理浮窗（主面板）
点击页面底部蓝色浮动按钮或按下快捷键 F（默认绑定）可打开好友管理面板。面板包含两个标签页：
好友总览
- KPI 卡片：好友总数、游戏中、在线、离线、新好友（30天内）、国家/地区数、VAC封禁数、开发者封禁数、已删除好友数。点击卡片可快速筛选对应类别的列表。
- 搜索与排序：支持按昵称/国家搜索，按好友天数、状态、名字、等级、国家、共同好友等多种方式排序。
- 好友卡片列表：以网格形式展示所有好友，每个卡片显示头像、昵称、在线状态、国家、等级、共同好友数、VAC状态，并带有“对比库存”按钮。
深度大盘（社交仪表盘）
- KPI 总览：好友总数、当前在线、游戏中、近2周总时长、数据公开好友数。
- 好友游戏时长排行：近2周好友游戏总时长排行，显示前三名游戏及占比。
- 热门游戏分布：环形图展示近2周所有好友游玩的热门游戏及时长占比，悬停显示详情。
- 游戏时长热力图：以热力图形式展示近14天好友游戏时长变化（基于每日快照或估算）。
- 游戏总数排行：好友游戏库总数排行。
- 好友数排行：好友拥有好友数量排行。
仪表盘数据会自动缓存，点击右上角刷新按钮可强制刷新。
4️⃣ 家庭组浮窗
点击橙色浮动按钮或按 G 键可打开家庭组浮窗。需先获取 Steam Web API Token（自动从页面提取）。浮窗包含多个标签页：
贡献分布
- 展示家庭成员的共享游戏贡献分布（堆叠柱状图），每个柱子代表一位成员，不同颜色表示独占/多人共享程度。
- 右侧显示成员贡献占比（环形图）和近6月入库增量。
- 点击柱子可查看该成员贡献的游戏列表；点击月度柱可查看该月入库游戏列表。
增长曲线
- 显示家庭库随时间增长的累计曲线（按成员分组），并显示90天内各成员贡献对比（横向条形图）和最新入库游戏卡片。
入库动态
- 按日期分组显示游戏入库记录，可筛选“共拥游戏”/“仅个人”或搜索游戏名。
- 对共拥游戏，自动通过个人许可页交叉验证入库日期（修正家庭组 API 时间，避免被他人入库时间覆盖）。
游玩动态
- 显示每个家庭成员近2周游玩游戏列表、时长，并支持折叠展开。
月度饼图
- 按月度显示每个成员入库游戏数量占比（饼图），点击饼图可查看该月具体游戏列表。
成员洞察
- 活跃度：显示成员活跃状态（活跃/温热/冷淡/沉睡），健康分。
- 共同游戏矩阵：6×6 头像网格显示成员间共同游戏数量，悬停查看详情。
- 雷达图：多维度对比（总游戏、独占、共享、月均、共享率、库龄）。
- 加入时间：显示成员加入家庭组时间和冷却剩余天数。
- 24小时入库热力图：按小时统计全家及每个成员的入库分布。
- 入库热力图：按成员×月份展示入库数（各成员独立峰值）。
愿望单
- 获取所有家庭成员 Steam 愿望单，合并去重，显示每个游戏被多少成员想要、是否已在家庭库中。
- 支持按成员人数筛选，显示成员分布条形图。
精品游戏
- 加载预定义精品游戏列表（从
2026.json 获取），按年份分组，展示已发售和未发售的游戏。
- 对未发售游戏，实时检测商店页面是否已被预购（自己或家庭组），并显示拥有状态。
系列游戏
- 加载游戏系列数据（从
game_series.json 获取），按系列分组展示，显示系列中已拥有数量和占比。
5️⃣ 个人游戏库浮窗
点击紫色浮动按钮或按 L 键可打开个人游戏库浮窗。需先配置 API Key。包含四个标签页：
最近游玩
- 显示统计卡片：总游戏数、总时长、平均时长、已玩过、未玩游戏、近2周游玩游戏数。
- 最近游玩网格：展示近2周游玩的游戏，包含游玩时长和进度条。
游玩时长
- 显示时长分布柱状图（0小时、0-1h、1-10h、10-50h、50-100h、100-500h、500+h）。
- 显示 Top 20 游玩时长游戏（含进度条和排名）。
入库动态
- 显示所有游戏的入库时间线（按日期分组），支持搜索和筛选（全部/仅共拥/仅个人）。
- 对共拥游戏，自动通过个人许可页修正入库日期（避免家庭共享影响）。
绝版收藏
- 检测游戏库中的绝版游戏，显示总数、已拥有、未拥有，支持按绝版类型筛选和分页。
6️⃣ 好友库存对比
在好友管理面板的好友卡片上，点击“对比库存”按钮（显示器图标）可打开对比窗口。窗口包含以下标签页：
- 最近游玩：显示好友最近游玩游戏列表。
- 游玩时长：显示好友 Top 15 游玩时长游戏（含进度条）。
- 入库动态：显示好友游戏库入库历史（首次记录、新增游戏等），类似于个人游戏库的入库动态。
- 绝版游戏：检测好友游戏库中的绝版游戏。
- 共同好友：显示与当前好友的共同好友列表（需 API Key 且好友列表公开）。
- 共同游戏：您和该好友共同拥有的游戏。
- 好友独有：好友拥有但您没有的游戏。
- 我的独有：您拥有但好友没有的游戏。
⌨️ 键盘快捷键
注意：快捷键仅在焦点不在输入框时生效。
| 按键 |
功能 |
F |
打开/关闭好友管理面板（主面板） |
L |
打开/关闭个人游戏库浮窗 |
G |
打开/关闭家庭组浮窗 |
Esc |
关闭当前打开的任意浮窗/弹窗 |
此外，在好友管理面板内：
- 点击 获取好友数据 按钮（搜索图标）可刷新好友列表。
- 点击 VAC 刷新 按钮可查询所有好友的 VAC 封禁状态。
- 点击 等级刷新 按钮可查询所有好友的 Steam 等级。
- 点击 共同好友刷新 按钮可批量计算共同好友数。
⚙️ 配置与数据管理
API Key 配置
首次使用需在好友管理面板的“设置”标签页中配置 Steam Web API Key：
- 前往
https://steamcommunity.com/dev/apikey 注册（免费），填写任意域名即可获得。
- 将 API Key 粘贴到设置页的输入框，并保存。
SteamID 设置
脚本会自动检测您的 SteamID，若检测失败可手动填写（17位数字）。个人游戏库和家庭组功能需要使用正确的 SteamID。
缓存与存储
- 所有数据（好友列表、VAC、等级、共同好友、游戏库、最近游玩、家庭组信息、愿望单等）均存储在浏览器的 IndexedDB 中，容量大且持久。
- 缓存设置了不同的 TTL（例如好友摘要 5 分钟，游戏库 12 小时，家庭组 1 天等），过期后自动刷新。
- 您可以通过点击好友管理面板右上角的“刷新”按钮强制刷新特定数据。
🔒 隐私与安全
- 脚本不收集任何个人数据，所有数据仅保存在本地。
- Steam Web API Key 仅用于调用 Steam 官方 API，不会外传。
- 家庭组功能依赖
access_token（从商店页面提取），仅用于家庭组相关 API，不会泄露。
- 所有网络请求均通过
GM_xmlhttpRequest 发起，受脚本权限控制。
❓ 常见问题 (FAQ)
Q：为什么好友卡片上的 VAC 封禁状态不显示？
A：需要先点击好友管理面板中的“VAC 刷新”按钮（盾牌图标）才会查询并缓存 VAC 状态。
Q：共同好友查询失败或显示“私密”？
A：若对方好友列表为私密，API 返回空，脚本会标记为“私密”（锁图标）。请确保对方公开好友列表。
Q：家庭组浮窗打开后提示“请访问 Steam 商店页面并登录”？
A：家庭组 API 需要 access_token，该 token 从 store.steampowered.com 页面获取。请确保您已登录 Steam 商店，或访问一次商店页面后再试。
Q：个人游戏库入库动态中的日期与家庭组显示不一致？
A：对于家庭共享游戏，家庭组 API 返回的 rt_time_acquired 可能是他人入库的时间，脚本会通过个人许可页（store.steampowered.com/account/licenses）交叉验证并修正，确保显示的是您自己真实的入库时间。
Q：精品游戏和系列游戏数据从哪里来？
A：数据从 GitHub 上的 JSON 文件加载（2026.json 和 game_series.json），脚本会优先使用 @resource 预加载，失败时网络获取。您也可以手动刷新。
Q：仪表盘的数据更新频率？
A：仪表盘数据有缓存（好友摘要 5 分钟，游戏库 12 小时，最近游玩 24 小时），点击右上角刷新按钮可强制刷新所有数据。
📜 开源与反馈
- 主页：脚本通过 GreasyFork 托管（搜索“Steam 好友管理器”）。
- 更新：自动通过
@updateURL 检查更新。
- 反馈：欢迎在 GreasyFork 评论区或 Keylol 论坛反馈问题与建议。
本手册基于脚本源码 v1.3.2 编写，实际功能以最新版本为准。
Happy friend managing! 👥
