倾慕慕官机平台 教程中心
首页控制台工作流后台插件SDK

排错手册

这里是 倾慕慕官机平台 的全站详细教程。教程按实际使用顺序编写，从账号登录、后台设置、机器人管理，到可视化工作流、节点、变量、按钮、排错全部覆盖。

排错手册

页面显示异常

  1. 先 Ctrl+F5 强制刷新。
  2. 换浏览器测试。
  3. 检查是否登录过期。
  4. 如果是刚修改过页面，可能是前端 JS 报错，需要检查浏览器控制台。

工作流不执行

  1. 确认选择的是正确机器人。
  2. 确认工作流状态为启用。
  3. 确认触发器关键词和匹配方式。
  4. 确认是否需要艾特。
  5. 确认触发器后面有连线。

执行到一半停止

  1. 检查中间节点是否缺少必要配置。
  2. HTTP 请求是否超时。
  3. JSON 解析路径是否错误。
  4. 判断节点对应出口是否连线。
  5. 循环是否缺循环尾。

修改不生效

  1. 确认点了保存流程。
  2. 刷新页面重新打开工作流。
  3. 确认测试的是同一个机器人和同一个群。
  4. 如果仍不生效，检查是否有另一个工作流也被同一触发词触发。

补充：新手完整使用路线

如果是第一次使用，建议不要一上来就改复杂配置。先按下面顺序走一遍，能减少大部分配置错误。

  1. 先登录账号，进入用户中心确认账号状态正常。
  2. 进入机器人管理，确认机器人已添加、在线状态正常、AppID 和密钥配置正确。
  3. 进入插件系统，只开启当前需要的插件，避免多个插件同时响应同一条消息。
  4. 如果只是固定关键词回复，优先使用词库。
  5. 如果需要判断、请求接口、变量拼接、按钮消息，再使用工作流。
  6. 配置完成后，先在测试群里验证，再放到正式群使用。
建议每次只改一个功能，测试没问题后再继续改下一个功能。这样出现问题时更容易定位。

补充：QQ聊天页面使用说明

基础聊天

  • 左侧选择机器人和联系人，右侧显示当前会话。
  • 输入框发送普通文字时，默认按纯文本发送。
  • 聊天记录会自动轮询刷新，新消息会追加到当前会话底部。
  • 上滑到顶部时，会自动加载更早聊天记录。

MD、@ 和 TTS

功能用途说明
MDMarkdown 消息用于发送带格式、按钮、链接等结构化消息。
@艾特群成员在群聊中快速插入艾特对象。
TTS文字转语音输入文字后选择音色，点击 TTS 生成并发送语音。
音色选择切换语音声音只展示当前接口实测可用音色，避免选择后生成失败。
TTS 依赖第三方语音接口。若某个音色临时失败，可换一个音色或稍后再试。

语音消息说明

语音发送后，页面会先显示本地生成的语音气泡，随后后台会保存为正式聊天记录。刷新页面后，如果历史记录中存在该语音，会继续显示为可播放的 audio 控件。

补充：工作流配置检查清单

工作流保存前，建议按下面清单检查一遍。

  1. 是否有且只有需要的触发器。
  2. 触发器关键词是否和实际发送内容一致。
  3. 是否设置了“需要艾特”，如果设置了，测试时必须艾特机器人。
  4. 每个节点是否都连到了下一步。
  5. 判断节点的“符合条件”和“不符合条件”出口是否都按需求连接。
  6. HTTP 请求节点的地址、请求方式、请求头、参数是否填写完整。
  7. JSON 解析节点的路径是否和接口真实返回一致。
  8. Markdown 节点的按钮是否保存，按钮数量是否超出限制。
  9. 循环节点是否连接循环尾，避免流程提前结束。
  10. 修改后是否点击保存流程。

补充：常用变量速查

变量含义常见用途
{user_id}触发用户个性化回复、用户判断、接口参数。
{user_name}用户昵称个性化称呼，例如“欢迎 {user_name}”。昵称为空时自动兜底为用户ID后6位。
{group_id}触发群区分不同群配置、传给接口。
{content}原始消息内容转发用户输入、关键词判断。
{recv_msg}收到的消息内容兼容部分旧流程。
{参数1}第一个参数如“查询 天气”，天气就是参数1。
{参数2}第二个参数多参数命令使用。
{参数}全部参数把触发词后面的内容整体传给接口。
{time}当前时间日志、签到、提示消息。
变量名要完整复制，包含左右花括号。变量为空时，优先检查触发词是否真的带了参数。

补充：接口请求排错

HTTP 请求节点最常见的问题不是平台错误，而是接口参数、鉴权或返回格式不符合预期。

检查顺序

  1. 先在浏览器或接口测试工具中确认接口本身可访问。
  2. 确认请求方式是 GET 还是 POST。
  3. 确认 Content-Type 是否符合接口要求。
  4. 需要 token、key、cookie 的接口，要确认请求头或参数已填写。
  5. 接口返回不是 JSON 时，不要接 JSON 解析节点。
  6. 接口返回字段层级变化时，要同步修改 JSON 路径。
示例 JSON：{"data":{"title":"今日标题"}}
解析路径：data.title
保存变量：title
后续使用：{title}

补充：安全与维护建议

  • 不要在公开群里发送后台账号、密码、机器人密钥、接口 token。
  • 管理员修改后台配置前，建议先记录原配置。
  • 重要流程修改前可以复制一份备用流程。
  • 插件、词库、工作流如果响应重复，优先检查是否多个功能同时命中同一关键词。
  • 页面异常时先 Ctrl+F5 强制刷新，再判断是否是真故障。
  • 如果刚发布过新代码或改过页面，浏览器缓存可能导致旧 JS 继续生效。
© 2026 倾慕慕官机平台 · 宁ICP备2024002935号-1