---
read_when:
  - 调试 Mac 应用健康指示器
summary: macOS 应用如何报告 Gateway 网关和渠道健康状态
title: 健康检查
x-i18n:
  generated_at: "2026-02-03T07:52:40Z"
  model: manual
  provider: manual
  source_hash: 0560e96501ddf53a499f8960cfcf11c2622fcb9056bfd1bcc57876e955cab03d
  source_path: platforms/mac/health.md
  workflow: 15
---

# macOS 上的健康检查

如何从菜单栏应用查看 Gateway 网关和关联渠道是否健康。

## 菜单栏

- 状态圆点反映 Gateway/渠道健康状态：
  - 绿色：Gateway 可达，并且在有渠道数据时，关联渠道 socket 最近已打开。
  - 橙色：正在连接/重试。
  - 红色：已登出或探测失败。
- 第二行显示"linked · auth 12m"或显示失败原因。
- "Run Health Check"菜单项触发按需探测。

## 设置

- 通用选项卡新增健康卡片，显示：关联认证时间、会话存储路径/数量、上次检查时间、上次错误/状态码，以及运行健康检查/显示日志按钮。
- 使用缓存快照，因此 UI 立即加载，离线时优雅降级。
- 频道账号设置和路由在浏览器 Control UI 的 **Agent > Channels** 中管理。macOS 应用可以显示健康状态，但不是 Agent 路由的事实来源。

## 探测工作原理

- 应用每约 60 秒和按需时通过 `ShellExecutor` 运行 `fased health --json`。探测加载凭证并报告状态，不发送消息。
- 分别缓存上次成功的快照和上次错误以避免闪烁；显示每个的时间戳。

## 有疑问时

- 你仍然可以使用 [Gateway 网关健康](/gateway/health) 中的 CLI 流程（`fased status`、`fased status --deep`、`fased health --json`）和 `fased logs --follow` 查看 Gateway 诊断。
