96 行
3.7 KiB
Python
96 行
3.7 KiB
Python
"""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)
|