Files
abot/docs/RAG_用户使用指南.md
liuwei 6122add576 新增面向RAG的ABOT用户使用指南
变更项:

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

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

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

4. 增加RAG落地建议(拆分目录、分片策略、元数据模板、检索测试问法),可直接用于知识库建设。
2026-04-16 10:32:10 +08:00

6.9 KiB
Raw Permalink Blame History

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. 管理员权限命令,普通成员不可执行

Q3AI 回复了,但其他插件没触发

系统已支持“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 助手系统提示里:

你是 ABOT 的用户助手。
当用户询问“有什么功能/怎么用/命令是什么”时,优先回答:
1) 先让用户发送“菜单 指令清单”确认本群可用命令;
2) 再给出用户问题对应的1~3条可直接复制命令
3) 如果是管理员操作,明确标注“需要管理员权限”。
回答风格要求:短句、可执行、少术语。

9. 更新维护建议

  1. 每新增/修改一个插件命令,同步更新本文件第 3 节。
  2. 每周至少一次,用真实群测试 菜单 指令清单 与文档是否一致。
  3. 若文档与线上行为不一致,以线上 菜单 指令清单 为准并优先修正文档。

最后更新2026-04-16