建筑学/可靠的交付和回收
可靠的交付和回收
v1.0.x · 已更新 2026-07-27
AiHummer 旨在即使在通道连接短暂中断或实例重启时也能完成回复。本页描述了 可见行为 以及管理员应采取的措施。它故意不要求你了解平台的内部传输机制。
用户应该看到的内容
在用户发送消息之后:
- 会话显示了被接收的消息。
- 代理处理它并产生一个可见的回复。
- 如果频道暂时不可用,将会重试投递。
- 当频道返回时,回复会出现,而无需用户发送
同样的请求再次。
同样的请求不应产生重复的可见回复。如果客户端重新连接,它可能会重新加载最近的历史记录,但对话本身仍然是一个连续的会话。
重启后会发生什么
实例更新、主机重启或意外重启不应导致已接受的请求消失。可以安全继续的工作在实例恢复健康后会继续进行。用户应该看到已完成的回复或可以重试的明确失败状态。
[!NOTE]
在实例仍在恢复时,请不要立即重复请求。
首先等待健康状态恢复正常,然后刷新会话。
这避免了在正在恢复的请求旁边创建一个真正新的请求。
如果没有回复
- 打开 状态 并确认实例和受影响的频道是
健康的。
- 打开会话并刷新一次。
- 检查 通知 用于交付或渠道警告。
- 只有在前一个请求可见后才发送新的简短测试消息
成功或失败的结果。
- 如果问题再次发生,请记录时间、会话、频道和可见错误,
然后联系支持。切勿将 API 密钥或频道密钥粘贴到工单中。
对于特定频道的恢复,请打开相应指南下的 频道例如健康检查,请参见 Systemd 和健康检查.
管理员应监控的事项
关注用户可见的结果,而不是实现细节:
- 回复停止到达一个频道,而其他频道正常工作;
- 会话异常长时间仍在进行;
- 实例反复在健康和不可用之间切换;
- 通知报告重复的传送失败;
- 用户会看到针对同一个已接受请求的重复回复。
这些症状及其时间戳足以让支持团队诊断问题。
接下来去哪儿
AiHummer 旨在即使在通道连接短暂中断或实例重启时也能完成回复。本页描述了 **可见行为** 以及管理员应采取的措施。它故意不要求你了解平台的内部传输机制。
## 用户应该看到的内容
在用户发送消息之后:
1. 会话显示了被接收的消息。
2. 代理处理它并产生一个可见的回复。
3. 如果频道暂时不可用,将会重试投递。
4. 当频道返回时,回复会出现,而无需用户发送
同样的请求再次。
同样的请求不应产生重复的可见回复。如果客户端重新连接,它可能会重新加载最近的历史记录,但对话本身仍然是一个连续的会话。
## 重启后会发生什么
实例更新、主机重启或意外重启不应导致已接受的请求消失。可以安全继续的工作在实例恢复健康后会继续进行。用户应该看到已完成的回复或可以重试的明确失败状态。
> [!NOTE]
> 在实例仍在恢复时,请不要立即重复请求。
> 首先等待健康状态恢复正常,然后刷新会话。
> 这避免了在正在恢复的请求旁边创建一个真正新的请求。
## 如果没有回复
1. 打开 **状态** 并确认实例和受影响的频道是
健康的。
2. 打开会话并刷新一次。
3. 检查 **通知** 用于交付或渠道警告。
4. 只有在前一个请求可见后才发送新的简短测试消息
成功或失败的结果。
5. 如果问题再次发生,请记录时间、会话、频道和可见错误,
然后联系支持。切勿将 API 密钥或频道密钥粘贴到工单中。
对于特定频道的恢复,请打开相应指南下的 [频道](/zh/v1.0/webui/channels)例如健康检查,请参见 [Systemd 和健康检查](/zh/v1.0/operations/systemd-health).
## 管理员应监控的事项
关注用户可见的结果,而不是实现细节:
- 回复停止到达一个频道,而其他频道正常工作;
- 会话异常长时间仍在进行;
- 实例反复在健康和不可用之间切换;
- 通知报告重复的传送失败;
- 用户会看到针对同一个已接受请求的重复回复。
这些症状及其时间戳足以让支持团队诊断问题。
## 接下来去哪儿
- [网关和转向引擎](/zh/v1.0/architecture/gateway-turn-engine)
- [可观测性](/zh/v1.0/operations/observability)
- [频道](/zh/v1.0/webui/channels)