SenMeshNet/docs/device-commands.md

NetMesh 设备命令速查手册

涵盖系统巡检（Inspection Adapter）和 RCA 根因分析（AI 诊断规划）两套命令集。 版本：2026-10-13

---

目录

• 1. 设备 Catalog 类型
• 2. Linux 服务器（catalogId: linux）
• 3. Windows 服务器（catalogId: windows）
• 4. 华为/H3C 交换机（catalogId: huawei_h3c_switch）
• 5. Cisco 交换机（catalogId: cisco_switch）
• 6. 华为防火墙（catalogId: huawei_firewall）
• 7. 飞塔防火墙（catalogId: fortinet_firewall）
• 8. Shell Prompt 匹配规则
• 9. RCA 诊断流程

---

1. 设备 Catalog 类型

catalogId	名称	Shell	Adapter 实现	支持指标	默认巡检周期
linux	Linux 服务器	bash/sh	✅ 有	cpu, memory, disk, load, uptime, process_count, online	5 分钟
windows	Windows 服务器	PowerShell	✅ 有	cpu, memory, disk, uptime, process_count, service_status, online	5 分钟
huawei_h3c_switch	华为/H3C 交换机	HUAWEI CLI	✅ 有	cpu, memory, port_status, power_status, fan_status, device_info, online	10 分钟
cisco_switch	Cisco 交换机	IOS CLI	❌ 暂无	cpu, memory, port_status, power_status, fan_status, online	10 分钟
huawei_firewall	华为防火墙	HUAWEI CLI	❌ 暂无	cpu, memory, session_count, online	5 分钟
fortinet_firewall	飞塔防火墙	FortiOS CLI	❌ 暂无	cpu, memory, session_count, online	5 分钟

⚠️ 暂无专用 adapter 的 catalog，巡检阶段复用 HuaweiH3CSwitchAdapter，因此实际执行的是华为 CLI 命令。但 AI RCA 会按 catalogId 正确选择对应厂商的命令族。

---

2. Linux 服务器（catalogId: linux）

Shell

bash / sh（所有主流 Linux 发行版：Ubuntu / CentOS / Debian / Alpine / RHEL）

实际巡检命令（系统在用）

指标	命令
CPU	top -bn1 2>/dev/null | head -n 5（兜底 mpstat 1 1 2>/dev/null | tail -n 1）
内存	free -k 2>/dev/null | head -n 2 | tail -n 1（兜底 cat /proc/meminfo 2>/dev/null | head -n 3）
磁盘	df -h 2>/dev/null | tail -n +2 | grep -v '/dev/loop'

RCA 诊断命令（按告警类型）

告警类型	推荐命令（最多 6 条）
CPU 高	top -bn1 | head -20, vmstat 1 2, ps aux --sort=-%cpu | head -10, mpstat -P ALL 1 1
内存高	free -m, cat /proc/meminfo | head -20, ps aux --sort=-%mem | head -10, slabtop -s c
磁盘高	df -h, du -sh /* 2>/dev/null | sort -rh | head -10, iostat -x 1 1 2>/dev/null || echo no_iostat
网络	ip -s link, netstat -s, lsof -i
离线/连通性	ping -c 3 <host>, traceroute <host>, ip route
通用体检	uname -a, uptime, dmesg | tail -50, journalctl -xe --no-pager | tail -50

Prompt 匹配

user@host:~$         # bash/zsh
user@host:/path#     # bash 特权
root@host:~#         # root

---

3. Windows 服务器（catalogId: windows）

Shell

PowerShell（通过 powershell -NoProfile -NonInteractive -EncodedCommand <base64> 执行 UTF-16LE Base64 编码脚本）

实际巡检命令（系统在用）

指标	PowerShell 脚本摘要
CPU + 内存 + 运行时间	Get-WmiObject Win32_Processor + Get-WmiObject Win32_OperatingSystem
磁盘	Get-WmiObject Win32_LogicalDisk -Filter "DeviceID='C:'"
服务状态	Get-Service 检查 wuauserv / Spooler / TermService / DHCP / DNScache

RCA 诊断命令（直接用 PowerShell 可执行形式）

告警类型	推荐命令（最多 5 条）
CPU 高	Get-Process | Sort-Object CPU -Descending | Select-Object -First 10
内存高	Get-CimInstance Win32_OperatingSystem | Select TotalVisibleMemorySize,FreePhysicalMemory
磁盘高	Get-CimInstance Win32_LogicalDisk | Where-Object {$_.DriveType -eq 3}
服务异常	Get-Service | Where-Object {$_.Status -ne 'Running'} | Select Name,Status
系统日志	Get-EventLog -LogName System -Newest 50 | Select TimeGenerated,EntryType,Message
网络	Get-NetAdapter | Select Name,Status,LinkSpeed, netstat -ano
通用体检	Get-ComputerInfo, systeminfo

---

4. 华为/H3C 交换机（catalogId: huawei_h3c_switch）

Shell

Huawei VRP CLI / H3C Comware CLI（SSH 登录后进入 enable 模式）

实际巡检命令（系统在用，批量一次执行）

指标	命令	备注
CPU	display cpu-usage	解析 % in last 5 seconds / CPU Usage: XX%
内存	display memory	解析 Used Rate: XX% / Memory Using Percentage Is: XX%
端口状态	display interface brief	匹配 GE1/0/1 UP/DOWN / GigabitEthernet... UP/DOWN
电源状态	display power	匹配 Normal / Fault / Absent
风扇状态	display fan	匹配 Normal / Fault / Absent

RCA 诊断命令

告警类型	推荐命令（最多 6 条）
CPU 高	display cpu-usage, display device, display version
内存高	display memory, display version, display current-configuration
端口异常	display interface brief, display interface <ifname>, display mac-address
电源/风扇告警	display power, display fan, display environment
STP 环路	display stp brief, display stp topology-change
VLAN 问题	display vlan brief, display vlan <id>
网关/路由	display ip routing-table, display vrrp brief
日志排查	display logbuffer, display logbuffer size 512
通用体检	display version, display device, display diagnostic-information

Prompt 匹配

<host>              # HUAWEI VRP 用户模式
<host>              # HUAWEI VRP 特权模式
host>               # H3C Comware
host#               # H3C Comware 特权

---

5. Cisco 交换机（catalogId: cisco_switch）

Shell

Cisco IOS CLI / IOS-XE CLI

⚠️ 当前暂无专用巡检 adapter，复用华为交换机 adapter。AI RCA 会按 catalogId 正确选 Cisco 命令族。

RCA 诊断命令（Cisco IOS 风格）

告警类型	推荐命令
CPU 高	show processes cpu sorted, show processes cpu history
内存高	show memory summary, show memory allocations process sort
端口异常	show interfaces brief, show interfaces counters errors, show interfaces trunk
电源/风扇告警	show environment all, show inventory
STP	show spanning-tree summary, show spanning-tree inconsistentports
VLAN	show vlan brief, show vtp status
路由/网关	show ip route summary, show ip interface brief, show standby brief
日志	show logging tail 50, show logging, terminal length 0（禁用分页后重定向）
MAC 地址表	show mac address-table count, show mac address-table interface <ifname>
ARP	show arp, show ip arp inspection statistics
通用体检	show version, show environment, show controllers power inline

Prompt 匹配

Switch>             # IOS 用户模式
Switch#             # IOS 特权模式
hostname>           # IOS-XE
hostname#

---

6. 华为防火墙（catalogId: huawei_firewall）

Shell

Huawei USG VRP CLI

⚠️ 当前暂无专用巡检 adapter，复用华为交换机 adapter。

RCA 诊断命令

告警类型	推荐命令
CPU/内存高	display cpu-usage, display memory, display version
会话数异常	display firewall session table, display firewall session table verbose
安全策略	display security-policy count, display security-policy rule all
服务器保护	display server-protect statistics, display server-protect attack-log
NAT	display nat session table, display nat policy
资源/连接数	display firewall statistic system, display ip session aging
接口状态	display interface brief, display ip interface brief
路由	display ip routing-table, display ip routing-table statistics
日志	display logbuffer, display alarm all
通用体检	display version, display current-configuration

---

7. 飞塔防火墙（catalogId: fortinet_firewall）

Shell

FortiOS CLI

⚠️ 当前暂无专用巡检 adapter，复用华为交换机 adapter。

RCA 诊断命令

告警类型	推荐命令
CPU/内存	get system status, get system performance status, get system performance cpu, get system performance memory
会话数	get firewall session list, get firewall session list <count>, diagnose sys session stat
接口	get system interface, get hardware nic, diagnose hardware deviceinfo nic
路由	get router info routing-table all, get config route static
策略	get firewall policy all, get firewall policy count
NAT	get firewall nat all, get firewall nat count
VPN	get vpn ipsec tunnel summary, get vpn ssl monitor
资源/DoS	get system resource usage, diagnose dos stat, diagnose debug flow stat
硬件	get hardware status, get hardware psu, get hardware fan
日志	execute log tail <lines>, get router info log dmesg
通用体检	get system status, get system info, diagnose sys top

---

8. Shell Prompt 匹配规则

文件位置：electron/bridges/inspection/promptParser.cjs

巡检命令发送前，SSH 通道已就绪但不知道 shell 类型，需要等 prompt 出现才发命令。当前正则：

Shell 类型	Prompt 正则
Linux bash/zsh	user@host[:~$#]、root@host[:~#]
华为/H3C	<hostname>、hostname>、hostname#
Cisco IOS	Switch[>#]、hostname[>#]
FortiOS	FortiGate[>#]、hostname[>#]

⚠️ 避免用 % 作为通用 prompt 结尾 —— 命令输出中的百分比数值会被误识别为 prompt。

---

9. RCA 诊断流程

触发

告警中心 → 点告警行的 🤖 按钮

执行链路

runRCA(alert)
  │
  ├─ Phase 1: AI 规划诊断命令
  │   prompt 顶部带 catalogId（来自 inspectionHostMetrics / inspectionHostInfo）
  │   AI 输出 JSON: { commands: [{ command, purpose }, ...], reasoning }
  │
  ├─ Execute: 复用 SSH session 执行命令
  │   ├─ echo __rca_probe_ok__ 探活
  │   ├─ 没有 SSH session → vaultHostOpen 自动开终端 tab
  │   └─ 逐条 inspectionRunCommand（SSH session.exec）
  │
  ├─ Phase 2: AI 综合 RCA
  │   输入：告警 + metrics + 所有命令 stdout/stderr
  │   输出：{ confidence, rootCauses, recommendations[], summary }
  │
  └─ 前端渲染（证据区可折叠展开 stdout）

关键设计

设计点	说明
SSH 连接复用	不独立建 SSH —— 用主进程 sessions Map 里已有终端的 conn.exec()
自动开终端	没有 session 时调 vaultHostOpen 创建 tab + 等 SSH 连上（最多 10 秒轮询）
Policy 绕过	policy.requiresChatSession: false 的 capability 跳过 chatSessionId 强制检查
API Key 安全	aiFetch 请求 header 用 __IPC_SECURED__ placeholder → 主进程用 providerId 解密注入
Host allowlist	RCA 开头调 aiAllowlistAddHost 预注册 provider baseURL
Prompt 可配置	设置 → AI → RCA 诊断 tab，运维可覆盖 Phase 1 / Phase 2 的 system prompt
Fallback	无 AI provider → 确定性兜底（按 catalogId 挑内置命令 + 规则合成 RCAResult）

命令执行 handler 位置

• 巡检：electron/bridges/inspection/index.cjs → registerInspectionHandlers（主进程启动时注册到 ipcMain）
• RCA：electron/bridges/mcpServerBridge/inspectionAgentHandlers.cjs → handleRunCommand（MCP dispatch 路由到）
• SSH 执行底层：electron/bridges/inspection/inspectionExec.cjs → execSshCommand / execSshCommands（prompt 检测 + 批量发送）

---

本手册自动维护，基于项目 inspection adapters 和 RCA prompt 对照表生成。