ensp_cross_validate_topology
Cross-validate a .topo file against LLDP neighbor scans to detect mismatched interfaces, missing links, or outdated records before config deployment.
Instructions
把 .topo 文件解析结果与设备 LLDP 邻居做交叉验证。
这是「拓扑纠错」的核心入口——ensp_parse_topology 只看拓扑文件，
而 ensp_verify_lldp_neighbors 反映物理事实。两者不一致时就是
拓扑图错位 / 线缆未接 / 对端设备未启 / 老拓扑需要更新等问题的信号。
工作流程：
解析
topo_path（XML 或 ZIP 自动识别）接收
lldp_results（每台设备调ensp_verify_lldp_neighbors返回的scan字段或整个返回对象）对每条边做双向比对：
matched：
.topo和 LLDP 都看到的连线（接口端点完全一致）topo_only：
.topo记录了但 LLDP 没看到（线没接 / 对端未启 / LLDP 未使能）lldp_only：物理上接了但
.topo没记（拓扑图过时）mismatched：两端点都对得上，但至少一个接口号错位（拓扑图错位）
输出结构化 JSON + Markdown 报告，便于 LLM 直接理解和用户存档
参数：
topo_path：.topo文件绝对路径lldp_results：列表，元素为ensp_verify_lldp_neighbors的返回 （建议传scan字段；为了容错，传整个返回对象也可）device_aliases：可选，把 LLDP 的system-name映射到.topo里的设备名（如{"AR1": "R1"}），处理 sysname 与拓扑名不一致的情况
典型使用场景：
生成配置前验证接口号：调用本工具确认
.topo的GE0/0/0是否真的接在物理 GE0/0/0 上，避免下发配置时把 IP 配到错误接口拓扑图纠错：发现接口错位后，用
ensp_gather_diagnostic_context收集上下文，让 LLM 给出修改建议（更新 .topo 或重新接线）实验前环境检查：学生实验前用本工具确认 eNSP GUI 接的线与设计一致
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topo_path | Yes | ||
| lldp_results | Yes | ||
| device_aliases | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||