技能介绍

要解决什么问题

运维侧经常要在监控平台里核对「哪些主机正常、哪些异常、当前还有哪些未恢复告警」，并把这些结论交给值班或管理层。手工在控制台里翻主机列表、再对告警明细，既慢又容易漏掉分页边界；若还要同时给出可归档的 Excel，往往还要再抄一遍表格。

技能如何工作

本技能用 纯 Python 跑通一次完整巡检，不依赖 Node 或臆造的 CLI 子命令。核心入口是 generate_report.py，取数与字段归一化集中在 alert_data.py。

主机必须分两次查询，不能一次 host-list 全量再本地猜分组：

正常主机：active_status=0
异常主机：active_status[0..5] 分别为 1,5,4,3,2,-1

两次结果合并后，再拉告警数据，并落盘标准化 hosts.json / problems.json，同时生成 Markdown 文本报告。

Excel 通过 references/export_excel_template.py 的结构生成一次性临时脚本（替换 {{HOSTS_JSON}}、{{PROBLEMS_JSON}}、{{OUTPUT_XLSX}} 等占位符后执行），输出 且仅有 4 个 Sheet：巡检概览（标题、告警概览、主机概览、巡检结论同 Sheet）、正常主机、异常主机、异常详细清单。文本结论与「巡检概览」共用同一套模板与同一批分页数据。

字段展示上：监控类型优先 classification_label；监控状态优先 active_status_label（-1 未监控、0 正常等）；采集状态优先 power_label（power_status 1/2）。

适用边界与注意点

用户说「做巡检」「监控设备巡检」「告警巡检」时，文本报告与 Excel 是同一次必交付物，不要拆成先报告再询问是否导出。
正常/异常主机划分只看 active_status 查询规则，不要按「是否存在告警明细」反推主机分组。
API 地址、签名密钥等写在 config.json（api.base_url、api.secret、api.timeout），需环境可用；若依赖或权限导致 .xlsx 无法生成，应明确阻塞原因并说明任务未完成。