嵌入式网络调试工具，用于发现接口、抓包、分析 pcap/pcapng、做连通性测试、端口扫描和流量统计。当用户提到 Wireshark、tshark、Npcap、抓包、网络联调、端口扫描、连通性排查、pcap 分析、网络接口、ping 测试、traceroute、流量统计、Modbus TCP、EtherNet/IP 等网络协议调试时自动触发，也兼容 /net 显式调用。即使用户只是说"抓个包看看"、"扫一下端口"、"网络通不通"或"分析一下这个 pcap"，只要上下文中出现具体工具名（tshark、Wireshark、Npcap）、协议名（Modbus TCP、EtherNet/IP

Net Debug Skill 嵌入式网络通信调试工具，统一封装接口发现、抓包、离线分析、连通性测试、端口扫描和流量统计能力。脚本与配置路径脚本目录: <skill dir /scripts/ 环境级配置: <skill dir /config.json （仅工具路径）工程级配置: <workspace /.embeddedskills/config.json （网络参数）协议参考: <skill dir /references/common protocols.json 依赖 tshark (随 Wireshark 安装，需加入 PATH) dumpcap (随 Wireshark 安装) 可选: capinfos Windows 自带: ipconfig 、 ping 、 tracert 、 netstat 、 arp 、 nslookup Python 3.x (仅标准库) 抓包需要 Npcap 驱动，部分环境需管理员权限配置环境级配置 ( skill/config.json ) 仅保留工具路径相关的环境级配置：工程级配置 ( .embeddedskills/config.json ) 工作区下的 .embeddedskills/config.json 存放工程级网络配置：参数解析优先级 1. CLI 参数 ( interface , target 等) 最高优先级 2. 工程级配置 ( .embeddedskills/config.json 中的 net 部分) 3. 状态文件 ( .embeddedskills/state.json 中的历史记录) 4. 默认值最低优先级连接和采集参数按优先级解析，脚本通过 CLI 参数接收覆盖值。若配置缺少必要项或连接失败，询问用户并引导修改配置。执行流程 1. 检查 tshark 是否可用；若不可用，提示用户安装 Wireshark（含 tshark）并确认已加入 PATH；若需要抓包，还需提示安装 Npcap 驱动；依赖缺失时终止执行并输出 status: error 及安装指引 2. 按优先级解析参数：CLI 工程级配置状态文件默认值；若多个来源对同一参数均有值，以更高优先级来源为准，并在输出 summary 中注明被覆盖的来源 3. 若无子命令，默认执行 iface （列出网络接口） 4. 成功执行后，将确认的参数写回工程配置 5. 运行对应脚本并输出结构化 JSON 结果 6. 失败时优先提示权限、Npcap、过滤器、接口选择等问题子命令 iface — 列出网络接口 tshark : 同时显示 tshark 抓包接口索引映射 filter : 按关键词筛选接口无副作用，可直接执行 capture — 抓包接口、过滤器、时长按优先级解析 interface : 抓包接口（覆盖配置） duration : 抓包时长（覆盖配置） capture filter : BPF 抓包过滤器（覆盖配置） display filter : Wireshark 显示过滤器（覆盖配置） output : 保存抓包文件路径 json : 输出 JSON Lines 格式（基于 tshark T ek） decode as : 自定义解码规则默认格式 pcapng，参数完整后直接执行 analyze — 分析 pcap 文件基于 tshark 和 capinfos 进行离线分析 mode all 输出全部分析维度无副作用，可直接执行 ping — 连通性测试目标按优先级解析 target : 目标地址（覆盖配置） tcp : TCP 连通性测试（指定端口） traceroute : 执行路由追踪 timeout : 超时毫秒数（覆盖配置）参数完整后直接执行 scan — 端口扫描目标和端口范围按优先级解析 target : 目标地址（覆盖配置） ports : 端口范围，如 '80,443,8000 8100'（覆盖配置） banner : 尝试获取服务 Banner 默认收敛到嵌入式常用端口集参数完整后直接执行 stats — 流量统计接口和时长按优先级解析 interface : 抓包接口（覆盖配置） duration : 统计时长（覆盖配置） display filter : Wireshark 显示过滤器（覆盖配置）默认输出按时段汇总的 JSON 无副作用，可直接执行输出格式所有脚本输出统一的 JSON 结构: 错误时: capture json 输出 JSON Lines，进度信息写入 stderr。交互策略按优先级解析参数：CLI 工程级配置状态文件默认值优先用解析后的参数直接执行，不额外询问连接失败时再询问用户并引导修改配置成功执行后，确认的参数自动写回 .embeddedskills/config.json 未给扫描范围时默认收敛到单主机、小范围端口结果中明确回显目标范围、过滤器和持续时间抓包结果优先总结异常协议、重传、RST 等抓包失败优先提示权限和 Npcap 问题协议参考需要查询嵌入式常用端口和协议映射时，读取 references/common protocols.json 。