Repository navigation
Expand file tree
/
Copy pathplugin.py
More file actions
50 lines (37 loc) · 2.55 KB
/
Copy pathplugin.py
File metadata and controls
50 lines (37 loc) · 2.55 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
"""群管理助手 v2.7.1 — QQ 群的自动小管理员
18 个管理 Tool + 29 个命令入口 + 5 个 HookHandler，支持禁言/解禁/踢人/警告/设精华/撤回/改名片/
改头衔/改群名/公告发布与删除/入群审批，Bot 群主完整权限；管理员保留安全护栏与按群独立配置。
v2.7 修复：MaiBot 新版本（response item 重构）把 Hook 载荷从 messages 改为 items，
插件注入协议同步升级为 Context Item（SystemMessageItem.parts），并兼容旧版 messages；
before_request 返回完整 kwargs，避免模型名/任务名等字段丢失。
v2.7 优化：重写默认管理提示词模板（分区清晰、去除重复的身份说明，动态发言者信息统一由
插件追加），并精简插件市场简介。
v2.6 更新：对话中主动识别发言者身份（群主/管理员/普通成员）并注入提示词，避免
"先质疑群主是冒充的、调用工具后才认出来" 的错位；身份与 Bot 角色缓存改为更短
刷新周期（默认 5 分钟 / 2 分钟），新增 /admin perm 权限决策链可视化用于排查，
优化默认提示词模板；同步优化插件简介与说明文档。
v2.6 新增：为全部 18 个管理功能补齐命令入口，并按 QQ 实际权限设置最低可用等级；
普通成员可通过 /mytitle、/member、/notices 只读查询，群管理员可执行常规管理命令，
群名与专属头衔仍仅群主可用。提示词同时携带发言者昵称/群名片并强调工具必须使用 QQ 号，
降低模型在记忆/ID 之间串认人的概率。
模块结构：
config_model.py 配置模型（10 个配置分区，2 个默认提示词）
plugin_core.py 核心生命周期、后台任务、辅助方法
tools.py 18 个管理 Tool
commands.py 29 个命令入口（含管理员命令与普通成员自助修改命令）
handlers.py 1 个 EventHandler + 5 个 HookHandler
plugin.py 入口：组合所有模块，导出 create_plugin
"""
from __future__ import annotations
from maibot_sdk import MaiBotPlugin
from .commands import CommandMixin
from .config_model import GroupAdminConfig
from .handlers import HandlerMixin
from .plugin_core import PluginCore
from .tools import ToolMixin
class GroupAdminPlugin(PluginCore, ToolMixin, CommandMixin, HandlerMixin):
"""群管理助手插件 — 组合核心、工具、命令、事件处理器。"""
config_model = GroupAdminConfig
def create_plugin() -> GroupAdminPlugin:
"""创建群管理助手插件实例。"""
return GroupAdminPlugin()