Initial release of AstrBot reminder plugin

This commit is contained in:
itxiaohui committed 2026-10-05 19:22:07 +08:00
commit cf10c43e61
20 files changed
+1692

No files matched your search

+87
View File
@@ -0,0 +1,87 @@
"""Deliver through the current adapter; never persist a live event or old msg_id."""
from html import escape
OFFICIAL = {"qq_official", "qq_official_webhook"}
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):
creator = rem["creator_name"] or rem["creator_id"]
prefix = f"来自 {creator} 的提醒:\n" if rem["target_id"] != rem["creator_id"] else ""
return f"{prefix}⏰ {rem['content']}\n(提醒 #{rem['id']})"
async def deliver(platform, rem):
"""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"]
if scene == "group":
mention = f'<qqbot-at-user id="{escape(rem["target_id"], quote=True)}" />'
result = await api.post_group_message(
group_openid=rem["destination"], msg_type=0, content=f"{mention}\n{text}"
)
elif scene == "c2c":
result = await api.post_c2c_message(openid=rem["destination"], msg_type=0, content=text)
elif scene == "channel":
result = await api.post_message(
channel_id=rem["destination"], content=f"<@{rem['target_id']}>\n{text}"
)
elif scene == "guild_dm":
result = await api.post_dms(guild_id=rem["destination"], content=text)
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']}")