Skip to content

扩展清单 ​

官方扩展大部分默认关闭,但有少数例外默认开启:echo(连通性自检)、help(帮助菜单)、scheduler(定时任务调度)、webui(Web 管理后台)。 其余接入端与功能插件默认关闭,需显式启用:把对应块 enabled 改为 true,或 python tools/scan_core_plugins.py --enable <名>,然后重启。

官方内置扩展(core_plugins/) ​

扩展作用默认
echo连通性自检:/echo 原样回显、/ping 健康检查(覆盖所有接入端)✅ 开
help内置帮助菜单:/help(别名 /帮助、/菜单)列出全部已注册命令✅ 开
scheduler定时任务调度(APScheduler cron)✅ 开
webuiWeb 管理后台(端口/仪表盘/插件市场)✅ 开
onebot_adapterOneBot 11 反向 WS 接入端(协议端连入)❌ 关
rust_accelOneBot 的 Rust 加速接入端(启用前先停 onebot_adapter,详见 core_plugins/rust_accel/README.md)❌ 关
ws_client正向 WS 接入端(主动连协议端)❌ 关
qq_officialQQ 官方机器人接入(需 AppID/AppSecret)❌ 关
telegram / discordTelegram / Discord Bot 接入(需 Token)❌ 关
kookKOOK 接入(Gateway WS + REST v3,需 Bot Token)❌ 关
matrixMatrix 接入(Client-Server API v3 长轮询,支持自建 homeserver)❌ 关
session多轮会话:ctx.wait_for() / ctx.create_session()❌ 关
http_api独立对外 HTTP API❌ 关
http_injectHTTP 事件注入端❌ 关
image_renderer通用图片渲染引擎(卡片/文字图,Rust 原生加速、缺失回退 PIL)❌ 关
html_assembler单文件 HTML 装配引擎:占位符替换 + 图片 base64 内嵌❌ 关
llm_loadLLM 核心装载器:释放/自愈 plugins/llm_core(对话核心,提供模型总线 / 工具调用 / Agent 循环)❌ 关
aiwriterAI 智能体 CLI:python main.py code 或终端 code 打开全屏界面(可配置 OpenAI / 写插件),不依赖 llm_core❌ 关

随项目内置的用户扩展(plugins/) ​

以下插件位于 plugins/ 目录,默认全部加载(除非在 core_plugins.yaml 或后台显式禁用)。 echo / help 已作为官方自检/帮助入口移入 core_plugins/(见上表),不再列于此。

扩展显示名作用
Lolicon随机动漫图Lolicon API 随机动漫插画,触发词被动下发 + /setu 主动命令
big_banana绘图OpenAI/Gemini 兼容的图像生成,支持高级参数
context_aware群聊场景感知维护群聊对话流,推断谁在和谁说话,辅助 Bot 避免抢答
daily_pig今日小猪每人每日抽取专属小猪,当日固定、次日刷新,猪库可自定义
dzmmDZMM 聊天对接 dzmm.ai 兼容 OpenAI 聊天接口,多角色/多密钥/上下文隔离/失败自动切换
emoji_like智能贴表情按概率调用 LLM 判断消息情感并贴对应表情,缺失 LLM 配置时随机降级
get_pxPixiv搜图签到Lolicon API 搜图发图 + 每日签到养成,支持标签/R18过滤
group_daily群日常分析总结群聊流水采集 + 每日活跃/排行/热词/话题摘要,支持定时推送与历史回看
group_guardian群管卫士群管操作 + 违禁词 + 可选 LLM 智能审核,正则初筛与二次判定
human_service人工客服群内转人工:用户消息转发给管理员、管理员回复回传,状态持久化
humanlike更像真人随机忽略/已读不回/夜间睡觉不回,让 Bot 更像真人
life_scheduler生活日程LLM 生成拟人化每日日程与穿搭,存储可查询,支持定时生成
link_parser万能链接解析按域名分发解析视频/图集/音频链接,解析器可插拔扩展
matrix_adapterMatrix桥接Matrix 协议桥接:把 Matrix 房间消息转发到 QQ 群(依赖 matrix-nio)
mconMCON 互通核心《我的世界》服务器主动上报心跳(玩家/TPS/MSPT)与日志;北京时间动态轮换 Token
meme_manager表情管理器按目录组织表情素材,支持随机发送、关键词匹配、群内收录与 Web 管理
memeify表情包识别 LLM 回复中的 [表情词] 或主动命令,调用 apihz.cn 发送表情包图片
message_stats群发言统计群发言计数与排行(总/今日/昨日/周/月/年),缓冲落库 + 定时推送
msg_stats群发言统计群发言计数与字数统计,缓冲批量落库,支持日榜/总榜/仪表盘
music点歌关键词搜歌并发送音乐卡片,搜索源可配置
novel群协作小说每群独立的长篇小说协作:世界观/人物/AI续写/大纲/导出
portrayal人物画像基于群聊历史发言统计 + 可选 LLM 生成群友性格画像,带当日缓存
qzone_ultraQQ空间发布经本地 QZone 网关发布内容到 QQ 空间(守护进程架构,凭证不下放)
reneban黑名单管理会话/全局用户禁用与解禁,支持时限与理由,pass>ban,过期自动清理
reread复读姬纯内存群聊复读:分类型阈值 + 概率 + 冷却 + 违禁词
shit_detector_plus搬史专家搜索 GitHub 项目并用 LLM 做史级评定,支持定时推送精选项目到群聊
steam_monitorSteam 状态监控轮询 Steam 玩家游戏状态,变更时推送到绑定的群
video_sora视频生成OpenAI Sora / 兼容视频生成接口,支持提交与轮询
web_analyzer网页分析抓取网页正文并可选 LLM 摘要,按 URL 缓存
what_to_eat吃什么智能识别「吃什么」问句,按概率推荐美食或复读,支持自定义食物库/频率限制/复读冷却

官方扩展仓库(20+ 现成扩展) ​

把 config.yaml → plugin.dir 指向 zcbot_plugins 仓库,或在后台插件市场安装。

扩展作用扩展作用
llm_chat大模型对话qqadmin群管理全套(禁言/踢人/撤回/审批/违禁词)
llm_plugin_genAI 写插件fun_score签到积分/排行榜
video_parse视频链接解析卡片send_like点赞/自动点赞
broadcast消息批量广播file服务器文件管理
custom_ui接管/换肤后台hitokoto随机一言
plugin_memmon插件内存监控llm_blacklistLLM 对话黑名单

完整命令与用法见插件仓库说明。

基于 MIT + Apache 2.0 双协议发布