BOT CORE / L01

名爵mj98bot房间里的自动应答层,先把运行方式弄明白

它不给你一个按钮,而是在房间里接消息、认指令、回状态。搞懂 mj98bot 的工作边界,掉线、重复回复、回执延迟这些问题就不难判断。

名爵导航页登录入口 名爵房间号:988888
名爵mj98bot 运行驾驶舱:健康度仪表、消息量、房间 988888 与事件日志
BOT CORE / HEALTH 98.6 / ROOM 988888
UPTIME42d连续在线
AVG LATENCY32ms指令回执
QUEUE128待处理消息
ROOM988888已绑定
Definition

名爵mj98bot 是什么

一句话:它是房间 988888 里的自动化服务进程,负责监听消息、识别指令、给出回执。你不需要安装它,只需要知道它在什么条件下工作。

它处理的是「消息」,不是「页面」。当群里出现符合格式的指令,mj98bot 会解析、校验、执行,然后把结果作为一条回执发回房间。整个链路在后台完成,前端只负责展示。

它绑定房间号,不绑定设备。房间号统一为 988888,同一房间内换手机、换浏览器都不影响机器人工作;反过来,房间号填错,机器人就收不到你的指令。

它和 mjbotapp 是一体两面。mj98bot 是后端能力,mjbotapp 是把这些能力可视化出来的客户端。只聊天可以用 H5,需要通知与常驻再装客户端。

Capability Matrix

六项核心能力,各司其职

不必全部记住,遇到问题时按「消息、指令、状态、日志」四类去找对应能力即可。

消息接收

持续监听房间 988888 的新消息,按时间顺序进入队列,丢弃重复投递。

QUEUE

指令识别

识别斜杠指令与约定格式,区分大小写与空格,格式不符会回执提示。

PARSE

状态回执

执行结果以 ok / retry / fail 三种状态返回,fail 附带错误码。

ACK

房间绑定

一个机器人实例对应一个房间号,绑定 988888 后自动开始工作。

BIND

掉线重连

网络抖动时自动重试,超过阈值转为手动重连,并记录重连次数。

RETRY

日志留痕

关键动作写入事件日志,含时间、动作名与结果,便于回溯。

LOG
Command Reference

常用指令与回执格式

指令以斜杠开头,参数之间用单个空格分隔。下表为常用项,具体以房间公告为准。

MJ98BOT COMMAND TABLE / ROOM 988888
指令作用示例回执状态
/room bind 988888绑定或核对房间号bind ok · room 988888ok
/status查看机器人与会话状态online · session validok
/msg sync补拉最近一段消息sync 128 recordsok
/log tail 20查看最近 20 条事件log tail readyok
/room switch切换房间(需权限)permission deniedfail E403
/help返回指令清单help · 12 commandsok
Message Lifecycle

一条消息的四段旅程

理解这四段,就能判断卡在哪一层:房间没收到、解析失败、执行超时,还是回执没送达。

  1. 入队

    消息进入接收队列,按时间排序并去重,网络差时队列会变长。

  2. 解析

    识别指令名与参数,格式不符则直接回执提示,不进入执行。

  3. 执行

    调用房间能力完成动作,超过超时阈值会标记为可重试。

  4. 回执

    把结果写回房间,同时落一条日志,失败时附错误码。

Room Binding

把机器人绑定到 988888

绑定动作通常由房间管理员在后台完成,普通成员只需确认自己填的房间号正确。若你是管理员,按下面的顺序核对。

  1. 进入管理后台,选择「房间设置」。
  2. 在房间号一栏确认是六位数字 988888。
  3. 保存后观察状态灯,变为在线即绑定成功。
  4. 在房间内发送 /status 验证回执。
BOUND ROOM 988888 ONE BOT · ONE ROOM
Compatibility

终端与系统兼容性

mj98bot 在后台运行,本身不挑设备;受影响的只是你用来查看消息的终端。下表按常见组合列出建议。

Android 9+ iOS 14+ Windows 10+ macOS 12+ Chrome 100+ Safari 15+ Edge 100+ 国产浏览器(需极速模式) IE / 旧版内核(不支持)
TERMINAL MATRIX
终端推荐方式消息提醒备注
Android 手机mjbotapp / H5支持需允许后台运行
iPhoneH5 / mjbotapp支持注意省电策略
Windows 电脑mjbotapp支持适合长时间挂机
平板H5部分横屏建议放大字号
Error Codes

错误码与处理动作

回执里看到 fail 时,先对码,再动作。多数错误码的含义是「重试即可」,不需要改配置。

ERROR CODE / ACTION
错误码含义处理动作等级
E401会话失效或已过期重新进入房间,刷新会话中
E403当前角色无此权限联系管理员调整角色中
E409房间号冲突或重复绑定核对是否为 988888,避免多端绑定高
E429发送过于频繁等待 30 秒后重发低
E503中继超时换网络后重试,观察是否恢复高
E-988房间未绑定或号码错误回到绑定流程,确认 988888高
Security Boundary

机器人能做什么,不能做什么

把边界说清楚,比堆功能列表更有用。以下两类要区分开。

它可以做的事

接收房间消息、识别指令、返回执行状态、记录事件日志、在掉线后自动重连。所有动作都围绕房间 988888 展开。

它不会做的事

不会主动私聊索要密码或验证码,不会要求你转账,也不会让你安装来源不明的文件。遇到这类要求,一律视为冒充。

权限最小化

只授予房间内必要的消息与状态权限。管理员在后台可以随时撤销绑定,撤销后机器人立即停止响应。

不要共享会话

同一账号不要在多个设备同时登录,避免会话互相顶掉。公共设备用完请退出,不要勾选长期保持登录。

Changelog

版本与更新记录

页面内容与说明口径变更时记录在此,便于核对某次反馈对应的版本。

EVENT LOGLAST 5
doc.update 重写运行说明,补充 E-988 错误码
doc.update 新增终端兼容性矩阵
flow.change 消息生命周期改为四段描述
doc.update 统一房间号为 988888
init 页面首次发布
FAQ

关于 mj98bot 的高频问题

不需要。mj98bot 运行在房间后台,由管理端绑定房间 988888 后自动工作。普通成员感知到的是它在群里回复指令;如果希望有独立的消息面板与通知,再安装 mjbotapp 客户端。

先确认房间号是 988888、指令拼写与空格无误,再看会话是否过期。多数情况是会话失效(E401)或中继超时(E503),重新进入房间或等待几十秒重发即可恢复。

常见原因是网络在 Wi-Fi 与移动数据之间切换、同一账号在多个终端同时登录,或系统限制了后台运行。保留单一登录端、给客户端后台权限,能显著减少掉线。

回执一般由时间、指令名与状态三部分组成。状态为 ok 表示已受理,retry 表示需要重发,fail 后面会跟错误码,可对照本页错误码表处理。

通用。两者使用同一套账号体系与同一个房间号 988888,客户端只是把机器人能力做成了可视化面板,不产生第二套账号。

回执还是对不上?把截图发过来

附上回执原文、发生时间与所用终端,客服会判断是会话、权限还是房间绑定层面的问题。

本页为 mj98bot 使用说明,内容随版本更新;涉及账号与资金的操作为第三方行为,请自行核实。返回 weixinqun.cc 首页 查看七条线路全图。