内置插件指南¶
Remilia 内置了 30+ 插件(builtin/),大多已包含在 bundle.All() 默认插件集中,注册即可使用。
本文按功能分类介绍各内置插件的用途与使用方式。
应用级插件(updater / pic / sauce / welcome 等)见 应用级插件指南。
🛡️ 内容安全¶
antispam — 防刷屏/防轰炸¶
检测群消息突发(user_burst / group_burst 阈值),支持违规自动封禁(ban_on_violation + ban_duration)。
无聊天命令,作为规则/中间件使用:
engine.On(string(platform.EventKindGroupMessage), spam.Rule()).Handle(myHandler)
keywordfilter — 关键词过滤¶
拦截包含违规关键词的消息(可配置命中策略:静默丢弃/警告/撤回)。无聊天命令,以中间件形式挂载。
moderation — 群管理¶
| 命令 | 说明 |
|---|---|
/clean |
清理聊天记录 |
/kick |
踢出成员 |
/mute |
禁言成员 |
/warn |
警告成员(累计触发自动处理) |
/warnings |
查看警告记录 |
⚙️ 自动化¶
autoresponder — 关键词自动回复¶
/ar 管理自动回复规则:设置关键词与回复内容,命中即自动回复。
broadcast — 广播¶
向所有群组 / 指定用户批量发送消息。
subscription — 订阅推送¶
多数据源订阅框架:按配置定时查询外部资源(如 RSS)并推送更新到目标会话。
scheduler — 计划任务¶
支持固定间隔与 cron 表达式的定时任务,执行历史可查(配套 API:/api/v1/scheduler/*)。
job — 后台作业¶
结构化后台作业系统:延迟执行、自动重试(指数退避)、失败指定重试、超时控制,作业可持久化。
customcommands — 自定义命令¶
/cc 管理用户自定义命令:无需编写 Go 代码即可注册"关键词 → 回复"的自定义命令。
💬 用户互动¶
cooldown — 命令冷却¶
为命令配置冷却时间,支持用户级/群级/全局维度(如 /daily、/sign 签到类命令防刷)。
verifycode — 验证码授权¶
通过一次性验证码授予用户权限(支持角色授予、入群验证、自动过期),详见 验证码系统。
vevent — 虚拟事件注入¶
将自定义事件合成为 platform.Event 注入引擎,用于测试、演示和扩展开发(含 /cmd、/hello、/ping 示例命令)。
📊 管理与观测¶
auditlog — 审计日志¶
记录命令调用、配置变更与权限操作,供合规审查(配套 API:/api/v1/auditlog/*)。
logviewer — 日志查询¶
/logs 在聊天中查询运行日志。
ratelimitui — 限流状态¶
/rl 查看综合 antispam 与 cooldown 的实时限流状态。
pluginstore — 插件状态持久化¶
插件状态存取(保存/恢复/临时状态),供其他插件做状态持久化。
i18n — 国际化¶
多语言文本查找与热更新支持,为插件提供 ctx 语言感知的消息翻译。
📨 消息通道¶
sendqueue — 异步发送队列¶
异步消息发送队列,带全局桶限速,防止 API 超限;支持队列满时的降级策略。
messagelog — 群消息历史¶
内存环形缓冲 + SQLite 持久化记录群聊(含 bot 出站消息),见 应用级插件指南。
🧩 其他核心插件¶
| 插件 | 说明 |
|---|---|
core/help |
/help 命令:按分类展示全部命令与插件信息 |
core/admin |
管理命令集(插件热重载、状态查询等) |
core/permission |
RBAC 权限系统(角色/权限/分配),见 权限系统架构 |
acl |
黑白名单访问控制,见 访问控制列表 |
dev/debug |
调试工具集(/debug event/ctx/matcher/runtime/commands/plugins/stats) |
ping |
/ping 消息处理延迟检测 |
stats |
用户行为统计(命令调用排行、活跃用户),可对接 AI 工具 |
各插件的完整命令帮助可在机器人内使用 /help 查看;bundle.All() 为默认推荐组合。