Steam 好友管理器 (Steam Friend Manager) 使用手册

版本：1.3.3 适用页面：https://steamcommunity.com/*/friends*
作者：SmallFork & SmallRob & Antigravity
开源许可：MIT

📦 概述

Steam 好友管理器 是一款针对 Steam 好友列表页面（/friends）的增强型用户脚本。它在原生页面的基础上，注入了丰富的信息增强和统计功能，帮助您全面管理好友关系、追踪好友动态、分析社交数据，并集成了家庭组分析、个人游戏库管理、绝版游戏检测等强大工具。

脚本完全在本地运行，通过 Steam Web API 和页面数据获取信息，所有数据均缓存在本地（IndexedDB），不会外传。

✨ 主要功能

🖥️ 界面与使用指南

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 且好友列表公开）。
• 共同游戏：您和该好友共同拥有的游戏。
• 好友独有：好友拥有但您没有的游戏。
• 我的独有：您拥有但好友没有的游戏。

⌨️ 键盘快捷键

注意：快捷键仅在焦点不在输入框时生效。

此外，在好友管理面板内：

• 点击 获取好友数据 按钮（搜索图标）可刷新好友列表。
• 点击 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! 👥