nonebot-plugin-R6States 1.0.0__tar.gz

nonebot_plugin_r6states-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Siornya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nonebot_plugin_r6states-1.0.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.1
+Name: nonebot-plugin-R6States
+Version: 1.0.0
+Summary: 查询指定玩家的各项数据
+Author-Email: Siornya <wxh200607@outlook.com>
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: nonebot2>=2.3.1
+Requires-Dist: nonebot-adapter-onebot>=2.4.6
+Requires-Dist: httpx>=0.27
+Requires-Dist: pillow>=10.0
+Description-Content-Type: text/markdown
+
+# nonebot-plugin-R6States
+
+一个基于 **NoneBot2** 的《彩虹六号：围攻》战绩查询插件
+
+---
+
+## 功能特性
+
+* ✅ 通过 QQ 指令查询 R6 玩家战绩
+* ✅ 支持 **单人查询 / 多人查询**
+* ✅ 数据源自 [R6Data API](https://r6data.com/)
+* ✅ 玩家数据缓存半小时，降低 API 用量
+* ✅ 数据分析功能
+* ⚙️ 地图筛选 `-m / --map`
+
+---
+
+## 参考运行环境
+
+* **Python 3.12**
+* **NoneBot2**
+* **OneBot v11**
+* **NapCat（反向 WebSocket）**
+
+---
+
+## Usage 使用说明
+
+### 安装
+
+可以直接将 `nonebot_plugin_R6States` 文件夹放入插件目录中。
+
+### 基础指令
+
+```text
+/R6 <player_id>
+```
+
+### 多人查询
+
+```text
+/R6 -g <id1> <id2> ... <idN>
+```
+
+### 帮助信息
+
+```text
+/R6help
+```
+
+### 额外获取地图信息
+
+```text
+-m / --map <map_name>
+```
+
+---
+
+## 特别提醒
+
+* 本插件为 **非育碧官方工具**
+* 所有数据来自R6Data API
+* 设计初衷仅对于个人与学习
+* 请勿用于“超出个人正常使用范围”的用途

nonebot_plugin_r6states-1.0.0/README.md

@@ -0,0 +1,64 @@
+# nonebot-plugin-R6States
+
+一个基于 **NoneBot2** 的《彩虹六号：围攻》战绩查询插件
+
+---
+
+## 功能特性
+
+* ✅ 通过 QQ 指令查询 R6 玩家战绩
+* ✅ 支持 **单人查询 / 多人查询**
+* ✅ 数据源自 [R6Data API](https://r6data.com/)
+* ✅ 玩家数据缓存半小时，降低 API 用量
+* ✅ 数据分析功能
+* ⚙️ 地图筛选 `-m / --map`
+
+---
+
+## 参考运行环境
+
+* **Python 3.12**
+* **NoneBot2**
+* **OneBot v11**
+* **NapCat（反向 WebSocket）**
+
+---
+
+## Usage 使用说明
+
+### 安装
+
+可以直接将 `nonebot_plugin_R6States` 文件夹放入插件目录中。
+
+### 基础指令
+
+```text
+/R6 <player_id>
+```
+
+### 多人查询
+
+```text
+/R6 -g <id1> <id2> ... <idN>
+```
+
+### 帮助信息
+
+```text
+/R6help
+```
+
+### 额外获取地图信息
+
+```text
+-m / --map <map_name>
+```
+
+---
+
+## 特别提醒
+
+* 本插件为 **非育碧官方工具**
+* 所有数据来自R6Data API
+* 设计初衷仅对于个人与学习
+* 请勿用于“超出个人正常使用范围”的用途

nonebot_plugin_r6states-1.0.0/pyproject.toml

@@ -0,0 +1,102 @@
+[project]
+name = "nonebot-plugin-R6States"
+version = "1.0.0"
+description = "查询指定玩家的各项数据"
+authors = [
+    { name = "Siornya", email = "wxh200607@outlook.com" },
+]
+dependencies = [
+    "nonebot2>=2.3.1",
+    "nonebot-adapter-onebot>=2.4.6",
+    "httpx>=0.27",
+    "pillow>=10.0",
+]
+requires-python = ">=3.10"
+readme = "README.md"
+
+[project.license]
+text = "MIT"
+
+[build-system]
+requires = [
+    "pdm-backend",
+]
+build-backend = "pdm.backend"
+
+[tool.pdm]
+distribution = true
+
+[tool.pdm.build]
+includes = [
+    "src",
+]
+
+[tool.pdm.dev-dependencies]
+dev = [
+    "black>=24.4.2",
+    "isort>=5.13.2",
+    "ruff>=0.4.6",
+]
+
+[tool.pdm.scripts.format]
+composite = [
+    "isort . ",
+    "black . ",
+    "ruff check .",
+]
+
+[tool.black]
+line-length = 90
+target-version = [
+    "py39",
+    "py310",
+    "py311",
+    "py312",
+]
+include = "\\.pyi?$"
+extend-exclude = ""
+
+[tool.isort]
+profile = "black"
+line_length = 90
+length_sort = true
+skip_gitignore = true
+force_sort_within_sections = true
+extra_standard_library = [
+    "typing_extensions",
+]
+
+[tool.ruff]
+line-length = 90
+target-version = "py39"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "UP",
+    "C",
+    "T",
+    "PYI",
+    "PT",
+    "Q",
+]
+ignore = [
+    "C901",
+    "T201",
+    "E731",
+    "E402",
+]
+
+[tool.pyright]
+pythonVersion = "3.9"
+pythonPlatform = "All"
+typeCheckingMode = "basic"
+
+[tool.nonebot]
+adapters = []
+plugin_dirs = [
+    "src",
+]
+builtin_plugins = []

nonebot_plugin_r6states-1.0.0/src/nonebot_plugin_R6States/__init__.py

@@ -0,0 +1,117 @@
+from nonebot import on_command, logger
+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 .formatter import format_full_stats
+from .renderer import render_full_stats
+from .config_mannger import (
+    KEY_TTL_DAYS,
+    set_apikey,
+    resolve_apikey,
+    get_apikey_age_days,
+)
+
+__plugin_meta__ = PluginMetadata(
+    name="彩六数据查询",
+    description="查询指定玩家的数据",
+    usage="/r6 <id> [平台]　/r6key <key>　/r6help",
+    homepage="https://github.com/Siornya/nonebot-plugin-R6States",
+    type="application",
+    config=Config,
+    supported_adapters={"~onebot.v11"},
+)
+
+plugin_config = get_plugin_config(Config)
+
+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"
+    "/r6key <key>      设置本群/本人的 r6data API Key\n"
+    "/r6help           显示本帮助\n"
+    "Key 可在 https://r6data.com/ 免费获取；优先用你的个人 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)]
+
+
+@r6_help.handle()
+async def _():
+    await r6_help.finish(HELP_TEXT)
+
+
+@r6_key.handle()
+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"
+            "没有的话可在 https://r6data.com/ 免费获取"
+        )
+
+    scope = _scope_id(event)
+    set_apikey(scope, key)
+    where = "本群" if isinstance(event, GroupMessageEvent) else "个人"
+    await r6_key.finish(f"✅ 已设置{where} API Key（官方有效期约 {KEY_TTL_DAYS} 天）")
+
+
+@r6.handle()
+async def _(event: MessageEvent, args: Message = CommandArg()):
+    tokens = args.extract_plain_text().split()
+    if not tokens:
+        await r6.finish("用法：/r6 <id> [平台]，详见 /r6help")
+
+    # 末尾 token 若是平台名则作为平台，其余都当作玩家 id。
+    platform = "uplay"
+    if len(tokens) > 1 and tokens[-1].lower() in VALID_PLATFORMS:
+        platform = tokens[-1].lower()
+        tokens = tokens[:-1]
+
+    if len(tokens) > 5:
+        await r6.finish("一次最多查询 5 个 id")
+
+    scopes = _lookup_scopes(event)
+
+    # key 临近过期的轻提醒（针对实际命中的那个 key，不阻断查询）。
+    _, matched = resolve_apikey(scopes)
+    age = get_apikey_age_days(matched) if matched else None
+    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
+            )
+            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}")
+            await r6.send(f"❌ {player_id}：查询失败")

nonebot_plugin_r6states-1.0.0/src/nonebot_plugin_R6States/cache.py

@@ -0,0 +1,63 @@
+"""轻量本地缓存：单 JSON 文件 + 每条目独立 TTL + 异步锁 + 原子写。
+
+设计动机（对比旧的 players.yaml）：
+- 旧实现按**整文件** mtime 判 TTL，一次写入会重置所有条目的有效期，过期还整包丢弃。
+- 这里每条目自带写入时间戳，**各自过期**；TTL 由调用方按 endpoint 指定。
+- 写入走 "临时文件 + os.replace" 原子替换，配异步锁，避免并发下半写/相互覆盖。
+"""
+from __future__ import annotations
+
+import os
+import json
+import time
+import asyncio
+import tempfile
+from typing import Any, Optional
+from pathlib import Path
+
+
+class JSONCache:
+    def __init__(self, path: Path) -> None:
+        self._path = path
+        self._lock = asyncio.Lock()
+
+    def _load(self) -> dict[str, dict[str, Any]]:
+        if not self._path.exists():
+            return {}
+        try:
+            with self._path.open("r", encoding="utf-8") as f:
+                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:
+        self._path.parent.mkdir(parents=True, exist_ok=True)
+        fd, tmp = tempfile.mkstemp(dir=str(self._path.parent), suffix=".tmp")
+        try:
+            with os.fdopen(fd, "w", encoding="utf-8") as f:
+                json.dump(data, f, ensure_ascii=False, separators=(",", ":"))
+            os.replace(tmp, self._path)
+        except BaseException:
+            try:
+                os.unlink(tmp)
+            except OSError:
+                pass
+            raise
+
+    async def get(self, key: str, ttl: float) -> Optional[Any]:
+        """命中且未超过 ttl（秒）则返回缓存值，否则返回 None。"""
+        async with self._lock:
+            entry = self._load().get(key)
+        if not entry:
+            return None
+        if time.time() - entry.get("ts", 0) > ttl:
+            return None
+        return entry.get("value")
+
+    async def set(self, key: str, value: Any) -> None:
+        async with self._lock:
+            data = self._load()
+            data[key] = {"ts": time.time(), "value": value}
+            self._atomic_write(data)

nonebot_plugin_r6states-1.0.0/src/nonebot_plugin_R6States/config.py

@@ -0,0 +1,12 @@
+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

nonebot_plugin_r6states-1.0.0/src/nonebot_plugin_R6States/config_mannger.py

@@ -0,0 +1,72 @@
+"""按群/按人管理 r6data api-key。
+
+落盘格式（带设置时间戳，用于过期提醒；key 官方有效期约 1 个月）::
+
+    {"apikeys": {"<id>": {"key": "...", "set_at": 1712345678.0}}}
+"""
+from __future__ import annotations
+
+import json
+import time
+from typing import Any, Optional
+
+from .storage import API_KEY_FILE
+
+#: 官方 key 有效期约 30 天，超过这个天数就在查询时给个提醒。
+KEY_TTL_DAYS = 30
+
+
+def load_config() -> dict[str, Any]:
+    if not API_KEY_FILE.exists():
+        return {"apikeys": {}}
+    try:
+        with API_KEY_FILE.open("r", encoding="utf-8") as f:
+            data = json.load(f)
+    except (json.JSONDecodeError, OSError):
+        return {"apikeys": {}}
+    data.setdefault("apikeys", {})
+    return data
+
+
+def save_config(data: dict[str, Any]) -> None:
+    API_KEY_FILE.parent.mkdir(parents=True, exist_ok=True)
+    with API_KEY_FILE.open("w", encoding="utf-8") as f:
+        json.dump(data, f, ensure_ascii=False, indent=2)
+
+
+def set_apikey(target_id: str, key: str) -> None:
+    data = load_config()
+    data["apikeys"][target_id] = {"key": key, "set_at": time.time()}
+    save_config(data)
+
+
+def _entry(target_id: str) -> Optional[dict[str, Any]]:
+    raw = load_config()["apikeys"].get(target_id)
+    if raw is None:
+        return None
+    return raw
+
+
+def get_apikey(target_id: str) -> Optional[str]:
+    entry = _entry(target_id)
+    return entry["key"] if entry else None
+
+
+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:
+            return key, scope
+    return None, None
+
+
+def get_apikey_age_days(target_id: str) -> Optional[float]:
+    """key 已设置的天数；旧格式/未设置返回 None。"""
+    entry = _entry(target_id)
+    if not entry:
+        return None
+    return (time.time() - entry["set_at"]) / 86400

nonebot_plugin_r6states-1.0.0/src/nonebot_plugin_R6States/formatter.py

@@ -0,0 +1,91 @@
+"""把 fullStats 返回格式化成可发送文本。
+
+fullStats 顶层有三块：
+- ``operators``：干员明细（operator/side/roundsPlayed/winPercent/kd/headshotPercent...）
+- ``platform_families_full_profiles``：各 board(ranked/casual/...)的完整档案
+- ``data``：tracker 风格的 platformInfo / metadata(等级、通行证) / segments
+"""
+from __future__ import annotations
+
+from typing import Any
+
+#: 默认展示出场最多的前 N 个干员
+TOP_N = 8
+
+_SIDE_CN = {"Attacker": "攻", "Defender": "防"}
+_BOARD_CN = {
+    "ranked": "排位", "casual": "休闲", "standard": "标准",
+    "event": "活动", "warmup": "热身",
+}
+
+
+def _format_boards(profiles: list[dict[str, Any]]) -> list[str]:
+    """各 board 取最新赛季档案，输出概览行。"""
+    out: list[str] = []
+    for fam in profiles:
+        for board in fam.get("board_ids_full_profiles") or []:
+            fps = board.get("full_profiles") or []
+            if not fps:
+                continue
+            fp = max(fps, key=lambda f: f.get("season_id", 0))
+            p = fp.get("profile") or {}
+            wins, losses = p.get("wins", 0), p.get("losses", 0)
+            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", "?"))
+            out.append(
+                f"{name} RP{p.get('rank_points', 0)}(峰{p.get('max_rank_points', 0)}) "
+                f"胜负{wins}/{losses}({wr:.0f}%) KD{kd:.2f} 掉线{p.get('abandon', 0)}"
+            )
+    return out
+
+
+def _format_operators(operators: list[dict[str, Any]], top_n: int) -> list[str]:
+    ranked = sorted(operators, key=lambda o: o.get("roundsPlayed", 0), reverse=True)
+    out: list[str] = []
+    for op in ranked[:top_n]:
+        side = _SIDE_CN.get(op.get("side", ""), op.get("side", "?"))
+        out.append(
+            f"{op.get('operator', '?')}({side}) "
+            f"场{op.get('roundsPlayed', 0)} "
+            f"胜{op.get('winPercent', 0)}% "
+            f"KD{op.get('kd', 0)}"
+        )
+    # 聚合：用总量重算，避免对各干员百分比做无权平均
+    kills = sum(o.get("kills", 0) for o in operators)
+    deaths = sum(o.get("deaths", 0) for o in operators)
+    rounds = sum(o.get("roundsPlayed", 0) for o in operators)
+    kd = kills / deaths if deaths else float(kills)
+    out.append(f"— 合计 {len(operators)} 干员 场{rounds} KD{kd:.2f}")
+    return out
+
+
+def format_full_stats(player_id: str, data: dict[str, Any], top_n: int = TOP_N) -> str:
+    info = data.get("data") or {}
+    handle = (info.get("platformInfo") or {}).get("platformUserHandle") or player_id
+    meta = info.get("metadata") or {}
+
+    lines = [f"🎯 {handle} 数据快照"]
+
+    head_bits = []
+    if meta.get("clearanceLevel") is not None:
+        head_bits.append(f"等级{meta['clearanceLevel']}")
+    if meta.get("battlepassLevel") is not None:
+        head_bits.append(f"通行证{meta['battlepassLevel']}")
+    if head_bits:
+        lines.append("　".join(head_bits))
+
+    board_lines = _format_boards(data.get("platform_families_full_profiles") or [])
+    if board_lines:
+        lines.append("— 档案 —")
+        lines.extend(board_lines)
+
+    operators = data.get("operators") or []
+    if operators:
+        lines.append("— 干员 Top —")
+        lines.extend(_format_operators(operators, top_n))
+
+    if not board_lines and not operators:
+        return f"🎯 {handle}：没有查询到数据"
+    return "\n".join(lines)