nonebot-plugin-R6States 1.0.0__tar.gz → 1.1.1__tar.gz

{nonebot_plugin_r6states-1.0.0 → nonebot_plugin_r6states-1.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nonebot-plugin-R6States
-Version: 1.0.0
+Version: 1.1.1
 Summary: 查询指定玩家的各项数据
 Author-Email: Siornya <wxh200607@outlook.com>
 License: MIT
@@ -15,59 +15,42 @@ Description-Content-Type: text/markdown
 
 一个基于 **NoneBot2** 的《彩虹六号：围攻》战绩查询插件
 
----
-
 ## 功能特性
 
 * ✅ 通过 QQ 指令查询 R6 玩家战绩
 * ✅ 支持 **单人查询 / 多人查询**
 * ✅ 数据源自 [R6Data API](https://r6data.com/)
-* ✅ 玩家数据缓存半小时，降低 API 用量
+* ✅ 玩家数据缓存，降低 API 用量
 * ✅ 数据分析功能
 * ⚙️ 地图筛选 `-m / --map`
 
----
-
-## 参考运行环境
-
-* **Python 3.12**
-* **NoneBot2**
-* **OneBot v11**
-* **NapCat（反向 WebSocket）**
-
----
-
 ## Usage 使用说明
 
 ### 安装
 
-可以直接将 `nonebot_plugin_R6States` 文件夹放入插件目录中。
+- （推荐）使用nb安装`nb plugin install nonebot-plugin-R6States`
+- 使用pip安装`pip install nonebot-plugin-R6States`
+- 下载release放到`plugins`文件夹中
 
-### 基础指令
+### 指令
 
-```text
-/R6 <player_id>
-```
+数据查询：`/R6 <player_ids...>`
+其他指令与帮助信息：`/R6help`
 
-### 多人查询
+## 环境配置
 
-```text
-/R6 -g <id1> <id2> ... <idN>
-```
+CURRENT_SEASON = "Y11S2"
 
-### 帮助信息
+R6_OUTPUT_IMAGE = True
 
-```text
-/R6help
-```
+R6_CACHE_MINUTES = 45
 
-### 额外获取地图信息
-
-```text
--m / --map <map_name>
-```
+## 参考运行环境
 
----
+* **Python 3.12**
+* **NoneBot2**
+* **OneBot v11**
+* **NapCat（反向 WebSocket）**
 
 ## 特别提醒
 

{nonebot_plugin_r6states-1.0.0 → nonebot_plugin_r6states-1.1.1}/README.md

@@ -2,59 +2,42 @@
 
 一个基于 **NoneBot2** 的《彩虹六号：围攻》战绩查询插件
 
----
-
 ## 功能特性
 
 * ✅ 通过 QQ 指令查询 R6 玩家战绩
 * ✅ 支持 **单人查询 / 多人查询**
 * ✅ 数据源自 [R6Data API](https://r6data.com/)
-* ✅ 玩家数据缓存半小时，降低 API 用量
+* ✅ 玩家数据缓存，降低 API 用量
 * ✅ 数据分析功能
 * ⚙️ 地图筛选 `-m / --map`
 
----
-
-## 参考运行环境
-
-* **Python 3.12**
-* **NoneBot2**
-* **OneBot v11**
-* **NapCat（反向 WebSocket）**
-
----
-
 ## Usage 使用说明
 
 ### 安装
 
-可以直接将 `nonebot_plugin_R6States` 文件夹放入插件目录中。
+- （推荐）使用nb安装`nb plugin install nonebot-plugin-R6States`
+- 使用pip安装`pip install nonebot-plugin-R6States`
+- 下载release放到`plugins`文件夹中
 
-### 基础指令
+### 指令
 
-```text
-/R6 <player_id>
-```
+数据查询：`/R6 <player_ids...>`
+其他指令与帮助信息：`/R6help`
 
-### 多人查询
+## 环境配置
 
-```text
-/R6 -g <id1> <id2> ... <idN>
-```
+CURRENT_SEASON = "Y11S2"
 
-### 帮助信息
+R6_OUTPUT_IMAGE = True
 
-```text
-/R6help
-```
+R6_CACHE_MINUTES = 45
 
-### 额外获取地图信息
-
-```text
--m / --map <map_name>
-```
+## 参考运行环境
 
----
+* **Python 3.12**
+* **NoneBot2**
+* **OneBot v11**
+* **NapCat（反向 WebSocket）**
 
 ## 特别提醒
 

{nonebot_plugin_r6states-1.0.0 → nonebot_plugin_r6states-1.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-R6States"
-version = "1.0.0"
+version = "1.1.1"
 description = "查询指定玩家的各项数据"
 authors = [
     { name = "Siornya", email = "wxh200607@outlook.com" },

{nonebot_plugin_r6states-1.0.0 → nonebot_plugin_r6states-1.1.1}/src/nonebot_plugin_R6States/__init__.py

@@ -1,11 +1,13 @@
-from nonebot import on_command, logger
+import asyncio
+
+from nonebot import on_command, logger, get_driver
 from nonebot.adapters import Message
 from nonebot.params import CommandArg
 from nonebot.plugin import PluginMetadata, get_plugin_config
 from nonebot.adapters.onebot.v11 import MessageEvent, MessageSegment, GroupMessageEvent
 
 from .config import Config
-from .service import VALID_PLATFORMS, ServiceError, get_full_stats
+from .service import VALID_PLATFORMS, ServiceError, aclose, get_full_stats
 from .formatter import format_full_stats
 from .renderer import render_full_stats
 from .config_mannger import (
@@ -18,7 +20,7 @@ from .config_mannger import (
 __plugin_meta__ = PluginMetadata(
     name="彩六数据查询",
     description="查询指定玩家的数据",
-    usage="/r6 <id> [平台]　/r6key <key>　/r6help",
+    usage="/r6 <id...> [平台]　/r6key <key>　/r6help",
     homepage="https://github.com/Siornya/nonebot-plugin-R6States",
     type="application",
     config=Config,
@@ -27,28 +29,32 @@ __plugin_meta__ = PluginMetadata(
 
 plugin_config = get_plugin_config(Config)
 
+
+@get_driver().on_shutdown
+async def _shutdown():
+    await aclose()
+
+
 r6 = on_command("r6", aliases={"R6"}, priority=10, block=True)
 r6_key = on_command("r6key", aliases={"R6key", "R6DAPI", "r6dapi"}, priority=5, block=True)
 r6_help = on_command("r6help", aliases={"R6help"}, priority=5, block=True)
 
 HELP_TEXT = (
     "彩六数据查询\n"
-    "/r6 <id> [平台]   查询玩家数据（平台默认 uplay，可选 psn/xbl）\n"
+    "/r6 <id...> [平台]  查询玩家数据（最多5个，空格分隔；平台默认 uplay，可选 psn/xbl）\n"
     "/r6key <key>      设置本群/本人的 r6data API Key\n"
-    "/r6help           显示本帮助\n"
-    "Key 可在 https://r6data.com/ 免费获取；优先用你的个人 Key，没有则用群 Key"
+    "/r6help           显示帮助\n"
+    "聊群中API KEY优先用个人 Key，没有则用群 Key"
 )
 
 
 def _scope_id(event: MessageEvent) -> str:
-    """设置 key 的归属：群聊按群、私聊按人。"""
     if isinstance(event, GroupMessageEvent):
         return str(event.group_id)
     return str(event.user_id)
 
 
 def _lookup_scopes(event: MessageEvent) -> list[str]:
-    """查询时的 key 候选顺序：个人优先，个人没设则回退到群。"""
     if isinstance(event, GroupMessageEvent):
         return [str(event.user_id), str(event.group_id)]
     return [str(event.user_id)]
@@ -64,7 +70,7 @@ async def _(event: MessageEvent, args: Message = CommandArg()):
     key = args.extract_plain_text().strip()
     if not key:
         await r6_key.finish(
-            "请在命令后输入 API Key，例如：/r6key abcdef...\n"
+            "请在命令后输入 API Key，例如：/r6key <key>\n"
             "没有的话可在 https://r6data.com/ 免费获取"
         )
 
@@ -78,7 +84,7 @@ async def _(event: MessageEvent, args: Message = CommandArg()):
 async def _(event: MessageEvent, args: Message = CommandArg()):
     tokens = args.extract_plain_text().split()
     if not tokens:
-        await r6.finish("用法：/r6 <id> [平台]，详见 /r6help")
+        await r6.finish("用法：/r6 <id...> [平台]，详见 /r6help")
 
     # 末尾 token 若是平台名则作为平台，其余都当作玩家 id。
     platform = "uplay"
@@ -97,21 +103,33 @@ async def _(event: MessageEvent, args: Message = CommandArg()):
     if age is not None and age >= KEY_TTL_DAYS:
         await r6.send(f"⚠️ 当前 API Key 已设置 {age:.0f} 天，可能已过期，如查询失败请 /r6key 重设")
 
-    for player_id in tokens:
-        try:
-            data = await get_full_stats(
-                player_id, scopes, platform, season_year=plugin_config.current_season
+    # 并发取数（单个失败不连累其余），再按原顺序逐个发送
+    ttl = plugin_config.r6_cache_minutes * 60
+    results = await asyncio.gather(
+        *(
+            get_full_stats(
+                pid, scopes, platform,
+                season_year=plugin_config.current_season, ttl=ttl,
             )
-            if plugin_config.r6_output_image:
-                try:
-                    png = render_full_stats(player_id, data)
-                    await r6.send(MessageSegment.image(png))
-                    continue
-                except Exception as e:  # noqa: BLE001 - 渲染失败回退文本
-                    logger.warning(f"图片渲染失败，回退文本: {type(e).__name__}: {e}")
-            await r6.send(format_full_stats(player_id, data))
-        except ServiceError as e:
-            await r6.send(f"❌ {player_id}：{e.message}")
-        except Exception as e:  # noqa: BLE001
-            logger.error(f"查询 {player_id} 出错: {type(e).__name__}: {e}")
+            for pid in tokens
+        ),
+        return_exceptions=True,
+    )
+
+    for player_id, data in zip(tokens, results):
+        if isinstance(data, ServiceError):
+            logger.warning(f"查询 {player_id} 失败: {data.message}")
+            await r6.send(f"❌ {player_id}：{data.message}")
+            continue
+        if isinstance(data, BaseException):
+            logger.error(f"查询 {player_id} 出错: {type(data).__name__}: {data}")
             await r6.send(f"❌ {player_id}：查询失败")
+            continue
+        if plugin_config.r6_output_image:
+            try:
+                png = render_full_stats(player_id, data)
+                await r6.send(MessageSegment.image(png))
+                continue
+            except Exception as e:  # noqa: BLE001 - 渲染失败回退文本
+                logger.warning(f"图片渲染失败，回退文本: {type(e).__name__}: {e}")
+        await r6.send(format_full_stats(player_id, data))

{nonebot_plugin_r6states-1.0.0 → nonebot_plugin_r6states-1.1.1}/src/nonebot_plugin_R6States/cache.py

@@ -1,10 +1,3 @@
-"""轻量本地缓存：单 JSON 文件 + 每条目独立 TTL + 异步锁 + 原子写。
-
-设计动机（对比旧的 players.yaml）：
-- 旧实现按**整文件** mtime 判 TTL，一次写入会重置所有条目的有效期，过期还整包丢弃。
-- 这里每条目自带写入时间戳，**各自过期**；TTL 由调用方按 endpoint 指定。
-- 写入走 "临时文件 + os.replace" 原子替换，配异步锁，避免并发下半写/相互覆盖。
-"""
 from __future__ import annotations
 
 import os
@@ -29,7 +22,6 @@ class JSONCache:
                 data = json.load(f)
             return data if isinstance(data, dict) else {}
         except (json.JSONDecodeError, OSError):
-            # 缓存损坏不应影响主流程：当作空缓存重建。
             return {}
 
     def _atomic_write(self, data: dict[str, dict[str, Any]]) -> None:
@@ -46,18 +38,18 @@ class JSONCache:
                 pass
             raise
 
-    async def get(self, key: str, ttl: float) -> Optional[Any]:
-        """命中且未超过 ttl（秒）则返回缓存值，否则返回 None。"""
+    async def get(self, key: str) -> Optional[Any]:
         async with self._lock:
             entry = self._load().get(key)
-        if not entry:
-            return None
-        if time.time() - entry.get("ts", 0) > ttl:
+        if not entry or entry.get("exp", 0) < time.time():
             return None
         return entry.get("value")
 
-    async def set(self, key: str, value: Any) -> None:
+    async def set(self, key: str, value: Any, ttl: float) -> None:
+        """写入并带上过期时间；顺手剔除已过期条目，避免文件无限增长。"""
+        now = time.time()
         async with self._lock:
             data = self._load()
-            data[key] = {"ts": time.time(), "value": value}
+            data[key] = {"exp": now + ttl, "value": value}
+            data = {k: v for k, v in data.items() if v.get("exp", 0) > now}
             self._atomic_write(data)

nonebot_plugin_r6states-1.1.1/src/nonebot_plugin_R6States/config.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from pydantic import BaseModel
+
+
+class Config(BaseModel):
+    # 当前赛季代码，查询默认按此赛季过滤。填 "all" 则不过滤、查生涯。
+    # 在 .env 里用 CURRENT_SEASON 覆盖
+    current_season: str = "Y11S2"
+
+    # 查询结果渲染成图片，失败时自动回退文本
+    # 在 .env 用 R6_OUTPUT_IMAGE 覆盖
+    r6_output_image: bool = True
+
+    # 玩家数据本地缓存时长（分钟）。越大越省 API 用量，但数据越旧。
+    # 在 .env 用 R6_CACHE_MINUTES 覆盖
+    r6_cache_minutes: int = 45

{nonebot_plugin_r6states-1.0.0 → nonebot_plugin_r6states-1.1.1}/src/nonebot_plugin_R6States/config_mannger.py

@@ -1,9 +1,3 @@
-"""按群/按人管理 r6data api-key。
-
-落盘格式（带设置时间戳，用于过期提醒；key 官方有效期约 1 个月）::
-
-    {"apikeys": {"<id>": {"key": "...", "set_at": 1712345678.0}}}
-"""
 from __future__ import annotations
 
 import json
@@ -53,10 +47,6 @@ def get_apikey(target_id: str) -> Optional[str]:
 
 
 def resolve_apikey(scopes: list[str]) -> tuple[Optional[str], Optional[str]]:
-    """按候选顺序找第一个有 key 的归属，返回 (key, 命中的 scope)。
-
-    群聊传 [群号, 用户号]：群没设 key 时回退到个人 key。
-    """
     for scope in scopes:
         key = get_apikey(scope)
         if key:
@@ -65,7 +55,6 @@ def resolve_apikey(scopes: list[str]) -> tuple[Optional[str], Optional[str]]:
 
 
 def get_apikey_age_days(target_id: str) -> Optional[float]:
-    """key 已设置的天数；旧格式/未设置返回 None。"""
     entry = _entry(target_id)
     if not entry:
         return None

{nonebot_plugin_r6states-1.0.0 → nonebot_plugin_r6states-1.1.1}/src/nonebot_plugin_R6States/formatter.py

@@ -7,20 +7,44 @@ fullStats 顶层有三块：
 """
 from __future__ import annotations
 
-from typing import Any
+from typing import Any, Optional
+from datetime import timezone, datetime, timedelta
 
 #: 默认展示出场最多的前 N 个干员
 TOP_N = 8
 
+#: 展示时间用东八区（CN bot）
+_CST = timezone(timedelta(hours=8))
+
+
+def fetched_label(data: dict[str, Any]) -> Optional[str]:
+    """数据实际取回时刻（随缓存保存），格式 '更新 06-14 17:30'；无则返回 None。"""
+    ts = data.get("_fetched_at")
+    if not ts:
+        return None
+    return "更新 " + datetime.fromtimestamp(ts, _CST).strftime("%m-%d %H:%M")
+
 _SIDE_CN = {"Attacker": "攻", "Defender": "防"}
 _BOARD_CN = {
     "ranked": "排位", "casual": "休闲", "standard": "标准",
     "event": "活动", "warmup": "热身",
 }
 
+#: 1000 起每档 100 分、每大段 5 小级；<1000 未定级，>=4500 冠军。
+_RANK_TIERS = ("紫铜", "青铜", "白银", "黄金", "铂金", "翡翠", "钻石")
+
+
+def rank_name(mmr: int) -> str:
+    if mmr < 1000:
+        return "未定级"
+    if mmr >= 4500:
+        return "冠军"
+    idx = (mmr - 1000) // 100
+    return f"{_RANK_TIERS[idx // 5]}{5 - idx % 5}"
+
 
 def _format_boards(profiles: list[dict[str, Any]]) -> list[str]:
-    """各 board 取最新赛季档案，输出概览行。"""
+    """各 board 取最新赛季档案，输出概览行；排位行补段位名。"""
     out: list[str] = []
     for fam in profiles:
         for board in fam.get("board_ids_full_profiles") or []:
@@ -33,9 +57,12 @@ def _format_boards(profiles: list[dict[str, Any]]) -> list[str]:
             kills, deaths = p.get("kills", 0), p.get("deaths", 0)
             wr = wins / (wins + losses) * 100 if (wins + losses) else 0
             kd = kills / deaths if deaths else float(kills)
-            name = _BOARD_CN.get(board.get("board_id", ""), board.get("board_id", "?"))
+            bid = board.get("board_id", "")
+            name = _BOARD_CN.get(bid, bid or "?")
+            rp = p.get("rank_points", 0)
+            rank_str = f"{rank_name(rp)} " if bid == "ranked" else ""
             out.append(
-                f"{name} RP{p.get('rank_points', 0)}(峰{p.get('max_rank_points', 0)}) "
+                f"{name} {rank_str}RP{rp}({p.get('max_rank_points', 0)}) "
                 f"胜负{wins}/{losses}({wr:.0f}%) KD{kd:.2f} 掉线{p.get('abandon', 0)}"
             )
     return out
@@ -88,4 +115,8 @@ def format_full_stats(player_id: str, data: dict[str, Any], top_n: int = TOP_N)
 
     if not board_lines and not operators:
         return f"🎯 {handle}：没有查询到数据"
+
+    label = fetched_label(data)
+    if label:
+        lines.append(label)
     return "\n".join(lines)

{nonebot_plugin_r6states-1.0.0 → nonebot_plugin_r6states-1.1.1}/src/nonebot_plugin_R6States/r6data.py

@@ -1,11 +1,6 @@
 """
-r6data.py — Python 移植版 r6-data.js (Players + Game)
+对 https://api.r6data.com/api 的封装，从官方 npm 包 `r6-data.js` 移植修改而来。
 
-对 https://api.r6data.com/api 的薄封装,异步 (httpx)。从官方 npm 包
-`r6-data.js` 移植而来;源码层逻辑长期稳定,只有下面 ``易变常量`` 区域会
-随赛季/平台调整,跟新版时基本只动那几行。
-
-依赖:  pip install httpx
 用法:
     from .r6data import R6Client
 
@@ -13,31 +8,12 @@ r6data.py — Python 移植版 r6-data.js (Players + Game)
     info = await r6.players.get_account_info("PlayerName", "uplay")
     ops  = await r6.game.get_operators(side="attacker")
     await r6.aclose()
-
-NoneBot 启动时检查版本(贴进插件 __init__.py):
-    from nonebot import get_driver, logger
-    from .r6data import check_latest_version, BASED_ON_VERSION
-
-    @get_driver().on_startup
-    async def _r6_version_check():
-        latest = await check_latest_version()
-        if latest and latest != BASED_ON_VERSION:
-            logger.warning(
-                f"r6data 移植基于 r6-data.js@{BASED_ON_VERSION}, "
-                f"上游最新为 {latest},建议核对是否有接口变化。"
-            )
 """
 
 from __future__ import annotations
-
 from typing import Any, Optional, Sequence, Mapping
-
 import httpx
 
-# ──────────────────────────────────────────────────────────────────────────
-# 易变常量 —— 跟随上游版本时,基本只需要改这一段
-# ──────────────────────────────────────────────────────────────────────────
-
 #: 本移植对标的 r6-data.js 版本。启动时与 npm 最新版比对。
 BASED_ON_VERSION = "3.1.7"
 

{nonebot_plugin_r6states-1.0.0 → nonebot_plugin_r6states-1.1.1}/src/nonebot_plugin_R6States/renderer.py

@@ -1,10 +1,3 @@
-"""把 fullStats 渲染成图片（PNG 字节）。
-
-- 双字体：拉丁/数字用 Mona Sans，汉字用 Noto Sans CJK，按字符分段、基线对齐。
-- 2x 超采样：按 SCALE 倍分辨率绘制，避免客户端放大时发虚。
-- 干员区为对齐表格，数字右对齐；攻/防用不同颜色。
-内容提取复用 formatter 的 _format_boards（档案行）；干员直接读结构化字段以便排版。
-"""
 from __future__ import annotations
 
 from io import BytesIO
@@ -13,7 +6,7 @@ from pathlib import Path
 
 from PIL import Image, ImageDraw, ImageFont
 
-from .formatter import _format_boards
+from .formatter import _format_boards, fetched_label
 
 _ASSETS = Path(__file__).parent / "assets"
 _MONA = str(_ASSETS / "MonaSans.ttf")
@@ -33,12 +26,12 @@ _DEF = (94, 160, 232)   # 防
 _SCALE = 2              # 超采样倍率
 _W = 760 * _SCALE
 _PAD = 36 * _SCALE
+_PER_SIDE = 4           # 攻/防各展示几个干员
 
 _font_cache: dict[tuple[str, int, Optional[int]], ImageFont.FreeTypeFont] = {}
 
 
 def _font(path: str, size: int, weight: Optional[int] = None) -> ImageFont.FreeTypeFont:
-    """按字号取字体；weight 给定时尝试调可变字重（失败则忽略）。"""
     key = (path, size * _SCALE, weight)
     if key in _font_cache:
         return _font_cache[key]
@@ -100,7 +93,7 @@ def _ascent(size: int) -> int:
     return _font(_NOTO, size).getmetrics()[0]
 
 
-def render_full_stats(player_id: str, data: dict[str, Any], top_n: int = 8) -> bytes:
+def render_full_stats(player_id: str, data: dict[str, Any]) -> bytes:
     info = data.get("data") or {}
     handle = (info.get("platformInfo") or {}).get("platformUserHandle") or player_id
     meta = info.get("metadata") or {}
@@ -149,18 +142,18 @@ def render_full_stats(player_id: str, data: dict[str, Any], top_n: int = 8) -> b
         section("干员 Top")
         by_rounds = lambda o: o.get("roundsPlayed", 0)  # noqa: E731
         atks = sorted((o for o in operators if o.get("side") == "Attacker"),
-                      key=by_rounds, reverse=True)[:4]
+                      key=by_rounds, reverse=True)[:_PER_SIDE]
         defs = sorted((o for o in operators if o.get("side") == "Defender"),
-                      key=by_rounds, reverse=True)[:4]
+                      key=by_rounds, reverse=True)[:_PER_SIDE]
 
         gap = 48 * _SCALE
         col_w = (_W - 2 * _PAD - gap) // 2
         lx, rx = p, p + col_w + gap
 
-        # 列头：攻 / 防
+        # 列头
         y += _ascent(19)
-        _draw(draw, lx, y, "攻", 19, _ATK, weight=700)
-        _draw(draw, rx, y, "防", 19, _DEF, weight=700)
+        _draw(draw, lx, y, "进攻方", 19, _ATK, weight=700)
+        _draw(draw, rx, y, "防守方", 19, _DEF, weight=700)
         y += _font(_NOTO, 19).getmetrics()[1] + 12 * _SCALE
 
         def _cell(cx: int, base: int, op: dict[str, Any]) -> None:
@@ -195,6 +188,13 @@ def render_full_stats(player_id: str, data: dict[str, Any], top_n: int = 8) -> b
         _draw(draw, p, y, "没有查询到数据", 22, _GRAY)
         y += _font(_NOTO, 22).getmetrics()[1]
 
+    # 底部：数据实际取回时间（右下角，小字）
+    label = fetched_label(data)
+    if label:
+        y += 14 * _SCALE + _ascent(14)
+        _draw_right(draw, rcol, y, label, 14, _DIM)
+        y += _font(_NOTO, 14).getmetrics()[1]
+
     img = img.crop((0, 0, _W, y + _PAD))
     buf = BytesIO()
     img.save(buf, format="PNG")

{nonebot_plugin_r6states-1.0.0 → nonebot_plugin_r6states-1.1.1}/src/nonebot_plugin_R6States/service.py

@@ -1,20 +1,21 @@
 """数据源（API 为主）+ 缓存层。
 
-对外只暴露 ``get_operator_stats``：先查本地缓存，未命中再打 r6data API，
+对外暴露 ``get_full_stats``：先查本地缓存，未命中再打 r6data 的 fullStats，
 成功后回写缓存。错误统一转成 ``ServiceError``，由指令层决定怎么回话。
+复用一个进程级共享的 httpx 客户端（连接池复用），指令层须在 on_shutdown 调 ``aclose``。
 """
 from __future__ import annotations
 
-from typing import Any
+import time
+from typing import Any, Optional
+
+import httpx
 
 from .cache import JSONCache
 from .storage import PLAYER_CACHE_FILE
 from .r6data import R6Client, R6APIError
 from .config_mannger import resolve_apikey
 
-#: 玩家快照属于会变的数据，缓存 30 分钟即可显著降低 API 用量。
-FULL_STATS_TTL = 30 * 60
-
 VALID_PLATFORMS = ("uplay", "psn", "xbl")
 
 #: 免费申请 api-key 的入口，附在缺/失效提示里
@@ -22,6 +23,24 @@ APIKEY_HELP = "可在 https://r6data.com/ 免费获取 Key，再用 /r6key <key>
 
 _cache = JSONCache(PLAYER_CACHE_FILE)
 
+#: 进程级共享 httpx 客户端，注入给每个 R6Client，避免每次查询重建连接池/握手。
+_http: Optional[httpx.AsyncClient] = None
+
+
+def _client() -> httpx.AsyncClient:
+    global _http
+    if _http is None or _http.is_closed:
+        _http = httpx.AsyncClient(timeout=15.0)
+    return _http
+
+
+async def aclose() -> None:
+    """关闭共享 httpx 客户端（在 nonebot on_shutdown 调用）。"""
+    global _http
+    if _http is not None and not _http.is_closed:
+        await _http.aclose()
+    _http = None
+
 
 class ServiceError(Exception):
     def __init__(self, message: str, *, expired: bool = False) -> None:
@@ -36,6 +55,8 @@ async def get_full_stats(
     platform: str = "uplay",
     season_year: str | None = None,
     modes: str | None = None,
+    *,
+    ttl: float,
 ) -> dict[str, Any]:
     if platform not in VALID_PLATFORMS:
         raise ServiceError(f"平台无效，可选：{', '.join(VALID_PLATFORMS)}")
@@ -45,15 +66,15 @@ async def get_full_stats(
         raise ServiceError(f"未设置 API Key。{APIKEY_HELP}")
 
     cache_key = f"fullStats:{platform}:{season_year or 'all'}:{modes or 'all'}:{player_id.lower()}"
-    cached = await _cache.get(cache_key, ttl=FULL_STATS_TTL)
+    cached = await _cache.get(cache_key)
     if cached is not None:
         return cached
 
     try:
-        async with R6Client(api_key=api_key) as r6:
-            data = await r6.players.get_full_stats(
-                player_id, platform, season_year=season_year, modes=modes
-            )
+        r6 = R6Client(api_key=api_key, client=_client())
+        data = await r6.players.get_full_stats(
+            player_id, platform, season_year=season_year, modes=modes
+        )
     except R6APIError as e:
         if e.status == 401:
             raise ServiceError(
@@ -64,5 +85,8 @@ async def get_full_stats(
     except Exception as e:  # noqa: BLE001 - 网络等异常统一兜底
         raise ServiceError(f"请求失败：{type(e).__name__}") from e
 
-    await _cache.set(cache_key, data)
+    # 打上实际取数时间，随数据一起缓存（缓存命中时展示的就是这个原始取数时刻）
+    if isinstance(data, dict):
+        data["_fetched_at"] = time.time()
+    await _cache.set(cache_key, data, ttl)
     return data

nonebot_plugin_r6states-1.0.0/src/nonebot_plugin_R6States/config.py

@@ -1,12 +0,0 @@
-from __future__ import annotations
-
-from pydantic import BaseModel
-
-
-class Config(BaseModel):
-    #: 当前赛季代码（如 "Y10S4"）。查询默认按此赛季过滤；填 "all" 则不过滤、查生涯。
-    #: 在 .env 里用 CURRENT_SEASON=Y10S4 覆盖；每赛季更新一次即可。
-    current_season: str = "Y11S2"
-
-    #: 查询结果是否渲染成图片（失败时自动回退文本）。.env 用 R6_OUTPUT_IMAGE=false 关闭。
-    r6_output_image: bool = True