astrbot_plugin_button_gateway/keyboards.py
2026-08-03 16:32:48 +08:00

96 行
3.7 KiB
Python

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

"""Platform-specific keyboard payloads built from one platform-neutral button spec.
Callers describe buttons once; this module renders them for whichever platform the window
belongs to. The wire format for a click is always `bg:<action>:<ref>` — at most 59 bytes, which
clears Telegram's 64-byte callback_data limit (the tighter of the two) and QQ's 100.
"""
from __future__ import annotations
import re
from typing import Any
BUTTON_DATA_RE = re.compile(r"^bg:(?P<action>[a-z][a-z0-9_-]{0,15}):(?P<ref>g1\.[A-Za-z0-9_-]{12}\.[0-9a-f]{24})$")
# Telegram is the tighter limit; enforce it everywhere so a spec that works on one platform
# works on both.
MAX_DATA_BYTES = 64
def encode(action: str, ref: str) -> str:
data = f"bg:{action}:{ref}"
if len(data.encode("utf-8")) > MAX_DATA_BYTES:
raise ValueError(f"按钮数据超长({len(data.encode('utf-8'))} > {MAX_DATA_BYTES})")
return data
def decode(value: Any) -> tuple[str, str]:
match = BUTTON_DATA_RE.fullmatch(str(value or ""))
if not match:
raise ValueError("无法识别的按钮数据")
return match.group("action"), match.group("ref")
def build_qq_keyboard(
buttons: list[dict[str, Any]],
ref: str,
*,
allowed_user_id: str | None,
per_row: int = 2,
) -> dict[str, Any]:
"""action.type=1 keyboard (native Interaction callbacks).
permission.type=2 with specify_user_ids makes QQ itself reject clicks from anyone else, so
a forged click never reaches us. click_limit=1 matches the registry's single-use default.
"""
if not buttons:
raise ValueError("按钮列表不能为空")
permission: dict[str, Any] = {"type": 2, "specify_role_ids": [], "specify_user_ids": []}
if allowed_user_id:
permission["specify_user_ids"] = [str(allowed_user_id)]
else:
permission = {"type": 0} # anyone in the conversation
rows: list[dict[str, Any]] = []
for start in range(0, len(buttons), per_row):
row_buttons = []
for index, spec in enumerate(buttons[start:start + per_row], start=start):
action = str(spec["action"])
row_buttons.append({
"id": f"bg_{index}_{action}",
"render_data": {
"label": str(spec["label"])[:20],
"visited_label": str(spec.get("visited_label") or spec["label"])[:20],
"style": int(spec.get("style", 1)),
},
"action": {
"type": 1,
"permission": permission,
"click_limit": 1,
"data": encode(action, ref),
},
})
rows.append({"buttons": row_buttons})
return {"content": {"rows": rows}}
def build_qq_c2c_payload(text: str, keyboard: dict[str, Any]) -> dict[str, Any]:
"""QQ only renders a keyboard alongside markdown; msg_type=0 drops it *silently*."""
text = str(text or "").strip()
if not text or len(text) > 4000:
raise ValueError("markdown 文本无效")
if not keyboard.get("content", {}).get("rows"):
raise ValueError("keyboard 内容无效")
return {"msg_type": 2, "markdown": {"content": text}, "keyboard": keyboard}
def build_telegram_markup(buttons: list[dict[str, Any]], ref: str, *, per_row: int = 2):
"""Lazily imported so the gateway still loads when python-telegram-bot is absent."""
from telegram import InlineKeyboardButton, InlineKeyboardMarkup # noqa: PLC0415
rows = []
for start in range(0, len(buttons), per_row):
rows.append([
InlineKeyboardButton(str(spec["label"])[:30], callback_data=encode(str(spec["action"]), ref))
for spec in buttons[start:start + per_row]
])
return InlineKeyboardMarkup(rows)