Files

213 lines
7.9 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Deliver through the current adapter using a validated incoming reply context."""
import re
import time
from datetime import datetime
from html import escape
OFFICIAL = {"qq_official", "qq_official_webhook"}
class MentionDeliveryError(RuntimeError):
"""The app cannot send the Markdown format required by this delivery path."""
def markdown_unavailable(exc):
text = str(exc).lower()
return ("markdown" in text or "模板" in text) and any(
token in text
for token in (
"不允许",
"权限",
"无效",
"不合法",
"不存在",
"not allowed",
"permission",
"invalid",
)
)
def proactive_denied(exc):
text = str(exc).lower()
return any(
token in text
for token in ("主动消息失败", "无权限", "permission", "not allowed", "主动消息权限")
)
def incoming_reply(event):
"""Read an inbound message ID and its original timestamp, never a sent ID."""
raw = event.message_obj.raw_message
data = field(raw, "raw_data", raw)
msg_id = str(
field(raw, "id") or field(data, "id") or field(event.message_obj, "message_id", "") or ""
)
if not msg_id:
return None
timestamp = (
field(raw, "timestamp") or field(data, "timestamp") or field(event.message_obj, "timestamp")
)
try:
received_at = float(timestamp)
except (TypeError, ValueError):
try:
parsed = datetime.fromisoformat(str(timestamp).replace("Z", "+00:00"))
if parsed.tzinfo is None:
return None
received_at = parsed.timestamp()
except (TypeError, ValueError):
return None
return {"msg_id": msg_id, "received_at": min(received_at, time.time())}
def reply_unavailable(exc):
text = str(exc).lower()
return any(
token in text
for token in (
"22009",
"msg limit exceed",
"msg_id",
"msg id",
"msg_seq",
"message expired",
"message is expired",
"消息过期",
"消息已过期",
"被动消息",
"回复超",
"超频",
"无权限",
"permission",
"主动消息失败",
)
)
def field(value, name, default=None):
return value.get(name, default) if isinstance(value, dict) else getattr(value, name, default)
def route(event):
group = str(event.get_group_id() or "")
raw = event.message_obj.raw_message
data = field(raw, "raw_data", raw)
if event.get_platform_name() in OFFICIAL:
if field(raw, "group_openid") or field(data, "group_openid"):
return "group", str(field(raw, "group_openid") or field(data, "group_openid"))
if field(raw, "channel_id") or field(data, "channel_id"):
# Guild DMs need a separate guild ID, not the user's OpenID.
if not group:
return "guild_dm", str(field(raw, "guild_id") or field(data, "guild_id") or "")
return "channel", str(field(raw, "channel_id") or field(data, "channel_id"))
if not group:
return "c2c", str(event.get_sender_id())
raise ValueError("无法识别官方 QQ 群消息来源,请检查 AstrBot 适配器版本。")
return ("group", group) if group else ("private", str(event.get_sender_id()))
def find_platform(context, platform_id):
manager = context.platform_manager
return next((p for p in manager.platform_insts if str(p.meta().id) == platform_id), None)
def available(platform):
if platform is None:
return False
status = field(field(platform, "status"), "value", "running")
# An absent/starting/disconnected platform does not count as a failed delivery.
return str(status).lower() == "running"
def reminder_text(rem):
# AstrBot may use an OpenID as the display-name fallback. Keep IDs out of prose.
creator = rem["creator_name"]
if not creator or creator == rem["creator_id"]:
creator = "群成员" if rem["scene"] in {"group", "channel"} else "用户"
prefix = f"来自 {creator} 的提醒:\n" if rem["target_id"] != rem["creator_id"] else ""
return f"{prefix}⏰ {rem['content']}\n(提醒 #{rem['id']})"
def official_mention(user_id):
"""QQ native mention token; do not replace it with visible @OpenID text."""
return f'<qqbot-at-user id="{escape(str(user_id), quote=True)}" />'
def reminder_markdown(rem):
# Keep the mention outside user-provided text/code blocks. Preserve reminder
# text literally instead of interpreting formatting delimiters as Markdown.
# QQ exposes unnecessary backslashes before ordinary parentheses and the
# inline reminder number, so do not escape every CommonMark punctuation mark.
text = escape(reminder_text(rem), quote=False)
text = re.sub(r"([\\`*_{}\[\]|~])", r"\\\1", text)
return official_mention(rem["target_id"]) + "\n\n" + text.replace("\n", "\n\n")
async def deliver(
platform, rem, reply=None, *, markdown_template_id="", markdown_parameter="content"
):
"""Official SDK return value must contain a message ID to count as sent."""
client = platform.get_client()
text = reminder_text(rem)
if rem["platform_name"] in OFFICIAL:
api = client.api
scene = rem["scene"]
kwargs = dict(reply or {})
if scene not in {"group", "c2c"}:
kwargs.pop("msg_seq", None)
if scene == "group":
body = reminder_markdown(rem)
markdown = (
{
"custom_template_id": markdown_template_id,
"params": [{"key": markdown_parameter, "values": [body]}],
}
if markdown_template_id
else {"content": body}
)
try:
result = await api.post_group_message(
group_openid=rem["destination"], msg_type=2, markdown=markdown, **kwargs
)
except Exception as exc:
if markdown_unavailable(exc):
raise MentionDeliveryError(
"QQ 拒绝 Markdown @ 消息,请开通原生 Markdown,或配置已获批的 "
"official_markdown_template_id / official_markdown_parameter;"
f"原始错误:{exc}"
) from exc
raise
elif scene == "c2c":
result = await api.post_c2c_message(
openid=rem["destination"], msg_type=0, content=text, **kwargs
)
elif scene == "channel":
result = await api.post_message(
channel_id=rem["destination"],
content=f"{official_mention(rem['target_id'])}\n{text}",
**kwargs,
)
elif scene == "guild_dm":
result = await api.post_dms(guild_id=rem["destination"], content=text, **kwargs)
else:
raise ValueError(f"未知官方 QQ 投递场景:{scene}")
if not field(result, "id"):
raise RuntimeError(
"QQ 官方发送接口未返回消息 ID,请检查主动消息权限、额度和适配器版本。"
)
return
# Preserve old OneBot behavior, including a real @ and member validation.
if rem["platform_name"] == "aiocqhttp":
message = [{"type": "text", "data": {"text": text}}]
if rem["scene"] == "group":
message.insert(0, {"type": "at", "data": {"qq": rem["target_id"]}})
result = await client.send_group_msg(group_id=int(rem["destination"]), message=message)
else:
result = await client.send_private_msg(user_id=int(rem["destination"]), message=message)
if not field(result, "message_id"):
raise RuntimeError("OneBot 发送接口未返回消息 ID。")
return
raise ValueError(f"不支持的提醒平台:{rem['platform_name']}")