6122add576
变更项： 1. 新增 docs/RAG_用户使用指南.md，聚焦群成员与群管理员的用户向说明。 2. 提供按场景整理的指令清单，覆盖菜单、AI、新闻、天气、积分、签到、媒体、游戏、推送、系统管理等常见功能。 3. 补充新手上手路径、管理员操作手册与FAQ，提升自助使用效率。 4. 增加RAG落地建议（拆分目录、分片策略、元数据模板、检索测试问法），可直接用于知识库建设。
265 lines
6.9 KiB
Markdown
265 lines
6.9 KiB
Markdown
# 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
|
||
|