From a145335f49bc8bfb653d56fa1599b708de263c3b Mon Sep 17 00:00:00 2001 From: liuwei Date: Thu, 16 Apr 2026 10:48:03 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=A8RAG=E5=8A=9F=E8=83=BD?= =?UTF-8?q?=E6=B8=85=E5=8D=95=E4=B8=BA=E5=AE=8C=E6=95=B4=E6=8F=92=E4=BB=B6?= =?UTF-8?q?=E5=88=97=E8=A1=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 变更项： 1. 重写 docs/rag/04_功能详解_逐插件.md，整理为完整插件总表。 2. 覆盖命令触发、自动触发、后台任务、管理运维四类插件，并标注主要命令与触发方式。 3. 补充目录中存在但不可加载插件（无main.py）说明，避免文档与运行态认知偏差。 4. 增加后续维护规则，便于只维护局部插件条目。 --- docs/rag/04_功能详解_逐插件.md | 230 ++++++++++++++++++++++++++++----- 1 file changed, 196 insertions(+), 34 deletions(-) diff --git a/docs/rag/04_功能详解_逐插件.md b/docs/rag/04_功能详解_逐插件.md index 10b8069..71312a6 100644 --- a/docs/rag/04_功能详解_逐插件.md +++ b/docs/rag/04_功能详解_逐插件.md @@ -1,44 +1,206 @@ -# 04 功能详解（逐插件模板） +# 04 功能详解（完整插件清单） -> 这个文件用于持续新增。每新增一个插件，按下面模板加一段。 +> 本文件是“完整插件总表”，用于给用户和 RAG 做统一检索。 +> +> 约定： +> - `命令触发`：用户主动发命令触发 +> - `自动触发`：满足条件自动执行（如识别链接、后台定时） +> - `后台任务`：不直接响应用户消息 -## 模板 +## A. 用户高频插件（命令触发） -### 插件名 +### 1) robot_menu（功能菜单） +- 目录：`plugins/robot_menu` +- 主要命令：`菜单`、`功能菜单`、`菜单 指令清单`、`菜单 状态` +- @问答：`@机器人 功能清单`、`@机器人 指令清单`、`@机器人 怎么用` +- 说明：用于查看本群可用功能、状态和管理员操作入口 -- 功能定位： -- 触发命令： -- 参数说明： -- 返回示例： -- 权限要求：普通成员 / 管理员 -- 常见失败原因： -- 关联功能开关（Feature）： -- 备注： +### 2) dify（AI聊天） +- 目录：`plugins/dify` +- 主要命令：`聊天` +- 说明：AI问答入口 + +### 3) ai_gen_image（AI绘图） +- 目录：`plugins/ai_gen_image` +- 主要命令：`AI绘图`、`绘图`、`画图`、`生成图片` +- 说明：文本生成图片 + +### 4) message_sign（签到） +- 目录：`plugins/message_sign` +- 主要命令：`签到`、`每日签到`、`qd`、`上班`、`牛马` +- 补签命令：`补签`、`续签` +- 说明：签到积分体系 + +### 5) point_trade（积分交易） +- 目录：`plugins/point_trade` +- 主要命令：`积分交易`、`积分转账`、`我的积分`、`积分排行`、`打劫`、`保释` +- 说明：积分查询、转账与互动玩法 + +### 6) global_news（全球新闻） +- 目录：`plugins/global_news` +- 主要命令：`全球新闻`、`国际新闻`、`环球新闻`、`政经新闻`、`政治经济新闻` +- 说明：新闻查询 + +### 7) weather（天气） +- 目录：`plugins/weather` +- 主要命令：`天气`、`订阅天气`、`取消订阅` +- 说明：天气查询与订阅 + +### 8) music（点歌） +- 目录：`plugins/music` +- 主要命令：`点歌`、`音乐`、`音乐点播`、`点播音乐`、`音乐点歌` +- 说明：音乐搜索与点播 + +### 9) guess_song（猜歌名） +- 目录：`plugins/guess_song` +- 主要命令：`猜歌名` +- 说明：猜歌互动游戏 + +### 10) inactive_rank（潜水排行） +- 目录：`plugins/inactive_rank` +- 主要命令：`潜水排行` +- 说明：群活跃度榜单 + +### 11) xiuren_image（图来） +- 目录：`plugins/xiuren_image` +- 主要命令：`图来`、`秀人`、`美图`、`随机图片` +- 说明：图片内容插件 + +### 12) beautyleg（美腿） +- 目录：`plugins/beautyleg` +- 主要命令：`美腿`、`腿来` +- 说明：图片内容插件 + +### 13) video_man（猛男） +- 目录：`plugins/video_man` +- 主要命令：`猛男`、`肌肉`、`帅哥` +- 说明：视频内容插件 + +### 14) video（黑丝视频） +- 目录：`plugins/video` +- 主要命令：`黑丝视频`、`黑丝`、`来个黑丝`、`搞个黑丝` +- 说明：视频内容插件 + +### 15) game_task（百科答题） +- 目录：`plugins/game_task` +- 主要命令：`/s`、`/t`、`/a 任务ID 答案`、`/r`、`/l`、`/h` +- 说明：群问答任务与排行 + +### 16) xiuxian（文字修仙） +- 目录：`plugins/xiuxian` +- 主要命令（节选）：`修仙帮助`、`注册修仙`、`我的状态`、`闭关`、`出关`、`聚灵`、`排行榜`、`修仙签到`、`坊市`、`突破`、`创建门派`、`加入门派` +- 说明：长线养成玩法，命令较多，以 `修仙帮助` 为入口 + +### 17) duanju_search（短剧搜索） +- 目录：`plugins/duanju_search` +- 主要命令：`短剧`、`短剧搜索`、`搜索短剧`、`短剧查询` +- 说明：短剧检索 + +### 18) fanhao_search（番号查询） +- 目录：`plugins/fanhao_search` +- 主要命令：`番号`、`番号查询` +- 说明：番号检索 + +### 19) lucky_pot（拼手气大奖池） +- 目录：`plugins/lucky_pot` +- 主要命令：`大奖池`、`开奖池`、`拼手气` +- 说明：群互动玩法 + +### 20) jd_sign_token（京东配置） +- 目录：`plugins/jd_sign_token` +- 主要命令：`设置京东` +- 说明：用于设置京东相关凭据 + +### 21) message_push_task（推送任务） +- 目录：`plugins/message_push_task` +- 主要命令：`推送`、`消息推送`、`定时推送` +- 说明：创建与管理消息推送任务 + +### 22) group_auto_invite（自动加群） +- 目录：`plugins/group_auto_invite` +- 主要命令：`#加群`、`#加群配置` +- 说明：按关键词路由进群 + +### 23) group_virtual（跨群） +- 目录：`plugins/group_virtual` +- 主要命令：`#创建跨群`、`#添加群`、`#查看跨群列表`、`#查看跨群`、`#退出跨群`、`#解散跨群` +- 说明：群与群之间的消息联动 + +### 24) douyu（斗鱼订阅） +- 目录：`plugins/douyu` +- 主要命令：`斗鱼订阅`、`取消斗鱼订阅`、`斗鱼订阅列表`、`斗鱼订阅提醒`、`取消斗鱼订阅提醒`、`订阅鱼吧`、`取消订阅鱼吧`、`鱼吧订阅列表`、`#斗鱼弹幕日报`、`斗鱼弹幕日报` +- 说明：斗鱼开播与鱼吧订阅提醒 + +### 25) gscore_adapter（早柚适配器） +- 目录：`plugins/gscore_adapter` +- 主要命令：`早柚`、`重连早柚` +- 说明：将消息转发到早柚核心 + +## B. 自动触发插件（无需命令） + +### 26) ai_auto_response（小牛拟人群聊） +- 目录：`plugins/ai_auto_response` +- 触发方式：群文本消息自然触发（可配合@） +- 辅助命令：`#人格列表`、`#当前人格`、`#切换人格 人格名` +- 说明：当前为非阻断模式，不拦截后续插件 + +### 27) douyin_parser（抖音解析） +- 目录：`plugins/douyin_parser` +- 触发方式：检测到抖音短链自动解析 +- 说明：自动解析并回传视频/图文结果 + +### 28) message_summary（群聊总结） +- 目录：`plugins/message_summary` +- 触发方式：`#总结` +- 说明：对群聊内容做摘要 + +### 29) group_member_change（群成员变更监控） +- 目录：`plugins/group_member_change` +- 触发方式：群成员变更事件自动触发 +- 说明：自动播报成员变动 + +## C. 后台任务插件（不直接给用户发命令） + +### 30) member_context（成员交互摘要） +- 目录：`plugins/member_context` +- 触发方式：定时任务（按配置时间执行） +- 说明：后台生成成员画像/摘要，供其他AI能力使用 + +### 31) stats_collector（指令记录） +- 目录：`plugins/stats_collector` +- 触发方式：插件调用事件自动记录 +- 说明：统计调用量、成功率、耗时、错误日志 + +## D. 管理与运维插件 + +### 32) plugin_manager（插件管理） +- 目录：`plugins/plugin_manager` +- 主要命令：`插件 列表`、`插件 启用 插件名`、`插件 禁用 插件名`、`插件 重载 插件名`、`插件 信息 插件名` +- 权限：管理员 +- 说明：插件生命周期管理 + +### 33) system_updater（系统更新） +- 目录：`plugins/system_updater` +- 主要命令：`更新系统`、`系统更新`、`重启系统`、`更新重启` +- 权限：管理员 +- 说明：系统更新与重启 + +## E. 目录中存在但当前不可加载（无 main.py） + +### 34) pfe_hub +- 目录：`plugins/pfe_hub` +- 状态：无 `main.py`，不会被插件管理器加载 + +### 35) wx_red_pack +- 目录：`plugins/wx_red_pack` +- 状态：无 `main.py`，不会被插件管理器加载 --- -## RobotMenu（功能菜单） +## 维护说明（你后续只改这一节即可） -- 功能定位：展示本群可用功能与命令 -- 触发命令：`菜单` `功能菜单` `菜单 指令清单` `菜单 状态` -- @问答：`@机器人 功能清单` `@机器人 指令清单` `@机器人 怎么用` -- 权限要求： - - 查看菜单：普通成员可用 - - 开关管理：管理员 -- 常见失败原因：本群未启用机器人总开关 - -## PluginManager（插件管理） - -- 功能定位：启停、重载、查询插件 -- 触发命令：`插件 列表` `插件 启用 插件名` `插件 禁用 插件名` `插件 信息 插件名` -- 权限要求：管理员 -- 风险提示：生产环境重载前建议先在测试群验证 - -## AI Auto Response（拟人群聊） - -- 功能定位：群聊拟人回复 -- 触发方式：文本消息自然触发（可结合@） -- 行为说明：当前为非阻断模式，不拦截后续插件处理 -- 常见失败原因：群权限关闭、夜间策略、冷却策略、队列拥堵 +1. 新增插件：补一条到本文件对应分区（A/B/C/D/E）。 +2. 新增命令：只改对应插件“主要命令”一行。 +3. 插件下线：移到 E 分区并标注原因。 最后更新：2026-04-16