From 2144e218ec3c8f8dad1fad7630d4118f9eb369ec Mon Sep 17 00:00:00 2001 From: itxiaohui <177289791+itxiaohui66@users.noreply.github.com> Date: Mon, 5 Oct 2026 12:22:51 +0800 Subject: [PATCH] Release xiaohuicat MOTD plugin with 24-hour player history --- .gitignore | 11 + LICENSE | 21 ++ README.md | 103 +++++++++ __init__.py | 1 + _conf_schema.json | 12 + assets/motd-preview.png | Bin 0 -> 113047 bytes main.py | 178 ++++++++++++++ metadata.yaml | 11 + pyproject.toml | 15 ++ requirements-dev.txt | 4 + requirements.txt | 3 + services/__init__.py | 1 + services/address.py | 31 +++ services/mc_api.py | 313 +++++++++++++++++++++++++ services/monitor.py | 78 +++++++ services/motd_card.py | 422 ++++++++++++++++++++++++++++++++++ services/storage.py | 128 +++++++++++ tests/test_api.py | 157 +++++++++++++ tests/test_plugin.py | 148 ++++++++++++ tests/test_render_address.py | 79 +++++++ tests/test_storage_monitor.py | 101 ++++++++ tools/package.py | 35 +++ tools/preview.py | 52 +++++ 23 files changed, 1904 insertions(+) create mode 100644 .gitignore create mode 100644 LICENSE create mode 100644 README.md create mode 100644 __init__.py create mode 100644 _conf_schema.json create mode 100644 assets/motd-preview.png create mode 100644 main.py create mode 100644 metadata.yaml create mode 100644 pyproject.toml create mode 100644 requirements-dev.txt create mode 100644 requirements.txt create mode 100644 services/__init__.py create mode 100644 services/address.py create mode 100644 services/mc_api.py create mode 100644 services/monitor.py create mode 100644 services/motd_card.py create mode 100644 services/storage.py create mode 100644 tests/test_api.py create mode 100644 tests/test_plugin.py create mode 100644 tests/test_render_address.py create mode 100644 tests/test_storage_monitor.py create mode 100644 tools/package.py create mode 100644 tools/preview.py diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..20816c3 --- /dev/null +++ b/.gitignore @@ -0,0 +1,11 @@ +__pycache__/ +*.py[cod] +.pytest_cache/ +.ruff_cache/ +.venv/ +.dev/ +dist/ +data/ +*.db +*.db-wal +*.db-shm diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..05b296d --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 itxiaohui + +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. diff --git a/README.md b/README.md new file mode 100644 index 0000000..373a6f1 --- /dev/null +++ b/README.md @@ -0,0 +1,103 @@ +# Minecraft MOTD 与玩家波动(AstrBot) + +Minecraft Java 服务器状态查询插件,适用于 AstrBot 的 QQ 官方机器人(WebSocket / Webhook)与 OneBot。保留 xiaohuicat 原机器人项目的全部 MOTD 功能,新增最近 24 小时玩家人数波动图。默认卡片署名为 `xiaohuicat`。 + +![状态卡与 24 小时玩家波动图(演示数据)](assets/motd-preview.png) + +## 保留的功能 + +- `/motd`、`/mc`、`/mcstatus` 三个命令入口;群默认服务器查询与临时地址查询。 +- 机器人管理员设置/清除群默认服务器,支持 `set / 设置`、`unset / clear / 清除 / 取消`。设置成功后立即查询。 +- 查询在线/离线、版本、MOTD、在线/上限人数、人数进度条、公开玩家样本、服务器图标。没有图标时显示像素苦力怕。 +- Minecraft 状态握手和 ping/pong 测得的真实 RTT;保留域名 SRV 解析与显式端口。 +- 保留原像素风图片;图片渲染或上传失败时回复文字,包含人数历史摘要。 +- 原查询 API 地址、超时可配置;备用 API 返回的主机名、服务端软件和插件数量仍可显示。 + +## 新增 24 小时图表 + +每张状态卡下方显示滚动 24 小时人数曲线,以及采样最低/最高/平均人数。`/motd history` 或 `/motd 波动` 可以直接请求带曲线的卡片,也可附带地址。 + +默认每 300 秒采样,优先直连 Minecraft Java 状态协议,避免公开 API 缓存影响人数变化。直连失败时使用旧项目的 mcsrvstat.us API;图中会标注 API 样本可能有缓存。服务器不公开玩家名字时仍可记录总人数。直连成功时,软件、插件数量等额外信息仍从原 API 补充(缓存 1 小时),但不会覆盖直连的人数和 Ping;API 补充的玩家名单会注明缓存样本。 + +群绑定的服务器持续采样;临时查询的地址从最近一次手动查询起自动跟踪 24 小时(最多跟踪最近 128 个临时地址)。多群绑定同一地址只采样一次。配置 `monitor_servers` 可添加永久跟踪地址。清除群绑定后,之前临时跟踪的剩余时间内仍可能采样;若别的群仍有绑定,会继续采样。 + +**首次使用不会补造过去的记录。** 首次只有一个点,持续运行后逐渐形成曲线;完整的 24 小时图需要运行采集 24 小时。停机、查询失败和离线均断开曲线,离线用红色标记、失败用黄色标记,在线 0 人会正常显示 0。时间以 UTC+8 显示。平均值是成功的人数采样平均值,不是按时间加权的全天均值。 + +数据库在 AstrBot 的 `data/plugin_data/astrbot_plugin_motd/motd.db` 中,默认保留 48 小时,重载和重启后保留。后台只采集数据,用户发命令时才回复卡片。停用/卸载会取消后台任务。 + +## 安装 + +需要 Python 3.10+、AstrBot 4.16+(5.x 尚未验证)。按 [AstrBot 插件开发指南](https://docs.astrbot.app/dev/star/plugin-new.html) 的插件目录结构安装。 + +### 文件夹安装 + +将插件的整个目录复制到 **AstrBot 根目录** 的 `data/plugins/astrbot_plugin_motd/`,确认 `main.py`、`metadata.yaml`、`_conf_schema.json`、`services/` 位于同一层。在 AstrBot 使用的 Python 环境执行: + +```bash +python -m pip install -r data/plugins/astrbot_plugin_motd/requirements.txt +``` + +随后在 AstrBot WebUI 重启/重载插件。也可从 [Releases](https://github.com/itxiaohui66/astrbot_plugin_motd/releases) 下载插件 ZIP,在支持本地 ZIP 安装的插件管理页面导入。 + +### 从 GitHub 安装 + +在 AstrBot WebUI 的插件管理中选择通过链接安装,填写: + +```text +https://github.com/itxiaohui66/astrbot_plugin_motd +``` + +### QQ 官方机器人 + +1. 按 [AstrBot QQ 官方平台接入文档](https://docs.astrbot.app/platform/qqofficial.html) 接入机器人。 +2. 使用 AstrBot 的 `/sid` 获取平台 ID,按 [内置命令文档](https://docs.astrbot.app/use/command.html) 在 WebUI 设置管理员,或填入本插件的 `admin_ids`。 +3. 群内 @机器人发送 `/motd set 你的服务器地址`。 +4. 群内 @机器人发送 `/motd` 或 `/motd history`。 + +插件使用 AstrBot 通用本地图片消息,由 QQ 适配器负责上传,无需 OneBot 的 `base64://` 消息。旧项目中的数字 QQ 群号与官方机器人的 group openid 不同,因此**需要在新机器人所在群重新绑定默认服务器**。管理员也应使用官方平台 ID,不能直接复制旧数字 QQ 号。 + +指令前缀遵循 AstrBot 的唤醒配置,默认使用 `/`。官方机器人实际接收范围、图片发送权限与平台审核以你的 QQ 机器人配置为准。 + +### 中文字体 + +Windows 自动使用系统微软雅黑。Linux / Docker 建议在 AstrBot 运行环境安装 `fonts-noto-cjk`,或将中文字体放到容器可读位置,并在 `font_path` 填写绝对路径。没有中文字体时卡片可能显示方框。 + +## 指令 + +| 指令 | 功能 | +| --- | --- | +| `/motd` | 查询本群默认服务器,并显示波动图 | +| `/motd mc.example.com` | 临时查询,不改变群默认设置 | +| `/motd mc.example.com:25565` | 指定端口查询 | +| `/motd set mc.example.com` | 管理员设置本群服务器并立即查询 | +| `/motd unset` | 管理员清除本群服务器 | +| `/motd history` | 默认服务器的状态与 24 小时波动 | +| `/motd history mc.example.com` | 指定服务器的状态与波动 | +| `/motd help` | 帮助 | + +私聊可以临时查询地址;默认服务器设置/清除在群聊中使用。当前查询 Minecraft **Java 版**,保持旧项目的查询范围。 + +## 配置 + +在 WebUI 插件配置中调整:`bot_name`、`admin_ids`、`api_url`、`request_timeout`、`ping_timeout`、`history_enabled`、`sample_interval`、`retention_hours`、`monitor_servers`、`font_path`。后台采样参数修改后重载插件。 + +## 本地验证与打包 + +```bash +python -m pip install -r requirements-dev.txt +python -m pytest +python -m ruff check . +python -m ruff format --check . +python tools/preview.py +python tools/package.py +``` + +自动测试覆盖实际 Minecraft 协议模拟、直连/API 切换、群设置隔离与管理员权限、后台采样、持久化、失败断线和图片降级。最终的官方 QQ 收发仍需在你实际运行的 AstrBot 和机器人账号中联调。 + +## 来源 + +命令行为、原 Minecraft API 服务、像素卡片基础移植自 itxiaohui 的原机器人项目 `liziqqbotpy`,对应模块为 `plugins/mc_motd.py`、`services/mc_api.py`、`services/motd_card.py`。保留 `itxiaohui` 技术支持署名。插件入口和消息发送依据 [AstrBot 官方开发文档](https://docs.astrbot.app/dev/star/plugin-new.html) 重写;直连查询使用 [mcstatus](https://github.com/py-mine/mcstatus)。 + +## 许可证 + +本项目以 [MIT 许可证](LICENSE) 开源。 diff --git a/__init__.py b/__init__.py new file mode 100644 index 0000000..af3366d --- /dev/null +++ b/__init__.py @@ -0,0 +1 @@ +"""AstrBot Minecraft MOTD plugin package.""" diff --git a/_conf_schema.json b/_conf_schema.json new file mode 100644 index 0000000..5896efc --- /dev/null +++ b/_conf_schema.json @@ -0,0 +1,12 @@ +{ + "bot_name": {"description": "状态卡署名", "type": "string", "default": "xiaohuicat"}, + "admin_ids": {"description": "额外机器人管理员 ID", "type": "list", "default": [], "hint": "AstrBot 管理员自动拥有权限。QQ 官方机器人请填写平台用户 ID/openid,可通过 /sid 查看,不要填写旧机器人的数字 QQ 号。"}, + "api_url": {"description": "备用查询 API", "type": "string", "default": "https://api.mcsrvstat.us/2/{address}", "hint": "直连失败时使用,保留 {address} 占位符。响应应为 mcsrvstat.us 格式。"}, + "request_timeout": {"description": "备用 API 超时(秒)", "type": "float", "default": 10.0}, + "ping_timeout": {"description": "Minecraft 直连超时(秒)", "type": "float", "default": 4.0}, + "history_enabled": {"description": "启用后台人数采样", "type": "bool", "default": true, "hint": "关闭时只记录手动查询;已有历史保留。修改后重载插件。"}, + "sample_interval": {"description": "后台采样间隔(秒)", "type": "int", "default": 300, "hint": "默认 5 分钟,最低 60 秒。绑定的服务器会持续采样,临时查询的服务器会跟踪 24 小时。"}, + "retention_hours": {"description": "历史保留时长(小时)", "type": "int", "default": 48, "hint": "最低 24 小时,图表固定显示最近 24 小时。"}, + "monitor_servers": {"description": "额外持续采样服务器", "type": "list", "default": [], "hint": "域名或 IP,可附带端口。这些服务器无需在群内绑定也会持续采样。"}, + "font_path": {"description": "自定义中文字体文件绝对路径", "type": "string", "default": "", "hint": "留空自动查找 Noto Sans CJK、文泉驿或 Windows 微软雅黑。Linux 建议安装 fonts-noto-cjk,路径须在 AstrBot 运行环境内可读。"} +} diff --git a/assets/motd-preview.png b/assets/motd-preview.png new file mode 100644 index 0000000000000000000000000000000000000000..4d900712b21261269a0ddebc60e65d1f7c0494c6 GIT binary patch literal 113047 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 z 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≻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

c_Gf=+5@xBjz8ZjK~SXfzGWxAo|2Hhm+ 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 Lsh2rInxFm$hY+6E literal 0 HcmV?d00001 diff --git a/main.py b/main.py new file mode 100644 index 0000000..e24d16b --- /dev/null +++ b/main.py @@ -0,0 +1,178 @@ +"""AstrBot MOTD plugin, using platform-neutral messages for official QQ bots.""" + +import asyncio +import contextlib +import json +import time +import uuid + +from astrbot.api import AstrBotConfig, logger +from astrbot.api.event import AstrMessageEvent, filter +from astrbot.api.star import Context, Star, StarTools + +from .services.address import normalize_address +from .services.mc_api import MinecraftServerAPI +from .services.monitor import PlayerMonitor +from .services.motd_card import render_motd_card +from .services.storage import MotdStore + +HELP = """Minecraft MOTD 查询 +/motd 查询本群默认服务器 +/motd 服务器地址 临时查询(不改变默认设置) +/motd set 服务器地址 设置本群服务器(机器人管理员) +/motd unset 清除本群设置(机器人管理员) +/motd history [服务器地址] 查看最近 24 小时玩家波动 +/motd help 查看帮助 +别名:/mc、/mcstatus;设置、清除、取消、波动、趋势也可使用。 +服务器地址示例:mc.example.com 或 mc.example.com:25565 +每张状态卡自带 24 小时波动图;首次使用从当前时刻开始积累。""" + + +class MotdPlugin(Star): + def __init__(self, context: Context, config: AstrBotConfig): + super().__init__(context) + self.config = config + self.data_dir = StarTools.get_data_dir("astrbot_plugin_motd") + self.store = MotdStore(self.data_dir / "motd.db") + self.api = MinecraftServerAPI(config) + self._ready = False + self._init_lock = asyncio.Lock() + self.monitor = PlayerMonitor( + self.api, + self.store, + interval=max(60, int(config.get("sample_interval", 300))), + retention_hours=max(24, int(config.get("retention_hours", 48))), + enabled=bool(config.get("history_enabled", True)), + addresses=[ + normalize_address(a) for a in config.get("monitor_servers", []) if a.strip() + ], + ) + + async def initialize(self): + async with self._init_lock: + if self._ready: + return + await self.store.initialize() + self.monitor.start() + self._ready = True + + @staticmethod + def _scope(event: AstrMessageEvent) -> str: + # Official QQ uses group openids, which differ from old OneBot numeric group IDs. + # Include the adapter instance to prevent collisions between bots/platforms. + group = event.get_group_id() + if group: + return json.dumps([event.get_platform_id(), "group", group], ensure_ascii=False) + return event.unified_msg_origin + + def _is_admin(self, event): + return event.is_admin() or str(event.get_sender_id()) in { + str(value) for value in self.config.get("admin_ids", []) + } + + @filter.command("motd", alias={"mc", "mcstatus"}) + async def motd(self, event: AstrMessageEvent, action: str = "", address: str = ""): + """查询 Minecraft 状态、设置群默认服务器,以及查看 24 小时玩家波动图。""" + try: + await self.initialize() + await self._handle(event, action, address) + except ValueError as exc: + await event.send(event.plain_result(f"❌ {exc}")) + except Exception: + logger.exception("MOTD 插件处理失败") + await event.send( + event.plain_result("❌ MOTD 处理失败,请稍后重试或查看 AstrBot 日志。") + ) + finally: + event.stop_event() + + async def _handle(self, event, action, address): + action = action.strip() + verb = action.lower() + scope = self._scope(event) + if verb in {"help", "帮助"}: + await event.send(event.plain_result(HELP)) + return + if verb in {"set", "设置", "unset", "clear", "清除", "取消"}: + if not self._is_admin(event): + await event.send( + event.plain_result("❌ 只有机器人管理员可以设置或清除本群 MOTD 服务器。") + ) + return + if not event.get_group_id(): + await event.send( + event.plain_result( + "⚠️ 请在群内设置或清除默认服务器;私聊可使用 /motd 服务器地址。" + ) + ) + return + if verb in {"set", "设置"}: + if not address: + raise ValueError("格式: /motd set 服务器地址") + address = normalize_address(address) + await self.store.set_binding(scope, address, event.get_sender_id()) + await event.send(event.plain_result(f"✅ 已将本群 MOTD 服务器设为: {address}")) + await self._query_and_send(event, address) + else: + if address: + raise ValueError("格式: /motd unset") + await self.store.clear_binding(scope) + await event.send(event.plain_result("✅ 已清除本群 MOTD 服务器设置。")) + return + if verb in {"history", "chart", "波动", "趋势", "历史"}: + target = address or await self.store.get_binding(scope) + else: + if address: + raise ValueError("格式: /motd 服务器地址;查看帮助: /motd help") + target = action or await self.store.get_binding(scope) + if not target: + await event.send( + event.plain_result( + "⚠️ 本群还没有设置 MOTD 服务器。\n管理员请使用: /motd set 服务器地址\n" + "也可以临时查询: /motd 服务器地址" + ) + ) + return + await self._query_and_send(event, normalize_address(target)) + + async def _query_and_send(self, event, address): + await self.store.track(address) + await event.send(event.plain_result(f"🔍 正在查询 {address} ...")) + data = await self.monitor.query(address) + now = int(time.time()) + history = await self.store.history(address, now) + if data is None: + # Keep the previous history visible even when the current query failed. + data = {"address": address, "online": False, "query_failed": True} + path = self.data_dir / f"card-{uuid.uuid4().hex}.png" + try: + image_bytes = await asyncio.to_thread( + render_motd_card, + data, + str(self.config.get("bot_name", "xiaohuicat")), + history, + now, + self.monitor.interval, + self.monitor.enabled, + str(self.config.get("font_path", "")), + ) + await asyncio.to_thread(path.write_bytes, image_bytes) + # Await the adapter send so upload errors can use the original text fallback. + await event.send(event.image_result(str(path.resolve()))) + except Exception: + logger.exception("MOTD 图片生成或发送失败: %s", address) + text = self.api.format_server_info(None if data.get("query_failed") else data) + counts = [p["players"] for p in history if p["players"] is not None] + if counts: + text += ( + f"\n24小时采样: {len(counts)} 次,人数最低 {min(counts)},最高 {max(counts)}" + ) + else: + text += "\n24小时波动: 暂无成功采样,正在积累历史。" + await event.send(event.plain_result(text)) + finally: + with contextlib.suppress(OSError): + path.unlink(missing_ok=True) + + async def terminate(self): + await self.monitor.close() diff --git a/metadata.yaml b/metadata.yaml new file mode 100644 index 0000000..361639a --- /dev/null +++ b/metadata.yaml @@ -0,0 +1,11 @@ +name: astrbot_plugin_motd +display_name: Minecraft MOTD 与玩家波动 +desc: Minecraft Java 服务器状态图片、群默认服务器、真实 Ping、玩家名单和最近 24 小时人数波动图。 +version: v1.0.0 +author: itxiaohui +support_platforms: + - qq_official + - qq_official_webhook + - aiocqhttp +astrbot_version: ">=4.16,<5" +repo: "https://github.com/itxiaohui66/astrbot_plugin_motd" diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..5916b6d --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,15 @@ +[tool.ruff] +target-version = "py310" +line-length = 100 +extend-exclude = [".dev", "dist"] + +[tool.ruff.lint] +select = ["E4", "E7", "E9", "F", "I"] + +[tool.ruff.lint.per-file-ignores] +"tools/preview.py" = ["E402"] + +[tool.pytest.ini_options] +asyncio_mode = "auto" +testpaths = ["tests"] +pythonpath = ["."] diff --git a/requirements-dev.txt b/requirements-dev.txt new file mode 100644 index 0000000..2e91335 --- /dev/null +++ b/requirements-dev.txt @@ -0,0 +1,4 @@ +-r requirements.txt +pytest>=8,<10 +pytest-asyncio>=0.24,<2 +ruff>=0.9,<1 diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..3769912 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,3 @@ +httpx>=0.27,<1 +Pillow>=10.4,<13 +mcstatus>=12,<15 diff --git a/services/__init__.py b/services/__init__.py new file mode 100644 index 0000000..15c1919 --- /dev/null +++ b/services/__init__.py @@ -0,0 +1 @@ +"""MOTD 查询、存储和图片服务。""" diff --git a/services/address.py b/services/address.py new file mode 100644 index 0000000..de7a479 --- /dev/null +++ b/services/address.py @@ -0,0 +1,31 @@ +"""Validate Minecraft addresses without changing implicit SRV semantics.""" + +import ipaddress +import re + +LABEL = re.compile(r"^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?$") + + +def normalize_address(value: str) -> str: + value = value.strip().lower() + if not value or len(value) > 259 or "/" in value: + raise ValueError("服务器地址格式不正确。请输入域名或 IP,可附带 :端口。") + # Brackets make IPv6 + port unambiguous. + if value.startswith("["): + match = re.fullmatch(r"\[([^]]+)\](?::([0-9]{1,5}))?", value) + if not match: + raise ValueError("IPv6 地址请使用 [IPv6]:端口 格式。") + try: + ipaddress.IPv6Address(match[1]) + except ValueError as exc: + raise ValueError("IPv6 地址格式不正确。") from exc + port = match[2] + else: + host, separator, port = value.partition(":") + if len(host) > 253 or not all(LABEL.fullmatch(p) for p in host.split(".")): + raise ValueError("服务器地址格式不正确。") + if separator and (not port.isascii() or not port.isdigit()): + raise ValueError("端口必须是 1 到 65535 的整数。") + if port and not 1 <= int(port) <= 65535: + raise ValueError("端口必须是 1 到 65535 的整数。") + return value diff --git a/services/mc_api.py b/services/mc_api.py new file mode 100644 index 0000000..ae15cb0 --- /dev/null +++ b/services/mc_api.py @@ -0,0 +1,313 @@ +"""Minecraft Java 直连查询、真实 Ping 和原项目公开 API 备用服务。""" + +import asyncio +import logging +import struct +import time +from collections import OrderedDict +from urllib.parse import quote + +import httpx +from mcstatus import JavaServer + +logger = logging.getLogger("qqbot.mc_api") + + +class MinecraftServerAPI: + """Minecraft 服务器状态查询客户端""" + + def __init__(self, config: dict): + mc_cfg = config.get("mc_status", config) + self.api_url: str = mc_cfg.get("api_url", "https://api.mcsrvstat.us/2/{address}") + self.timeout: float = mc_cfg.get("request_timeout", 10) + self.ping_timeout: float = mc_cfg.get("ping_timeout", 4) + self.default_port: int = mc_cfg.get("default_port", 25565) + self._metadata = OrderedDict() + + async def query(self, address: str) -> dict | None: + """Prefer uncached Java status for player history; retain the original public API fallback.""" + + async def direct(): + server = await JavaServer.async_lookup(address, timeout=self.ping_timeout) + status = await server.async_status(tries=1) + raw = status.raw + sample = raw.get("players", {}).get("sample", []) or [] + return { + "online": True, + "address": address, + "hostname": "", + "ip": server.address.host, + "port": server.address.port, + "version": status.version.name, + "motd": status.motd.to_plain(), + "players_online": status.players.online, + "players_max": status.players.max, + "player_list": [ + str(p.get("name", "")) for p in sample if isinstance(p, dict) and p.get("name") + ], + "latency_ms": round(status.latency, 1), + "software": raw.get("software", ""), + "plugins": raw.get("plugins", {}), + "icon": raw.get("favicon", ""), + "source": "direct", + } + + try: + data = await asyncio.wait_for(direct(), timeout=self.ping_timeout + 2) + except Exception as exc: + logger.debug("MC 直连失败,使用原公开 API %s: %s", address, exc) + data = await self._query_api(address) + if data is not None: + data["source"] = "api" + return data + # Java status does not normally expose software/plugin names. Preserve the + # old API's extra fields while NEVER replacing direct player counts or RTT. + cached = self._metadata.get(address) + if not cached or time.monotonic() - cached[0] >= 3600: + extra = await self._query_api(address, measure_latency=False) + self._metadata[address] = (time.monotonic(), extra) + self._metadata.move_to_end(address) + while len(self._metadata) > 128: + self._metadata.popitem(last=False) + else: + extra = cached[1] + if extra and extra.get("online"): + for key in ("hostname", "software", "plugins", "icon", "player_list"): + if not data.get(key) and extra.get(key): + data[key] = extra[key] + if key == "player_list": + data["player_list_cached"] = True + return data + + @staticmethod + def _encode_varint(value: int) -> bytes: + value &= 0xFFFFFFFF + encoded = bytearray() + while True: + byte = value & 0x7F + value >>= 7 + encoded.append(byte | (0x80 if value else 0)) + if not value: + return bytes(encoded) + + @classmethod + def _encode_string(cls, value: str) -> bytes: + raw = value.encode("utf-8") + return cls._encode_varint(len(raw)) + raw + + @staticmethod + async def _read_varint(reader: asyncio.StreamReader) -> int: + value = 0 + for position in range(5): + byte = (await reader.readexactly(1))[0] + value |= (byte & 0x7F) << (7 * position) + if not byte & 0x80: + return value + raise ValueError("Minecraft VarInt 过长") + + async def _measure_minecraft_latency( + self, connect_host: str, port: int, handshake_host: str, protocol: int + ) -> float | None: + """执行 Minecraft Java 状态握手与 ping/pong,返回真实 RTT。""" + + async def probe() -> float: + reader, writer = await asyncio.open_connection(connect_host, port) + try: + handshake = ( + self._encode_varint(0) + + self._encode_varint(protocol) + + self._encode_string(handshake_host) + + struct.pack(">H", port) + + self._encode_varint(1) + ) + writer.write(self._encode_varint(len(handshake)) + handshake) + writer.write(b"\x01\x00") # status request: length=1, packet id=0 + await writer.drain() + + packet_length = await self._read_varint(reader) + if not 1 <= packet_length <= 2_097_152: + raise ValueError("Minecraft 状态响应大小超出限制") + if await self._read_varint(reader) != 0: + raise ValueError("非法的 Minecraft 状态响应") + json_length = await self._read_varint(reader) + if not 0 <= json_length <= packet_length: + raise ValueError("非法的 Minecraft JSON 长度") + await reader.readexactly(json_length) + + payload = int(time.time_ns() // 1_000_000) + ping_packet = self._encode_varint(1) + struct.pack(">q", payload) + started = time.perf_counter() + writer.write(self._encode_varint(len(ping_packet)) + ping_packet) + await writer.drain() + if await self._read_varint(reader) != 9: + raise ValueError("非法的 Minecraft pong 长度") + if await self._read_varint(reader) != 1: + raise ValueError("非法的 Minecraft pong 响应") + if await reader.readexactly(8) != struct.pack(">q", payload): + raise ValueError("Minecraft pong 校验失败") + return round((time.perf_counter() - started) * 1000, 1) + finally: + writer.close() + try: + await writer.wait_closed() + except Exception: + pass + + try: + return await asyncio.wait_for(probe(), timeout=self.ping_timeout) + except Exception as exc: + logger.warning("Minecraft Ping 测量失败 %s:%s: %s", connect_host, port, exc) + return None + + async def _query_api(self, address: str, measure_latency: bool = True) -> dict | None: + """ + 查询 Minecraft 服务器状态 + + Args: + address: 服务器地址,如 "mc.hypixel.net" 或 "mc.example.com:25565" + + Returns: + 服务器信息字典,失败返回 None + """ + # 不要给纯域名强制补 :25565。查询服务会先解析 + # _minecraft._tcp SRV 记录;只有用户显式填写端口时才固定端口。 + url = self.api_url.format(address=quote(address, safe="")) + + try: + async with httpx.AsyncClient(timeout=self.timeout) as client: + response = await client.get(url) + + if response.status_code != 200: + logger.warning(f"MC服务器查询失败: {address} HTTP {response.status_code}") + return None + + data = response.json() + + if not data.get("online", False): + return { + "online": False, + "address": address, + "latency_ms": None, + } + + # 提取 MOTD 纯文本 + motd_text = "" + motd = data.get("motd", {}) + if isinstance(motd, dict): + motd_text = " | ".join(motd.get("clean", [])) + elif isinstance(motd, str): + motd_text = motd + + players = data.get("players", {}) + player_list = [] + for player in players.get("list", []) or []: + if isinstance(player, dict): + name = player.get("name") or player.get("username") or "" + else: + name = str(player) + name = name.strip() + if name: + player_list.append(name) + resolved_ip = str(data.get("ip") or "") + resolved_port = int(data.get("port") or self.default_port) + protocol = int(data.get("protocol") or 47) + handshake_host = address.rsplit(":", 1)[0] if ":" in address else address + latency_ms = None + if resolved_ip and measure_latency: + latency_ms = await self._measure_minecraft_latency( + resolved_ip, resolved_port, handshake_host, protocol + ) + return { + "online": True, + "address": address, + "hostname": data.get("hostname", ""), + "ip": data.get("ip", ""), + "port": resolved_port, + "version": data.get("version", "未知"), + "motd": motd_text, + "players_online": players.get("online", 0), + "players_max": players.get("max", 0), + "player_list": player_list, + "latency_ms": latency_ms, + "software": data.get("software", ""), + "plugins": data.get("plugins", {}), + "icon": data.get("icon", ""), + } + + except httpx.TimeoutException: + logger.error(f"MC服务器查询超时: {address}") + return None + except Exception as e: + logger.error(f"MC服务器查询失败 ({address}): {e}") + return None + + def format_server_info(self, data: dict | None) -> str: + """格式化服务器信息为文本""" + if not data: + return "❌ 无法查询该服务器,请检查地址是否正确。" + + if not data.get("online", False): + addr = data.get("address", "未知服务器") + return f"⚠️ 服务器离线\n🖥️ 地址: {addr}" + + # 在线服务器 + lines = [ + "🟢 服务器在线", + ] + + if data.get("hostname"): + lines.append(f"🏷️ 名称: {data['hostname']}") + + addr = data.get("address", "") + if addr: + lines.append(f"🖥️ 地址: {addr}") + + lines.append(f"📦 版本: {data.get('version', '未知')}") + + if data.get("software"): + lines.append(f"🔧 服务端: {data['software']}") + + motd = data.get("motd", "") + if motd: + # 限制标语长度 + if len(motd) > 200: + motd = motd[:200] + "..." + lines.append(f"📝 标语: {motd}") + + players_online = data.get("players_online", 0) + players_max = data.get("players_max", 0) + # 玩家数进度条 + if players_max > 0: + bar_len = 10 + ratio = min(players_online / players_max, 1.0) + filled = int(bar_len * ratio) + bar = "█" * filled + "░" * (bar_len - filled) + lines.append(f"👥 在线: {players_online}/{players_max} [{bar}]") + else: + lines.append(f"👥 在线: {players_online}") + + latency = data.get("latency_ms") + lines.append(f"📡 MC Ping: {latency}ms" if latency is not None else "📡 MC Ping: 未提供") + + # 如果安装了插件,显示数量 + plugins = data.get("plugins", {}) + if isinstance(plugins, dict) and plugins.get("names"): + plug_count = len(plugins["names"]) + lines.append(f"🔌 插件: {plug_count} 个") + + player_list = data.get("player_list") or [] + if player_list: + lines.append( + f"👤 已公开玩家({len(player_list)}/{players_online}): " + + "、".join(player_list)[:400] + ) + elif players_online: + lines.append("👤 服务器未公开玩家名单") + else: + lines.append("👤 暂无玩家在线") + if data.get("source") == "api": + lines.append("数据来源: 公开 API(可能有缓存)") + if data.get("player_list_cached"): + lines.append("玩家名单来源: API 缓存样本") + + return "\n".join(lines) diff --git a/services/monitor.py b/services/monitor.py new file mode 100644 index 0000000..3cb9aa9 --- /dev/null +++ b/services/monitor.py @@ -0,0 +1,78 @@ +"""Shared query cache and bounded background sampling, with clean cancellation.""" + +import asyncio +import logging +import time +from collections import OrderedDict + +logger = logging.getLogger(__name__) + + +class PlayerMonitor: + def __init__(self, api, store, interval=300, retention_hours=48, enabled=True, addresses=()): + self.api, self.store = api, store + self.interval, self.retention_hours, self.enabled = interval, retention_hours, enabled + self.addresses = set(addresses) + self._semaphore = asyncio.Semaphore(4) + self._cache = OrderedDict() + self._pending = {} + self._task = None + + async def query(self, address: str): + cached = self._cache.get(address) + if cached and time.monotonic() - cached[0] < 15: + return cached[1] + # Concurrent requests for the same server share one query and one sample. + if address not in self._pending: + self._pending[address] = asyncio.create_task(self._fetch(address)) + task = self._pending[address] + try: + return await asyncio.shield(task) + finally: + if task.done() and self._pending.get(address) is task: + self._pending.pop(address, None) + + async def _fetch(self, address): + async with self._semaphore: + try: + data = await self.api.query(address) + except Exception: + logger.exception("MOTD 查询异常: %s", address) + data = None + await self.store.record(address, data) + self._cache[address] = (time.monotonic(), data) + self._cache.move_to_end(address) + while len(self._cache) > 128: + self._cache.popitem(last=False) + return data + + def start(self): + if self.enabled and self._task is None: + self._task = asyncio.create_task(self._loop(), name="motd-player-monitor") + + async def sample_once(self): + addresses = set(await self.store.monitored_addresses()) | self.addresses + results = await asyncio.gather(*(self.query(a) for a in addresses), return_exceptions=True) + for address, result in zip(addresses, results): + if isinstance(result, Exception): + logger.error("MOTD 采样失败 %s: %s", address, result) + await self.store.prune(self.retention_hours) + + async def _loop(self): + while True: + started = time.monotonic() + try: + await self.sample_once() + except Exception: + logger.exception("MOTD 后台采样异常") + await asyncio.sleep(max(1, self.interval - (time.monotonic() - started))) + + async def close(self): + tasks = list(self._pending.values()) + if self._task: + tasks.append(self._task) + for task in tasks: + task.cancel() + await asyncio.gather(*tasks, return_exceptions=True) + self._pending.clear() + self._task = None diff --git a/services/motd_card.py b/services/motd_card.py new file mode 100644 index 0000000..57dab69 --- /dev/null +++ b/services/motd_card.py @@ -0,0 +1,422 @@ +"""Minecraft MOTD 图片卡片渲染器。""" + +from __future__ import annotations + +import base64 +import hashlib +import html +import io +import math +import re +import time +from datetime import datetime, timedelta, timezone +from functools import lru_cache +from pathlib import Path + +from PIL import Image, ImageDraw, ImageFont + +CARD_WIDTH = 1200 +CARD_HEIGHT = 1080 +CHINA_TIME = timezone(timedelta(hours=8)) + + +@lru_cache(maxsize=64) +def _load_font( + size: int, bold: bool = False, font_path: str = "" +) -> ImageFont.FreeTypeFont | ImageFont.ImageFont: + """优先使用服务器上的中文字体,兼容 Windows 本地预览。""" + names = ( + [ + "/usr/share/fonts/opentype/noto/NotoSansCJK-Bold.ttc", + "/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc", + "C:/Windows/Fonts/msyhbd.ttc", + "C:/Windows/Fonts/simhei.ttf", + ] + if bold + else [ + "/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc", + "/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc", + "C:/Windows/Fonts/msyh.ttc", + "C:/Windows/Fonts/simsun.ttc", + ] + ) + for name in ([font_path] if font_path else []) + names: + if Path(name).exists(): + return ImageFont.truetype(name, size=size) + try: + return ImageFont.truetype("DejaVuSans-Bold.ttf" if bold else "DejaVuSans.ttf", size=size) + except OSError: + return ImageFont.load_default() + + +def _rounded_panel( + draw: ImageDraw.ImageDraw, + box: tuple[int, int, int, int], + fill: tuple[int, int, int, int], + outline: tuple[int, int, int, int] | None = None, + radius: int = 22, +) -> None: + draw.rounded_rectangle(box, radius=radius, fill=fill, outline=outline, width=2) + + +def _draw_pixel_background(image: Image.Image, seed_text: str) -> None: + draw = ImageDraw.Draw(image, "RGBA") + top = (12, 23, 18) + bottom = (22, 49, 34) + for y in range(CARD_HEIGHT): + ratio = y / max(CARD_HEIGHT - 1, 1) + color = tuple(int(top[i] + (bottom[i] - top[i]) * ratio) for i in range(3)) + draw.line((0, y, CARD_WIDTH, y), fill=(*color, 255)) + + digest = hashlib.sha256(seed_text.encode("utf-8")).digest() + palette = [(17, 39, 26, 255), (20, 46, 29, 255), (15, 34, 24, 255)] + for index in range(34): + x = (digest[index % len(digest)] * 47 + index * 113) % CARD_WIDTH + y = (digest[(index + 9) % len(digest)] * 31 + index * 71) % CARD_HEIGHT + size = 24 + digest[(index + 17) % len(digest)] % 64 + draw.rectangle((x, y, x + size, y + size), fill=palette[index % len(palette)]) + + +def _decode_server_icon(icon_value: str) -> Image.Image | None: + if not icon_value: + return None + if len(icon_value) > 1_000_000: + return None + try: + encoded = icon_value.split(",", 1)[1] if "," in icon_value else icon_value + source = Image.open(io.BytesIO(base64.b64decode(encoded))) + if source.width > 512 or source.height > 512: + return None + icon = source.convert("RGBA") + return icon.resize((128, 128), Image.Resampling.NEAREST) + except Exception: + return None + + +def _draw_creeper_icon(image: Image.Image, box: tuple[int, int, int, int], seed_text: str) -> None: + """服务器没有图标时,绘制像素风苦力怕头像。""" + x1, y1, x2, y2 = box + size = x2 - x1 + cell = max(size // 8, 1) + draw = ImageDraw.Draw(image, "RGBA") + digest = hashlib.md5(seed_text.encode("utf-8")).digest() + greens = [(72, 160, 72, 255), (83, 177, 79, 255), (55, 139, 65, 255), (101, 188, 88, 255)] + for row in range(8): + for col in range(8): + color = greens[digest[(row * 8 + col) % len(digest)] % len(greens)] + draw.rectangle( + (x1 + col * cell, y1 + row * cell, x1 + (col + 1) * cell, y1 + (row + 1) * cell), + fill=color, + ) + dark = (15, 31, 22, 255) + for col, row, width, height in ( + (1, 2, 2, 2), + (5, 2, 2, 2), + (3, 4, 2, 2), + (2, 5, 4, 2), + (2, 7, 1, 1), + (5, 7, 1, 1), + ): + draw.rectangle( + ( + x1 + col * cell, + y1 + row * cell, + x1 + (col + width) * cell, + y1 + (row + height) * cell, + ), + fill=dark, + ) + + +def _ellipsize(draw: ImageDraw.ImageDraw, text: str, font, max_width: int) -> str: + text = str(text) + if draw.textlength(text, font=font) <= max_width: + return text + suffix = "..." + while text and draw.textlength(text + suffix, font=font) > max_width: + text = text[:-1] + return text + suffix + + +def _wrap_text( + draw: ImageDraw.ImageDraw, text: str, font, max_width: int, max_lines: int = 2 +) -> list[str]: + clean = ( + html.unescape(re.sub(r"§.", "", str(text))).replace("\r", " ").replace("\n", " ").strip() + ) + if not clean: + return [] + lines: list[str] = [] + current = "" + for char in clean: + candidate = current + char + if current and draw.textlength(candidate, font=font) > max_width: + lines.append(current) + current = char + if len(lines) == max_lines: + break + else: + current = candidate + if len(lines) < max_lines and current: + lines.append(current) + consumed = "".join(lines) + if len(consumed) < len(clean) and lines: + lines[-1] = _ellipsize(draw, lines[-1] + "...", font, max_width) + return lines[:max_lines] + + +def render_motd_card( + data: dict, + bot_name: str = "xiaohuicat", + history: list[dict] | None = None, + now: int | None = None, + sample_interval: int = 300, + history_enabled: bool = True, + font_path: str = "", +) -> bytes: + """把 MOTD 查询结果渲染为 PNG 字节。""" + address = str(data.get("address") or "未知服务器") + online = bool(data.get("online")) + accent = (91, 214, 111, 255) if online else (241, 96, 89, 255) + accent_soft = (27, 67, 37, 255) if online else (76, 31, 29, 255) + + image = Image.new("RGBA", (CARD_WIDTH, CARD_HEIGHT), (12, 23, 18, 255)) + _draw_pixel_background(image, address) + draw = ImageDraw.Draw(image, "RGBA") + + # 主面板和左侧像素饰条 + _rounded_panel(draw, (44, 42, 1156, 1040), (8, 16, 13, 222), (77, 123, 90, 110), 30) + draw.rounded_rectangle((44, 42, 58, 1040), radius=7, fill=accent) + _rounded_panel(draw, (84, 100, 264, 280), (20, 38, 27, 245), (83, 147, 94, 155), 22) + + icon = _decode_server_icon(str(data.get("icon") or "")) + if icon is not None: + image.alpha_composite(icon, (110, 126)) + else: + _draw_creeper_icon(image, (110, 126, 238, 254), address) + + title_font = _load_font(25, bold=True, font_path=font_path) + address_font = _load_font(42, bold=True, font_path=font_path) + status_font = _load_font(28, bold=True, font_path=font_path) + label_font = _load_font(22, font_path=font_path) + value_font = _load_font(29, bold=True, font_path=font_path) + motd_font = _load_font(25, font_path=font_path) + footer_font = _load_font(19, font_path=font_path) + + draw.text((84, 66), "MINECRAFT SERVER STATUS", font=title_font, fill=(161, 196, 171, 255)) + shown_address = _ellipsize(draw, address, address_font, 790) + draw.text((298, 112), shown_address, font=address_font, fill=(239, 247, 241, 255)) + + status_text = ( + "查询失败" if data.get("query_failed") else ("服务器在线" if online else "服务器离线") + ) + status_width = int(draw.textlength(status_text, font=status_font)) + 58 + draw.rounded_rectangle( + (298, 176, 298 + status_width, 226), radius=25, fill=accent_soft, outline=accent, width=2 + ) + draw.ellipse((316, 193, 330, 207), fill=accent) + draw.text((342, 183), status_text, font=status_font, fill=accent) + details = " · ".join(str(data.get(k) or "") for k in ("hostname", "software") if data.get(k)) + plugins = data.get("plugins") + if isinstance(plugins, dict) and plugins.get("names"): + details += f" · 插件 {len(plugins['names'])} 个" + if details: + draw.text( + (298, 247), + _ellipsize(draw, details.strip(" ·"), label_font, 780), + font=label_font, + fill=(145, 171, 152, 255), + ) + + # 信息卡片 + latency = data.get("latency_ms") + latency_text = f"{latency} ms" if latency is not None else "未提供" + panels = [ + (84, 314, 392, 426, "游戏版本", str(data.get("version") or "未知")), + ( + 414, + 314, + 722, + 426, + "在线玩家", + f"{data.get('players_online', 0)} / {data.get('players_max', 0)}" + if online + else "- / -", + ), + (744, 314, 1072, 426, "MC PING", latency_text), + ] + for x1, y1, x2, y2, label, value in panels: + _rounded_panel(draw, (x1, y1, x2, y2), (19, 35, 27, 230), (65, 104, 76, 100), 18) + draw.text((x1 + 22, y1 + 16), label, font=label_font, fill=(145, 171, 152, 255)) + draw.text( + (x1 + 22, y1 + 52), + _ellipsize(draw, value, value_font, x2 - x1 - 44), + font=value_font, + fill=(237, 244, 239, 255), + ) + + # 玩家数进度条 + players_online = int(data.get("players_online") or 0) + players_max = int(data.get("players_max") or 0) + ratio = min(players_online / players_max, 1.0) if players_max > 0 and online else 0 + draw.rounded_rectangle((436, 404, 700, 414), radius=5, fill=(40, 61, 47, 255)) + if ratio > 0: + draw.rounded_rectangle((436, 404, 436 + int(264 * ratio), 414), radius=5, fill=accent) + + # MOTD + _rounded_panel(draw, (84, 452, 714, 568), (17, 31, 24, 230), (65, 104, 76, 90), 18) + draw.text((106, 468), "MOTD", font=label_font, fill=(145, 171, 152, 255)) + motd = str(data.get("motd") or ("暂无服务器标语" if online else "无法连接到该服务器")) + for line_index, line in enumerate(_wrap_text(draw, motd, motd_font, 580, 2)): + draw.text((106, 500 + line_index * 32), line, font=motd_font, fill=(226, 236, 229, 255)) + + # 在线玩家名单(Minecraft 状态协议可能只返回部分样本) + _rounded_panel(draw, (736, 452, 1072, 568), (17, 31, 24, 230), (65, 104, 76, 90), 18) + player_list = [str(name) for name in (data.get("player_list") or []) if str(name).strip()] + if player_list: + public_count = len(player_list) + player_label = f"在线玩家(已公开 {public_count}/{players_online})" + if data.get("player_list_cached"): + player_label = "公开玩家(API 缓存样本)" + player_text = "、".join(player_list) + elif online and players_online > 0: + player_label = "在线玩家" + player_text = "服务器未公开玩家名单" + elif online: + player_label = "在线玩家" + player_text = "暂无玩家在线" + else: + player_label = "在线玩家" + player_text = "-" + draw.text( + (758, 468), + _ellipsize(draw, player_label, label_font, 292), + font=label_font, + fill=(145, 171, 152, 255), + ) + for line_index, line in enumerate(_wrap_text(draw, player_text, label_font, 290, 2)): + draw.text((758, 504 + line_index * 28), line, font=label_font, fill=(226, 236, 229, 255)) + + now = int(time.time()) if now is None else now + _draw_history(draw, history or [], now, sample_interval, history_enabled, font_path) + source = "公开 API(可能有缓存)" if data.get("source") == "api" else "Minecraft 直连" + if data.get("query_failed"): + source = "本次查询失败" + update_time = datetime.fromtimestamp(now, CHINA_TIME).strftime("%m-%d %H:%M") + footer = f"{bot_name} · itxiaohui · {source} · {update_time} (UTC+8)" + draw.text( + (84, 996), + _ellipsize(draw, footer, footer_font, 1010), + font=footer_font, + fill=(116, 145, 125, 255), + ) + + output = io.BytesIO() + image.convert("RGB").save(output, format="PNG", optimize=True) + return output.getvalue() + + +def history_segments(history: list[dict], now: int, interval: int) -> list[list[dict]]: + """Split at failures, offline responses, and missing samples instead of inventing a connecting line.""" + segments, current = [], [] + for point in sorted(history, key=lambda p: p["timestamp"]): + if not now - 86400 <= point["timestamp"] <= now: + continue + valid = point.get("online") == 1 and point.get("players") is not None + if not valid or ( + current and point["timestamp"] - current[-1]["timestamp"] > interval * 2.5 + ): + if current: + segments.append(current) + current = [] + if valid: + current.append(point) + if current: + segments.append(current) + return segments + + +def _draw_history(draw, history, now, interval, enabled, font_path): + _rounded_panel(draw, (84, 590, 1072, 974), (17, 31, 24, 230), (65, 104, 76, 90), 18) + title = _load_font(25, True, font_path) + font = _load_font(19, font_path=font_path) + small = _load_font(17, font_path=font_path) + draw.text((106, 606), "最近 24 小时 · 在线玩家波动", font=title, fill=(226, 236, 229)) + history = sorted( + (p for p in history if now - 86400 <= p["timestamp"] <= now), key=lambda p: p["timestamp"] + ) + counts = [ + p["players"] for p in history if p.get("online") == 1 and p.get("players") is not None + ] + if counts: + summary = f"最低 {min(counts)} / 最高 {max(counts)} / 采样均值 {sum(counts) / len(counts):.1f}" + else: + summary = "暂无成功的人数采样" + draw.text((106, 644), summary, font=font, fill=(145, 171, 152)) + # Fixed rolling 24h axis: partial histories only occupy their actual time range. + left, right, top, bottom = 162, 1034, 694, 874 + maximum = max(counts, default=1) + step = max(1, math.ceil(maximum / 4)) + ceiling = step * 4 + for index in range(5): + y = bottom - index * (bottom - top) / 4 + draw.line((left, y, right, y), fill=(48, 70, 55), width=1) + label = str(index * step) + draw.text( + (left - 14 - draw.textlength(label, font=small), y - 12), + label, + font=small, + fill=(116, 145, 125), + ) + for index in range(5): + x = left + index * (right - left) / 4 + draw.line((x, top, x, bottom), fill=(32, 51, 39), width=1) + stamp = datetime.fromtimestamp(now - 86400 + index * 21600, CHINA_TIME).strftime("%H:%M") + draw.text( + (x - draw.textlength(stamp, font=small) / 2, 883), + stamp, + font=small, + fill=(116, 145, 125), + ) + + def coordinates(p): + return ( + left + (p["timestamp"] - (now - 86400)) / 86400 * (right - left), + bottom - p["players"] / ceiling * (bottom - top), + ) + + for segment in history_segments(history, now, interval): + points = [coordinates(p) for p in segment] + if len(points) > 1: + draw.line(points, fill=(91, 214, 111), width=3) + for x, y in points: + draw.ellipse((x - 2, y - 2, x + 2, y + 2), fill=(123, 238, 141)) + for point in history: + if point.get("online") != 1: + x = left + (point["timestamp"] - (now - 86400)) / 86400 * (right - left) + color = (241, 96, 89) if point.get("online") == 0 else (212, 175, 99) + draw.line((x, bottom - 6, x, bottom), fill=color, width=2) + if not counts: + text = "开始采集后将在这里显示曲线" if not history else "服务器离线或查询失败,暂无人数曲线" + draw.text((left + 140, top + 70), text, font=font, fill=(145, 171, 152)) + if len(counts) == 1: + note = "仅有 1 个人数采样,继续运行后自动形成曲线" + else: + note = f"人数采样 {len(counts)} 次 · 间隔 {interval // 60} 分钟 · 红:离线 黄:失败 空白:无数据" + if not enabled: + note = "后台采样已关闭,仅记录手动查询 · 空白时段没有数据" + draw.text((106, 918), _ellipsize(draw, note, small, 936), font=small, fill=(116, 145, 125)) + if any(p.get("source") == "api" for p in history): + draw.text( + (106, 944), + "部分采样来自公开 API,人数可能有缓存延迟 · 时间 UTC+8", + font=small, + fill=(212, 175, 99), + ) + else: + draw.text( + (106, 944), + "从首次查询或绑定开始积累 · 重启后保留历史 · 时间 UTC+8", + font=small, + fill=(116, 145, 125), + ) diff --git a/services/storage.py b/services/storage.py new file mode 100644 index 0000000..5a82f68 --- /dev/null +++ b/services/storage.py @@ -0,0 +1,128 @@ +"""SQLite persistence outside the plugin checkout; every connection stays in a worker thread.""" + +import asyncio +import sqlite3 +import time +from pathlib import Path + + +class MotdStore: + def __init__(self, path: Path): + self.path = Path(path) + + def _run(self, operation): + self.path.parent.mkdir(parents=True, exist_ok=True) + with sqlite3.connect(self.path, timeout=15) as db: + db.row_factory = sqlite3.Row + return operation(db) + + async def initialize(self): + def create(db): + db.execute("PRAGMA journal_mode=WAL") + db.executescript(""" + CREATE TABLE IF NOT EXISTS bindings ( + scope TEXT PRIMARY KEY, address TEXT NOT NULL, + updated_by TEXT NOT NULL, updated_at INTEGER NOT NULL + ); + CREATE TABLE IF NOT EXISTS tracked ( + address TEXT PRIMARY KEY, touched_at INTEGER NOT NULL + ); + CREATE TABLE IF NOT EXISTS samples ( + address TEXT NOT NULL, timestamp INTEGER NOT NULL, + online INTEGER, players INTEGER, source TEXT NOT NULL, + PRIMARY KEY (address, timestamp) + ); + """) + + await asyncio.to_thread(self._run, create) + + async def get_binding(self, scope: str) -> str | None: + def query(db): + row = db.execute("SELECT address FROM bindings WHERE scope=?", (scope,)).fetchone() + return row[0] if row else None + + return await asyncio.to_thread(self._run, query) + + async def set_binding(self, scope: str, address: str, user: str): + await asyncio.to_thread( + self._run, + lambda db: ( + db.execute( + "INSERT OR REPLACE INTO bindings VALUES (?, ?, ?, ?)", + (scope, address, user, int(time.time())), + ).rowcount + ), + ) + + async def clear_binding(self, scope: str): + await asyncio.to_thread( + self._run, + lambda db: ( + db.execute( + "DELETE FROM bindings WHERE scope=?", + (scope,), + ).rowcount + ), + ) + + async def track(self, address: str, limit: int = 128): + def insert(db): + db.execute("INSERT OR REPLACE INTO tracked VALUES (?, ?)", (address, int(time.time()))) + db.execute( + """DELETE FROM tracked WHERE address IN ( + SELECT address FROM tracked ORDER BY touched_at DESC, address LIMIT -1 OFFSET ? + )""", + (limit,), + ) + + await asyncio.to_thread(self._run, insert) + + async def monitored_addresses(self, now: int | None = None) -> list[str]: + now = int(time.time()) if now is None else now + return await asyncio.to_thread( + self._run, + lambda db: [ + r[0] + for r in db.execute( + "SELECT address FROM bindings UNION SELECT address FROM tracked WHERE touched_at>=?", + (now - 86400,), + ) + ], + ) + + async def record(self, address: str, data: dict | None, timestamp: int | None = None): + timestamp = int(time.time()) if timestamp is None else timestamp + online = int(bool(data["online"])) if data is not None else None + players = int(data.get("players_online", 0)) if online else None + source = data.get("source", "api") if data else "error" + await asyncio.to_thread( + self._run, + lambda db: ( + db.execute( + "INSERT OR REPLACE INTO samples VALUES (?, ?, ?, ?, ?)", + (address, timestamp, online, players, source), + ).rowcount + ), + ) + + async def history(self, address: str, now: int | None = None) -> list[dict]: + now = int(time.time()) if now is None else now + return await asyncio.to_thread( + self._run, + lambda db: [ + dict(r) + for r in db.execute( + "SELECT * FROM samples WHERE address=? AND timestamp BETWEEN ? AND ? ORDER BY timestamp", + (address, now - 86400, now), + ) + ], + ) + + async def prune(self, retention_hours: int = 48): + now = int(time.time()) + + def clean(db): + db.execute("DELETE FROM samples WHERE timestamp= 0 + # Exercise the migrated fallback ping/pong path too. + latency = await api._measure_minecraft_latency("127.0.0.1", port, "127.0.0.1", 767) + assert latency is not None and latency >= 0 + finally: + server.close() + await server.wait_closed() + + +async def test_api_fallback_and_player_normalization(monkeypatch): + async def unavailable(*args, **kwargs): + raise OSError("direct unavailable") + + monkeypatch.setattr("services.mc_api.JavaServer.async_lookup", unavailable) + real_client = httpx.AsyncClient + seen = [] + + def response(request): + seen.append(str(request.url)) + return httpx.Response( + 200, + json={ + "online": True, + "version": "Paper 1.21", + "port": 25565, + "motd": {"clean": ["First", "Second"]}, + "players": { + "online": 5, + "max": 20, + "list": ["Steve", {"name": "Alex"}, {"username": "Third"}], + }, + "plugins": {"names": ["Example"]}, + "software": "Paper", + }, + ) + + monkeypatch.setattr( + "services.mc_api.httpx.AsyncClient", + lambda **kwargs: real_client(transport=httpx.MockTransport(response), **kwargs), + ) + api = MinecraftServerAPI({}) + data = await api.query("mc.example.com") + assert data["source"] == "api" and data["motd"] == "First | Second" + assert data["player_list"] == ["Steve", "Alex", "Third"] + assert seen == ["https://api.mcsrvstat.us/2/mc.example.com"] # no forced :25565 + text = api.format_server_info(data) + assert "Steve" in text and "插件: 1 个" in text and "缓存" in text + + +async def test_api_offline_different_from_transport_error(monkeypatch): + async def unavailable(*args, **kwargs): + raise OSError("down") + + monkeypatch.setattr("services.mc_api.JavaServer.async_lookup", unavailable) + real_client = httpx.AsyncClient + status = [200] + monkeypatch.setattr( + "services.mc_api.httpx.AsyncClient", + lambda **kwargs: real_client( + transport=httpx.MockTransport( + lambda req: httpx.Response(status[0], json={"online": False}) + ), + **kwargs, + ), + ) + api = MinecraftServerAPI({}) + assert (await api.query("a.test"))["online"] is False + status[0] = 503 + assert await api.query("a.test") is None + + +async def test_srv_lookup_input_is_not_changed(monkeypatch): + seen = [] + + async def status(**kwargs): + return SimpleNamespace( + raw={}, + version=SimpleNamespace(name="1.21"), + motd=SimpleNamespace(to_plain=lambda: "Hi"), + players=SimpleNamespace(online=0, max=20), + latency=5, + ) + + async def lookup(address, **kwargs): + seen.append(address) + return SimpleNamespace( + address=SimpleNamespace(host="srv-target.test", port=25570), async_status=status + ) + + monkeypatch.setattr("services.mc_api.JavaServer.async_lookup", lookup) + api = MinecraftServerAPI({}) + + async def no_extra(*args, **kwargs): + return None + + api._query_api = no_extra + data = await api.query("mc.example.com") + assert seen == ["mc.example.com"] and data["port"] == 25570 diff --git a/tests/test_plugin.py b/tests/test_plugin.py new file mode 100644 index 0000000..d63a1d1 --- /dev/null +++ b/tests/test_plugin.py @@ -0,0 +1,148 @@ +"""Framework-free adapter contract tests; the actual QQ account needs deployment verification.""" + +import importlib.util +import logging +import sys +import types +from pathlib import Path + +import pytest + + +class Event: + def __init__(self, platform="qq-main", group="group-openid", admin=False, image_error=False): + self.platform, self.group, self.admin = platform, group, admin + self.image_error = image_error + self.unified_msg_origin = f"{platform}:private:user" + self.messages = [] + self.stopped = False + + def get_group_id(self): + return self.group + + def get_platform_id(self): + return self.platform + + def get_sender_id(self): + return "user-openid" + + def is_admin(self): + return self.admin + + def plain_result(self, text): + return ("text", text) + + def image_result(self, path): + return ("image", path) + + def stop_event(self): + self.stopped = True + + async def send(self, result): + if result[0] == "image": + assert Path(result[1]).is_file() + if self.image_error: + raise RuntimeError("QQ upload failed") + self.messages.append(result) + + +@pytest.fixture +def plugin_class(monkeypatch, tmp_path): + class Star: + def __init__(self, context): + self.context = context + + def command(name, alias): + def decorate(func): + func.registered_aliases = alias + return func + + return decorate + + modules = { + "astrbot": types.ModuleType("astrbot"), + "astrbot.api": types.ModuleType("astrbot.api"), + "astrbot.api.event": types.ModuleType("astrbot.api.event"), + "astrbot.api.star": types.ModuleType("astrbot.api.star"), + } + modules["astrbot.api"].AstrBotConfig = dict + modules["astrbot.api"].logger = logging.getLogger("test") + modules["astrbot.api.event"].AstrMessageEvent = Event + modules["astrbot.api.event"].filter = types.SimpleNamespace(command=command) + modules["astrbot.api.star"].Star = Star + modules["astrbot.api.star"].Context = object + modules["astrbot.api.star"].StarTools = types.SimpleNamespace( + get_data_dir=lambda name: tmp_path + ) + for name, module in modules.items(): + monkeypatch.setitem(sys.modules, name, module) + root = Path(__file__).resolve().parents[1] + package = types.ModuleType("plugin_under_test") + package.__path__ = [str(root)] + monkeypatch.setitem(sys.modules, "plugin_under_test", package) + spec = importlib.util.spec_from_file_location("plugin_under_test.main", root / "main.py") + module = importlib.util.module_from_spec(spec) + monkeypatch.setitem(sys.modules, spec.name, module) + spec.loader.exec_module(module) + return module.MotdPlugin + + +async def test_permission_binding_scope_aliases_and_clear(plugin_class): + plugin = plugin_class(object(), {"history_enabled": False}) + + async def no_send(*args): + pass + + plugin._query_and_send = no_send + ordinary = Event() + await plugin.motd(ordinary, "set", "mc.example.com") + assert "管理员" in ordinary.messages[-1][1] + assert await plugin.store.get_binding(plugin._scope(ordinary)) is None + admin = Event(admin=True) + await plugin.motd(admin, "设置", "MC.Example.COM") + assert await plugin.store.get_binding(plugin._scope(admin)) == "mc.example.com" + assert await plugin.store.get_binding(plugin._scope(Event(platform="second-bot"))) is None + await plugin.motd(admin, "清除") + assert await plugin.store.get_binding(plugin._scope(admin)) is None + assert admin.stopped and plugin.motd.registered_aliases == {"mc", "mcstatus"} + await plugin.terminate() + + +async def test_query_image_fallback_and_file_cleanup(plugin_class, tmp_path): + plugin = plugin_class(object(), {"history_enabled": False}) + + async def query(address): + return { + "online": True, + "address": address, + "players_online": 5, + "players_max": 20, + "player_list": ["Alex"], + "source": "direct", + } + + plugin.api.query = query + event = Event(image_error=True) + await plugin.motd(event, "mc.example.com") + assert "Alex" in event.messages[-1][1] and "人数最低 5" in event.messages[-1][1] + assert not list(tmp_path.glob("card-*.png")) + success = Event() + await plugin.motd(success, "history", "mc.example.com") + assert success.messages[-1][0] == "image" + assert not list(tmp_path.glob("card-*.png")) + await plugin.terminate() + + +async def test_missing_default_invalid_and_private_setting(plugin_class): + plugin = plugin_class(object(), {"history_enabled": False}) + event = Event() + await plugin.motd(event) + assert "还没有设置" in event.messages[-1][1] + await plugin.motd(event, "https://bad") + assert "格式不正确" in event.messages[-1][1] + private = Event(group="", admin=True) + await plugin.motd(private, "set", "a.test") + assert "请在群内" in private.messages[-1][1] + await plugin.motd(event, "help") + assert "/mcstatus" in event.messages[-1][1] + await plugin.terminate() diff --git a/tests/test_render_address.py b/tests/test_render_address.py new file mode 100644 index 0000000..872f1ee --- /dev/null +++ b/tests/test_render_address.py @@ -0,0 +1,79 @@ +import io + +import pytest +from PIL import Image + +from services.address import normalize_address +from services.motd_card import history_segments, render_motd_card + + +@pytest.mark.parametrize( + "address", ["mc.example.com", "127.0.0.1:25565", "localhost", "[::1]:25565", "[2001:db8::1]"] +) +def test_valid_address(address): + assert normalize_address(" " + address.upper() + " ") == address + + +@pytest.mark.parametrize( + "address", + [ + "", + "https://a.test", + "a.test:0", + "a.test:65536", + "a.test:", + "../a", + "-a.test", + "a..test", + "[broken]:1", + "a.test:1", + "a.test;command", + ], +) +def test_invalid_address(address): + with pytest.raises(ValueError): + normalize_address(address) + + +def test_history_does_not_bridge_offline_errors_or_shutdown(): + points = [ + {"timestamp": stamp, "online": online, "players": players} + for stamp, online, players in [ + (100000, 1, 0), + (100300, 1, 2), + (100600, 0, None), + (100900, 1, 5), + (101200, None, None), + (101500, 1, 7), + (110000, 1, 10), + ] + ] + segments = history_segments(points, 110000, 300) + assert [[p["players"] for p in segment] for segment in segments] == [[0, 2], [5], [7], [10]] + + +@pytest.mark.parametrize( + "online,failed,history", + [ + (True, False, []), + (False, False, []), + (False, True, []), + (True, False, [{"timestamp": 100000, "online": 1, "players": 0}]), + ], +) +def test_card_handles_empty_history_offline_failure_and_zero(online, failed, history): + raw = render_motd_card( + { + "online": online, + "query_failed": failed, + "address": "mc.example.com", + "icon": "invalid-base64", + "motd": "中文标语 " * 100, + "players_online": 0, + "players_max": 0, + }, + history=history, + now=100000, + ) + image = Image.open(io.BytesIO(raw)) + assert image.format == "PNG" and image.size == (1200, 1080) diff --git a/tests/test_storage_monitor.py b/tests/test_storage_monitor.py new file mode 100644 index 0000000..1d0bf8a --- /dev/null +++ b/tests/test_storage_monitor.py @@ -0,0 +1,101 @@ +import asyncio + +from services.monitor import PlayerMonitor +from services.storage import MotdStore + + +async def test_binding_isolation_persistence_and_history_window(tmp_path): + path = tmp_path / "motd.db" + store = MotdStore(path) + await store.initialize() + await store.set_binding("bot-a:group-1", "one.test", "admin") + await store.set_binding("bot-b:group-1", "two.test", "admin") + await store.record( + "one.test", {"online": True, "players_online": 0, "source": "direct"}, 100000 + ) + await store.record("one.test", {"online": False}, 100300) + await store.record("one.test", None, 100600) + await store.record("one.test", {"online": True, "players_online": 9}, 1) + reloaded = MotdStore(path) + await reloaded.initialize() + assert await reloaded.get_binding("bot-a:group-1") == "one.test" + assert await reloaded.get_binding("bot-b:group-1") == "two.test" + assert [(p["online"], p["players"]) for p in await reloaded.history("one.test", 101000)] == [ + (1, 0), + (0, None), + (None, None), + ] + await reloaded.clear_binding("bot-a:group-1") + assert await reloaded.get_binding("bot-a:group-1") is None + assert await reloaded.get_binding("bot-b:group-1") == "two.test" + + +async def test_tracking_expiry_bindings_and_prune(tmp_path, monkeypatch): + monkeypatch.setattr("services.storage.time.time", lambda: 200000) + store = MotdStore(tmp_path / "motd.db") + await store.initialize() + await store.track("temporary.test") + await store.set_binding("a", "permanent.test", "admin") + assert set(await store.monitored_addresses(200001)) == {"temporary.test", "permanent.test"} + assert await store.monitored_addresses(286401) == ["permanent.test"] + await store.record("temporary.test", {"online": True, "players_online": 4}, 1) + await store.record("temporary.test", {"online": True, "players_online": 5}, 199999) + await store.prune(48) + assert len(await store.history("temporary.test", 200000)) == 1 + + +async def test_concurrent_queries_and_background_sampling(tmp_path): + class API: + calls = 0 + + async def query(self, address): + self.calls += 1 + await asyncio.sleep(0.02) + return {"online": True, "players_online": 3, "source": "direct"} + + store = MotdStore(tmp_path / "motd.db") + await store.initialize() + await store.set_binding("group-a", "same.test", "a") + await store.set_binding("group-b", "same.test", "a") + api = API() + monitor = PlayerMonitor(api, store, addresses=["extra.test"]) + result = await asyncio.gather(*(monitor.query("same.test") for _ in range(5))) + assert api.calls == 1 and all(p["players_online"] == 3 for p in result) + await monitor.sample_once() + assert api.calls == 2 # same.test cached, extra.test polled + assert len(await store.history("extra.test")) == 1 + monitor.start() + task = monitor._task + await monitor.close() + assert task.done() and not monitor._pending + + +async def test_api_exception_records_unknown_not_zero(tmp_path): + class API: + async def query(self, address): + raise OSError("network down") + + store = MotdStore(tmp_path / "motd.db") + await store.initialize() + monitor = PlayerMonitor(API(), store) + assert await monitor.query("a.test") is None + point = (await store.history("a.test"))[0] + assert point["players"] is None and point["online"] is None + + +async def test_cancellation_joins_inflight_queries(tmp_path): + started = asyncio.Event() + + class API: + async def query(self, address): + started.set() + await asyncio.Event().wait() + + store = MotdStore(tmp_path / "motd.db") + await store.initialize() + monitor = PlayerMonitor(API(), store) + request = asyncio.create_task(monitor.query("a.test")) + await started.wait() + await monitor.close() + results = await asyncio.gather(request, return_exceptions=True) + assert isinstance(results[0], asyncio.CancelledError) diff --git a/tools/package.py b/tools/package.py new file mode 100644 index 0000000..16e81de --- /dev/null +++ b/tools/package.py @@ -0,0 +1,35 @@ +"""Build an installable archive without local data, test stubs, or development downloads.""" + +from pathlib import Path +from zipfile import ZIP_DEFLATED, ZipFile + +ROOT = Path(__file__).resolve().parents[1] + + +def main(): + target = ROOT / "dist" / "astrbot_plugin_motd-v1.0.0.zip" + target.parent.mkdir(exist_ok=True) + files = ( + [ + ROOT / n + for n in ( + "__init__.py", + "main.py", + "metadata.yaml", + "_conf_schema.json", + "requirements.txt", + "README.md", + "LICENSE", + ) + ] + + sorted((ROOT / "services").glob("*.py")) + + sorted((ROOT / "assets").glob("*.png")) + ) + with ZipFile(target, "w", ZIP_DEFLATED) as archive: + for path in files: + archive.write(path, "astrbot_plugin_motd/" + path.relative_to(ROOT).as_posix()) + print(target) + + +if __name__ == "__main__": + main() diff --git a/tools/preview.py b/tools/preview.py new file mode 100644 index 0000000..dbc04f9 --- /dev/null +++ b/tools/preview.py @@ -0,0 +1,52 @@ +"""Render synthetic examples: generated data is never written to the plugin database.""" + +import math +import sys +import time +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +sys.path.insert(0, str(ROOT)) +from services.motd_card import render_motd_card + + +def main(): + now = int(time.time()) + history = [] + for i in range(289): + stamp = now - 86400 + i * 300 + players = max(0, int(45 + 25 * math.sin(i / 32) + 10 * math.sin(i / 7))) + history.append({"timestamp": stamp, "online": 1, "players": players, "source": "direct"}) + # Include a gap and downtime to verify broken curves. + history = [p for i, p in enumerate(history) if not 85 <= i < 100] + for point in history[165:175]: + point.update(online=0, players=None) + data = { + "online": True, + "address": "mc.example.com:25565", + "version": "1.21.1", + "motd": "欢迎来到栗子服务器!生存 · 建筑 · 冒险,和朋友一起探索方块世界", + "players_online": history[-1]["players"], + "players_max": 100, + "player_list": ["itxiaohui", "Steve", "Alex", "栗子玩家"], + "latency_ms": 32.6, + "software": "Paper", + "plugins": {"names": ["Example"]}, + "source": "direct", + } + folder = ROOT / "dist" / "previews" + folder.mkdir(parents=True, exist_ok=True) + examples = { + "24h": (data, history), + "first": (data, history[-1:]), + "offline": ({"online": False, "address": data["address"], "source": "api"}, history), + "failed": ({"online": False, "address": data["address"], "query_failed": True}, []), + } + for name, (status, points) in examples.items(): + path = folder / f"motd-{name}.png" + path.write_bytes(render_motd_card(status, "xiaohuicat · 演示数据", points, now)) + print(path) + + +if __name__ == "__main__": + main()