From 6122add57686c145e8ec73ead703690634d0ae76 Mon Sep 17 00:00:00 2001
From: liuwei <liuwei@wdtrgf.com.cn>
Date: Thu, 16 Apr 2026 10:32:10 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E9=9D=A2=E5=90=91RAG?=
 =?UTF-8?q?=E7=9A=84ABOT=E7=94=A8=E6=88=B7=E4=BD=BF=E7=94=A8=E6=8C=87?=
 =?UTF-8?q?=E5=8D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

变更项：

1. 新增 docs/RAG_用户使用指南.md，聚焦群成员与群管理员的用户向说明。

2. 提供按场景整理的指令清单，覆盖菜单、AI、新闻、天气、积分、签到、媒体、游戏、推送、系统管理等常见功能。

3. 补充新手上手路径、管理员操作手册与FAQ，提升自助使用效率。

4. 增加RAG落地建议（拆分目录、分片策略、元数据模板、检索测试问法），可直接用于知识库建设。
---
 docs/RAG_用户使用指南.md | 264 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 264 insertions(+)
 create mode 100644 docs/RAG_用户使用指南.md

diff --git a/docs/RAG_用户使用指南.md b/docs/RAG_用户使用指南.md
new file mode 100644
index 0000000..a655952
--- /dev/null
+++ b/docs/RAG_用户使用指南.md
@@ -0,0 +1,264 @@
+# ABOT 用户使用指南（RAG版）
+
+> 适用对象：群成员、群管理员、运营人员
+>  
+> 文档目的：让用户“看完就会用”，并可直接作为 AI 知识库（RAG）基础文档。
+
+## 1. 先看这 30 秒
+
+ABOT 是一个微信群机器人，功能按“群”独立开关。
+你在 A 群能用的功能，在 B 群不一定开了。
+
+推荐先执行：
+
+1. `菜单`：查看本群已开通功能
+2. `菜单 指令清单`：查看本群可直接触发的命令
+3. `菜单 状态`：查看本群功能开关状态（通常管理员使用）
+
+如果你习惯 `@机器人` 询问，也支持：
+
+- `@机器人 功能清单`
+- `@机器人 指令清单`
+- `@机器人 这个怎么用`
+
+---
+
+## 2. 使用规则（非常重要）
+
+1. 功能是否可用，取决于“本群是否启用该功能”。
+2. 部分功能仅管理员可操作（例如：功能开关、系统更新、插件管理）。
+3. 部分功能会消耗积分（例如：补签、部分互动玩法）。
+4. 同一个命令可能有多个别名，命中任一别名即可触发。
+
+---
+
+## 3. 用户常用指令清单（按场景）
+
+说明：以下为系统支持指令。你所在群实际可用项，请以 `菜单 指令清单` 返回为准。
+
+### 3.1 菜单与帮助
+
+- `菜单`
+- `功能菜单`
+- `菜单 指令清单`
+- `菜单 状态`
+
+### 3.2 AI 对话与内容生成
+
+- 对话：`聊天 你的问题`
+- 图片生成：`AI绘图 描述词`、`绘图 描述词`、`画图 描述词`、`生成图片 描述词`
+
+### 3.3 新闻资讯
+
+- `全球新闻`
+- `国际新闻`
+- `环球新闻`
+- `政经新闻`
+- `政治经济新闻`
+
+### 3.4 天气
+
+- `天气 城市`
+- `订阅天气 城市`
+- `取消订阅 城市`
+
+### 3.5 音乐与娱乐
+
+- 点歌：`点歌 歌名`
+- 猜歌：`猜歌名`（可跟歌手名或答案）
+- 潜水排行：`潜水排行`
+
+### 3.6 图片与视频
+
+- 秀人图：`图来`、`秀人`、`美图`、`随机图片`
+- 美腿图：`美腿`、`腿来`
+- 猛男视频：`猛男`、`肌肉`、`帅哥`
+- 黑丝视频：`黑丝视频`、`黑丝`、`来个黑丝`、`搞个黑丝`
+- 抖音解析：直接发送抖音链接（通常自动触发）
+
+### 3.7 积分与签到
+
+- 签到：`签到`、`每日签到`、`qd`、`上班`、`牛马`
+- 补签：`补签`、`续签`
+- 积分：`我的积分`、`积分排行`
+- 转账：`积分转账 100 @某人`（也支持多种近义词）
+- 互动：`打劫 @某人`、`保释 @某人`
+
+### 3.8 游戏任务（百科问答）
+
+- `/s`：加入
+- `/t`：出题
+- `/a 任务ID 答案`：答题
+- `/r`：排行
+- `/l`：活跃题
+- `/h`：未解决题
+
+### 3.9 群功能与跨群
+
+- 加群：`#加群 关键词`
+- 加群管理：`#加群配置 ...`
+- 跨群：`#创建跨群`、`#添加群`、`#查看跨群列表`、`#查看跨群`、`#退出跨群`、`#解散跨群`
+
+### 3.10 定时推送与消息任务
+
+- `推送`
+- `消息推送`
+- `定时推送`
+
+### 3.11 系统与插件（管理员常用）
+
+- 系统更新：`更新系统`、`系统更新`、`重启系统`、`更新重启`
+- 插件管理：`插件 列表`、`插件 启用 插件名`、`插件 禁用 插件名`、`插件 信息 插件名`
+
+---
+
+## 4. 新手上手路径（建议照做）
+
+### 第一步：确认本群开通了什么
+
+发送：`菜单 指令清单`
+
+你会拿到一份“本群可用命令列表”，直接复制其中一条即可触发。
+
+### 第二步：先试 3 条高频命令
+
+1. `签到`
+2. `全球新闻`
+3. `点歌 稻香`
+
+### 第三步：再试一个互动玩法
+
+- `/t`（答题）或
+- `猜歌名`
+
+---
+
+## 5. 管理员使用指南（群运营）
+
+> 以下操作通常需要管理员权限。
+
+### 5.1 查看并管理功能开关
+
+- 查看状态：`菜单 状态`
+- 启用功能：`菜单 启用 序号` 或 `菜单 启用 功能名`
+- 关闭功能：`菜单 关闭 序号` 或 `菜单 关闭 功能名`
+
+示例：
+
+- `菜单 启用 1`
+- `菜单 关闭 2`
+
+### 5.2 管理群管理员
+
+- `菜单 管理员 列表`
+- `菜单 管理员 添加 wxid`（也支持 @）
+- `菜单 管理员 删除 wxid`（也支持 @）
+
+### 5.3 插件管理
+
+- `插件 列表`
+- `插件 启用 插件模块名`
+- `插件 禁用 插件模块名`
+- `插件 重载 插件模块名`
+- `插件 信息 插件模块名`
+
+---
+
+## 6. 常见问题（用户向）
+
+### Q1：我发了命令没反应
+
+按顺序检查：
+
+1. 是否命令拼写正确（建议直接复制 `菜单 指令清单` 返回内容）
+2. 本群是否启用了对应功能（`菜单 状态`）
+3. 是否被风控时段或冷却策略限制（部分群可能配置了夜间静默）
+
+### Q2：为什么别人能用我不能用
+
+可能原因：
+
+1. 你发送格式不正确（尤其带参数命令）
+2. 该命令要求 `@用户` 或具体参数
+3. 管理员权限命令，普通成员不可执行
+
+### Q3：AI 回复了，但其他插件没触发
+
+系统已支持“AI 与其他插件并行处理”模式。
+若你仍遇到冲突，请联系管理员检查插件优先级与群开关。
+
+### Q4：怎么快速知道这个群能干什么
+
+最直接：`菜单 指令清单`
+
+---
+
+## 7. 给 RAG 的整理建议（落地版）
+
+这一节是给你（知识库维护者）看的。
+
+### 7.1 推荐文档拆分
+
+建议把用户文档拆成这些文件（每个文件 300~1200 行最佳）：
+
+1. `docs/rag/00_快速开始.md`
+2. `docs/rag/01_指令清单_按场景.md`
+3. `docs/rag/02_管理员指南.md`
+4. `docs/rag/03_FAQ_故障排查.md`
+5. `docs/rag/04_功能详解_逐插件.md`
+
+### 7.2 建议分片策略（Chunking）
+
+1. 按二级标题（`##`）切块
+2. 每块建议 300~800 中文字
+3. 相邻块保留 80~120 字重叠
+4. 命令清单与 FAQ 独立成块，便于检索命中
+
+### 7.3 元数据模板（建议）
+
+每个 chunk 附加：
+
+- `source`: 文件路径
+- `section`: 标题名
+- `intent`: `新手引导/命令查询/管理员操作/故障排查`
+- `audience`: `user/admin`
+- `updated_at`: 日期
+- `keywords`: 命令词数组
+
+### 7.4 检索问法覆盖（建议做测试集）
+
+至少准备以下问法做召回测试：
+
+1. “这个群可以用哪些功能？”
+2. “签到命令是什么？”
+3. “怎么点歌？”
+4. “怎么开启某个功能？”
+5. “为什么命令没反应？”
+
+---
+
+## 8. 可直接复用的“用户提示词”
+
+可放到你自己的 AI 助手系统提示里：
+
+```text
+你是 ABOT 的用户助手。
+当用户询问“有什么功能/怎么用/命令是什么”时，优先回答：
+1) 先让用户发送“菜单 指令清单”确认本群可用命令；
+2) 再给出用户问题对应的1~3条可直接复制命令；
+3) 如果是管理员操作，明确标注“需要管理员权限”。
+回答风格要求：短句、可执行、少术语。
+```
+
+---
+
+## 9. 更新维护建议
+
+1. 每新增/修改一个插件命令，同步更新本文件第 3 节。
+2. 每周至少一次，用真实群测试 `菜单 指令清单` 与文档是否一致。
+3. 若文档与线上行为不一致，以线上 `菜单 指令清单` 为准并优先修正文档。
+
+---
+
+最后更新：2026-04-16
+