nanxiaoyao 华为设备综合巡检技能 (health-check)
本技能对华为 VRP 设备执行一键综合体检，覆盖系统层、硬件层、接口层、路由层、安全层、日志层六大维度，自动采集 display 命令输出、分析关键指标、生成结构化巡检报告。
适用：路由器（AR/NE 系列）、交换机（S/CE 系列）、防火墙（USG 系列）。
触发场景
用户描述以下任一需求时加载此技能：
- "帮我巡检一下序号为 X 的设备"
- "对 LL-xcsyy-FW 做个体检"
- "看下这台设备健康状况"
- "device health check / inspection"
- "生成设备巡检报告"
- "查一下 CPU/内存/接口/日志"（综合查询时）
不适用： 单一协议排错（OSPF 邻居不通 → 用 ospf-config）、配置变更（→ 对应配置技能）。
工作流程
Step 1：确认目标设备
需要用户提供：
- 设备序号（对应 user.txt）或设备名/IP
- 巡检深度：快速（5 分钟）/ 标准（10 分钟）/ 深度（含日志分析）
- 输出形式：终端摘要 / Markdown 报告 / 两者
Step 2：登录设备
使用封装脚本 bin/hwssh.sh <序号> '<命令>'，禁止在命令行明文传密。
Step 3：按维度采集
执行 references/inspection-commands.md 中对应深度的命令集，逐条采集输出。
Step 4：分析与判定
对照 references/health-criteria.md 的健康阈值，给每项打 ✓ / ⚠ / ✗。
Step 5：生成报告
按 templates/report-template.md 输出 Markdown 报告，关键项前置告警。
巡检维度（六大类）
1. 系统层
- 设备型号、VRP 版本、运行时长、Patch 状态
- 主控/备控状态、主备一致性
- 时间同步（NTP）
2. 硬件层
- CPU 利用率（5s/1min/5min）
- 内存利用率
- 风扇、电源、温度
- 单板状态、光模块状态
3. 接口层
- 物理 up/down 状态
- 速率/双工/带宽利用率
- CRC/Input Error/Drop 计数
- 光模块收发光功率（阈值告警）
4. 路由层
- 路由表规模（IPv4/IPv6）
- 各协议邻居数（OSPF/BGP/ISIS）
- 默认路由是否存在
5. 安全层（防火墙专属）
- 会话表大小、新建速率
- 安全策略命中统计
- 攻击防范日志
6. 日志层
- 最近 24h ERROR/CRIT 日志数
- 异常事件（接口频繁 up/down、CPU 抖动）
健康判定原则
| 等级 | 标记 | 含义 | 触发条件示例 |
|---|---|---|---|
| 健康 | ✓ | 全部正常 | CPU<60%, 内存<70%, 无错包, 无关键日志 |
| 警告 | ⚠ | 需关注 | CPU 60-80%, 接口少量 CRC, 光功率边缘 |
| 异常 | ✗ | 立即处理 | CPU>80%, 接口 down, 风扇故障, 大量 CRIT |
快速入口
| 需求 | 入口 |
|---|---|
| 一键巡检（推荐） | scripts/full_inspection.sh <序号> [--depth quick|standard|deep] |
| 命令清单参考 | references/inspection-commands.md |
| 健康阈值定义 | references/health-criteria.md |
| 报告模板 | templates/report-template.md |
输出示例（摘要）
=== LL-xcsyy-FW 巡检报告 ===
时间: 2026-05-21 21:50:00
型号: USG6307E VRP: V600R007C20SPC600 运行: 43w6d
[✓] 系统层 版本正常, 主备一致, NTP 同步
[✓] 硬件层 CPU 12%, 内存 45%, 温度 38°C, 风扇正常
[⚠] 接口层 GE0/0/3 CRC 错包递增 (近1h +234)
[✓] 路由层 OSPF 邻居 3/3 Full, BGP 邻居 2/2 Established
[✓] 安全层 会话 12k/500k, 无攻击事件
[✓] 日志层 近 24h 无 CRIT 日志
总体: ⚠ 警告 (1 项)
建议: 检查 GE0/0/3 物理链路 / 光模块
注意事项
- 巡检命令只读，全部
display/show，不修改设备配置 - 部分命令华为不同型号有差异，脚本会自动适配（USG/S/AR）
- 大表输出（路由表/会话表）只统计数量，不全量拉取
- 深度模式才采集日志，避免大量 IO
关联技能
- 配置变更 →
network-huawei/<协议>-config/ - 设备登录 → 本仓库
bin/hwssh.sh - 跨厂商对比 →
network-cisco/、network-h3c/（规划中）