消息接收
持续监听房间 988888 的新消息，按时间顺序进入队列，丢弃重复投递。
QUEUE
BOT CORE / L01
名爵mj98bot房间里的自动应答层，先把运行方式弄明白
它不给你一个按钮，而是在房间里接消息、认指令、回状态。搞懂 mj98bot 的工作边界，掉线、重复回复、回执延迟这些问题就不难判断。
名爵导航页登录入口
名爵房间号：988888
UPTIME42d连续在线
AVG LATENCY32ms指令回执
QUEUE128待处理消息
ROOM988888已绑定
名爵mj98bot 是什么
一句话：它是房间 988888 里的自动化服务进程，负责监听消息、识别指令、给出回执。你不需要安装它，只需要知道它在什么条件下工作。
它处理的是「消息」，不是「页面」。当群里出现符合格式的指令，mj98bot 会解析、校验、执行，然后把结果作为一条回执发回房间。整个链路在后台完成，前端只负责展示。
它绑定房间号，不绑定设备。房间号统一为 988888，同一房间内换手机、换浏览器都不影响机器人工作；反过来，房间号填错，机器人就收不到你的指令。
它和 mjbotapp 是一体两面。mj98bot 是后端能力，mjbotapp 是把这些能力可视化出来的客户端。只聊天可以用 H5，需要通知与常驻再装客户端。
六项核心能力，各司其职
不必全部记住，遇到问题时按「消息、指令、状态、日志」四类去找对应能力即可。
指令识别
识别斜杠指令与约定格式，区分大小写与空格，格式不符会回执提示。
PARSE状态回执
执行结果以 ok / retry / fail 三种状态返回，fail 附带错误码。
ACK房间绑定
一个机器人实例对应一个房间号，绑定 988888 后自动开始工作。
BIND掉线重连
网络抖动时自动重试，超过阈值转为手动重连，并记录重连次数。
RETRY日志留痕
关键动作写入事件日志，含时间、动作名与结果，便于回溯。
LOG常用指令与回执格式
指令以斜杠开头，参数之间用单个空格分隔。下表为常用项，具体以房间公告为准。
| 指令 | 作用 | 示例回执 | 状态 |
|---|---|---|---|
/room bind 988888 | 绑定或核对房间号 | bind ok · room 988888 | ok |
/status | 查看机器人与会话状态 | online · session valid | ok |
/msg sync | 补拉最近一段消息 | sync 128 records | ok |
/log tail 20 | 查看最近 20 条事件 | log tail ready | ok |
/room switch | 切换房间（需权限） | permission denied | fail E403 |
/help | 返回指令清单 | help · 12 commands | ok |
一条消息的四段旅程
理解这四段，就能判断卡在哪一层：房间没收到、解析失败、执行超时，还是回执没送达。
入队
消息进入接收队列，按时间排序并去重，网络差时队列会变长。
解析
识别指令名与参数，格式不符则直接回执提示，不进入执行。
执行
调用房间能力完成动作，超过超时阈值会标记为可重试。
回执
把结果写回房间，同时落一条日志，失败时附错误码。
Room Binding
把机器人绑定到 988888
绑定动作通常由房间管理员在后台完成，普通成员只需确认自己填的房间号正确。若你是管理员，按下面的顺序核对。
- 进入管理后台，选择「房间设置」。
- 在房间号一栏确认是六位数字 988888。
- 保存后观察状态灯，变为在线即绑定成功。
- 在房间内发送
/status验证回执。
BOUND ROOM
988888
ONE BOT · ONE ROOM
终端与系统兼容性
mj98bot 在后台运行，本身不挑设备；受影响的只是你用来查看消息的终端。下表按常见组合列出建议。
Android 9+
iOS 14+
Windows 10+
macOS 12+
Chrome 100+
Safari 15+
Edge 100+
国产浏览器（需极速模式）
IE / 旧版内核（不支持）
| 终端 | 推荐方式 | 消息提醒 | 备注 |
|---|---|---|---|
| Android 手机 | mjbotapp / H5 | 支持 | 需允许后台运行 |
| iPhone | H5 / mjbotapp | 支持 | 注意省电策略 |
| Windows 电脑 | mjbotapp | 支持 | 适合长时间挂机 |
| 平板 | H5 | 部分 | 横屏建议放大字号 |
错误码与处理动作
回执里看到 fail 时，先对码，再动作。多数错误码的含义是「重试即可」，不需要改配置。
| 错误码 | 含义 | 处理动作 | 等级 |
|---|---|---|---|
E401 | 会话失效或已过期 | 重新进入房间，刷新会话 | 中 |
E403 | 当前角色无此权限 | 联系管理员调整角色 | 中 |
E409 | 房间号冲突或重复绑定 | 核对是否为 988888，避免多端绑定 | 高 |
E429 | 发送过于频繁 | 等待 30 秒后重发 | 低 |
E503 | 中继超时 | 换网络后重试，观察是否恢复 | 高 |
E-988 | 房间未绑定或号码错误 | 回到绑定流程，确认 988888 | 高 |
机器人能做什么，不能做什么
把边界说清楚，比堆功能列表更有用。以下两类要区分开。
它可以做的事
接收房间消息、识别指令、返回执行状态、记录事件日志、在掉线后自动重连。所有动作都围绕房间 988888 展开。
它不会做的事
不会主动私聊索要密码或验证码，不会要求你转账，也不会让你安装来源不明的文件。遇到这类要求，一律视为冒充。
权限最小化
只授予房间内必要的消息与状态权限。管理员在后台可以随时撤销绑定，撤销后机器人立即停止响应。
不要共享会话
同一账号不要在多个设备同时登录，避免会话互相顶掉。公共设备用完请退出，不要勾选长期保持登录。
版本与更新记录
页面内容与说明口径变更时记录在此，便于核对某次反馈对应的版本。
EVENT LOGLAST 5
doc.update 重写运行说明，补充 E-988 错误码
doc.update 新增终端兼容性矩阵
flow.change 消息生命周期改为四段描述
doc.update 统一房间号为 988888
init 页面首次发布
关于 mj98bot 的高频问题
不需要。mj98bot 运行在房间后台，由管理端绑定房间 988888 后自动工作。普通成员感知到的是它在群里回复指令；如果希望有独立的消息面板与通知，再安装 mjbotapp 客户端。
先确认房间号是 988888、指令拼写与空格无误，再看会话是否过期。多数情况是会话失效（E401）或中继超时（E503），重新进入房间或等待几十秒重发即可恢复。
常见原因是网络在 Wi-Fi 与移动数据之间切换、同一账号在多个终端同时登录，或系统限制了后台运行。保留单一登录端、给客户端后台权限，能显著减少掉线。
回执一般由时间、指令名与状态三部分组成。状态为 ok 表示已受理，retry 表示需要重发，fail 后面会跟错误码，可对照本页错误码表处理。
通用。两者使用同一套账号体系与同一个房间号 988888，客户端只是把机器人能力做成了可视化面板，不产生第二套账号。
本页为 mj98bot 使用说明，内容随版本更新；涉及账号与资金的操作为第三方行为，请自行核实。返回 weixinqun.cc 首页 查看七条线路全图。