sssysy · sssysy · Jul 13, 2026 · Jul 13, 2026 · Jul 13, 2026 · Jul 13, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.md b/README.md
@@ -35,9 +35,8 @@
 
 ## 丨命令列表
 
-### steam帮助
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQV9pdEVIS2NsaFRKVUtBT1R2Z2JGT0FSX2xJbnB4MEVtRkgtamNLdEc3ZUc0P2U9ZEVHZWxC.jpg" width="480" alt="Steam帮助菜单"></a>
-
+### steam帮助(图片更新可能不及时)
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2FlcEk0R3k1TFRMR2tzLWZmUUJHNkFXRFJCRXZobV9JbHh2MWZ5Rlplb2RrP2U9ejJzWGx5.jpg" width="480" alt="Steam帮助菜单">
 ### 命令说明
 
 #### 绑定账号
@@ -68,6 +67,7 @@
 | `steam游戏成就123456` | 查看appid123456的成就详情 |
 | `steam开启成就推送` | 开启自己的成就推送功能 |
 | `steam关闭成就推送` | 关闭自己的成就推送功能 |
+| `steam玩什么` | 从自己的游戏库随机挑3个游戏 |
 
 #### 商店相关
 | 命令 | 说明 |
@@ -76,11 +76,16 @@
 | `steam取消订阅降价123456` | 取消订阅商店游戏降价信息 |
 | `steam订阅降价查看` | 查看订阅的商店游戏降价信息 |
 
+#### 社交相关
+| 命令 | 说明 |
+|------|:------:|
+| `@xx steam加好友123456` | 获取被 @ 用户的好友码 |
+| `steam群排行` | 查看群游玩时长排行榜 |
+
 #### 其他服务
 | 命令 | 说明 |
 |------|:------:|
 | `steam帮助` | 呼出本插件帮助菜单 |
-| `@xx steam加好友` | 获取被 @ 用户的好友码 |
 | `清除全部缓存` | 清除全部缓存 |
 
 ## 效果图
@@ -89,25 +94,29 @@
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRHR5UVVwYVVENFJhX2UxakdHblNIeUFRVVoxcDVZMGpxRkpBWmYtRGhQRENjP2U9RTdMMlJk.png" width="160"/>
 
 ### steam成就推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQWVnNm85WjBHc1NyZWhvWHJJaVFLdUFiZEJqb3ZlQ1JHMXlNdUNLenk3TlY0P2U9cXlpTWdS.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRDVmeDFrYTF2RlI2aXo2RklpNFlSQkFkUHFGQ1FwaloteW8wZllfbkpVQXhFP2U9Ynd5bXBh.png" width="160"/>
 
 ### steam开始游戏 / 结束游戏推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2lrOERKZ1VIZFE1bkl1S2dOTzRDeUFjQlB1SmRyYlM0SlhjcGdLSTU0bGFvP2U9bm1ja0gy.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQUEtZEVQOXV3blRwMjJaN2R0MVFXNEFaZUMtVTVsOWdQZjFRSmZGSUd5UlIwP2U9elRLQmdu.png" width="160"/>
 
 ### steam游戏墙
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQnhKUDRNUFhhX1NKdUROakNNYzJ1T0FTeVRKNGlqam5wMG95YzZRUFF2QXo4P2U9aHNRV2dw.jpg" width="160"/>
 
+## steam玩什么
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQjcxemRIckRxTlI0ZGYwVmhpQm5YUkFkR0lzZjAzVktic2x2ZTQ3VUNSYnNRP2U9WXhMVUhP.jpg" width="160">
+
+
 
 ## 计划功能
 
 - [x] 支持设置所有状态推送推送默认值
 - [ ] 玩家上下线状态推送
 - [ ] 带游玩时长的游戏库存图片
 - [x] 游戏降价 / 打折信息订阅推送
-- [] steam玩什么 (随机抽游戏)
+- [x] steam玩什么 (随机抽游戏)
 - [x] 游戏名 / 成就名本地化名字获取
 - [ ] 总结推送功能 (定时总结周期内游戏情况而不每次状态变化都推送)
-- [] 群游玩时长排行榜
+- [x] 群游玩时长排行榜
 - [x] 隐藏 steamid / 好友码
 
 
@@ -117,7 +126,7 @@
 
 - 本项目仅供学习使用，请勿用于商业用途
 - [GPL-3.0 License](LICENSE)
-
+- 部分功能没有写绘图，以后再说
 
 ## 致谢
 

diff --git a/SteamUID/SteamHelp/help.json b/SteamUID/SteamHelp/help.json
@@ -115,6 +115,14 @@
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
+ },
+ {
+ "name": "玩什么",
+ "desc": "从自己的游戏库随机挑3个游戏",
+ "eg": "玩什么",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
  }
  ]
  },
@@ -147,21 +155,34 @@
  }
  ]
  },
- "其他服务": {
- "desc": "一些杂项服务",
+ "社交相关": {
+ "desc": "加好友和排行榜功能",
  "data": [
  {
- "name": "帮助",
- "desc": "呼出本插件帮助菜单",
- "eg": "帮助",
+ "name": "加好友",
+ "desc": "获取被 @ 用户的好友码",
+ "eg": "加好友",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
  },
  {
- "name": "@xx 加好友",
- "desc": "获取被 @ 用户的好友码",
- "eg": "加好友",
+ "name": "群排行",
+ "desc": "查看群游玩时长排行榜",
+ "eg": "群排行",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
+ }
+ ]
+ },
+ "其他服务": {
+ "desc": "一些杂项服务",
+ "data": [
+ {
+ "name": "帮助",
+ "desc": "呼出本插件帮助菜单",
+ "eg": "帮助",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false

diff --git a/SteamUID/SteamLibarary/__init__.py b/SteamUID/SteamLibarary/__init__.py
@@ -6,7 +6,7 @@
 
 from ..utils.exceptions import SteamError, SteamValidationError
 from ..utils.target import resolve_target_steamid64
-from .library_service import build_library_wall
+from .library_service import build_library_wall, build_random_pick
 
 library_SV = SV("steam库存相关")
 
@@ -26,3 +26,19 @@ async def get_steamlibrary_image(bot: Bot, ev: Event):
  except Exception as e:
  logger.exception(f"[steam库存] 未知错误: {e!r}")
  await bot.send(f"发生未知错误: {e}")
+
+@library_SV.on_command(("玩什么",))
+async def get_my_steamlibrary_image(bot: Bot, ev: Event):
+ try:
+ steamid64 = await resolve_target_steamid64(ev, ev.text.strip())
+ if not steamid64:
+ raise SteamValidationError("请先绑定 steam 账号")
+
+ await bot.send("正在从游戏库中随机挑选......")
+ img_bytes = await build_random_pick(steamid64)
+ await bot.send(MessageSegment.image(img_bytes))
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[steam库存] 未知错误: {e!r}")
+ await bot.send(f"发生未知错误: {e}")
diff --git a/SteamUID/SteamLibarary/library_service.py b/SteamUID/SteamLibarary/library_service.py
@@ -1,3 +1,4 @@
+import random
 from io import BytesIO
 
 from gsuid_core.data_store import get_res_path
@@ -7,6 +8,7 @@
 from ..SteamConfig.interface import SteamAPI
 from ..utils.api import get_steamlibrary_by_steamid64
 from ..utils.exceptions import SteamConfigError, SteamValidationError
+from ..utils.PIL.draw import draw_what_to_play
 from ..utils.PIL.steam_wall import build_wall
 from ..utils.utils import batch_download_images
 
@@ -50,3 +52,44 @@ async def build_library_wall(steamid64: str) -> bytes:
  buf = BytesIO()
  wall.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
  return buf.getvalue()
+
+
+async def build_random_pick(steamid64: str) -> bytes:
+ """从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+ api_key = SteamConfig.get_config("SteamWebAPIKey").data
+ if not api_key:
+ raise SteamConfigError("请先配置 steam web api key")
+
+ library = await get_steamlibrary_by_steamid64(api_key, steamid64)
+ games = library.get("games")
+ if games is None:
+ raise SteamValidationError("获取 steam 游戏库列表失败")
+ if not games:
+ raise SteamValidationError("该 steam 账号暂无游戏库存")
+ pick_count = min(3, len(games))
+ picks = random.sample(games, pick_count)
+
+ for game in picks:
+ appid = str(game.get("appid", ""))
+ name = game.get("name", "未知游戏")
+ playtime = (
+ game.get("playtime_forever", 0) or
+ game.get("playtime_windows_forever", 0) +
+ game.get("playtime_mac_forever", 0) +
+ game.get("playtime_linux_forever", 0) +
+ game.get("playtime_deck_forever", 0)
+ )
+ cover_url = SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+ game_data.append({
+ "appid": appid,
+ "name": name,
+ "playtime": playtime,
+ "cover_url": cover_url,
+ }) })
+
+ img = await draw_what_to_play(game_data)
+ img = img.convert("RGB")
+
+ buf = BytesIO()
+ img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+ return buf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
diff --git a/SteamUID/SteamPoll/poll_service.py b/SteamUID/SteamPoll/poll_service.py
@@ -1,4 +1,5 @@
 import json
+import time
 
 from gsuid_core.logger import logger
 from gsuid_core.segment import MessageSegment
@@ -18,6 +19,7 @@
  SteamBind,
  SteamArchivementInfo,
  SteamPriceInfo,
+ SteamPlayRecord,
 )
 from ..utils.PIL.draw import draw_game_status_photo, draw_archivements_photo
 from ..utils.steam_status import (
@@ -173,13 +175,32 @@ async def _dispatch_to_subs(subs, send_msg, push_column, steamid64) -> None:
 
 
 async def flush_status_updates(update_list) -> None:
- """将有变化的状态数据写回数据库"""
+ """将有变化的状态数据写回状态轮询数据库"""
  for steamid64, info in update_list:
  await SteamIDInfo.upsert_steamuserinfo(
  steamid64, json.dumps(info, ensure_ascii=False)
  )
 
-
+async def update_game_record(push_list) -> None:
+ """写入游戏记录数据库"""
+ now = int(time.time())
+ for info, old_info in push_list:
+ steamid64 = info.get("steamid")
+ if not steamid64:
+ continue
+ old_appid = old_info.get("gameid", "")
+ new_appid = info.get("gameid", "")
+ # 结束旧游戏（覆盖"切换游戏"与"退出游戏"两种场景）
+ if old_appid:
+ ret = await SteamPlayRecord.upsert_record(steamid64, old_appid, end_ts=now)
+ if ret != 0:
+ logger.warning(
+ f"[SteamPoll] 结束游玩记录失败: steamid={steamid64} appid={old_appid}"
+ )
+ # 开始新游戏
+ if new_appid:
+ await SteamPlayRecord.upsert_record(steamid64, new_appid, now)
+
 async def poll_and_push_game_status() -> None:
  """游戏状态轮询主入口：拉取状态、检测变化、推送、更新基线、落盘。"""
  try:
@@ -198,6 +219,8 @@ async def poll_and_push_game_status() -> None:
  await process_game_status_push(push_list, game_info_map)
  await update_achievement_baselines(push_list)
  await flush_status_updates(update_list)
+ await update_game_record(push_list)
+
  except Exception as error:
  logger.warning(f"[SteamPoll] 游戏状态轮询失败: {error!r}")
 

diff --git a/SteamUID/SteamRanking/__init__.py b/SteamUID/SteamRanking/__init__.py
@@ -0,0 +1,54 @@
+from gsuid_core.sv import SV
+from gsuid_core.bot import Bot
+from gsuid_core.models import Event
+from gsuid_core.logger import logger
+from gsuid_core.segment import MessageSegment
+
+from ..utils.exceptions import SteamError, SteamValidationError
+# from ..utils.target import resolve_target_steamid64
+from ..utils.utils import time_convert_s
+from .ranking_service import get_group_ranking_list
+
+ranking_sv = SV("steam排名服务")
+
+@ranking_sv.on_command(("群排行", "群排名"))
+async def group_ranking(bot: Bot, ev: Event):
+ """按用户游戏时长从高到低取5位返回"""
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+
+ ranking_list = await get_group_ranking_list(ev.group_id)
+ top5 = ranking_list[:5]
+
+ if not top5:
+ await bot.send("本群暂无游戏时长排行数据")
+ return
+
+ text = f"本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
+ for i, item in enumerate(top5, 1):
+ text += f"{i}. {item['user_id']} ({time_convert_s(item['total_duration'])})\n"
+
+ await bot.send(text)
+
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[SteamRanking - 群排行] 未知错误: {e!r}")
+ await bot.send("发生未知错误，请联系管理员查看控制台")
+
+"""
+============鸽了=============
+
+@ranking_sv.on_command(("我的排行", "我的排名"))
+async def my_ranking(bot: Bot, ev: Event):
+ 获取用户在群中的排名，应为总排行 + ... + 用户所在排行位置
+
+@ranking_sv.on_command(("游戏排行", "游戏排行"))
+async def game_ranking(bot: Bot, ev: Event):
+ 获取用户在某appid在某群中的用户游玩时长排行
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+ steamid64 = await resolve_target_steamid64(ev)
+"""
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.md b/README.md
@@ -35,9 +35,8 @@
 
 ## 丨命令列表
 
-### steam帮助
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQV9pdEVIS2NsaFRKVUtBT1R2Z2JGT0FSX2xJbnB4MEVtRkgtamNLdEc3ZUc0P2U9ZEVHZWxC.jpg" width="480" alt="Steam帮助菜单"></a>
-
+### steam帮助(图片更新可能不及时)
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2FlcEk0R3k1TFRMR2tzLWZmUUJHNkFXRFJCRXZobV9JbHh2MWZ5Rlplb2RrP2U9ejJzWGx5.jpg" width="480" alt="Steam帮助菜单">
 ### 命令说明
 
 #### 绑定账号
@@ -68,6 +67,7 @@
 | `steam游戏成就123456` | 查看appid123456的成就详情 |
 | `steam开启成就推送` | 开启自己的成就推送功能 |
 | `steam关闭成就推送` | 关闭自己的成就推送功能 |
+| `steam玩什么` | 从自己的游戏库随机挑3个游戏 |
 
 #### 商店相关
 | 命令 | 说明 |
@@ -76,11 +76,16 @@
 | `steam取消订阅降价123456` | 取消订阅商店游戏降价信息 |
 | `steam订阅降价查看` | 查看订阅的商店游戏降价信息 |
 
+#### 社交相关
+| 命令 | 说明 |
+|------|:------:|
+| `@xx steam加好友123456` | 获取被 @ 用户的好友码 |
+| `steam群排行` | 查看群游玩时长排行榜 |
+
 #### 其他服务
 | 命令 | 说明 |
 |------|:------:|
 | `steam帮助` | 呼出本插件帮助菜单 |
-| `@xx steam加好友` | 获取被 @ 用户的好友码 |
 | `清除全部缓存` | 清除全部缓存 |
 
 ## 效果图
@@ -89,25 +94,29 @@
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRHR5UVVwYVVENFJhX2UxakdHblNIeUFRVVoxcDVZMGpxRkpBWmYtRGhQRENjP2U9RTdMMlJk.png" width="160"/>
 
 ### steam成就推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQWVnNm85WjBHc1NyZWhvWHJJaVFLdUFiZEJqb3ZlQ1JHMXlNdUNLenk3TlY0P2U9cXlpTWdS.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRDVmeDFrYTF2RlI2aXo2RklpNFlSQkFkUHFGQ1FwaloteW8wZllfbkpVQXhFP2U9Ynd5bXBh.png" width="160"/>
 
 ### steam开始游戏 / 结束游戏推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2lrOERKZ1VIZFE1bkl1S2dOTzRDeUFjQlB1SmRyYlM0SlhjcGdLSTU0bGFvP2U9bm1ja0gy.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQUEtZEVQOXV3blRwMjJaN2R0MVFXNEFaZUMtVTVsOWdQZjFRSmZGSUd5UlIwP2U9elRLQmdu.png" width="160"/>
 
 ### steam游戏墙
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQnhKUDRNUFhhX1NKdUROakNNYzJ1T0FTeVRKNGlqam5wMG95YzZRUFF2QXo4P2U9aHNRV2dw.jpg" width="160"/>
 
+## steam玩什么
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQjcxemRIckRxTlI0ZGYwVmhpQm5YUkFkR0lzZjAzVktic2x2ZTQ3VUNSYnNRP2U9WXhMVUhP.jpg" width="160">
+
+
 
 ## 计划功能
 
 - [x] 支持设置所有状态推送推送默认值
 - [ ] 玩家上下线状态推送
 - [ ] 带游玩时长的游戏库存图片
 - [x] 游戏降价 / 打折信息订阅推送
-- [] steam玩什么 (随机抽游戏)
+- [x] steam玩什么 (随机抽游戏)
 - [x] 游戏名 / 成就名本地化名字获取
 - [ ] 总结推送功能 (定时总结周期内游戏情况而不每次状态变化都推送)
-- [] 群游玩时长排行榜
+- [x] 群游玩时长排行榜
 - [x] 隐藏 steamid / 好友码
 
 
@@ -117,7 +126,7 @@
 
 - 本项目仅供学习使用，请勿用于商业用途
 - [GPL-3.0 License](LICENSE)
-
+- 部分功能没有写绘图，以后再说
 
 ## 致谢
 

diff --git a/SteamUID/SteamHelp/help.json b/SteamUID/SteamHelp/help.json
@@ -115,6 +115,14 @@
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
+ },
+ {
+ "name": "玩什么",
+ "desc": "从自己的游戏库随机挑3个游戏",
+ "eg": "玩什么",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
  }
  ]
  },
@@ -147,21 +155,34 @@
  }
  ]
  },
- "其他服务": {
- "desc": "一些杂项服务",
+ "社交相关": {
+ "desc": "加好友和排行榜功能",
  "data": [
  {
- "name": "帮助",
- "desc": "呼出本插件帮助菜单",
- "eg": "帮助",
+ "name": "加好友",
+ "desc": "获取被 @ 用户的好友码",
+ "eg": "加好友",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
  },
  {
- "name": "@xx 加好友",
- "desc": "获取被 @ 用户的好友码",
- "eg": "加好友",
+ "name": "群排行",
+ "desc": "查看群游玩时长排行榜",
+ "eg": "群排行",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
+ }
+ ]
+ },
+ "其他服务": {
+ "desc": "一些杂项服务",
+ "data": [
+ {
+ "name": "帮助",
+ "desc": "呼出本插件帮助菜单",
+ "eg": "帮助",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false

diff --git a/SteamUID/SteamLibarary/__init__.py b/SteamUID/SteamLibarary/__init__.py
@@ -6,7 +6,7 @@
 
 from ..utils.exceptions import SteamError, SteamValidationError
 from ..utils.target import resolve_target_steamid64
-from .library_service import build_library_wall
+from .library_service import build_library_wall, build_random_pick
 
 library_SV = SV("steam库存相关")
 
@@ -26,3 +26,19 @@ async def get_steamlibrary_image(bot: Bot, ev: Event):
  except Exception as e:
  logger.exception(f"[steam库存] 未知错误: {e!r}")
  await bot.send(f"发生未知错误: {e}")
+
+@library_SV.on_command(("玩什么",))
+async def get_my_steamlibrary_image(bot: Bot, ev: Event):
+ try:
+ steamid64 = await resolve_target_steamid64(ev, ev.text.strip())
+ if not steamid64:
+ raise SteamValidationError("请先绑定 steam 账号")
+
+ await bot.send("正在从游戏库中随机挑选......")
+ img_bytes = await build_random_pick(steamid64)
+ await bot.send(MessageSegment.image(img_bytes))
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[steam库存] 未知错误: {e!r}")
+ await bot.send(f"发生未知错误: {e}")
diff --git a/SteamUID/SteamLibarary/library_service.py b/SteamUID/SteamLibarary/library_service.py
@@ -1,3 +1,4 @@
+import random
 from io import BytesIO
 
 from gsuid_core.data_store import get_res_path
@@ -7,6 +8,7 @@
 from ..SteamConfig.interface import SteamAPI
 from ..utils.api import get_steamlibrary_by_steamid64
 from ..utils.exceptions import SteamConfigError, SteamValidationError
+from ..utils.PIL.draw import draw_what_to_play
 from ..utils.PIL.steam_wall import build_wall
 from ..utils.utils import batch_download_images
 
@@ -50,3 +52,44 @@ async def build_library_wall(steamid64: str) -> bytes:
  buf = BytesIO()
  wall.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
  return buf.getvalue()
+
+
+async def build_random_pick(steamid64: str) -> bytes:
+ """从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+ api_key = SteamConfig.get_config("SteamWebAPIKey").data
+ if not api_key:
+ raise SteamConfigError("请先配置 steam web api key")
+
+ library = await get_steamlibrary_by_steamid64(api_key, steamid64)
+ games = library.get("games")
+ if games is None:
+ raise SteamValidationError("获取 steam 游戏库列表失败")
+ if not games:
+ raise SteamValidationError("该 steam 账号暂无游戏库存")
+ pick_count = min(3, len(games))
+ picks = random.sample(games, pick_count)
+
+ for game in picks:
+ appid = str(game.get("appid", ""))
+ name = game.get("name", "未知游戏")
+ playtime = (
+ game.get("playtime_forever", 0) or
+ game.get("playtime_windows_forever", 0) +
+ game.get("playtime_mac_forever", 0) +
+ game.get("playtime_linux_forever", 0) +
+ game.get("playtime_deck_forever", 0)
+ )
+ cover_url = SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+ game_data.append({
+ "appid": appid,
+ "name": name,
+ "playtime": playtime,
+ "cover_url": cover_url,
+ }) })
+
+ img = await draw_what_to_play(game_data)
+ img = img.convert("RGB")
+
+ buf = BytesIO()
+ img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+ return buf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
diff --git a/SteamUID/SteamPoll/poll_service.py b/SteamUID/SteamPoll/poll_service.py
@@ -1,4 +1,5 @@
 import json
+import time
 
 from gsuid_core.logger import logger
 from gsuid_core.segment import MessageSegment
@@ -18,6 +19,7 @@
  SteamBind,
  SteamArchivementInfo,
  SteamPriceInfo,
+ SteamPlayRecord,
 )
 from ..utils.PIL.draw import draw_game_status_photo, draw_archivements_photo
 from ..utils.steam_status import (
@@ -173,13 +175,32 @@ async def _dispatch_to_subs(subs, send_msg, push_column, steamid64) -> None:
 
 
 async def flush_status_updates(update_list) -> None:
- """将有变化的状态数据写回数据库"""
+ """将有变化的状态数据写回状态轮询数据库"""
  for steamid64, info in update_list:
  await SteamIDInfo.upsert_steamuserinfo(
  steamid64, json.dumps(info, ensure_ascii=False)
  )
 
-
+async def update_game_record(push_list) -> None:
+ """写入游戏记录数据库"""
+ now = int(time.time())
+ for info, old_info in push_list:
+ steamid64 = info.get("steamid")
+ if not steamid64:
+ continue
+ old_appid = old_info.get("gameid", "")
+ new_appid = info.get("gameid", "")
+ # 结束旧游戏（覆盖"切换游戏"与"退出游戏"两种场景）
+ if old_appid:
+ ret = await SteamPlayRecord.upsert_record(steamid64, old_appid, end_ts=now)
+ if ret != 0:
+ logger.warning(
+ f"[SteamPoll] 结束游玩记录失败: steamid={steamid64} appid={old_appid}"
+ )
+ # 开始新游戏
+ if new_appid:
+ await SteamPlayRecord.upsert_record(steamid64, new_appid, now)
+
 async def poll_and_push_game_status() -> None:
  """游戏状态轮询主入口：拉取状态、检测变化、推送、更新基线、落盘。"""
  try:
@@ -198,6 +219,8 @@ async def poll_and_push_game_status() -> None:
  await process_game_status_push(push_list, game_info_map)
  await update_achievement_baselines(push_list)
  await flush_status_updates(update_list)
+ await update_game_record(push_list)
+
  except Exception as error:
  logger.warning(f"[SteamPoll] 游戏状态轮询失败: {error!r}")
 

diff --git a/SteamUID/SteamRanking/__init__.py b/SteamUID/SteamRanking/__init__.py
@@ -0,0 +1,54 @@
+from gsuid_core.sv import SV
+from gsuid_core.bot import Bot
+from gsuid_core.models import Event
+from gsuid_core.logger import logger
+from gsuid_core.segment import MessageSegment
+
+from ..utils.exceptions import SteamError, SteamValidationError
+# from ..utils.target import resolve_target_steamid64
+from ..utils.utils import time_convert_s
+from .ranking_service import get_group_ranking_list
+
+ranking_sv = SV("steam排名服务")
+
+@ranking_sv.on_command(("群排行", "群排名"))
+async def group_ranking(bot: Bot, ev: Event):
+ """按用户游戏时长从高到低取5位返回"""
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+
+ ranking_list = await get_group_ranking_list(ev.group_id)
+ top5 = ranking_list[:5]
+
+ if not top5:
+ await bot.send("本群暂无游戏时长排行数据")
+ return
+
+ text = f"本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
+ for i, item in enumerate(top5, 1):
+ text += f"{i}. {item['user_id']} ({time_convert_s(item['total_duration'])})\n"
+
+ await bot.send(text)
+
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[SteamRanking - 群排行] 未知错误: {e!r}")
+ await bot.send("发生未知错误，请联系管理员查看控制台")
+
+"""
+============鸽了=============
+
+@ranking_sv.on_command(("我的排行", "我的排名"))
+async def my_ranking(bot: Bot, ev: Event):
+ 获取用户在群中的排名，应为总排行 + ... + 用户所在排行位置
+
+@ranking_sv.on_command(("游戏排行", "游戏排行"))
+async def game_ranking(bot: Bot, ev: Event):
+ 获取用户在某appid在某群中的用户游玩时长排行
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+ steamid64 = await resolve_target_steamid64(ev)
+"""
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.md b/README.md
@@ -35,9 +35,8 @@
 
 ## 丨命令列表
 
-### steam帮助
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQV9pdEVIS2NsaFRKVUtBT1R2Z2JGT0FSX2xJbnB4MEVtRkgtamNLdEc3ZUc0P2U9ZEVHZWxC.jpg" width="480" alt="Steam帮助菜单"></a>
-
+### steam帮助(图片更新可能不及时)
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2FlcEk0R3k1TFRMR2tzLWZmUUJHNkFXRFJCRXZobV9JbHh2MWZ5Rlplb2RrP2U9ejJzWGx5.jpg" width="480" alt="Steam帮助菜单">
 ### 命令说明
 
 #### 绑定账号
@@ -68,6 +67,7 @@
 | `steam游戏成就123456` | 查看appid123456的成就详情 |
 | `steam开启成就推送` | 开启自己的成就推送功能 |
 | `steam关闭成就推送` | 关闭自己的成就推送功能 |
+| `steam玩什么` | 从自己的游戏库随机挑3个游戏 |
 
 #### 商店相关
 | 命令 | 说明 |
@@ -76,11 +76,16 @@
 | `steam取消订阅降价123456` | 取消订阅商店游戏降价信息 |
 | `steam订阅降价查看` | 查看订阅的商店游戏降价信息 |
 
+#### 社交相关
+| 命令 | 说明 |
+|------|:------:|
+| `@xx steam加好友123456` | 获取被 @ 用户的好友码 |
+| `steam群排行` | 查看群游玩时长排行榜 |
+
 #### 其他服务
 | 命令 | 说明 |
 |------|:------:|
 | `steam帮助` | 呼出本插件帮助菜单 |
-| `@xx steam加好友` | 获取被 @ 用户的好友码 |
 | `清除全部缓存` | 清除全部缓存 |
 
 ## 效果图
@@ -89,25 +94,29 @@
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRHR5UVVwYVVENFJhX2UxakdHblNIeUFRVVoxcDVZMGpxRkpBWmYtRGhQRENjP2U9RTdMMlJk.png" width="160"/>
 
 ### steam成就推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQWVnNm85WjBHc1NyZWhvWHJJaVFLdUFiZEJqb3ZlQ1JHMXlNdUNLenk3TlY0P2U9cXlpTWdS.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRDVmeDFrYTF2RlI2aXo2RklpNFlSQkFkUHFGQ1FwaloteW8wZllfbkpVQXhFP2U9Ynd5bXBh.png" width="160"/>
 
 ### steam开始游戏 / 结束游戏推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2lrOERKZ1VIZFE1bkl1S2dOTzRDeUFjQlB1SmRyYlM0SlhjcGdLSTU0bGFvP2U9bm1ja0gy.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQUEtZEVQOXV3blRwMjJaN2R0MVFXNEFaZUMtVTVsOWdQZjFRSmZGSUd5UlIwP2U9elRLQmdu.png" width="160"/>
 
 ### steam游戏墙
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQnhKUDRNUFhhX1NKdUROakNNYzJ1T0FTeVRKNGlqam5wMG95YzZRUFF2QXo4P2U9aHNRV2dw.jpg" width="160"/>
 
+## steam玩什么
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQjcxemRIckRxTlI0ZGYwVmhpQm5YUkFkR0lzZjAzVktic2x2ZTQ3VUNSYnNRP2U9WXhMVUhP.jpg" width="160">
+
+
 
 ## 计划功能
 
 - [x] 支持设置所有状态推送推送默认值
 - [ ] 玩家上下线状态推送
 - [ ] 带游玩时长的游戏库存图片
 - [x] 游戏降价 / 打折信息订阅推送
-- [] steam玩什么 (随机抽游戏)
+- [x] steam玩什么 (随机抽游戏)
 - [x] 游戏名 / 成就名本地化名字获取
 - [ ] 总结推送功能 (定时总结周期内游戏情况而不每次状态变化都推送)
-- [] 群游玩时长排行榜
+- [x] 群游玩时长排行榜
 - [x] 隐藏 steamid / 好友码
 
 
@@ -117,7 +126,7 @@
 
 - 本项目仅供学习使用，请勿用于商业用途
 - [GPL-3.0 License](LICENSE)
-
+- 部分功能没有写绘图，以后再说
 
 ## 致谢
 

diff --git a/SteamUID/SteamHelp/help.json b/SteamUID/SteamHelp/help.json
@@ -115,6 +115,14 @@
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
+ },
+ {
+ "name": "玩什么",
+ "desc": "从自己的游戏库随机挑3个游戏",
+ "eg": "玩什么",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
  }
  ]
  },
@@ -147,21 +155,34 @@
  }
  ]
  },
- "其他服务": {
- "desc": "一些杂项服务",
+ "社交相关": {
+ "desc": "加好友和排行榜功能",
  "data": [
  {
- "name": "帮助",
- "desc": "呼出本插件帮助菜单",
- "eg": "帮助",
+ "name": "加好友",
+ "desc": "获取被 @ 用户的好友码",
+ "eg": "加好友",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
  },
  {
- "name": "@xx 加好友",
- "desc": "获取被 @ 用户的好友码",
- "eg": "加好友",
+ "name": "群排行",
+ "desc": "查看群游玩时长排行榜",
+ "eg": "群排行",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
+ }
+ ]
+ },
+ "其他服务": {
+ "desc": "一些杂项服务",
+ "data": [
+ {
+ "name": "帮助",
+ "desc": "呼出本插件帮助菜单",
+ "eg": "帮助",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false

diff --git a/SteamUID/SteamLibarary/__init__.py b/SteamUID/SteamLibarary/__init__.py
@@ -6,7 +6,7 @@
 
 from ..utils.exceptions import SteamError, SteamValidationError
 from ..utils.target import resolve_target_steamid64
-from .library_service import build_library_wall
+from .library_service import build_library_wall, build_random_pick
 
 library_SV = SV("steam库存相关")
 
@@ -26,3 +26,19 @@ async def get_steamlibrary_image(bot: Bot, ev: Event):
  except Exception as e:
  logger.exception(f"[steam库存] 未知错误: {e!r}")
  await bot.send(f"发生未知错误: {e}")
+
+@library_SV.on_command(("玩什么",))
+async def get_my_steamlibrary_image(bot: Bot, ev: Event):
+ try:
+ steamid64 = await resolve_target_steamid64(ev, ev.text.strip())
+ if not steamid64:
+ raise SteamValidationError("请先绑定 steam 账号")
+
+ await bot.send("正在从游戏库中随机挑选......")
+ img_bytes = await build_random_pick(steamid64)
+ await bot.send(MessageSegment.image(img_bytes))
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[steam库存] 未知错误: {e!r}")
+ await bot.send(f"发生未知错误: {e}")
diff --git a/SteamUID/SteamLibarary/library_service.py b/SteamUID/SteamLibarary/library_service.py
@@ -1,3 +1,4 @@
+import random
 from io import BytesIO
 
 from gsuid_core.data_store import get_res_path
@@ -7,6 +8,7 @@
 from ..SteamConfig.interface import SteamAPI
 from ..utils.api import get_steamlibrary_by_steamid64
 from ..utils.exceptions import SteamConfigError, SteamValidationError
+from ..utils.PIL.draw import draw_what_to_play
 from ..utils.PIL.steam_wall import build_wall
 from ..utils.utils import batch_download_images
 
@@ -50,3 +52,44 @@ async def build_library_wall(steamid64: str) -> bytes:
  buf = BytesIO()
  wall.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
  return buf.getvalue()
+
+
+async def build_random_pick(steamid64: str) -> bytes:
+ """从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+ api_key = SteamConfig.get_config("SteamWebAPIKey").data
+ if not api_key:
+ raise SteamConfigError("请先配置 steam web api key")
+
+ library = await get_steamlibrary_by_steamid64(api_key, steamid64)
+ games = library.get("games")
+ if games is None:
+ raise SteamValidationError("获取 steam 游戏库列表失败")
+ if not games:
+ raise SteamValidationError("该 steam 账号暂无游戏库存")
+ pick_count = min(3, len(games))
+ picks = random.sample(games, pick_count)
+
+ for game in picks:
+ appid = str(game.get("appid", ""))
+ name = game.get("name", "未知游戏")
+ playtime = (
+ game.get("playtime_forever", 0) or
+ game.get("playtime_windows_forever", 0) +
+ game.get("playtime_mac_forever", 0) +
+ game.get("playtime_linux_forever", 0) +
+ game.get("playtime_deck_forever", 0)
+ )
+ cover_url = SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+ game_data.append({
+ "appid": appid,
+ "name": name,
+ "playtime": playtime,
+ "cover_url": cover_url,
+ }) })
+
+ img = await draw_what_to_play(game_data)
+ img = img.convert("RGB")
+
+ buf = BytesIO()
+ img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+ return buf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
diff --git a/SteamUID/SteamPoll/poll_service.py b/SteamUID/SteamPoll/poll_service.py
@@ -1,4 +1,5 @@
 import json
+import time
 
 from gsuid_core.logger import logger
 from gsuid_core.segment import MessageSegment
@@ -18,6 +19,7 @@
  SteamBind,
  SteamArchivementInfo,
  SteamPriceInfo,
+ SteamPlayRecord,
 )
 from ..utils.PIL.draw import draw_game_status_photo, draw_archivements_photo
 from ..utils.steam_status import (
@@ -173,13 +175,32 @@ async def _dispatch_to_subs(subs, send_msg, push_column, steamid64) -> None:
 
 
 async def flush_status_updates(update_list) -> None:
- """将有变化的状态数据写回数据库"""
+ """将有变化的状态数据写回状态轮询数据库"""
  for steamid64, info in update_list:
  await SteamIDInfo.upsert_steamuserinfo(
  steamid64, json.dumps(info, ensure_ascii=False)
  )
 
-
+async def update_game_record(push_list) -> None:
+ """写入游戏记录数据库"""
+ now = int(time.time())
+ for info, old_info in push_list:
+ steamid64 = info.get("steamid")
+ if not steamid64:
+ continue
+ old_appid = old_info.get("gameid", "")
+ new_appid = info.get("gameid", "")
+ # 结束旧游戏（覆盖"切换游戏"与"退出游戏"两种场景）
+ if old_appid:
+ ret = await SteamPlayRecord.upsert_record(steamid64, old_appid, end_ts=now)
+ if ret != 0:
+ logger.warning(
+ f"[SteamPoll] 结束游玩记录失败: steamid={steamid64} appid={old_appid}"
+ )
+ # 开始新游戏
+ if new_appid:
+ await SteamPlayRecord.upsert_record(steamid64, new_appid, now)
+
 async def poll_and_push_game_status() -> None:
  """游戏状态轮询主入口：拉取状态、检测变化、推送、更新基线、落盘。"""
  try:
@@ -198,6 +219,8 @@ async def poll_and_push_game_status() -> None:
  await process_game_status_push(push_list, game_info_map)
  await update_achievement_baselines(push_list)
  await flush_status_updates(update_list)
+ await update_game_record(push_list)
+
  except Exception as error:
  logger.warning(f"[SteamPoll] 游戏状态轮询失败: {error!r}")
 

diff --git a/SteamUID/SteamRanking/__init__.py b/SteamUID/SteamRanking/__init__.py
@@ -0,0 +1,54 @@
+from gsuid_core.sv import SV
+from gsuid_core.bot import Bot
+from gsuid_core.models import Event
+from gsuid_core.logger import logger
+from gsuid_core.segment import MessageSegment
+
+from ..utils.exceptions import SteamError, SteamValidationError
+# from ..utils.target import resolve_target_steamid64
+from ..utils.utils import time_convert_s
+from .ranking_service import get_group_ranking_list
+
+ranking_sv = SV("steam排名服务")
+
+@ranking_sv.on_command(("群排行", "群排名"))
+async def group_ranking(bot: Bot, ev: Event):
+ """按用户游戏时长从高到低取5位返回"""
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+
+ ranking_list = await get_group_ranking_list(ev.group_id)
+ top5 = ranking_list[:5]
+
+ if not top5:
+ await bot.send("本群暂无游戏时长排行数据")
+ return
+
+ text = f"本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
+ for i, item in enumerate(top5, 1):
+ text += f"{i}. {item['user_id']} ({time_convert_s(item['total_duration'])})\n"
+
+ await bot.send(text)
+
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[SteamRanking - 群排行] 未知错误: {e!r}")
+ await bot.send("发生未知错误，请联系管理员查看控制台")
+
+"""
+============鸽了=============
+
+@ranking_sv.on_command(("我的排行", "我的排名"))
+async def my_ranking(bot: Bot, ev: Event):
+ 获取用户在群中的排名，应为总排行 + ... + 用户所在排行位置
+
+@ranking_sv.on_command(("游戏排行", "游戏排行"))
+async def game_ranking(bot: Bot, ev: Event):
+ 获取用户在某appid在某群中的用户游玩时长排行
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+ steamid64 = await resolve_target_steamid64(ev)
+"""
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.md b/README.md
@@ -35,9 +35,8 @@
 
 ## 丨命令列表
 
-### steam帮助
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQV9pdEVIS2NsaFRKVUtBT1R2Z2JGT0FSX2xJbnB4MEVtRkgtamNLdEc3ZUc0P2U9ZEVHZWxC.jpg" width="480" alt="Steam帮助菜单"></a>
-
+### steam帮助(图片更新可能不及时)
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2FlcEk0R3k1TFRMR2tzLWZmUUJHNkFXRFJCRXZobV9JbHh2MWZ5Rlplb2RrP2U9ejJzWGx5.jpg" width="480" alt="Steam帮助菜单">
 ### 命令说明
 
 #### 绑定账号
@@ -68,6 +67,7 @@
 | `steam游戏成就123456` | 查看appid123456的成就详情 |
 | `steam开启成就推送` | 开启自己的成就推送功能 |
 | `steam关闭成就推送` | 关闭自己的成就推送功能 |
+| `steam玩什么` | 从自己的游戏库随机挑3个游戏 |
 
 #### 商店相关
 | 命令 | 说明 |
@@ -76,11 +76,16 @@
 | `steam取消订阅降价123456` | 取消订阅商店游戏降价信息 |
 | `steam订阅降价查看` | 查看订阅的商店游戏降价信息 |
 
+#### 社交相关
+| 命令 | 说明 |
+|------|:------:|
+| `@xx steam加好友123456` | 获取被 @ 用户的好友码 |
+| `steam群排行` | 查看群游玩时长排行榜 |
+
 #### 其他服务
 | 命令 | 说明 |
 |------|:------:|
 | `steam帮助` | 呼出本插件帮助菜单 |
-| `@xx steam加好友` | 获取被 @ 用户的好友码 |
 | `清除全部缓存` | 清除全部缓存 |
 
 ## 效果图
@@ -89,25 +94,29 @@
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRHR5UVVwYVVENFJhX2UxakdHblNIeUFRVVoxcDVZMGpxRkpBWmYtRGhQRENjP2U9RTdMMlJk.png" width="160"/>
 
 ### steam成就推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQWVnNm85WjBHc1NyZWhvWHJJaVFLdUFiZEJqb3ZlQ1JHMXlNdUNLenk3TlY0P2U9cXlpTWdS.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRDVmeDFrYTF2RlI2aXo2RklpNFlSQkFkUHFGQ1FwaloteW8wZllfbkpVQXhFP2U9Ynd5bXBh.png" width="160"/>
 
 ### steam开始游戏 / 结束游戏推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2lrOERKZ1VIZFE1bkl1S2dOTzRDeUFjQlB1SmRyYlM0SlhjcGdLSTU0bGFvP2U9bm1ja0gy.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQUEtZEVQOXV3blRwMjJaN2R0MVFXNEFaZUMtVTVsOWdQZjFRSmZGSUd5UlIwP2U9elRLQmdu.png" width="160"/>
 
 ### steam游戏墙
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQnhKUDRNUFhhX1NKdUROakNNYzJ1T0FTeVRKNGlqam5wMG95YzZRUFF2QXo4P2U9aHNRV2dw.jpg" width="160"/>
 
+## steam玩什么
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQjcxemRIckRxTlI0ZGYwVmhpQm5YUkFkR0lzZjAzVktic2x2ZTQ3VUNSYnNRP2U9WXhMVUhP.jpg" width="160">
+
+
 
 ## 计划功能
 
 - [x] 支持设置所有状态推送推送默认值
 - [ ] 玩家上下线状态推送
 - [ ] 带游玩时长的游戏库存图片
 - [x] 游戏降价 / 打折信息订阅推送
-- [] steam玩什么 (随机抽游戏)
+- [x] steam玩什么 (随机抽游戏)
 - [x] 游戏名 / 成就名本地化名字获取
 - [ ] 总结推送功能 (定时总结周期内游戏情况而不每次状态变化都推送)
-- [] 群游玩时长排行榜
+- [x] 群游玩时长排行榜
 - [x] 隐藏 steamid / 好友码
 
 
@@ -117,7 +126,7 @@
 
 - 本项目仅供学习使用，请勿用于商业用途
 - [GPL-3.0 License](LICENSE)
-
+- 部分功能没有写绘图，以后再说
 
 ## 致谢
 

diff --git a/SteamUID/SteamHelp/help.json b/SteamUID/SteamHelp/help.json
@@ -115,6 +115,14 @@
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
+ },
+ {
+ "name": "玩什么",
+ "desc": "从自己的游戏库随机挑3个游戏",
+ "eg": "玩什么",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
  }
  ]
  },
@@ -147,21 +155,34 @@
  }
  ]
  },
- "其他服务": {
- "desc": "一些杂项服务",
+ "社交相关": {
+ "desc": "加好友和排行榜功能",
  "data": [
  {
- "name": "帮助",
- "desc": "呼出本插件帮助菜单",
- "eg": "帮助",
+ "name": "加好友",
+ "desc": "获取被 @ 用户的好友码",
+ "eg": "加好友",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
  },
  {
- "name": "@xx 加好友",
- "desc": "获取被 @ 用户的好友码",
- "eg": "加好友",
+ "name": "群排行",
+ "desc": "查看群游玩时长排行榜",
+ "eg": "群排行",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
+ }
+ ]
+ },
+ "其他服务": {
+ "desc": "一些杂项服务",
+ "data": [
+ {
+ "name": "帮助",
+ "desc": "呼出本插件帮助菜单",
+ "eg": "帮助",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false

diff --git a/SteamUID/SteamLibarary/__init__.py b/SteamUID/SteamLibarary/__init__.py
@@ -6,7 +6,7 @@
 
 from ..utils.exceptions import SteamError, SteamValidationError
 from ..utils.target import resolve_target_steamid64
-from .library_service import build_library_wall
+from .library_service import build_library_wall, build_random_pick
 
 library_SV = SV("steam库存相关")
 
@@ -26,3 +26,19 @@ async def get_steamlibrary_image(bot: Bot, ev: Event):
  except Exception as e:
  logger.exception(f"[steam库存] 未知错误: {e!r}")
  await bot.send(f"发生未知错误: {e}")
+
+@library_SV.on_command(("玩什么",))
+async def get_my_steamlibrary_image(bot: Bot, ev: Event):
+ try:
+ steamid64 = await resolve_target_steamid64(ev, ev.text.strip())
+ if not steamid64:
+ raise SteamValidationError("请先绑定 steam 账号")
+
+ await bot.send("正在从游戏库中随机挑选......")
+ img_bytes = await build_random_pick(steamid64)
+ await bot.send(MessageSegment.image(img_bytes))
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[steam库存] 未知错误: {e!r}")
+ await bot.send(f"发生未知错误: {e}")
diff --git a/SteamUID/SteamLibarary/library_service.py b/SteamUID/SteamLibarary/library_service.py
@@ -1,3 +1,4 @@
+import random
 from io import BytesIO
 
 from gsuid_core.data_store import get_res_path
@@ -7,6 +8,7 @@
 from ..SteamConfig.interface import SteamAPI
 from ..utils.api import get_steamlibrary_by_steamid64
 from ..utils.exceptions import SteamConfigError, SteamValidationError
+from ..utils.PIL.draw import draw_what_to_play
 from ..utils.PIL.steam_wall import build_wall
 from ..utils.utils import batch_download_images
 
@@ -50,3 +52,44 @@ async def build_library_wall(steamid64: str) -> bytes:
  buf = BytesIO()
  wall.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
  return buf.getvalue()
+
+
+async def build_random_pick(steamid64: str) -> bytes:
+ """从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+ api_key = SteamConfig.get_config("SteamWebAPIKey").data
+ if not api_key:
+ raise SteamConfigError("请先配置 steam web api key")
+
+ library = await get_steamlibrary_by_steamid64(api_key, steamid64)
+ games = library.get("games")
+ if games is None:
+ raise SteamValidationError("获取 steam 游戏库列表失败")
+ if not games:
+ raise SteamValidationError("该 steam 账号暂无游戏库存")
+ pick_count = min(3, len(games))
+ picks = random.sample(games, pick_count)
+
+ for game in picks:
+ appid = str(game.get("appid", ""))
+ name = game.get("name", "未知游戏")
+ playtime = (
+ game.get("playtime_forever", 0) or
+ game.get("playtime_windows_forever", 0) +
+ game.get("playtime_mac_forever", 0) +
+ game.get("playtime_linux_forever", 0) +
+ game.get("playtime_deck_forever", 0)
+ )
+ cover_url = SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+ game_data.append({
+ "appid": appid,
+ "name": name,
+ "playtime": playtime,
+ "cover_url": cover_url,
+ }) })
+
+ img = await draw_what_to_play(game_data)
+ img = img.convert("RGB")
+
+ buf = BytesIO()
+ img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+ return buf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
diff --git a/SteamUID/SteamPoll/poll_service.py b/SteamUID/SteamPoll/poll_service.py
@@ -1,4 +1,5 @@
 import json
+import time
 
 from gsuid_core.logger import logger
 from gsuid_core.segment import MessageSegment
@@ -18,6 +19,7 @@
  SteamBind,
  SteamArchivementInfo,
  SteamPriceInfo,
+ SteamPlayRecord,
 )
 from ..utils.PIL.draw import draw_game_status_photo, draw_archivements_photo
 from ..utils.steam_status import (
@@ -173,13 +175,32 @@ async def _dispatch_to_subs(subs, send_msg, push_column, steamid64) -> None:
 
 
 async def flush_status_updates(update_list) -> None:
- """将有变化的状态数据写回数据库"""
+ """将有变化的状态数据写回状态轮询数据库"""
  for steamid64, info in update_list:
  await SteamIDInfo.upsert_steamuserinfo(
  steamid64, json.dumps(info, ensure_ascii=False)
  )
 
-
+async def update_game_record(push_list) -> None:
+ """写入游戏记录数据库"""
+ now = int(time.time())
+ for info, old_info in push_list:
+ steamid64 = info.get("steamid")
+ if not steamid64:
+ continue
+ old_appid = old_info.get("gameid", "")
+ new_appid = info.get("gameid", "")
+ # 结束旧游戏（覆盖"切换游戏"与"退出游戏"两种场景）
+ if old_appid:
+ ret = await SteamPlayRecord.upsert_record(steamid64, old_appid, end_ts=now)
+ if ret != 0:
+ logger.warning(
+ f"[SteamPoll] 结束游玩记录失败: steamid={steamid64} appid={old_appid}"
+ )
+ # 开始新游戏
+ if new_appid:
+ await SteamPlayRecord.upsert_record(steamid64, new_appid, now)
+
 async def poll_and_push_game_status() -> None:
  """游戏状态轮询主入口：拉取状态、检测变化、推送、更新基线、落盘。"""
  try:
@@ -198,6 +219,8 @@ async def poll_and_push_game_status() -> None:
  await process_game_status_push(push_list, game_info_map)
  await update_achievement_baselines(push_list)
  await flush_status_updates(update_list)
+ await update_game_record(push_list)
+
  except Exception as error:
  logger.warning(f"[SteamPoll] 游戏状态轮询失败: {error!r}")
 

diff --git a/SteamUID/SteamRanking/__init__.py b/SteamUID/SteamRanking/__init__.py
@@ -0,0 +1,54 @@
+from gsuid_core.sv import SV
+from gsuid_core.bot import Bot
+from gsuid_core.models import Event
+from gsuid_core.logger import logger
+from gsuid_core.segment import MessageSegment
+
+from ..utils.exceptions import SteamError, SteamValidationError
+# from ..utils.target import resolve_target_steamid64
+from ..utils.utils import time_convert_s
+from .ranking_service import get_group_ranking_list
+
+ranking_sv = SV("steam排名服务")
+
+@ranking_sv.on_command(("群排行", "群排名"))
+async def group_ranking(bot: Bot, ev: Event):
+ """按用户游戏时长从高到低取5位返回"""
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+
+ ranking_list = await get_group_ranking_list(ev.group_id)
+ top5 = ranking_list[:5]
+
+ if not top5:
+ await bot.send("本群暂无游戏时长排行数据")
+ return
+
+ text = f"本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
+ for i, item in enumerate(top5, 1):
+ text += f"{i}. {item['user_id']} ({time_convert_s(item['total_duration'])})\n"
+
+ await bot.send(text)
+
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[SteamRanking - 群排行] 未知错误: {e!r}")
+ await bot.send("发生未知错误，请联系管理员查看控制台")
+
+"""
+============鸽了=============
+
+@ranking_sv.on_command(("我的排行", "我的排名"))
+async def my_ranking(bot: Bot, ev: Event):
+ 获取用户在群中的排名，应为总排行 + ... + 用户所在排行位置
+
+@ranking_sv.on_command(("游戏排行", "游戏排行"))
+async def game_ranking(bot: Bot, ev: Event):
+ 获取用户在某appid在某群中的用户游玩时长排行
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+ steamid64 = await resolve_target_steamid64(ev)
+"""
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.md b/README.md
@@ -35,9 +35,8 @@
 
 ## 丨命令列表
 
-### steam帮助
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQV9pdEVIS2NsaFRKVUtBT1R2Z2JGT0FSX2xJbnB4MEVtRkgtamNLdEc3ZUc0P2U9ZEVHZWxC.jpg" width="480" alt="Steam帮助菜单"></a>
-
+### steam帮助(图片更新可能不及时)
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2FlcEk0R3k1TFRMR2tzLWZmUUJHNkFXRFJCRXZobV9JbHh2MWZ5Rlplb2RrP2U9ejJzWGx5.jpg" width="480" alt="Steam帮助菜单">
 ### 命令说明
 
 #### 绑定账号
@@ -68,6 +67,7 @@
 | `steam游戏成就123456` | 查看appid123456的成就详情 |
 | `steam开启成就推送` | 开启自己的成就推送功能 |
 | `steam关闭成就推送` | 关闭自己的成就推送功能 |
+| `steam玩什么` | 从自己的游戏库随机挑3个游戏 |
 
 #### 商店相关
 | 命令 | 说明 |
@@ -76,11 +76,16 @@
 | `steam取消订阅降价123456` | 取消订阅商店游戏降价信息 |
 | `steam订阅降价查看` | 查看订阅的商店游戏降价信息 |
 
+#### 社交相关
+| 命令 | 说明 |
+|------|:------:|
+| `@xx steam加好友123456` | 获取被 @ 用户的好友码 |
+| `steam群排行` | 查看群游玩时长排行榜 |
+
 #### 其他服务
 | 命令 | 说明 |
 |------|:------:|
 | `steam帮助` | 呼出本插件帮助菜单 |
-| `@xx steam加好友` | 获取被 @ 用户的好友码 |
 | `清除全部缓存` | 清除全部缓存 |
 
 ## 效果图
@@ -89,25 +94,29 @@
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRHR5UVVwYVVENFJhX2UxakdHblNIeUFRVVoxcDVZMGpxRkpBWmYtRGhQRENjP2U9RTdMMlJk.png" width="160"/>
 
 ### steam成就推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQWVnNm85WjBHc1NyZWhvWHJJaVFLdUFiZEJqb3ZlQ1JHMXlNdUNLenk3TlY0P2U9cXlpTWdS.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRDVmeDFrYTF2RlI2aXo2RklpNFlSQkFkUHFGQ1FwaloteW8wZllfbkpVQXhFP2U9Ynd5bXBh.png" width="160"/>
 
 ### steam开始游戏 / 结束游戏推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2lrOERKZ1VIZFE1bkl1S2dOTzRDeUFjQlB1SmRyYlM0SlhjcGdLSTU0bGFvP2U9bm1ja0gy.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQUEtZEVQOXV3blRwMjJaN2R0MVFXNEFaZUMtVTVsOWdQZjFRSmZGSUd5UlIwP2U9elRLQmdu.png" width="160"/>
 
 ### steam游戏墙
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQnhKUDRNUFhhX1NKdUROakNNYzJ1T0FTeVRKNGlqam5wMG95YzZRUFF2QXo4P2U9aHNRV2dw.jpg" width="160"/>
 
+## steam玩什么
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQjcxemRIckRxTlI0ZGYwVmhpQm5YUkFkR0lzZjAzVktic2x2ZTQ3VUNSYnNRP2U9WXhMVUhP.jpg" width="160">
+
+
 
 ## 计划功能
 
 - [x] 支持设置所有状态推送推送默认值
 - [ ] 玩家上下线状态推送
 - [ ] 带游玩时长的游戏库存图片
 - [x] 游戏降价 / 打折信息订阅推送
-- [] steam玩什么 (随机抽游戏)
+- [x] steam玩什么 (随机抽游戏)
 - [x] 游戏名 / 成就名本地化名字获取
 - [ ] 总结推送功能 (定时总结周期内游戏情况而不每次状态变化都推送)
-- [] 群游玩时长排行榜
+- [x] 群游玩时长排行榜
 - [x] 隐藏 steamid / 好友码
 
 
@@ -117,7 +126,7 @@
 
 - 本项目仅供学习使用，请勿用于商业用途
 - [GPL-3.0 License](LICENSE)
-
+- 部分功能没有写绘图，以后再说
 
 ## 致谢
 

diff --git a/SteamUID/SteamHelp/help.json b/SteamUID/SteamHelp/help.json
@@ -115,6 +115,14 @@
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
+ },
+ {
+ "name": "玩什么",
+ "desc": "从自己的游戏库随机挑3个游戏",
+ "eg": "玩什么",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
  }
  ]
  },
@@ -147,21 +155,34 @@
  }
  ]
  },
- "其他服务": {
- "desc": "一些杂项服务",
+ "社交相关": {
+ "desc": "加好友和排行榜功能",
  "data": [
  {
- "name": "帮助",
- "desc": "呼出本插件帮助菜单",
- "eg": "帮助",
+ "name": "加好友",
+ "desc": "获取被 @ 用户的好友码",
+ "eg": "加好友",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
  },
  {
- "name": "@xx 加好友",
- "desc": "获取被 @ 用户的好友码",
- "eg": "加好友",
+ "name": "群排行",
+ "desc": "查看群游玩时长排行榜",
+ "eg": "群排行",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
+ }
+ ]
+ },
+ "其他服务": {
+ "desc": "一些杂项服务",
+ "data": [
+ {
+ "name": "帮助",
+ "desc": "呼出本插件帮助菜单",
+ "eg": "帮助",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false

diff --git a/SteamUID/SteamLibarary/__init__.py b/SteamUID/SteamLibarary/__init__.py
@@ -6,7 +6,7 @@
 
 from ..utils.exceptions import SteamError, SteamValidationError
 from ..utils.target import resolve_target_steamid64
-from .library_service import build_library_wall
+from .library_service import build_library_wall, build_random_pick
 
 library_SV = SV("steam库存相关")
 
@@ -26,3 +26,19 @@ async def get_steamlibrary_image(bot: Bot, ev: Event):
  except Exception as e:
  logger.exception(f"[steam库存] 未知错误: {e!r}")
  await bot.send(f"发生未知错误: {e}")
+
+@library_SV.on_command(("玩什么",))
+async def get_my_steamlibrary_image(bot: Bot, ev: Event):
+ try:
+ steamid64 = await resolve_target_steamid64(ev, ev.text.strip())
+ if not steamid64:
+ raise SteamValidationError("请先绑定 steam 账号")
+
+ await bot.send("正在从游戏库中随机挑选......")
+ img_bytes = await build_random_pick(steamid64)
+ await bot.send(MessageSegment.image(img_bytes))
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[steam库存] 未知错误: {e!r}")
+ await bot.send(f"发生未知错误: {e}")
diff --git a/SteamUID/SteamLibarary/library_service.py b/SteamUID/SteamLibarary/library_service.py
@@ -1,3 +1,4 @@
+import random
 from io import BytesIO
 
 from gsuid_core.data_store import get_res_path
@@ -7,6 +8,7 @@
 from ..SteamConfig.interface import SteamAPI
 from ..utils.api import get_steamlibrary_by_steamid64
 from ..utils.exceptions import SteamConfigError, SteamValidationError
+from ..utils.PIL.draw import draw_what_to_play
 from ..utils.PIL.steam_wall import build_wall
 from ..utils.utils import batch_download_images
 
@@ -50,3 +52,44 @@ async def build_library_wall(steamid64: str) -> bytes:
  buf = BytesIO()
  wall.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
  return buf.getvalue()
+
+
+async def build_random_pick(steamid64: str) -> bytes:
+ """从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+ api_key = SteamConfig.get_config("SteamWebAPIKey").data
+ if not api_key:
+ raise SteamConfigError("请先配置 steam web api key")
+
+ library = await get_steamlibrary_by_steamid64(api_key, steamid64)
+ games = library.get("games")
+ if games is None:
+ raise SteamValidationError("获取 steam 游戏库列表失败")
+ if not games:
+ raise SteamValidationError("该 steam 账号暂无游戏库存")
+ pick_count = min(3, len(games))
+ picks = random.sample(games, pick_count)
+
+ for game in picks:
+ appid = str(game.get("appid", ""))
+ name = game.get("name", "未知游戏")
+ playtime = (
+ game.get("playtime_forever", 0) or
+ game.get("playtime_windows_forever", 0) +
+ game.get("playtime_mac_forever", 0) +
+ game.get("playtime_linux_forever", 0) +
+ game.get("playtime_deck_forever", 0)
+ )
+ cover_url = SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+ game_data.append({
+ "appid": appid,
+ "name": name,
+ "playtime": playtime,
+ "cover_url": cover_url,
+ }) })
+
+ img = await draw_what_to_play(game_data)
+ img = img.convert("RGB")
+
+ buf = BytesIO()
+ img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+ return buf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
diff --git a/SteamUID/SteamPoll/poll_service.py b/SteamUID/SteamPoll/poll_service.py
@@ -1,4 +1,5 @@
 import json
+import time
 
 from gsuid_core.logger import logger
 from gsuid_core.segment import MessageSegment
@@ -18,6 +19,7 @@
  SteamBind,
  SteamArchivementInfo,
  SteamPriceInfo,
+ SteamPlayRecord,
 )
 from ..utils.PIL.draw import draw_game_status_photo, draw_archivements_photo
 from ..utils.steam_status import (
@@ -173,13 +175,32 @@ async def _dispatch_to_subs(subs, send_msg, push_column, steamid64) -> None:
 
 
 async def flush_status_updates(update_list) -> None:
- """将有变化的状态数据写回数据库"""
+ """将有变化的状态数据写回状态轮询数据库"""
  for steamid64, info in update_list:
  await SteamIDInfo.upsert_steamuserinfo(
  steamid64, json.dumps(info, ensure_ascii=False)
  )
 
-
+async def update_game_record(push_list) -> None:
+ """写入游戏记录数据库"""
+ now = int(time.time())
+ for info, old_info in push_list:
+ steamid64 = info.get("steamid")
+ if not steamid64:
+ continue
+ old_appid = old_info.get("gameid", "")
+ new_appid = info.get("gameid", "")
+ # 结束旧游戏（覆盖"切换游戏"与"退出游戏"两种场景）
+ if old_appid:
+ ret = await SteamPlayRecord.upsert_record(steamid64, old_appid, end_ts=now)
+ if ret != 0:
+ logger.warning(
+ f"[SteamPoll] 结束游玩记录失败: steamid={steamid64} appid={old_appid}"
+ )
+ # 开始新游戏
+ if new_appid:
+ await SteamPlayRecord.upsert_record(steamid64, new_appid, now)
+
 async def poll_and_push_game_status() -> None:
  """游戏状态轮询主入口：拉取状态、检测变化、推送、更新基线、落盘。"""
  try:
@@ -198,6 +219,8 @@ async def poll_and_push_game_status() -> None:
  await process_game_status_push(push_list, game_info_map)
  await update_achievement_baselines(push_list)
  await flush_status_updates(update_list)
+ await update_game_record(push_list)
+
  except Exception as error:
  logger.warning(f"[SteamPoll] 游戏状态轮询失败: {error!r}")
 

diff --git a/SteamUID/SteamRanking/__init__.py b/SteamUID/SteamRanking/__init__.py
@@ -0,0 +1,54 @@
+from gsuid_core.sv import SV
+from gsuid_core.bot import Bot
+from gsuid_core.models import Event
+from gsuid_core.logger import logger
+from gsuid_core.segment import MessageSegment
+
+from ..utils.exceptions import SteamError, SteamValidationError
+# from ..utils.target import resolve_target_steamid64
+from ..utils.utils import time_convert_s
+from .ranking_service import get_group_ranking_list
+
+ranking_sv = SV("steam排名服务")
+
+@ranking_sv.on_command(("群排行", "群排名"))
+async def group_ranking(bot: Bot, ev: Event):
+ """按用户游戏时长从高到低取5位返回"""
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+
+ ranking_list = await get_group_ranking_list(ev.group_id)
+ top5 = ranking_list[:5]
+
+ if not top5:
+ await bot.send("本群暂无游戏时长排行数据")
+ return
+
+ text = f"本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
+ for i, item in enumerate(top5, 1):
+ text += f"{i}. {item['user_id']} ({time_convert_s(item['total_duration'])})\n"
+
+ await bot.send(text)
+
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[SteamRanking - 群排行] 未知错误: {e!r}")
+ await bot.send("发生未知错误，请联系管理员查看控制台")
+
+"""
+============鸽了=============
+
+@ranking_sv.on_command(("我的排行", "我的排名"))
+async def my_ranking(bot: Bot, ev: Event):
+ 获取用户在群中的排名，应为总排行 + ... + 用户所在排行位置
+
+@ranking_sv.on_command(("游戏排行", "游戏排行"))
+async def game_ranking(bot: Bot, ev: Event):
+ 获取用户在某appid在某群中的用户游玩时长排行
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+ steamid64 = await resolve_target_steamid64(ev)
+"""
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.md b/README.md
@@ -35,9 +35,8 @@
 
 ## 丨命令列表
 
-### steam帮助
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQV9pdEVIS2NsaFRKVUtBT1R2Z2JGT0FSX2xJbnB4MEVtRkgtamNLdEc3ZUc0P2U9ZEVHZWxC.jpg" width="480" alt="Steam帮助菜单"></a>
-
+### steam帮助(图片更新可能不及时)
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2FlcEk0R3k1TFRMR2tzLWZmUUJHNkFXRFJCRXZobV9JbHh2MWZ5Rlplb2RrP2U9ejJzWGx5.jpg" width="480" alt="Steam帮助菜单">
 ### 命令说明
 
 #### 绑定账号
@@ -68,6 +67,7 @@
 | `steam游戏成就123456` | 查看appid123456的成就详情 |
 | `steam开启成就推送` | 开启自己的成就推送功能 |
 | `steam关闭成就推送` | 关闭自己的成就推送功能 |
+| `steam玩什么` | 从自己的游戏库随机挑3个游戏 |
 
 #### 商店相关
 | 命令 | 说明 |
@@ -76,11 +76,16 @@
 | `steam取消订阅降价123456` | 取消订阅商店游戏降价信息 |
 | `steam订阅降价查看` | 查看订阅的商店游戏降价信息 |
 
+#### 社交相关
+| 命令 | 说明 |
+|------|:------:|
+| `@xx steam加好友123456` | 获取被 @ 用户的好友码 |
+| `steam群排行` | 查看群游玩时长排行榜 |
+
 #### 其他服务
 | 命令 | 说明 |
 |------|:------:|
 | `steam帮助` | 呼出本插件帮助菜单 |
-| `@xx steam加好友` | 获取被 @ 用户的好友码 |
 | `清除全部缓存` | 清除全部缓存 |
 
 ## 效果图
@@ -89,25 +94,29 @@
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRHR5UVVwYVVENFJhX2UxakdHblNIeUFRVVoxcDVZMGpxRkpBWmYtRGhQRENjP2U9RTdMMlJk.png" width="160"/>
 
 ### steam成就推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQWVnNm85WjBHc1NyZWhvWHJJaVFLdUFiZEJqb3ZlQ1JHMXlNdUNLenk3TlY0P2U9cXlpTWdS.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRDVmeDFrYTF2RlI2aXo2RklpNFlSQkFkUHFGQ1FwaloteW8wZllfbkpVQXhFP2U9Ynd5bXBh.png" width="160"/>
 
 ### steam开始游戏 / 结束游戏推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2lrOERKZ1VIZFE1bkl1S2dOTzRDeUFjQlB1SmRyYlM0SlhjcGdLSTU0bGFvP2U9bm1ja0gy.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQUEtZEVQOXV3blRwMjJaN2R0MVFXNEFaZUMtVTVsOWdQZjFRSmZGSUd5UlIwP2U9elRLQmdu.png" width="160"/>
 
 ### steam游戏墙
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQnhKUDRNUFhhX1NKdUROakNNYzJ1T0FTeVRKNGlqam5wMG95YzZRUFF2QXo4P2U9aHNRV2dw.jpg" width="160"/>
 
+## steam玩什么
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQjcxemRIckRxTlI0ZGYwVmhpQm5YUkFkR0lzZjAzVktic2x2ZTQ3VUNSYnNRP2U9WXhMVUhP.jpg" width="160">
+
+
 
 ## 计划功能
 
 - [x] 支持设置所有状态推送推送默认值
 - [ ] 玩家上下线状态推送
 - [ ] 带游玩时长的游戏库存图片
 - [x] 游戏降价 / 打折信息订阅推送
-- [] steam玩什么 (随机抽游戏)
+- [x] steam玩什么 (随机抽游戏)
 - [x] 游戏名 / 成就名本地化名字获取
 - [ ] 总结推送功能 (定时总结周期内游戏情况而不每次状态变化都推送)
-- [] 群游玩时长排行榜
+- [x] 群游玩时长排行榜
 - [x] 隐藏 steamid / 好友码
 
 
@@ -117,7 +126,7 @@
 
 - 本项目仅供学习使用，请勿用于商业用途
 - [GPL-3.0 License](LICENSE)
-
+- 部分功能没有写绘图，以后再说
 
 ## 致谢
 

diff --git a/SteamUID/SteamHelp/help.json b/SteamUID/SteamHelp/help.json
@@ -115,6 +115,14 @@
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
+ },
+ {
+ "name": "玩什么",
+ "desc": "从自己的游戏库随机挑3个游戏",
+ "eg": "玩什么",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
  }
  ]
  },
@@ -147,21 +155,34 @@
  }
  ]
  },
- "其他服务": {
- "desc": "一些杂项服务",
+ "社交相关": {
+ "desc": "加好友和排行榜功能",
  "data": [
  {
- "name": "帮助",
- "desc": "呼出本插件帮助菜单",
- "eg": "帮助",
+ "name": "加好友",
+ "desc": "获取被 @ 用户的好友码",
+ "eg": "加好友",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
  },
  {
- "name": "@xx 加好友",
- "desc": "获取被 @ 用户的好友码",
- "eg": "加好友",
+ "name": "群排行",
+ "desc": "查看群游玩时长排行榜",
+ "eg": "群排行",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
+ }
+ ]
+ },
+ "其他服务": {
+ "desc": "一些杂项服务",
+ "data": [
+ {
+ "name": "帮助",
+ "desc": "呼出本插件帮助菜单",
+ "eg": "帮助",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false

diff --git a/SteamUID/SteamLibarary/__init__.py b/SteamUID/SteamLibarary/__init__.py
@@ -6,7 +6,7 @@
 
 from ..utils.exceptions import SteamError, SteamValidationError
 from ..utils.target import resolve_target_steamid64
-from .library_service import build_library_wall
+from .library_service import build_library_wall, build_random_pick
 
 library_SV = SV("steam库存相关")
 
@@ -26,3 +26,19 @@ async def get_steamlibrary_image(bot: Bot, ev: Event):
  except Exception as e:
  logger.exception(f"[steam库存] 未知错误: {e!r}")
  await bot.send(f"发生未知错误: {e}")
+
+@library_SV.on_command(("玩什么",))
+async def get_my_steamlibrary_image(bot: Bot, ev: Event):
+ try:
+ steamid64 = await resolve_target_steamid64(ev, ev.text.strip())
+ if not steamid64:
+ raise SteamValidationError("请先绑定 steam 账号")
+
+ await bot.send("正在从游戏库中随机挑选......")
+ img_bytes = await build_random_pick(steamid64)
+ await bot.send(MessageSegment.image(img_bytes))
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[steam库存] 未知错误: {e!r}")
+ await bot.send(f"发生未知错误: {e}")
diff --git a/SteamUID/SteamLibarary/library_service.py b/SteamUID/SteamLibarary/library_service.py
@@ -1,3 +1,4 @@
+import random
 from io import BytesIO
 
 from gsuid_core.data_store import get_res_path
@@ -7,6 +8,7 @@
 from ..SteamConfig.interface import SteamAPI
 from ..utils.api import get_steamlibrary_by_steamid64
 from ..utils.exceptions import SteamConfigError, SteamValidationError
+from ..utils.PIL.draw import draw_what_to_play
 from ..utils.PIL.steam_wall import build_wall
 from ..utils.utils import batch_download_images
 
@@ -50,3 +52,44 @@ async def build_library_wall(steamid64: str) -> bytes:
  buf = BytesIO()
  wall.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
  return buf.getvalue()
+
+
+async def build_random_pick(steamid64: str) -> bytes:
+ """从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+ api_key = SteamConfig.get_config("SteamWebAPIKey").data
+ if not api_key:
+ raise SteamConfigError("请先配置 steam web api key")
+
+ library = await get_steamlibrary_by_steamid64(api_key, steamid64)
+ games = library.get("games")
+ if games is None:
+ raise SteamValidationError("获取 steam 游戏库列表失败")
+ if not games:
+ raise SteamValidationError("该 steam 账号暂无游戏库存")
+ pick_count = min(3, len(games))
+ picks = random.sample(games, pick_count)
+
+ for game in picks:
+ appid = str(game.get("appid", ""))
+ name = game.get("name", "未知游戏")
+ playtime = (
+ game.get("playtime_forever", 0) or
+ game.get("playtime_windows_forever", 0) +
+ game.get("playtime_mac_forever", 0) +
+ game.get("playtime_linux_forever", 0) +
+ game.get("playtime_deck_forever", 0)
+ )
+ cover_url = SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+ game_data.append({
+ "appid": appid,
+ "name": name,
+ "playtime": playtime,
+ "cover_url": cover_url,
+ }) })
+
+ img = await draw_what_to_play(game_data)
+ img = img.convert("RGB")
+
+ buf = BytesIO()
+ img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+ return buf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
diff --git a/SteamUID/SteamPoll/poll_service.py b/SteamUID/SteamPoll/poll_service.py
@@ -1,4 +1,5 @@
 import json
+import time
 
 from gsuid_core.logger import logger
 from gsuid_core.segment import MessageSegment
@@ -18,6 +19,7 @@
  SteamBind,
  SteamArchivementInfo,
  SteamPriceInfo,
+ SteamPlayRecord,
 )
 from ..utils.PIL.draw import draw_game_status_photo, draw_archivements_photo
 from ..utils.steam_status import (
@@ -173,13 +175,32 @@ async def _dispatch_to_subs(subs, send_msg, push_column, steamid64) -> None:
 
 
 async def flush_status_updates(update_list) -> None:
- """将有变化的状态数据写回数据库"""
+ """将有变化的状态数据写回状态轮询数据库"""
  for steamid64, info in update_list:
  await SteamIDInfo.upsert_steamuserinfo(
  steamid64, json.dumps(info, ensure_ascii=False)
  )
 
-
+async def update_game_record(push_list) -> None:
+ """写入游戏记录数据库"""
+ now = int(time.time())
+ for info, old_info in push_list:
+ steamid64 = info.get("steamid")
+ if not steamid64:
+ continue
+ old_appid = old_info.get("gameid", "")
+ new_appid = info.get("gameid", "")
+ # 结束旧游戏（覆盖"切换游戏"与"退出游戏"两种场景）
+ if old_appid:
+ ret = await SteamPlayRecord.upsert_record(steamid64, old_appid, end_ts=now)
+ if ret != 0:
+ logger.warning(
+ f"[SteamPoll] 结束游玩记录失败: steamid={steamid64} appid={old_appid}"
+ )
+ # 开始新游戏
+ if new_appid:
+ await SteamPlayRecord.upsert_record(steamid64, new_appid, now)
+
 async def poll_and_push_game_status() -> None:
  """游戏状态轮询主入口：拉取状态、检测变化、推送、更新基线、落盘。"""
  try:
@@ -198,6 +219,8 @@ async def poll_and_push_game_status() -> None:
  await process_game_status_push(push_list, game_info_map)
  await update_achievement_baselines(push_list)
  await flush_status_updates(update_list)
+ await update_game_record(push_list)
+
  except Exception as error:
  logger.warning(f"[SteamPoll] 游戏状态轮询失败: {error!r}")
 

diff --git a/SteamUID/SteamRanking/__init__.py b/SteamUID/SteamRanking/__init__.py
@@ -0,0 +1,54 @@
+from gsuid_core.sv import SV
+from gsuid_core.bot import Bot
+from gsuid_core.models import Event
+from gsuid_core.logger import logger
+from gsuid_core.segment import MessageSegment
+
+from ..utils.exceptions import SteamError, SteamValidationError
+# from ..utils.target import resolve_target_steamid64
+from ..utils.utils import time_convert_s
+from .ranking_service import get_group_ranking_list
+
+ranking_sv = SV("steam排名服务")
+
+@ranking_sv.on_command(("群排行", "群排名"))
+async def group_ranking(bot: Bot, ev: Event):
+ """按用户游戏时长从高到低取5位返回"""
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+
+ ranking_list = await get_group_ranking_list(ev.group_id)
+ top5 = ranking_list[:5]
+
+ if not top5:
+ await bot.send("本群暂无游戏时长排行数据")
+ return
+
+ text = f"本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
+ for i, item in enumerate(top5, 1):
+ text += f"{i}. {item['user_id']} ({time_convert_s(item['total_duration'])})\n"
+
+ await bot.send(text)
+
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[SteamRanking - 群排行] 未知错误: {e!r}")
+ await bot.send("发生未知错误，请联系管理员查看控制台")
+
+"""
+============鸽了=============
+
+@ranking_sv.on_command(("我的排行", "我的排名"))
+async def my_ranking(bot: Bot, ev: Event):
+ 获取用户在群中的排名，应为总排行 + ... + 用户所在排行位置
+
+@ranking_sv.on_command(("游戏排行", "游戏排行"))
+async def game_ranking(bot: Bot, ev: Event):
+ 获取用户在某appid在某群中的用户游玩时长排行
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+ steamid64 = await resolve_target_steamid64(ev)
+"""
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.md b/README.md
@@ -35,9 +35,8 @@
 
 ## 丨命令列表
 
-### steam帮助
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQV9pdEVIS2NsaFRKVUtBT1R2Z2JGT0FSX2xJbnB4MEVtRkgtamNLdEc3ZUc0P2U9ZEVHZWxC.jpg" width="480" alt="Steam帮助菜单"></a>
-
+### steam帮助(图片更新可能不及时)
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2FlcEk0R3k1TFRMR2tzLWZmUUJHNkFXRFJCRXZobV9JbHh2MWZ5Rlplb2RrP2U9ejJzWGx5.jpg" width="480" alt="Steam帮助菜单">
 ### 命令说明
 
 #### 绑定账号
@@ -68,6 +67,7 @@
 | `steam游戏成就123456` | 查看appid123456的成就详情 |
 | `steam开启成就推送` | 开启自己的成就推送功能 |
 | `steam关闭成就推送` | 关闭自己的成就推送功能 |
+| `steam玩什么` | 从自己的游戏库随机挑3个游戏 |
 
 #### 商店相关
 | 命令 | 说明 |
@@ -76,11 +76,16 @@
 | `steam取消订阅降价123456` | 取消订阅商店游戏降价信息 |
 | `steam订阅降价查看` | 查看订阅的商店游戏降价信息 |
 
+#### 社交相关
+| 命令 | 说明 |
+|------|:------:|
+| `@xx steam加好友123456` | 获取被 @ 用户的好友码 |
+| `steam群排行` | 查看群游玩时长排行榜 |
+
 #### 其他服务
 | 命令 | 说明 |
 |------|:------:|
 | `steam帮助` | 呼出本插件帮助菜单 |
-| `@xx steam加好友` | 获取被 @ 用户的好友码 |
 | `清除全部缓存` | 清除全部缓存 |
 
 ## 效果图
@@ -89,25 +94,29 @@
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRHR5UVVwYVVENFJhX2UxakdHblNIeUFRVVoxcDVZMGpxRkpBWmYtRGhQRENjP2U9RTdMMlJk.png" width="160"/>
 
 ### steam成就推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQWVnNm85WjBHc1NyZWhvWHJJaVFLdUFiZEJqb3ZlQ1JHMXlNdUNLenk3TlY0P2U9cXlpTWdS.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRDVmeDFrYTF2RlI2aXo2RklpNFlSQkFkUHFGQ1FwaloteW8wZllfbkpVQXhFP2U9Ynd5bXBh.png" width="160"/>
 
 ### steam开始游戏 / 结束游戏推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2lrOERKZ1VIZFE1bkl1S2dOTzRDeUFjQlB1SmRyYlM0SlhjcGdLSTU0bGFvP2U9bm1ja0gy.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQUEtZEVQOXV3blRwMjJaN2R0MVFXNEFaZUMtVTVsOWdQZjFRSmZGSUd5UlIwP2U9elRLQmdu.png" width="160"/>
 
 ### steam游戏墙
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQnhKUDRNUFhhX1NKdUROakNNYzJ1T0FTeVRKNGlqam5wMG95YzZRUFF2QXo4P2U9aHNRV2dw.jpg" width="160"/>
 
+## steam玩什么
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQjcxemRIckRxTlI0ZGYwVmhpQm5YUkFkR0lzZjAzVktic2x2ZTQ3VUNSYnNRP2U9WXhMVUhP.jpg" width="160">
+
+
 
 ## 计划功能
 
 - [x] 支持设置所有状态推送推送默认值
 - [ ] 玩家上下线状态推送
 - [ ] 带游玩时长的游戏库存图片
 - [x] 游戏降价 / 打折信息订阅推送
-- [] steam玩什么 (随机抽游戏)
+- [x] steam玩什么 (随机抽游戏)
 - [x] 游戏名 / 成就名本地化名字获取
 - [ ] 总结推送功能 (定时总结周期内游戏情况而不每次状态变化都推送)
-- [] 群游玩时长排行榜
+- [x] 群游玩时长排行榜
 - [x] 隐藏 steamid / 好友码
 
 
@@ -117,7 +126,7 @@
 
 - 本项目仅供学习使用，请勿用于商业用途
 - [GPL-3.0 License](LICENSE)
-
+- 部分功能没有写绘图，以后再说
 
 ## 致谢
 

diff --git a/SteamUID/SteamHelp/help.json b/SteamUID/SteamHelp/help.json
@@ -115,6 +115,14 @@
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
+ },
+ {
+ "name": "玩什么",
+ "desc": "从自己的游戏库随机挑3个游戏",
+ "eg": "玩什么",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
  }
  ]
  },
@@ -147,21 +155,34 @@
  }
  ]
  },
- "其他服务": {
- "desc": "一些杂项服务",
+ "社交相关": {
+ "desc": "加好友和排行榜功能",
  "data": [
  {
- "name": "帮助",
- "desc": "呼出本插件帮助菜单",
- "eg": "帮助",
+ "name": "加好友",
+ "desc": "获取被 @ 用户的好友码",
+ "eg": "加好友",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
  },
  {
- "name": "@xx 加好友",
- "desc": "获取被 @ 用户的好友码",
- "eg": "加好友",
+ "name": "群排行",
+ "desc": "查看群游玩时长排行榜",
+ "eg": "群排行",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
+ }
+ ]
+ },
+ "其他服务": {
+ "desc": "一些杂项服务",
+ "data": [
+ {
+ "name": "帮助",
+ "desc": "呼出本插件帮助菜单",
+ "eg": "帮助",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false

diff --git a/SteamUID/SteamLibarary/__init__.py b/SteamUID/SteamLibarary/__init__.py
@@ -6,7 +6,7 @@
 
 from ..utils.exceptions import SteamError, SteamValidationError
 from ..utils.target import resolve_target_steamid64
-from .library_service import build_library_wall
+from .library_service import build_library_wall, build_random_pick
 
 library_SV = SV("steam库存相关")
 
@@ -26,3 +26,19 @@ async def get_steamlibrary_image(bot: Bot, ev: Event):
  except Exception as e:
  logger.exception(f"[steam库存] 未知错误: {e!r}")
  await bot.send(f"发生未知错误: {e}")
+
+@library_SV.on_command(("玩什么",))
+async def get_my_steamlibrary_image(bot: Bot, ev: Event):
+ try:
+ steamid64 = await resolve_target_steamid64(ev, ev.text.strip())
+ if not steamid64:
+ raise SteamValidationError("请先绑定 steam 账号")
+
+ await bot.send("正在从游戏库中随机挑选......")
+ img_bytes = await build_random_pick(steamid64)
+ await bot.send(MessageSegment.image(img_bytes))
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[steam库存] 未知错误: {e!r}")
+ await bot.send(f"发生未知错误: {e}")
diff --git a/SteamUID/SteamLibarary/library_service.py b/SteamUID/SteamLibarary/library_service.py
@@ -1,3 +1,4 @@
+import random
 from io import BytesIO
 
 from gsuid_core.data_store import get_res_path
@@ -7,6 +8,7 @@
 from ..SteamConfig.interface import SteamAPI
 from ..utils.api import get_steamlibrary_by_steamid64
 from ..utils.exceptions import SteamConfigError, SteamValidationError
+from ..utils.PIL.draw import draw_what_to_play
 from ..utils.PIL.steam_wall import build_wall
 from ..utils.utils import batch_download_images
 
@@ -50,3 +52,44 @@ async def build_library_wall(steamid64: str) -> bytes:
  buf = BytesIO()
  wall.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
  return buf.getvalue()
+
+
+async def build_random_pick(steamid64: str) -> bytes:
+ """从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+ api_key = SteamConfig.get_config("SteamWebAPIKey").data
+ if not api_key:
+ raise SteamConfigError("请先配置 steam web api key")
+
+ library = await get_steamlibrary_by_steamid64(api_key, steamid64)
+ games = library.get("games")
+ if games is None:
+ raise SteamValidationError("获取 steam 游戏库列表失败")
+ if not games:
+ raise SteamValidationError("该 steam 账号暂无游戏库存")
+ pick_count = min(3, len(games))
+ picks = random.sample(games, pick_count)
+
+ for game in picks:
+ appid = str(game.get("appid", ""))
+ name = game.get("name", "未知游戏")
+ playtime = (
+ game.get("playtime_forever", 0) or
+ game.get("playtime_windows_forever", 0) +
+ game.get("playtime_mac_forever", 0) +
+ game.get("playtime_linux_forever", 0) +
+ game.get("playtime_deck_forever", 0)
+ )
+ cover_url = SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+ game_data.append({
+ "appid": appid,
+ "name": name,
+ "playtime": playtime,
+ "cover_url": cover_url,
+ }) })
+
+ img = await draw_what_to_play(game_data)
+ img = img.convert("RGB")
+
+ buf = BytesIO()
+ img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+ return buf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
diff --git a/SteamUID/SteamPoll/poll_service.py b/SteamUID/SteamPoll/poll_service.py
@@ -1,4 +1,5 @@
 import json
+import time
 
 from gsuid_core.logger import logger
 from gsuid_core.segment import MessageSegment
@@ -18,6 +19,7 @@
  SteamBind,
  SteamArchivementInfo,
  SteamPriceInfo,
+ SteamPlayRecord,
 )
 from ..utils.PIL.draw import draw_game_status_photo, draw_archivements_photo
 from ..utils.steam_status import (
@@ -173,13 +175,32 @@ async def _dispatch_to_subs(subs, send_msg, push_column, steamid64) -> None:
 
 
 async def flush_status_updates(update_list) -> None:
- """将有变化的状态数据写回数据库"""
+ """将有变化的状态数据写回状态轮询数据库"""
  for steamid64, info in update_list:
  await SteamIDInfo.upsert_steamuserinfo(
  steamid64, json.dumps(info, ensure_ascii=False)
  )
 
-
+async def update_game_record(push_list) -> None:
+ """写入游戏记录数据库"""
+ now = int(time.time())
+ for info, old_info in push_list:
+ steamid64 = info.get("steamid")
+ if not steamid64:
+ continue
+ old_appid = old_info.get("gameid", "")
+ new_appid = info.get("gameid", "")
+ # 结束旧游戏（覆盖"切换游戏"与"退出游戏"两种场景）
+ if old_appid:
+ ret = await SteamPlayRecord.upsert_record(steamid64, old_appid, end_ts=now)
+ if ret != 0:
+ logger.warning(
+ f"[SteamPoll] 结束游玩记录失败: steamid={steamid64} appid={old_appid}"
+ )
+ # 开始新游戏
+ if new_appid:
+ await SteamPlayRecord.upsert_record(steamid64, new_appid, now)
+
 async def poll_and_push_game_status() -> None:
  """游戏状态轮询主入口：拉取状态、检测变化、推送、更新基线、落盘。"""
  try:
@@ -198,6 +219,8 @@ async def poll_and_push_game_status() -> None:
  await process_game_status_push(push_list, game_info_map)
  await update_achievement_baselines(push_list)
  await flush_status_updates(update_list)
+ await update_game_record(push_list)
+
  except Exception as error:
  logger.warning(f"[SteamPoll] 游戏状态轮询失败: {error!r}")
 

diff --git a/SteamUID/SteamRanking/__init__.py b/SteamUID/SteamRanking/__init__.py
@@ -0,0 +1,54 @@
+from gsuid_core.sv import SV
+from gsuid_core.bot import Bot
+from gsuid_core.models import Event
+from gsuid_core.logger import logger
+from gsuid_core.segment import MessageSegment
+
+from ..utils.exceptions import SteamError, SteamValidationError
+# from ..utils.target import resolve_target_steamid64
+from ..utils.utils import time_convert_s
+from .ranking_service import get_group_ranking_list
+
+ranking_sv = SV("steam排名服务")
+
+@ranking_sv.on_command(("群排行", "群排名"))
+async def group_ranking(bot: Bot, ev: Event):
+ """按用户游戏时长从高到低取5位返回"""
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+
+ ranking_list = await get_group_ranking_list(ev.group_id)
+ top5 = ranking_list[:5]
+
+ if not top5:
+ await bot.send("本群暂无游戏时长排行数据")
+ return
+
+ text = f"本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
+ for i, item in enumerate(top5, 1):
+ text += f"{i}. {item['user_id']} ({time_convert_s(item['total_duration'])})\n"
+
+ await bot.send(text)
+
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[SteamRanking - 群排行] 未知错误: {e!r}")
+ await bot.send("发生未知错误，请联系管理员查看控制台")
+
+"""
+============鸽了=============
+
+@ranking_sv.on_command(("我的排行", "我的排名"))
+async def my_ranking(bot: Bot, ev: Event):
+ 获取用户在群中的排名，应为总排行 + ... + 用户所在排行位置
+
+@ranking_sv.on_command(("游戏排行", "游戏排行"))
+async def game_ranking(bot: Bot, ev: Event):
+ 获取用户在某appid在某群中的用户游玩时长排行
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+ steamid64 = await resolve_target_steamid64(ev)
+"""
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.md b/README.md
@@ -35,9 +35,8 @@
 
 ## 丨命令列表
 
-### steam帮助
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQV9pdEVIS2NsaFRKVUtBT1R2Z2JGT0FSX2xJbnB4MEVtRkgtamNLdEc3ZUc0P2U9ZEVHZWxC.jpg" width="480" alt="Steam帮助菜单"></a>
-
+### steam帮助(图片更新可能不及时)
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2FlcEk0R3k1TFRMR2tzLWZmUUJHNkFXRFJCRXZobV9JbHh2MWZ5Rlplb2RrP2U9ejJzWGx5.jpg" width="480" alt="Steam帮助菜单">
 ### 命令说明
 
 #### 绑定账号
@@ -68,6 +67,7 @@
 | `steam游戏成就123456` | 查看appid123456的成就详情 |
 | `steam开启成就推送` | 开启自己的成就推送功能 |
 | `steam关闭成就推送` | 关闭自己的成就推送功能 |
+| `steam玩什么` | 从自己的游戏库随机挑3个游戏 |
 
 #### 商店相关
 | 命令 | 说明 |
@@ -76,11 +76,16 @@
 | `steam取消订阅降价123456` | 取消订阅商店游戏降价信息 |
 | `steam订阅降价查看` | 查看订阅的商店游戏降价信息 |
 
+#### 社交相关
+| 命令 | 说明 |
+|------|:------:|
+| `@xx steam加好友123456` | 获取被 @ 用户的好友码 |
+| `steam群排行` | 查看群游玩时长排行榜 |
+
 #### 其他服务
 | 命令 | 说明 |
 |------|:------:|
 | `steam帮助` | 呼出本插件帮助菜单 |
-| `@xx steam加好友` | 获取被 @ 用户的好友码 |
 | `清除全部缓存` | 清除全部缓存 |
 
 ## 效果图
@@ -89,25 +94,29 @@
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRHR5UVVwYVVENFJhX2UxakdHblNIeUFRVVoxcDVZMGpxRkpBWmYtRGhQRENjP2U9RTdMMlJk.png" width="160"/>
 
 ### steam成就推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQWVnNm85WjBHc1NyZWhvWHJJaVFLdUFiZEJqb3ZlQ1JHMXlNdUNLenk3TlY0P2U9cXlpTWdS.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRRDVmeDFrYTF2RlI2aXo2RklpNFlSQkFkUHFGQ1FwaloteW8wZllfbkpVQXhFP2U9Ynd5bXBh.png" width="160"/>
 
 ### steam开始游戏 / 结束游戏推送
-<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQ2lrOERKZ1VIZFE1bkl1S2dOTzRDeUFjQlB1SmRyYlM0SlhjcGdLSTU0bGFvP2U9bm1ja0gy.png" width="160"/>
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQUEtZEVQOXV3blRwMjJaN2R0MVFXNEFaZUMtVTVsOWdQZjFRSmZGSUd5UlIwP2U9elRLQmdu.png" width="160"/>
 
 ### steam游戏墙
 <img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQnhKUDRNUFhhX1NKdUROakNNYzJ1T0FTeVRKNGlqam5wMG95YzZRUFF2QXo4P2U9aHNRV2dw.jpg" width="160"/>
 
+## steam玩什么
+<img src="https://dlink.host/1drv/aHR0cHM6Ly8xZHJ2Lm1zL2kvYy8xYmIyNTkxODI4ZDcyZTIzL0lRQjcxemRIckRxTlI0ZGYwVmhpQm5YUkFkR0lzZjAzVktic2x2ZTQ3VUNSYnNRP2U9WXhMVUhP.jpg" width="160">
+
+
 
 ## 计划功能
 
 - [x] 支持设置所有状态推送推送默认值
 - [ ] 玩家上下线状态推送
 - [ ] 带游玩时长的游戏库存图片
 - [x] 游戏降价 / 打折信息订阅推送
-- [] steam玩什么 (随机抽游戏)
+- [x] steam玩什么 (随机抽游戏)
 - [x] 游戏名 / 成就名本地化名字获取
 - [ ] 总结推送功能 (定时总结周期内游戏情况而不每次状态变化都推送)
-- [] 群游玩时长排行榜
+- [x] 群游玩时长排行榜
 - [x] 隐藏 steamid / 好友码
 
 
@@ -117,7 +126,7 @@
 
 - 本项目仅供学习使用，请勿用于商业用途
 - [GPL-3.0 License](LICENSE)
-
+- 部分功能没有写绘图，以后再说
 
 ## 致谢
 

diff --git a/SteamUID/SteamHelp/help.json b/SteamUID/SteamHelp/help.json
@@ -115,6 +115,14 @@
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
+ },
+ {
+ "name": "玩什么",
+ "desc": "从自己的游戏库随机挑3个游戏",
+ "eg": "玩什么",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
  }
  ]
  },
@@ -147,21 +155,34 @@
  }
  ]
  },
- "其他服务": {
- "desc": "一些杂项服务",
+ "社交相关": {
+ "desc": "加好友和排行榜功能",
  "data": [
  {
- "name": "帮助",
- "desc": "呼出本插件帮助菜单",
- "eg": "帮助",
+ "name": "加好友",
+ "desc": "获取被 @ 用户的好友码",
+ "eg": "加好友",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false
  },
  {
- "name": "@xx 加好友",
- "desc": "获取被 @ 用户的好友码",
- "eg": "加好友",
+ "name": "群排行",
+ "desc": "查看群游玩时长排行榜",
+ "eg": "群排行",
+ "need_ck": false,
+ "need_sk": false,
+ "need_admin": false
+ }
+ ]
+ },
+ "其他服务": {
+ "desc": "一些杂项服务",
+ "data": [
+ {
+ "name": "帮助",
+ "desc": "呼出本插件帮助菜单",
+ "eg": "帮助",
  "need_ck": false,
  "need_sk": false,
  "need_admin": false

diff --git a/SteamUID/SteamLibarary/__init__.py b/SteamUID/SteamLibarary/__init__.py
@@ -6,7 +6,7 @@
 
 from ..utils.exceptions import SteamError, SteamValidationError
 from ..utils.target import resolve_target_steamid64
-from .library_service import build_library_wall
+from .library_service import build_library_wall, build_random_pick
 
 library_SV = SV("steam库存相关")
 
@@ -26,3 +26,19 @@ async def get_steamlibrary_image(bot: Bot, ev: Event):
  except Exception as e:
  logger.exception(f"[steam库存] 未知错误: {e!r}")
  await bot.send(f"发生未知错误: {e}")
+
+@library_SV.on_command(("玩什么",))
+async def get_my_steamlibrary_image(bot: Bot, ev: Event):
+ try:
+ steamid64 = await resolve_target_steamid64(ev, ev.text.strip())
+ if not steamid64:
+ raise SteamValidationError("请先绑定 steam 账号")
+
+ await bot.send("正在从游戏库中随机挑选......")
+ img_bytes = await build_random_pick(steamid64)
+ await bot.send(MessageSegment.image(img_bytes))
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[steam库存] 未知错误: {e!r}")
+ await bot.send(f"发生未知错误: {e}")
diff --git a/SteamUID/SteamLibarary/library_service.py b/SteamUID/SteamLibarary/library_service.py
@@ -1,3 +1,4 @@
+import random
 from io import BytesIO
 
 from gsuid_core.data_store import get_res_path
@@ -7,6 +8,7 @@
 from ..SteamConfig.interface import SteamAPI
 from ..utils.api import get_steamlibrary_by_steamid64
 from ..utils.exceptions import SteamConfigError, SteamValidationError
+from ..utils.PIL.draw import draw_what_to_play
 from ..utils.PIL.steam_wall import build_wall
 from ..utils.utils import batch_download_images
 
@@ -50,3 +52,44 @@ async def build_library_wall(steamid64: str) -> bytes:
  buf = BytesIO()
  wall.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
  return buf.getvalue()
+
+
+async def build_random_pick(steamid64: str) -> bytes:
+ """从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+ api_key = SteamConfig.get_config("SteamWebAPIKey").data
+ if not api_key:
+ raise SteamConfigError("请先配置 steam web api key")
+
+ library = await get_steamlibrary_by_steamid64(api_key, steamid64)
+ games = library.get("games")
+ if games is None:
+ raise SteamValidationError("获取 steam 游戏库列表失败")
+ if not games:
+ raise SteamValidationError("该 steam 账号暂无游戏库存")
+ pick_count = min(3, len(games))
+ picks = random.sample(games, pick_count)
+
+ for game in picks:
+ appid = str(game.get("appid", ""))
+ name = game.get("name", "未知游戏")
+ playtime = (
+ game.get("playtime_forever", 0) or
+ game.get("playtime_windows_forever", 0) +
+ game.get("playtime_mac_forever", 0) +
+ game.get("playtime_linux_forever", 0) +
+ game.get("playtime_deck_forever", 0)
+ )
+ cover_url = SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+ game_data.append({
+ "appid": appid,
+ "name": name,
+ "playtime": playtime,
+ "cover_url": cover_url,
+ }) })
+
+ img = await draw_what_to_play(game_data)
+ img = img.convert("RGB")
+
+ buf = BytesIO()
+ img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+ return buf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
-
-
-asyncdefbuild_random_pick(steamid64: str) ->bytes:
-"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
-api_key=SteamConfig.get_config("SteamWebAPIKey").data
-ifnotapi_key:
-raiseSteamConfigError("请先配置 steam web api key")
-
-library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
-games=library.get("games")
-ifgamesisNone:
-raiseSteamValidationError("获取 steam 游戏库列表失败")
-ifnotgames:
-raiseSteamValidationError("该 steam 账号暂无游戏库存")
-pick_count=min(3, len(games))
-picks=random.sample(games, pick_count)
-
-forgameinpicks:
-appid=str(game.get("appid", ""))
-name=game.get("name", "未知游戏")
-playtime= (
-game.get("playtime_forever", 0) or
-game.get("playtime_windows_forever", 0) +
-game.get("playtime_mac_forever", 0) +
-game.get("playtime_linux_forever", 0) +
-game.get("playtime_deck_forever", 0)
- )
-cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
-game_data.append({
-"appid": appid,
-"name": name,
-"playtime": playtime,
-"cover_url": cover_url,
- }) })
-
-img=awaitdraw_what_to_play(game_data)
-img=img.convert("RGB")
-
-buf=BytesIO()
-img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
-returnbuf.getvalue()
+
+asyncdefbuild_random_pick(steamid64: str) ->bytes:
+"""从用户 Steam 游戏库中随机选取 3 款游戏，生成推荐图片。"""
+api_key=SteamConfig.get_config("SteamWebAPIKey").data
+ifnotapi_key:
+raiseSteamConfigError("请先配置 steam web api key")
+
+library=awaitget_steamlibrary_by_steamid64(api_key, steamid64)
+games=library.get("games")
+ifgamesisNone:
+raiseSteamValidationError("获取 steam 游戏库列表失败")
+ifnotgames:
+raiseSteamValidationError("该 steam 账号暂无游戏库存")
+pick_count=min(3, len(games))
+picks=random.sample(games, pick_count)
+
+game_data= []
+forgameinpicks:
+appid=str(game.get("appid", ""))
+name=game.get("name", "未知游戏")
+playtime= (
+game.get("playtime_forever", 0) or
+game.get("playtime_windows_forever", 0) +
+game.get("playtime_mac_forever", 0) +
+game.get("playtime_linux_forever", 0) +
+game.get("playtime_deck_forever", 0)
+ )
+cover_url=SteamAPI.GetGameCoverImageURL(appid, variant='library_600x900')
+game_data.append({
+"appid": appid,
+"name": name,
+"playtime": playtime,
+"cover_url": cover_url,
+ })
+
+img=awaitdraw_what_to_play(game_data)
+img=img.convert("RGB")
+
+buf=BytesIO()
+img.save(buf, format="JPEG", quality=pic_quality, subsampling=0)
+returnbuf.getvalue()
diff --git a/SteamUID/SteamPoll/poll_service.py b/SteamUID/SteamPoll/poll_service.py
@@ -1,4 +1,5 @@
 import json
+import time
 
 from gsuid_core.logger import logger
 from gsuid_core.segment import MessageSegment
@@ -18,6 +19,7 @@
  SteamBind,
  SteamArchivementInfo,
  SteamPriceInfo,
+ SteamPlayRecord,
 )
 from ..utils.PIL.draw import draw_game_status_photo, draw_archivements_photo
 from ..utils.steam_status import (
@@ -173,13 +175,32 @@ async def _dispatch_to_subs(subs, send_msg, push_column, steamid64) -> None:
 
 
 async def flush_status_updates(update_list) -> None:
- """将有变化的状态数据写回数据库"""
+ """将有变化的状态数据写回状态轮询数据库"""
  for steamid64, info in update_list:
  await SteamIDInfo.upsert_steamuserinfo(
  steamid64, json.dumps(info, ensure_ascii=False)
  )
 
-
+async def update_game_record(push_list) -> None:
+ """写入游戏记录数据库"""
+ now = int(time.time())
+ for info, old_info in push_list:
+ steamid64 = info.get("steamid")
+ if not steamid64:
+ continue
+ old_appid = old_info.get("gameid", "")
+ new_appid = info.get("gameid", "")
+ # 结束旧游戏（覆盖"切换游戏"与"退出游戏"两种场景）
+ if old_appid:
+ ret = await SteamPlayRecord.upsert_record(steamid64, old_appid, end_ts=now)
+ if ret != 0:
+ logger.warning(
+ f"[SteamPoll] 结束游玩记录失败: steamid={steamid64} appid={old_appid}"
+ )
+ # 开始新游戏
+ if new_appid:
+ await SteamPlayRecord.upsert_record(steamid64, new_appid, now)
+
 async def poll_and_push_game_status() -> None:
  """游戏状态轮询主入口：拉取状态、检测变化、推送、更新基线、落盘。"""
  try:
@@ -198,6 +219,8 @@ async def poll_and_push_game_status() -> None:
  await process_game_status_push(push_list, game_info_map)
  await update_achievement_baselines(push_list)
  await flush_status_updates(update_list)
+ await update_game_record(push_list)
+
  except Exception as error:
  logger.warning(f"[SteamPoll] 游戏状态轮询失败: {error!r}")
 

diff --git a/SteamUID/SteamRanking/__init__.py b/SteamUID/SteamRanking/__init__.py
@@ -0,0 +1,54 @@
+from gsuid_core.sv import SV
+from gsuid_core.bot import Bot
+from gsuid_core.models import Event
+from gsuid_core.logger import logger
+from gsuid_core.segment import MessageSegment
+
+from ..utils.exceptions import SteamError, SteamValidationError
+# from ..utils.target import resolve_target_steamid64
+from ..utils.utils import time_convert_s
+from .ranking_service import get_group_ranking_list
+
+ranking_sv = SV("steam排名服务")
+
+@ranking_sv.on_command(("群排行", "群排名"))
+async def group_ranking(bot: Bot, ev: Event):
+ """按用户游戏时长从高到低取5位返回"""
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+
+ ranking_list = await get_group_ranking_list(ev.group_id)
+ top5 = ranking_list[:5]
+
+ if not top5:
+ await bot.send("本群暂无游戏时长排行数据")
+ return
+
+ text = f"本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
-text=f"本群游戏时长排行：\n"
+text="本群游戏时长排行：\n"
+ for i, item in enumerate(top5, 1):
+ text += f"{i}. {item['user_id']} ({time_convert_s(item['total_duration'])})\n"
+
+ await bot.send(text)
+
+ except SteamError as e:
+ await bot.send(str(e))
+ except Exception as e:
+ logger.exception(f"[SteamRanking - 群排行] 未知错误: {e!r}")
+ await bot.send("发生未知错误，请联系管理员查看控制台")
+
+"""
+============鸽了=============
+
+@ranking_sv.on_command(("我的排行", "我的排名"))
+async def my_ranking(bot: Bot, ev: Event):
+ 获取用户在群中的排名，应为总排行 + ... + 用户所在排行位置
+
+@ranking_sv.on_command(("游戏排行", "游戏排行"))
+async def game_ranking(bot: Bot, ev: Event):
+ 获取用户在某appid在某群中的用户游玩时长排行
+ try:
+ if not ev.group_id:
+ raise SteamValidationError("请在群聊中使用此功能")
+ steamid64 = await resolve_target_steamid64(ev)
+"""