nonebot-plugin-lingchu-bot 0.7.0.dev1__tar.gz → 0.8.0.dev1__tar.gz

{nonebot_plugin_lingchu_bot-0.7.0.dev1 → nonebot_plugin_lingchu_bot-0.8.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-lingchu-bot
-Version: 0.7.0.dev1
+Version: 0.8.0.dev1
 Summary: 由NoneBot2驱动，面向多平台的管理机器人
 Keywords: nonebot2,nonebot,bot,cross-platform,group-management
 Author: xinvxueyuan
@@ -36,7 +36,6 @@ Requires-Dist: aiofiles>=25.1.0
 Requires-Dist: babel>=2.18.0
 Requires-Dist: rtoml>=0.13.0
 Requires-Dist: packaging>=26.2
-Requires-Dist: nonebot-adapter-telegram>=0.1.0b20
 Requires-Dist: nonebot-plugin-docs>=2.5.0 ; extra == 'docs'
 Requires-Dist: nonebot-plugin-htmlkit>=0.1.0rc5 ; extra == 'webui'
 Requires-Dist: jinja2>=3.1.6 ; extra == 'webui'
@@ -100,7 +99,7 @@ Useful entry points:
 | Capability | Description |
 | --- | --- |
 | Member moderation | Mute, unmute, kick, block, unblock, clear blocklist, protect, and unprotect. |
-| Speech management | Member mute/unmute, whole-group mute/unmute, and recent message recall. |
+| Speech management | Member mute/unmute, whole-group mute/unmute, bulk unmute of all muted members and a muted-member list when the protocol implementation supports it, and recent message recall. |
 | Group operations | Set group name, set group avatar when supported, set member card/title/admin, send announcements when supported, and leave the current group. |
 | Remote management | Operate on another group by group ID or fuzzy group name matching, including remote mute/unmute, whole-group mute/unmute, kick, block/unblock, and announcement. |
 | Bot control | `silence` / `speak` suppress or resume response messages while still allowing commands to execute; `boot` / `shutdown` enable or disable command handlers. |

{nonebot_plugin_lingchu_bot-0.7.0.dev1 → nonebot_plugin_lingchu_bot-0.8.0.dev1}/README.md

@@ -47,7 +47,7 @@ Useful entry points:
 | Capability | Description |
 | --- | --- |
 | Member moderation | Mute, unmute, kick, block, unblock, clear blocklist, protect, and unprotect. |
-| Speech management | Member mute/unmute, whole-group mute/unmute, and recent message recall. |
+| Speech management | Member mute/unmute, whole-group mute/unmute, bulk unmute of all muted members and a muted-member list when the protocol implementation supports it, and recent message recall. |
 | Group operations | Set group name, set group avatar when supported, set member card/title/admin, send announcements when supported, and leave the current group. |
 | Remote management | Operate on another group by group ID or fuzzy group name matching, including remote mute/unmute, whole-group mute/unmute, kick, block/unblock, and announcement. |
 | Bot control | `silence` / `speak` suppress or resume response messages while still allowing commands to execute; `boot` / `shutdown` enable or disable command handlers. |

{nonebot_plugin_lingchu_bot-0.7.0.dev1 → nonebot_plugin_lingchu_bot-0.8.0.dev1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-lingchu-bot"
-version = "0.7.0.dev1"
+version = "0.8.0.dev1"
 description = "由NoneBot2驱动，面向多平台的管理机器人"
 keywords = [
     "nonebot2",
@@ -47,7 +47,6 @@ dependencies = [
     "babel>=2.18.0",
     "rtoml>=0.13.0",
     "packaging>=26.2",
-    "nonebot-adapter-telegram>=0.1.0b20",
 ]
 
 [[project.authors]]
@@ -91,10 +90,6 @@ plugin_dirs = ["src/plugins"]
 name = "OneBot V11"
 module_name = "nonebot.adapters.onebot.v11"
 
-[[tool.nonebot.adapters.nonebot-adapter-telegram]]
-name = "Telegram"
-module_name = "nonebot.adapters.telegram"
-
 [tool.nonebot.plugins]
 nonebot-plugin-apscheduler = ["nonebot_plugin_apscheduler"]
 nonebot-plugin-localstore = ["nonebot_plugin_localstore"]
@@ -239,6 +234,8 @@ allowed-confusables = [
     "E501",
     "F541",
     "TRY003",
+    "PLR0911",
+    "PLR0912",
 ]
 "src/plugins/nonebot_plugin_lingchu_bot/handle/**/adapters/onebot11/default/**.py" = [
     "E402",
@@ -248,13 +245,6 @@ allowed-confusables = [
     "TC001",
     "TC002",
 ]
-"src/plugins/nonebot_plugin_lingchu_bot/handle/telegram/adapters/default/**.py" = [
-    "E402",
-    "PLR0913",
-    "PLR0917",
-    "TC001",
-    "TC002",
-]
 "src/plugins/nonebot_plugin_lingchu_bot/hooks/handlers/message_store.py" = [
     "TC002",
     "BLE001",
@@ -319,6 +309,7 @@ allowed-confusables = [
     "TRY003",
     "E402",
 ]
+"src/plugins/nonebot_plugin_lingchu_bot/database/schema_guard.py" = ["E402"]
 "src/plugins/nonebot_plugin_lingchu_bot/database/toml_store/_helpers.py" = ["TRY003"]
 "src/plugins/nonebot_plugin_lingchu_bot/core/bot_state.py" = [
     "BLE001",
@@ -326,6 +317,17 @@ allowed-confusables = [
     "TC003",
 ]
 "src/plugins/nonebot_plugin_lingchu_bot/services/protocol_restart_feedback.py" = ["BLE001"]
+"src/plugins/nonebot_plugin_lingchu_bot/services/restart_app.py" = [
+    "BLE001",
+    "C901",
+    "PLR0911",
+    "PLR0913",
+    "TC002",
+]
+"src/plugins/nonebot_plugin_lingchu_bot/restart_worker.py" = [
+    "T201",
+    "TRY003",
+]
 "src/plugins/nonebot_plugin_lingchu_bot/start/startup.py" = [
     "BLE001",
     "E402",
@@ -369,6 +371,11 @@ allowed-confusables = [
     "TRY003",
     "PLR0913",
 ]
+"src/plugins/nonebot_plugin_lingchu_bot/services/webui/**.py" = [
+    "TC002",
+    "BLE001",
+    "PLR2004",
+]
 "src/plugins/nonebot_plugin_lingchu_bot/database/orm_crud/_single.py" = [
     "E402",
     "TRY003",

{nonebot_plugin_lingchu_bot-0.7.0.dev1 → nonebot_plugin_lingchu_bot-0.8.0.dev1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-lingchu-bot"
-version = "0.7.0.dev1"
+version = "0.8.0.dev1"
 # dynamic = ["version"]
 description = "由NoneBot2驱动，面向多平台的管理机器人"
 keywords = ["nonebot2", "nonebot", "bot", "cross-platform", "group-management"]
@@ -44,7 +44,6 @@ dependencies = [
     "babel>=2.18.0",
     "rtoml>=0.13.0",
     "packaging>=26.2",
-    "nonebot-adapter-telegram>=0.1.0b20",
 ]
 
 [project.optional-dependencies]
@@ -114,7 +113,6 @@ nonebot-adapter-onebot = [
     { name = "OneBot V11", module_name = "nonebot.adapters.onebot.v11" },
 ]
 "@local" = []
-nonebot-adapter-telegram = [{name = "Telegram", module_name = "nonebot.adapters.telegram"}]
 
 [tool.nonebot.plugins]
 nonebot-plugin-apscheduler = ["nonebot_plugin_apscheduler"]
@@ -260,6 +258,11 @@ allowed-confusables = [
     "E501",    # line-too-long
     "F541",    # f-string-without-placeholders
     "TRY003",  # raise-vanilla-args: CI scripts use SystemExit with inline messages
+    # ci_version_bump_args.py: the uv-semantics decision table is inherently a
+    # branch matrix (stable/pre/dev/alpha/beta/rc x level x prerelease); each
+    # branch is a single return, so the return/branch counts are structural.
+    "PLR0911", # too-many-return-statements
+    "PLR0912", # too-many-branches
 ]
 # handle handlers may have complex logic with many return paths and NoneBot-mandated parameters
 # E402: nonebot2 require() must precede cross-plugin imports at module level
@@ -271,14 +274,6 @@ allowed-confusables = [
     "TC001",    # typing-only-first-party-import (NoneBot evaluates type hints at runtime)
     "TC002",    # typing-only-third-party-import (Bot/Event imports needed by get_type_hints())
 ]
-# Telegram handlers use the same NoneBot runtime annotation and DI contract.
-"src/plugins/nonebot_plugin_lingchu_bot/handle/telegram/adapters/default/**.py" = [
-    "E402",     # module-import-not-at-top-of-file (nonebot2 require() pattern)
-    "PLR0913",  # too-many-arguments (NoneBot handler + Telegram API signatures)
-    "PLR0917",  # too-many-positional-arguments (NoneBot DI injection contract)
-    "TC001",    # typing-only-first-party-import (NoneBot evaluates annotations)
-    "TC002",    # typing-only-third-party-import (NoneBot evaluates annotations)
-]
 # TC001/TC002/TC003: NoneBot evaluates forward references at hook registration time;
 # these runtime imports must not be hidden behind TYPE_CHECKING.
 # Additionally, with future-annotations = true in ruff config, TC rules suggest moving
@@ -332,12 +327,28 @@ allowed-confusables = [
 "src/plugins/nonebot_plugin_lingchu_bot/core/handle_config_manager.py" = ["TRY003", "BLE001", "E402"]
 "src/plugins/nonebot_plugin_lingchu_bot/core/handle_config_defaults/__init__.py" = ["TRY003", "E402"]
 "src/plugins/nonebot_plugin_lingchu_bot/database/orm_crud/_base.py" = ["TRY003", "E402"]
+# E402: nonebot2 require() must precede cross-plugin imports at module level
+"src/plugins/nonebot_plugin_lingchu_bot/database/schema_guard.py" = ["E402"]
 "src/plugins/nonebot_plugin_lingchu_bot/database/toml_store/_helpers.py" = ["TRY003"]
 
 # BLE001: startup/probe code uses intentional fail-closed/fail-soft exception handling
 # E402: nonebot2 require() must precede cross-plugin imports at module level
 "src/plugins/nonebot_plugin_lingchu_bot/core/bot_state.py" = ["BLE001", "E402", "TC003"]
 "src/plugins/nonebot_plugin_lingchu_bot/services/protocol_restart_feedback.py" = ["BLE001"]
+# BLE001: fail-soft notification/send paths must never break event dispatch.
+# C901/PLR0911: adapter event type dispatch branches per platform event class.
+# PLR0913: register_pending_restart_app signature is a cross-task contract.
+# TC002: NoneBot inspects Bot/Event handler annotations at runtime via get_type_hints().
+"src/plugins/nonebot_plugin_lingchu_bot/services/restart_app.py" = [
+    "BLE001",
+    "C901",
+    "PLR0911",
+    "PLR0913",
+    "TC002",
+]
+# T201: standalone restart worker script prints diagnostics to stderr.
+# TRY003: vanilla raise messages are intentional for a self-contained script.
+"src/plugins/nonebot_plugin_lingchu_bot/restart_worker.py" = ["T201", "TRY003"]
 # E402: nonebot2 require() must precede cross-plugin imports at module level
 "src/plugins/nonebot_plugin_lingchu_bot/start/startup.py" = ["BLE001", "E402"]
 "src/plugins/nonebot_plugin_lingchu_bot/platforms/qq/permissions.py" = ["BLE001"]
@@ -383,6 +394,14 @@ allowed-confusables = [
     "TRY003",  # vanilla exceptions for CRUD validation
     "PLR0913",  # parameter-heavy generic CRUD functions
 ]
+# TC002: Starlette Request is evaluated at runtime in endpoint annotations.
+# BLE001: fail-soft upstream/JSON handling must never break request dispatch.
+# PLR2004: QQ id length bounds (4-15) are domain constants kept inline.
+"src/plugins/nonebot_plugin_lingchu_bot/services/webui/**.py" = [
+    "TC002",
+    "BLE001",
+    "PLR2004",
+]
 "src/plugins/nonebot_plugin_lingchu_bot/database/orm_crud/_single.py" = [
     "E402",     # module-import-not-at-top-of-file (nonebot2 require() pattern)
     "TRY003",  # vanilla exceptions for CRUD validation

{nonebot_plugin_lingchu_bot-0.7.0.dev1 → nonebot_plugin_lingchu_bot-0.8.0.dev1}/src/plugins/nonebot_plugin_lingchu_bot/__init__.py

@@ -60,6 +60,10 @@ from .start.startup import startup as startup
 # services.message_store and start.startup.
 from . import hooks as hooks
 
+# WebUI 动态运行时端点（只读 + 登录密码校验，无登录/JWT/令牌功能）。
+# 导入即触发 on_startup 挂载逻辑。
+from .services import webui as webui
+
 # zhenxun 等宿主环境同时注册 150+ 插件的 Alconna 命令，默认上限 200 会被突破。
 # 在 lingchu 自身命令注册前抬高全局上限，避免 ExceedMaxCount。
 from arclet.alconna.config import config as _alconna_config

{nonebot_plugin_lingchu_bot-0.7.0.dev1 → nonebot_plugin_lingchu_bot-0.8.0.dev1}/src/plugins/nonebot_plugin_lingchu_bot/core/config.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 from collections.abc import Mapping
 from dataclasses import dataclass, field, fields
+import os
 from pathlib import Path
 import platform
 from typing import Any, Final, Literal, cast
@@ -114,6 +115,7 @@ class Config(DeploymentSettings):
         data_dir: 数据存储目录路径。
         config_dir: 配置文件存储目录路径。
         cache_dir: 缓存文件存储目录路径。
+        lingchu_webui_password: WebUI 只读端点的简易字符串密码（默认空，空则不鉴权）。
         superuser_key: 运行时超级用户密钥。
         message_store_enabled: 是否启用消息存储。
         lingchu_superusers: 结构化超级用户平台账号绑定。
@@ -121,11 +123,12 @@ class Config(DeploymentSettings):
 
     """
 
-    core_version: str = "0.7.0.dev1"
+    core_version: str = "0.8.0.dev1"
     data_dir: Path = field(default_factory=get_plugin_data_dir)
     config_dir: Path = field(default_factory=get_plugin_config_dir)
     cache_dir: Path = field(default_factory=get_plugin_cache_dir)
     in_containers: bool = False
+    lingchu_webui_password: str = ""
 
     @classmethod
     def from_nonebot(cls) -> Config:
@@ -163,6 +166,17 @@ class Config(DeploymentSettings):
             config_dir=get_plugin_config_dir(),
             cache_dir=get_plugin_cache_dir(),
             in_containers=in_containers,
+            # .env 的 LINGCHU_WEBUI_PASSWORD 可能被解析为 int（如 123456），
+            # 与字段声明 str 不符，统一强转为 str 供 hmac.compare_digest 使用。
+            lingchu_webui_password=str(
+                values.get(
+                    "LINGCHU_WEBUI_PASSWORD",
+                    values.get(
+                        "lingchu_webui_password",
+                        os.environ.get("LINGCHU_WEBUI_PASSWORD", ""),
+                    ),
+                )
+            ),
         )
 
     # --- 平台检测 Properties ---

{nonebot_plugin_lingchu_bot-0.7.0.dev1 → nonebot_plugin_lingchu_bot-0.8.0.dev1}/src/plugins/nonebot_plugin_lingchu_bot/database/orm_crud/_base.py

@@ -10,6 +10,7 @@ from nonebot import require
 
 require("nonebot_plugin_orm")
 from nonebot_plugin_orm import Model
+from sqlalchemy import Table, UniqueConstraint
 from sqlalchemy.exc import IntegrityError, SQLAlchemyError
 from sqlalchemy.inspection import inspect
 
@@ -141,6 +142,65 @@ def _orders[T: Model](
     return o
 
 
+def declared_unique_targets[T: Model](model: type[T]) -> set[frozenset[str]]:
+    """返回模型声明的**非主键**唯一目标（唯一约束 / 唯一索引）。
+
+    用于 upsert 冲突目标校验与数据库模式自检：SQLite 的 ``ON CONFLICT`` 必须与某个
+    唯一索引逐列精确匹配；主键不含在内，因为 SQLite 的 ``INTEGER PRIMARY KEY`` 是
+    rowid 别名，不会出现在 ``PRAGMA index_list`` 里，纳入会产生假告警。
+
+    Args:
+        model: ORM 模型类 / ORM model class.
+
+    Returns:
+        每个唯一目标的列名集合；无法内省（如测试用抽象模型）时为空集合。
+    """
+    try:
+        table = inspect(model).local_table
+    except (AttributeError, SQLAlchemyError, TypeError):
+        logger.debug(
+            "Cannot inspect unique targets for model %s; skipping",
+            model.__name__,
+        )
+        return set()
+    if not isinstance(table, Table):
+        logger.debug(
+            "Model %s has no local Table; skipping unique target inspection",
+            model.__name__,
+        )
+        return set()
+
+    targets: set[frozenset[str]] = set()
+    try:
+        for constraint in table.constraints:
+            if isinstance(constraint, UniqueConstraint):
+                columns = frozenset(column.name for column in constraint.columns)
+                if columns:
+                    targets.add(columns)
+        for index in table.indexes:
+            if index.unique:
+                columns = frozenset(column.name for column in index.columns)
+                if columns:
+                    targets.add(columns)
+    except (AttributeError, SQLAlchemyError, TypeError):
+        return set()
+    return targets
+
+
+def primary_key_columns[T: Model](model: type[T]) -> frozenset[str]:
+    """返回模型主键列名集合（无法内省时为空集合）。"""
+    try:
+        table = inspect(model).local_table
+    except (AttributeError, SQLAlchemyError, TypeError):
+        return frozenset()
+    if not isinstance(table, Table):
+        return frozenset()
+    try:
+        return frozenset(column.name for column in table.primary_key.columns)
+    except (AttributeError, SQLAlchemyError, TypeError):
+        return frozenset()
+
+
 def _get_column_map[T: Model](model: type[T]) -> dict[str, Any]:
     """获取模型可用的数据库列映射。
 

{nonebot_plugin_lingchu_bot-0.7.0.dev1 → nonebot_plugin_lingchu_bot-0.8.0.dev1}/src/plugins/nonebot_plugin_lingchu_bot/database/orm_crud/_bulk.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 from collections.abc import Awaitable, Callable, Sequence
 from dataclasses import dataclass
+from functools import cache
 from typing import TYPE_CHECKING, Any
 
 from nonebot import require
@@ -23,7 +24,9 @@ from ._base import (
     _get_session_dialect_name,
     _orders,
     _validate_column_values,
+    declared_unique_targets,
     logger,
+    primary_key_columns,
 )
 
 if TYPE_CHECKING:
@@ -120,6 +123,16 @@ async def bulk_create[T: Model](
     return created, failed
 
 
+@cache
+def _cached_unique_targets(model: type[Model]) -> frozenset[frozenset[str]]:
+    """缓存模型声明的唯一冲突目标（主键 + 唯一约束/索引），避免热路径重复内省。"""
+    targets = set(declared_unique_targets(model))
+    primary_key = primary_key_columns(model)
+    if primary_key:
+        targets.add(primary_key)
+    return frozenset(targets)
+
+
 def _validate_upsert_conflict_target[T: Model](
     model: type[T],
     columns: dict[str, Any],
@@ -136,6 +149,17 @@ def _validate_upsert_conflict_target[T: Model](
     for key in conflict_keys:
         if key not in columns:
             raise ValueError(f"Unknown column '{key}' for model '{model.__name__}'")
+
+    targets = _cached_unique_targets(model)
+    if conflict_keys and targets and frozenset(conflict_keys) not in targets:
+        declared = "; ".join(
+            ",".join(sorted(target)) for target in sorted(targets, key=sorted)
+        )
+        raise ValueError(
+            f"Upsert conflict target {tuple(conflict_keys)} does not match any "
+            f"unique constraint, unique index or primary key declared on "
+            f"'{model.__name__}' (declared: {declared})"
+        )
     return conflict_keys
 
 

nonebot_plugin_lingchu_bot-0.8.0.dev1/src/plugins/nonebot_plugin_lingchu_bot/database/schema_guard.py

@@ -0,0 +1,155 @@
+"""数据库模式自检：比对模型声明的唯一目标与数据库实际的唯一索引。
+
+为什么不依赖迁移就够了：生产库的表可能是早期 ``create_all`` 建的（或由外部工具改过），
+而 ``create_all`` **不会**修改既有表结构；``ALEMBIC_STARTUP_CHECK=false`` 时 ORM 走
+``migrate.sync``（alembic autogenerate 同步），在 SQLite 上识别唯一约束差异并不可靠。
+
+一旦唯一索引与模型声明不一致，SQLite 的 ``ON CONFLICT`` 会在运行期报
+``ON CONFLICT clause does not match any PRIMARY KEY or UNIQUE constraint``，在业务层
+表现为「xxx失败，数据库异常: DatabaseError('Upsert failed')」。本模块在启动时**只读**
+检查并输出告警，让这种漂移在日志里第一时间可见，且绝不阻断启动。
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from nonebot import logger, require
+
+require("nonebot_plugin_orm")
+from nonebot_plugin_orm import Model, get_session
+from sqlalchemy import inspect
+from sqlalchemy.exc import SQLAlchemyError
+
+from . import models as models_module
+from .orm_crud._base import declared_unique_targets
+
+if TYPE_CHECKING:
+    from collections.abc import Iterable
+
+    from sqlalchemy.ext.asyncio import AsyncConnection
+
+#: 唯一目标集合的类型别名（表名 → 该表所有唯一目标的列名集合）。
+UniqueTargets = dict[str, set[frozenset[str]]]
+
+
+def collect_declared_unique_targets() -> UniqueTargets:
+    """收集本插件全部模型声明的**非主键**唯一目标。
+
+    Returns:
+        表名到唯一目标集合的映射；没有声明唯一目标的模型不会出现在结果里。
+    """
+    declared: UniqueTargets = {}
+    for name in getattr(models_module, "__all__", ()):
+        model = getattr(models_module, name, None)
+        if not isinstance(model, type) or not issubclass(model, Model):
+            continue
+        table_name = getattr(model, "__tablename__", None)
+        if not isinstance(table_name, str):
+            continue
+        targets = declared_unique_targets(model)
+        if targets:
+            declared.setdefault(table_name, set()).update(targets)
+    return declared
+
+
+def _inspector_unique_targets(inspector: Any, table: str) -> set[frozenset[str]] | None:
+    """用 inspector 读取唯一约束 / 唯一索引；读取失败时返回 None。"""
+    found: set[frozenset[str]] = set()
+    try:
+        for constraint in inspector.get_unique_constraints(table):
+            columns = constraint.get("column_names") or []
+            if columns:
+                found.add(frozenset(columns))
+        for index in inspector.get_indexes(table):
+            if index.get("unique"):
+                columns = index.get("column_names") or []
+                if columns:
+                    found.add(frozenset(columns))
+    except (SQLAlchemyError, NotImplementedError):
+        logger.debug("Inspector cannot read unique targets for table {}", table)
+        return None
+    return found
+
+
+def read_actual_unique_targets(
+    connection: AsyncConnection | Any, tables: Iterable[str]
+) -> UniqueTargets:
+    """读取数据库里各表的实际唯一目标（同步函数，供 ``run_sync`` 调用）。
+
+    Args:
+        connection: 同步连接（``AsyncConnection.run_sync`` 会传入）。
+        tables: 待检查的表名。
+
+    Returns:
+        表名到实际唯一目标集合的映射；表不存在或无法读取时为**空集合**（表示未知）。
+    """
+    inspector = inspect(connection)
+    if inspector is None:  # pragma: no cover - 防御性分支，非 Connection 才可能为 None
+        logger.debug("Inspector unavailable; skipping schema drift inspection")
+        return {table: set() for table in tables}
+    existing = set(inspector.get_table_names())
+    actual: UniqueTargets = {}
+    for table in tables:
+        if table not in existing:
+            actual[table] = set()
+            continue
+        found = _inspector_unique_targets(inspector, table)
+        if found is None:
+            actual[table] = set()
+            continue
+        actual[table] = found
+    return actual
+
+
+def schema_drift_report(declared: UniqueTargets, actual: UniqueTargets) -> list[str]:
+    """比对声明与实际，返回不一致的说明列表（纯函数，便于测试）。
+
+    只在「模型声明了某唯一目标、但数据库里读不到」时报告；数据库里多出来的唯一索引
+    不影响 upsert，故不计入。
+    """
+    lines: list[str] = []
+    for table in sorted(declared):
+        present = actual.get(table)
+        if present is None:
+            continue
+        lines.extend(
+            f"{table}: 模型声明的唯一目标 ({','.join(sorted(target))}) 在数据库中不存在"
+            for target in sorted(declared[table] - present, key=sorted)
+        )
+    return lines
+
+
+async def find_schema_drift() -> list[str]:
+    """只读检查数据库模式与模型声明的差异。
+
+    Returns:
+        差异说明列表；无差异或无法检查时为空列表（本函数不抛异常）。
+    """
+    declared = collect_declared_unique_targets()
+    if not declared:
+        return []
+    try:
+        async with get_session() as session:
+            connection = await session.connection()
+            actual = await connection.run_sync(
+                read_actual_unique_targets, tuple(declared)
+            )
+    except (SQLAlchemyError, AttributeError, TypeError) as exc:
+        logger.debug("Schema drift check skipped: {}", exc)
+        return []
+    return schema_drift_report(declared, actual)
+
+
+async def log_schema_drift() -> None:
+    """启动时只读自检：发现漂移只告警，绝不阻断启动。"""
+    try:
+        drift = await find_schema_drift()
+    except Exception as exc:  # noqa: BLE001 - 自检不得影响启动流程
+        logger.debug("Schema drift check failed: {}", exc)
+        return
+    if not drift:
+        return
+    logger.warning("数据库模式与模型声明不一致（{} 处）:", len(drift))
+    for line in drift:
+        logger.warning("  - {}", line)

{nonebot_plugin_lingchu_bot-0.7.0.dev1 → nonebot_plugin_lingchu_bot-0.8.0.dev1}/src/plugins/nonebot_plugin_lingchu_bot/handle/menu.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from dataclasses import dataclass, replace
+from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any, Final
 
 from arclet.alconna import Alconna
@@ -14,7 +14,6 @@ from ..core.mutable_settings import get_mutable_settings
 from ..i18n import get_configured_locale, gettext, normalize_locale
 from ..platforms import (
     QQ_CAPABILITIES,
-    TELEGRAM_CAPABILITIES,
     PlatformCapability,
 )
 from .qq.commands.triggers import COMMAND_TRIGGERS
@@ -25,8 +24,6 @@ if TYPE_CHECKING:
 _MENU = COMMAND_TRIGGERS["menu"]
 QQ_PLATFORM_ID: Final = "qq"
 ONEBOT_V11_ADAPTER_ID: Final = "~onebot.v11"
-TELEGRAM_PLATFORM_ID: Final = "telegram"
-TELEGRAM_ADAPTER_ID: Final = "~telegram"
 NAPCAT_IMPL: Final = "NapCat.Onebot"
 
 menu_cmd: type[AlconnaMatcher] = on_alconna(
@@ -34,7 +31,7 @@ menu_cmd: type[AlconnaMatcher] = on_alconna(
     aliases=_MENU.aliases,
     priority=805,
     block=True,
-    use_cmd_sep=True,
+    use_cmd_sep=False,
     use_cmd_start=True,
 )
 
@@ -181,7 +178,7 @@ menu_page_cmds: Final[dict[str, type[AlconnaMatcher]]] = {
         command=Alconna(_menu_page_command(page)),
         priority=805,
         block=True,
-        use_cmd_sep=True,
+        use_cmd_sep=False,
         use_cmd_start=True,
     )
     for page in _page_commands_from_pages(_DEFAULT_MENU_PAGES)
@@ -594,37 +591,7 @@ _BASE_MENU_FEATURES: Final[tuple[MenuFeature, ...]] = (
     ),
 )
 
-_TELEGRAM_COMMAND_KEYS: Final = frozenset({
-    "block_member",
-    "bot_boot",
-    "bot_shutdown",
-    "bot_silence",
-    "bot_speak",
-    "kick_member",
-    "leave_group",
-    "member_mute",
-    "member_unmute",
-    "recall_message",
-    "set_group_name",
-    "set_member_admin",
-    "unblock_member",
-    "unset_member_admin",
-    "whole_mute",
-    "whole_unmute",
-})
-_TELEGRAM_AVAILABILITY: Final = MenuAvailability(
-    TELEGRAM_PLATFORM_ID,
-    TELEGRAM_ADAPTER_ID,
-)
-_DEFAULT_MENU_FEATURES: Final = tuple(
-    replace(
-        feature,
-        availability=(*feature.availability, _TELEGRAM_AVAILABILITY),
-    )
-    if feature.command_key in _TELEGRAM_COMMAND_KEYS
-    else feature
-    for feature in _BASE_MENU_FEATURES
-)
+_DEFAULT_MENU_FEATURES: Final = _BASE_MENU_FEATURES
 MENU_FEATURES: tuple[MenuFeature, ...] = _DEFAULT_MENU_FEATURES
 
 
@@ -747,14 +714,6 @@ def qq_menu_context(
     )
 
 
-def telegram_menu_context() -> MenuRuntimeContext:
-    return MenuRuntimeContext(
-        platform_id=TELEGRAM_PLATFORM_ID,
-        adapter_id=TELEGRAM_ADAPTER_ID,
-        platform_capabilities=TELEGRAM_CAPABILITIES,
-    )
-
-
 def _render_section(
     section: MenuSection,
     context: MenuRuntimeContext,