运维状态

1. 页面概览

运维状态页（路由 /ops，OpsHealthPage.vue）是平台级健康观测页：页面加载后立即检测一次，之后每 10 秒轮询五大产品（AIP/Foundry/Apollo/Gotham/Swift）的 /health 探针，以「服务健康卡」实时展示各服务存活状态；同时提供「授权信息」（AIP /license/info，仅首次加载 + 手动刷新）、「产品信息」与「运维参考信息」三张只读卡片。

2. 访问入口

• 路由与菜单：路由 /ops（name OpsHealth），顶部导航栏「运维状态」入口（App.vue）；源码 action/web/src/views/OpsHealthPage.vue（362 行）。
• 认证与权限：路由 meta.requiresAuth = true，需先登录 AIP（aip_token）；授权信息经 aipClient 自动附带 Bearer token。
• 端口与 API 前缀：健康探针按产品前缀同源访问（/aip-api→18080、/api→18081、/apollo-api→18082、/gotham-api→18083、/swift-api→18084）；授权信息 /aip-api/v1/license/info。

3. 界面布局

┌──────────────────────────────────────────────┐
│ ① 页头：运维健康状态 + [立即检测/检测中...]   │
│ ② 操作结果提示条（alert，可关闭）             │
│ ③ 服务健康卡网格（2 列，5 张卡）             │
│   AIP/Foundry/Apollo/Gotham/Swift             │
│ ④ 授权信息卡：[刷新]                         │
│ ⑤ 产品信息卡（只读静态）                     │
│ ⑥ 运维参考信息卡（进程表 + 日志 + 降级说明） │
└──────────────────────────────────────────────┘

各板块职责：

• ① 页头：标题 + 「立即检测」按钮（检测中置灰显示「检测中...」）。
• ③ 服务健康卡：每卡显示服务名、状态徽标（检测中/正常/部分依赖异常/异常）、端口、service 标识、最近检查时间；异常时附「失败原因」。AIP 卡额外渲染依赖级明细列表（数据库 / 向量库 / LLM 网关 / 磁盘空间：状态 + 耗时 + 错误信息）；服务网格下方有常驻说明「依赖级明细仅 AIP 提供；其余四产品健康端点只回二元存活（后端契约差异）」，其余四产品卡不渲染空明细区。
• ④ 授权信息卡：授权状态（已授权/未授权）、有效期、机器码、AUTH_KEY（已设置/未设置）、说明；「刷新」按钮手动重拉。
• ⑤ 产品信息卡：产品名称/中文名称/开发公司/版本日期/官网/微信（静态）。
• ⑥ 运维参考信息卡：六进程表 + 日志位置 + 数据库降级说明 + gateway 探针说明。

4. 交互元素

5. 后端关联

5.1 API 端点

5.2 关键机制

• 轮询与并发：onMounted 立即 checkAll() 一次，之后 setInterval(checkAll, 10000) 每 10 秒轮询（onBeforeUnmount 清理定时器）；各服务用 Promise.allSettled 并发检测，单个失败不影响其他卡。
• 3 秒超时：每个探针请求用 axios 原生 { timeout: 3000 }（真正中断在途连接，替代此前无法取消底层连接的 Promise.race 包装），超时视为异常。
• 健康判定：响应 data.status === 'ok' 判「正常」；degraded 判独立琥珀态「部分依赖异常」；unhealthy/其他状态判「异常」并附 status=... 或「响应异常」；后端健康响应带 service 字段时覆盖卡的 service 标识。
• 依赖级明细：AIP 富响应 checks（{<name>: {status, latency_ms, message}}，products/aip/health/health.go:27-39）逐项渲染为中文名 + 状态 + 耗时 + 错误信息；degraded 时可直接看出挂掉的依赖项。其余四产品只回 {status:"ok", service}，无 checks 字段，故不渲染明细区（界面常驻说明该契约差异）。
• 授权信息：仅首次加载 + 手动刷新（不参与 10s 轮询）；失败时展示「AIP 未启动或未登录」等提示。
• 后端健康端点（AIP server.go）：GET /health（全依赖）、/health/live（存活）、/health/ready（就绪）、/api/health 别名；响应 {status, checks, timestamp}。

6. 权限与安全

• 进入页面需 AIP 登录（路由 requiresAuth）；健康探针走网关前缀同源访问，无需额外鉴权。
• 授权信息经 aipClient 附带 Bearer aip_token；401 时自动清理登录态并跳转 /login。
• 页面只读，无写操作；进程启停与日志查看需命令行（平台不提供 API）。

7. 常见问题与排错

1. 某服务卡长期「异常」：该产品后端未启动。启动对应进程（aip/foundry/apollo/gotham/swift）后点「立即检测」；确认端口未被占用。
2. 授权信息显示「未授权」：未配置 AUTH_KEY 或授权过期。前往「设置」页保存 AUTH_KEY 并「刷新有效期」；仍失败请联系厂商（官网 zyinfo.pro）。
3. 授权信息提示「AIP 未启动或未登录」：AIP 后端（18080）未启动或 token 过期。启动 AIP、重新登录后再「刷新」。
4. 卡片一直「检测中」：单请求 3 秒超时后仍失败，多为网络/代理不可达。检查 DevTools Network 中 /xxx-api/health 是否 502/超时。

8. 已知缺陷与边界