> 规范网页：https://docs.tensuu.com/核心概念/结果判断与排障.html ｜ Markdown：/核心概念/结果判断与排障.md ｜ 文档修订：2026.10.26

# 怎样判断结果与排查问题

“提示成功了，但群里没有变化”不一定是同一种问题。先确定成功的是哪一步，再选择对应记录。**没有回复不等于没有执行，结果未知也不等于执行失败。**

## 先分清四个层次 {#结果层次}

```text
配置保存 → 条件满足或匹配 → 请求受理/处理 → 平台结果或实际投递
```

这是理解结果的分层图，不表示每项功能都有四个同名状态，也不表示每一步都提供可长期查询的记录。

| 看到什么 | 可以证明 | 还不能证明 |
| --- | --- | --- |
| 保存提示成功，刷新回读一致 | 这项配置已保存 | 运行时已经消费、规则已经命中 |
| 预览或测试匹配命中 | 预览范围内的匹配或模板结果符合条件 | 群内权限、所有运行前提、平台动作一定成功 |
| 已受理、已排队、执行中 | 请求进入了相应处理环节 | 平台已经执行、消息已送达 |
| 对应功能确认平台执行或发送成功 | 该记录所述动作获得成功确认 | 每个成员都看见消息，或所有相关业务都完成 |
| 失败、拒绝、被保护条件阻止 | 该环节未取得成功结果或明确未派发 | 其他独立动作一定没有发生 |
| 未知、未证实、记录不可用 | 当前无法确认某个结果 | 一定没执行、可以重试、一定没有费用 |

## 该去哪个入口看 {#结果入口}

没有一个列表能证明所有功能的最终结果。按你正在检查的业务选择入口，并核对群、时间和具体对象。

| 业务 | 先看哪里 | 再检查什么 |
| --- | --- | --- |
| 关键词、刷屏等监控处理 | 群设置 → 群聊监控 → 最近触发记录 | 处理方式与动作终态、命中规则标识、触发消息 |
| 问答 | 群设置 → 问答词库 | 测试匹配、渲染结果、命中/受理/发送确认等计数，不能只看命中数 |
| 定时任务 | 群设置 → 定时任务；日志中心 → 调试 / 出站结果 | 上次执行时间只证明调度尝试，再按[定时任务说明](../功能模块详解/12_定时任务.md)核对出站与应用日志，不到监控触发记录找送达 |
| 投票 | 群设置 → 基本设置中的投票状态 | 投票通过与平台处罚分开，见[投票](../功能模块详解/24_投票.md) |
| AI 总结 | AI 管理 → 消息总结 → 详情 | 内容生成状态、缺失范围与投递状态分别看 |
| AI 调用与额度 | AI 管理 → 运行与用量 | 是否发起、服务商结果、额度和费用是否已知 |
| 持续清退 | 群设置 → 踢人设置的执行/授权状态，及相应处理记录 | 能力、授权范围、额度、未决结果和实际目标 |
| 程序、连接或保存异常 | 日志中心 → 应用日志 | 对应时间的错误，再按需要查本地日志文件 |

审计日志、调试记录和出站结果各有用途与保留边界；详见[应用日志](../功能模块详解/17_应用日志.md)。查询失败时不能把空列表当作“零动作”；页面仍显示旧结果时也不能当作本次查询的事实。

### 监控记录中的两个“动作” {#监控动作结果}

- **处理方式**是规则想做什么，例如警告、禁言、踢出、仅记录。
- **动作终态**是该条动作实际走到哪一步。例如平台已执行、平台已拒绝、未派发或派发结果未知。

所以“处理方式是踢出”不证明成员已经被移出。“仅记录（零出站）”表示该条规则不发送或处罚，不保证整个群的其他独立功能都没有动作。

### AI 的两个结果 {#ai结果}

“总结生成成功”和“发进群”是两件事。创建总结时未打开投递到群，内容可以只留在控制台；请求服务商成功也不代表机器人已经发送。额度是调用量约束，不是服务商金额账单；“费用未知”不能记为免费。

## 不生效时按什么顺序查 {#排查顺序}

1. **目标是不是对的**：平台群号、本地群、连接、方案与规则是否对应？不要拿模板群测试真实群效果。
2. **配置是否真的保存**：刷新回读；即时保存和卡片保存分开看。提示冲突时先读最新值，不覆盖重试。
3. **输入是否到达**：连接链路、机器人身份与群消息是否对应；消息记录未启用时，列表为空不能单独证明没收到。
4. **触发条件是否满足**：开关、绑定、优先级、匹配方式、时间、变量、模型就绪等。只检查当前功能需要的条件。
5. **是否被正确限制**：发起者权限、目标保护、机器人平台权限、授权、额度与锁。按设计拒绝不等于故障。
6. **走到了哪一步**：在对应入口核对本次结果；用群号、时间及记录标识关联，不把不同次尝试拼成一次成功。

例如问答没有回复：先看问答是否启用和测试匹配结果，再看是否被前序业务接受、模板是否可渲染、回复是否受理及平台发送结果。不要一开始就重建机器人、清库或关闭保护。

## 失败、超时和未知时怎样做 {#未知结果}

| 情况 | 正确处理 | 不要做 |
| --- | --- | --- |
| 配置版本冲突 | 刷新，理解最新配置后只改必要项 | 用旧页面反复覆盖 |
| 保存或导入提示失败，但可能已写入 | 先刷新回读，核对条目/值/数量 | 直接重复整批导入 |
| 平台动作结果未知 | 查原尝试及平台状态，遵守该功能的未决处理规则 | 因为“没看见”就再踢一次或换机器人再发 |
| AI 服务超时或费用未知 | 查调用与服务商账单，必要时停用新调用 | 当作零费用，靠反复重试猜结果 |
| 查询或记录读取失败 | 修复读取条件后再查 | 将空表、旧统计当作当前真实结果 |

不是所有失败都存在同样的恢复按钮。持续清退、投票、问答和配置导入的处理方式不同，不能把一个功能的重试规则复制到另一个功能。

## 怎样安全止损 {#止损与回退}

- 按来源停用对应规则、群功能、定时扫描或 AI 任务，并保存回读；不要认为一个局部总开关能关闭所有处罚。
- 停用通常不删除原配置，但已发送的消息、已派发的动作和已外传的数据不会因此撤回。被踢成员也不能靠改回开关自动回群。
- 删除、恢复默认、导入配置和恢复备份不是同一个动作。当前备份校验不执行数据恢复，见[数据备份](../功能模块详解/07_云端设置.md)。
- 提问时提供功能入口、目标范围、错误原文、发生时间和脱敏的相关记录；不要公开 Token、Key、确认码、整库或完整群消息。

相关：[工作方式与作用范围](工作方式与作用范围.md) · [常见问题](../快速入门指南/常见问题.md) · [应用日志](../功能模块详解/17_应用日志.md)