# 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