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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nonebot-plugin-R6States
-Version: 1.1.0
+Version: 1.1.1
 Summary: 查询指定玩家的各项数据
 Author-Email: Siornya <wxh200607@outlook.com>
 License: MIT
@@ -15,53 +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_ids...>
-```
+数据查询：`/R6 <player_ids...>`
+其他指令与帮助信息：`/R6help`
 
-### 帮助信息
+## 环境配置
 
-```text
-/R6help
-```
+CURRENT_SEASON = "Y11S2"
 
-### 额外获取地图信息
+R6_OUTPUT_IMAGE = True
 
-```text
--m / --map <map_name>
-```
+R6_CACHE_MINUTES = 45
+
+## 参考运行环境
 
----
+* **Python 3.12**
+* **NoneBot2**
+* **OneBot v11**
+* **NapCat（反向 WebSocket）**
 
 ## 特别提醒
 

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

@@ -2,53 +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_ids...>
-```
+数据查询：`/R6 <player_ids...>`
+其他指令与帮助信息：`/R6help`
 
-### 帮助信息
+## 环境配置
 
-```text
-/R6help
-```
+CURRENT_SEASON = "Y11S2"
 
-### 额外获取地图信息
+R6_OUTPUT_IMAGE = True
 
-```text
--m / --map <map_name>
-```
+R6_CACHE_MINUTES = 45
+
+## 参考运行环境
 
----
+* **Python 3.12**
+* **NoneBot2**
+* **OneBot v11**
+* **NapCat（反向 WebSocket）**
 
 ## 特别提醒
 

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

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

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

@@ -104,9 +104,13 @@ async def _(event: MessageEvent, args: Message = CommandArg()):
         await r6.send(f"⚠️ 当前 API Key 已设置 {age:.0f} 天，可能已过期，如查询失败请 /r6key 重设")
 
     # 并发取数（单个失败不连累其余），再按原顺序逐个发送
+    ttl = plugin_config.r6_cache_minutes * 60
     results = await asyncio.gather(
         *(
-            get_full_stats(pid, scopes, platform, season_year=plugin_config.current_season)
+            get_full_stats(
+                pid, scopes, platform,
+                season_year=plugin_config.current_season, ttl=ttl,
+            )
             for pid in tokens
         ),
         return_exceptions=True,

{nonebot_plugin_r6states-1.1.0 → nonebot_plugin_r6states-1.1.1}/src/nonebot_plugin_R6States/config.py

@@ -11,3 +11,7 @@ class Config(BaseModel):
     # 查询结果渲染成图片，失败时自动回退文本
     # 在 .env 用 R6_OUTPUT_IMAGE 覆盖
     r6_output_image: bool = True
+
+    # 玩家数据本地缓存时长（分钟）。越大越省 API 用量，但数据越旧。
+    # 在 .env 用 R6_CACHE_MINUTES 覆盖
+    r6_cache_minutes: int = 45

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

@@ -7,11 +7,23 @@ 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": "标准",
@@ -103,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.1.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.1.0 → nonebot_plugin_r6states-1.1.1}/src/nonebot_plugin_R6States/renderer.py

@@ -6,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")
@@ -188,6 +188,13 @@ def render_full_stats(player_id: str, data: dict[str, Any]) -> bytes:
         _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.1.0 → nonebot_plugin_r6states-1.1.1}/src/nonebot_plugin_R6States/service.py

@@ -6,6 +6,7 @@
 """
 from __future__ import annotations
 
+import time
 from typing import Any, Optional
 
 import httpx
@@ -15,9 +16,6 @@ from .storage import PLAYER_CACHE_FILE
 from .r6data import R6Client, R6APIError
 from .config_mannger import resolve_apikey
 
-#: 玩家快照属于会变的数据，缓存 45 分钟即可显著降低 API 用量。
-FULL_STATS_TTL = 45 * 60
-
 VALID_PLATFORMS = ("uplay", "psn", "xbl")
 
 #: 免费申请 api-key 的入口，附在缺/失效提示里
@@ -57,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)}")
@@ -85,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, FULL_STATS_TTL)
+    # 打上实际取数时间，随数据一起缓存（缓存命中时展示的就是这个原始取数时刻）
+    if isinstance(data, dict):
+        data["_fetched_at"] = time.time()
+    await _cache.set(cache_key, data, ttl)
     return data