指令一览

# QQ 端指令整理

> 整理自 `wymbotripworld` 当前代码（backend / legacy/shaolan / experimental/name_arena），2026-08-05。

> QQ 端实际会收到三个服务的事件，互不冲突：主后端（backend）、旧存档服务（Shaolan）、名字竞技场（Name Arena）。

## 一、整体约定

| 项目 | 说明 |

|---|---|

| 主后端前缀 | `#`（可用环境变量 `BOT_PREFIX` 修改），另有飞天大 / IUPAR 使用 `-` 前缀 |

| Shaolan 前缀 | 全部为 `-` |

| Name Arena 前缀 | `#`，命令为 `#名字竞技场` |

| 权限 | 普通用户 / 群管理员（QQ 群主与 QQ 原生管理员自动拥有，也可指派）/ 超级管理员（按统一玩家 ID） |

| 数据 | 主后端全部 YAML 存档；Shaolan 独立 MongoDB（与主后端完全隔离） |

| 图片命令 | 飞天大、Shaolan 抓图类命令需要与图片**在同一条消息**中发送 |

权限说明：

- `super_admin`：按统一玩家 ID 判定，自动拥有所有群管理员权限。

- `group_admin`：QQ 群主/原生管理员自动满足，或由 `#group-admin-add` 指派（仅对应群生效）。

- 权限文件每次判断时读取，修改后无需重启。

---

## 二、主后端（backend）指令

### 2.1 基础

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#ping` | `#ping` | 回复 `pong` | 所有人 |

| `#name` | `#name <名字>` | 设置玩家昵称，最多 10 字 | 所有人 |

| `#查询` | `#查询` | 查询当前啥币余额 | 所有人 |

| `#jrrp` / `#今日人品` | `#jrrp` | 每日首次生成人品（0.0～100.0）并赠送 75～150 啥币 + 随机一条“你知道妈”；当日重复调用按次数回复不同内容 | 所有人 |

| `#获取啥币` | `#获取啥币 [答案]` | 无参数时出题，答对获得 100～250 啥币；每天最多 3 次；答案忽略大小写和空白；答题后同一条消息仍继续执行其他命令 | 所有人 |

| `#绑定` | `#绑定 <引继码>` | 使用网页端生成的引继码绑定 QQ 账号 | 所有人 |

| `#俄罗斯转盘` | `#俄罗斯转盘` | 群聊内多人轮流参与，轮流扣扳机；中弹者被禁言 60 秒 | 所有人 |

### 2.2 发言记录（me）

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#enable_me` | `#enable_me` | 开启/关闭 bot 记录自己的 QQ 发言 | 所有人 |

| `#info_me` | `#info_me` | 查看已记录发言条数 | 所有人 |

| `#clear_me` | `#clear_me` | 清空自己的发言记录 | 所有人 |

| `#me` | `#me` | 随机回一条自己的历史发言 | 所有人 |

| `#me5` | `#me5` | 随机回 5 条自己的历史发言 | 所有人 |

### 2.3 WUM 与物品

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#wum` / `#wum列表` | `#wum [页码]` | 查看自己的 WUM 列表（分页图片） | 所有人 |

| `#wum_info` / `#wum信息` | `#wum_info <WUM ID>` | 查看单只 WUM 的种类、状态、特性、属性 | 所有人 |

| `#wum_rename` / `#wum改名` | `#wum_rename <WUM ID> <新名字>` | 给 WUM 改名 | 所有人 |

| `#item` / `#物品` | `#item [页码]` | 查看物品列表（分页图片） | 所有人 |

| `#item_info` / `#物品信息` | `#item_info <物品>` | 查看物品持有数量、描述与搜集度 | 所有人 |

### 2.4 旅行

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#place_info` / `#地点信息` | `#place_info <地点>` | 查看地点搜集度与已解锁信息 | 所有人 |

| `#place_items` / `#地点物品` | `#place_items <地点>` | 查看从该地点带回过哪些物品 | 所有人 |

| `#trip_map` / `#旅行地图` | `#trip_map` | 查看所有旅行地点、费用与解锁条件 | 所有人 |

| `#trip_goal` / `#旅行地点` | `#trip_goal <地点>` | 设定旅行目的地 | 所有人 |

| `#trip_start` / `#开始旅行` | `#trip_start` | 出发旅行（消耗啥币）；QQ 群消息会推进路程，少于 6 字记 0.7，否则记 1，再乘 `1 + 生/200` | 所有人 |

| `#trip_boost` / `#旅行加速` | `#trip_boost` | 消耗旅行券，保底时间减少 3 小时 | 所有人 |

| `#trip_wum` / `#旅行wum` | `#trip_wum <WUM ID>` | 设置旅行 WUM（旅行中不能更换） | 所有人 |

| `#trip_info` / `#tripinfo` / `#旅行信息` | `#trip_info` | 查看旅行地点、WUM、装备、等级 | 所有人 |

| `#statistics` / `#stats` / `#统计` | `#statistics` | 查看 WUM 累计、旅行/种植/做饭/钓鱼次数等统计 | 所有人 |

### 2.5 繁殖

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#繁殖` | `#繁殖 <wum1> <wum2>` | 让两只空闲 WUM 开始繁殖；基础时间 24 小时，按父母“生”属性平均值的 1/3 百分比缩短；有 5%（同种）/ 10%（异种）变异率 | 所有人 |

| `#繁殖信息` / `#breeding_info` | `#繁殖信息` | 查看进行中的繁殖与剩余时间（`#繁殖` 不带参数等同此命令） | 所有人 |

### 2.6 种菜

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#种植` / `#seed_plant` | `#种植 <种子>` | 开始种植，种子成熟后收获 | 所有人 |

| `#种菜wum` / `#seed_wum` | `#种菜wum <WUM ID>` | 设置种菜 WUM（成熟前不能更换） | 所有人 |

| `#种菜信息` / `#seed_info` | `#种菜信息` | 查看种菜 WUM、装备、当前种植与剩余时间 | 所有人 |

| `#种菜加速` / `#seed_boost` | `#种菜加速` | 消耗骨粉，直接推进 4 小时 | 所有人 |

### 2.7 钓鱼

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#钓鱼地点` / `#fishing_place` | `#钓鱼地点 <钓场>` | 设置钓鱼地点 | 所有人 |

| `#钓鱼wum` / `#fishing_wum` | `#钓鱼wum <WUM ID>` | 设置钓鱼 WUM | 所有人 |

| `#钓鱼信息` / `#fish_info` / `#fishing_info` | `#钓鱼信息` | 查看钓场、WUM、装备、获得力、剩余次数（每天 10 次） | 所有人 |

| `#抛竿` / `#cast` | `#抛竿` | 开始钓鱼；QQ 群中鱼上钩时会 @提醒并显示力度区间，60 秒内需调整 | 所有人 |

| `#增加` / `#increase` | `#增加 <力度>` | 鱼上钩后增加力度 | 所有人 |

| `#减少` / `#decrease` | `#减少 <力度>` | 鱼上钩后减少力度 | 所有人 |

### 2.8 合成

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#合成` / `#compound` | `#合成 <物品>` | 按配方合成 1 次 | 所有人 |

| `#合成表` / `#compound_info` | `#合成表 <物品>` | 查看合成配方、产量与等级需求 | 所有人 |

| `#批量合成` / `#compound_batch` | `#批量合成 <物品>*<次数>` | 批量合成，最多 100 次，材料不足时完成能合成的次数 | 所有人 |

### 2.9 烹饪

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#厨房` / `#kitchen` | `#厨房 [厨房名]` | 不带参数查看已发现厨房/当前厨房/今日剩余次数；带参数切换厨房 | 所有人 |

| `#做饭` / `#cook` | `#做饭 <原料1> [原料2] [原料3]` | 放入 2～3 个原料做饭；每天有次数上限，可能做出失败料理 | 所有人 |

| `#做饭wum` / `#cooking_wum` | `#做饭wum <WUM ID/默认>` | 设置做饭 WUM，`默认` 使用厨房默认 WUM | 所有人 |

| `#料理` / `#dish` | `#料理` | 查看现有料理与腐败倒计时 | 所有人 |

| `#料理信息` / `#dish_info` | `#料理信息 <料理名>` | 查看料理效果（需先解锁） | 所有人 |

| `#料理总览` / `#dish_overview` | `#料理总览 [厨房名]` | 查看厨房的全部料理及解锁进度 | 所有人 |

| `#吃` / `#eat` | `#吃 <料理名>` | 吃掉一份料理并触发效果 | 所有人 |

| `#料理效果` / `#dish_effect` | `#料理效果` | 查看当前生效的料理效果 | 所有人 |

### 2.10 装备

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#装备` / `#equip` | `#装备 <装备>` | 装备一件装备 | 所有人 |

| `#卸下` / `#unequip` | `#卸下 <装备>` | 卸下装备 | 所有人 |

### 2.11 队伍

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#创建队伍` | `#创建队伍 <队名>` | 创建队伍（队名 ≤20 字且不含空格），获得入队密码 | 所有人 |

| `#加入队伍` | `#加入队伍 <密码>` | 凭密码加入队伍 | 所有人 |

| `#退出队伍` | `#退出队伍` | 退出队伍；队长退出会解散队伍 | 所有人 |

| `#解散队伍` | `#解散队伍` | 解散队伍（仅队长） | 所有人 |

| `#队伍成员` | `#队伍成员` | 查看成员 | 所有人 |

| `#队伍密码` | `#队伍密码` | 查看本队入队密码 | 所有人 |

| `#队伍共享记录` | `#队伍共享记录` | 查看成员间共享物品的记录 | 所有人 |

### 2.12 成就与补偿

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#成就` / `#achv` | `#成就 [页码]` | 查看已获得的成就（分页图片） | 所有人 |

| `#成就信息` / `#achv_info` | `#成就信息 <成就名>` | 查看成就说明 | 所有人 |

| `#补偿` / `#compensation` | `#补偿 <编号>` | 领取补偿（过期/无效编号无回复） | 所有人 |

### 2.13 天气

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#天气` / `#weather` | `#天气 [地点]` | 查看当前与未来 3 小时天气（默认地球） | 所有人 |

| `#设置天气` / `#weather-set` | `#设置天气 地点 天气 [分钟]` | 临时修改地点天气，可指定 1～10080 分钟 | 超级管理员 |

| `#恢复天气` / `#weather-clear` | `#恢复天气 地点` | 恢复自然天气 | 超级管理员 |

### 2.14 群定义

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#def` | `#def "A" say "B"` 或 `#def "A" exe "#command"` | 定义当前群规则：完整匹配 A 时回复 B，或执行一次指令（参数需用引号包裹） | 当前不限制 |

| `#def-delete` | `#def-delete "A"` | 删除当前群定义 | 当前不限制 |

| `#def-show` | `#def-show "A"` | 查看某个定义 | 当前不限制 |

| `#def-list` | `#def-list` | 列出当前群全部定义 | 当前不限制 |

| `#def-global-say` | `#def-global-say "A" "B"` | 定义全局规则（**当前保存但不生效**） | 超级管理员 |

| `#def-global-exe` | `#def-global-exe "A" "#command"` | 同上，执行型 | 超级管理员 |

| `#def-global-delete` / `#def-global-show` / `#def-global-list` | 对应 `"A"` / `"A"` / 无参 | 管理全局定义 | 超级管理员 |

> 同一作用域的同一个 A 只保留最后一次定义；一次消息最多替换一次，替换结果不会继续触发其他定义；通过 `#def-exe` 间接执行命令仍会检查目标命令权限。

### 2.15 管理

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `#group-admin-add` | `#group-admin-add ID` | 指派当前群管理员 | 群管理员 |

| `#group-admin-delete` | `#group-admin-delete ID` | 取消当前群管理员 | 群管理员 |

| `#group-admin-list` | `#group-admin-list` | 列出指派的群管理员 | 群管理员 |

| `#itemadd` / `#增加物品` | `#itemadd [玩家ID] 物品 数量` | 给玩家发放物品（省略玩家 ID 给当前用户） | 超级管理员 |

| `#sbadd` / `#coinadd` / `#增加啥币` | `#sbadd [玩家ID] 数量` | 给玩家发放啥币 | 超级管理员 |

### 2.16 飞天大（图片处理，`-` 前缀）

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `-飞天大{王畅\|卤蛋\|wum\|羽蛇\|捏脸\|镜镜\|像像} [数量]` | 与图片同一条消息，如 `-飞天大卤蛋 3` | 按类型处理图片；数量缺省随机 1～15（捏脸 1～5）；`镜像` 是 `镜镜` 的兼容别名；`王畅` 要求本群已启用 | 所有人 |

| `-皈依飞天大wum` | 无参数 | 加入飞天大随机降临名单 | 所有人 |

| `-叛教飞天大wum` | 无参数 | 退出随机降临名单 | 所有人 |

| `-添加群飞天大wum` | 无参数 | 启用本群王畅召唤与随机降临 | 超级管理员 |

| `-删除群飞天大wum` | 无参数 | 停用本群王畅召唤与随机降临 | 超级管理员 |

被动触发：群与用户同时加入名单后，普通图片消息约有 10% 概率随机触发一次飞天大处理。

### 2.17 IUPAR（改词，`-`/`=` 前缀）

| 指令 | 用法 | 说明 | 权限 |

|---|---|---|---|

| `-iupar <内容>` / `=iupar <内容>` | `-iupar 你要买点啥` | 使用词库按词性改写内容 | 所有人 |

| `-delete <词语>` / `=delete <词语>` | `-delete 苹果` | 删除词库中的词条 | 超级管理员 |

| `-添加群iupar` / `添加群iupar` | 无参数 | 开启本群随机回复 | 超级管理员 |

| `-删除群iupar` / `删除群iupar` | 无参数 | 关闭本群随机回复 | 超级管理员 |

| `-群状态` / `=群状态` | 无参数 | 查看本群飞天大与 IUPAR 开关 | 所有人 |

被动触发：开启学习/回复的群里会学习发言，并有约 15% 概率对消息生成随机回复。

---

## 三、Shaolan（旧存档服务）指令

> 独立 MongoDB 存档，首次使用必须先选择存档；所有指令用 `-` 前缀，名称含空格时可用下划线代替。

### 3.1 存档选择

| 指令 | 用法 | 说明 |

|---|---|---|

| `-绑定 {旧QQ号}` | `-绑定 123456789` | 继承对应 QQ 号的老存档；5～12 位数字；绑定关系不可重复、不可更换 |

| `-不绑定` | `-不绑定` | 创建全新存档，从零开始 |

### 3.2 抓取与库存

| 指令 | 用法 | 说明 |

|---|---|---|

| `-抓wum` | `-抓wum` | 在当前背景抓取一只 WUM |

| `-来这抓wum {图片}` | 与图片同一条消息 | 把图片设为抓取背景，下次抓 WUM 使用 |

| `-wum库 [页码]` | `-wum库 2` | 查看个人 WUM 库存（图片） |

| `-wum奖池 [页码]` | `-wum奖池 1` | 查看系统奖池（图片） |

| `-wum进度` | `-wum进度` | 查看图鉴收集进度 |

| `-收藏 {名称}` | `-收藏 普通wum` | 收藏一只 WUM |

| `-取消收藏 {名称}` | `-取消收藏 普通wum` | 取消收藏 |

### 3.3 回收与盲盒

| 指令 | 用法 | 说明 |

|---|---|---|

| `-回收 {名称} {数量\|all}` | `-回收 普通wum all` | 回收指定 WUM，数量可用 `all` |

| `-回收全部{稀有度}` / `-回收所有{稀有度}` | `-回收全部普通` | 按稀有度回收；稀有度为：普通 / 轻冉 / 色彩 / 群 / 异 / 典 / 谜 |

| `-回收大于{数量}` / `-回收等于{数量}` / `-回收小于{数量}` | `-回收大于50` | 按持有数量回收 |

| `-wum盲盒` | `-wum盲盒` | 开普通盲盒 |

| `-wum大盲盒` | `-wum大盲盒` | 开大盲盒 |

| `-生成典wum` | `-生成典wum` | 生成典级 WUM |

### 3.4 异化

| 指令 | 用法 | 说明 |

|---|---|---|

| `-异化wum {名称} [数量] ...` | `-异化wum 普通wum 5 轻冉wum 5` | 投入 WUM 总数必须恰好为 10；数量为 1 时可省略；消耗当前全部异化点 |

| `-异化历史` | `-异化历史` | 查看最近 10 条异化记录（图片） |

| `-help 异化wum` | `-help 异化wum` | 查看异化帮助 |

---

## 四、Name Arena（名字竞技场，实验）指令

| 指令 | 用法 | 说明 |

|---|---|---|

| `#名字竞技场 <名字>` | `#名字竞技场 张三` | 给自己起名（≤20 字）并进入竞技场排队；同群有另一人进入时立即开战并返回 Markdown 战报；等待超时 10 分钟 |

---

## 五、注意事项

1. **前缀区分**：主后端命令主要是 `#`，飞天大与 IUPAR 使用 `-`（部分兼容 `=`）；Shaolan 全部使用 `-`。

2. **图片命令**：`-飞天大*`、`-来这抓wum` 必须与图片在同一条消息发送；QQ 官方普通群消息的回复段只有消息 ID，无法反查被回复的图片。

3. **参数含空格**：群定义 `#def` 系列使用引号包裹参数（如 `#def "A" say "B"`）；Shaolan 名称使用下划线代替空格。

4. **数据隔离**：Shaolan 的存档、货币与主后端完全隔离，两者互不影响；Name Arena 为独立实验服务。

5. **改动提示**：README 中曾记载“答错扣 100 啥币”，但当前代码 `COIN_QUIZ_WRONG_ANSWER_PENALTY = 0`，以代码为准，答错不扣。

6. **部署**：线上服务位于 `wum.hetonger.cn`，部署时保留玩家存档等运行数据。