用途:面向嵌入式网络通信调试,统一提供接口发现、抓包、离线分析、连通性测试、端口扫描和流量统计。
主要能力与子命令:iface 列出网络接口(--tshark 显示抓包接口索引映射,--filter 关键词筛选);capture 抓包(--interface、--duration、--capture-filter 为 BPF 过滤器、--display-filter 为 Wireshark 显示过滤器、--output、--format pcapng|pcap、--decode-as、--json 输出 JSON Lines);analyze 分析 pcap 文件(--mode summary|protocols|conversations|endpoints|io|anomalies|all,--filter、--top、--export-fields、--output 导出 CSV);ping 连通性测试(--target、--tcp、--count、--traceroute、--concurrent、--timeout);scan 端口扫描(--target、--ports 如 '80,443,8000-8100'、--timeout、--banner、--concurrent,默认收敛到嵌入式常用端口集);stats 流量统计(--interface、--duration、--display-filter、--interval、--mode overview|protocol|endpoint|port)。
依赖与配置:需 tshark、dumpcap(随 Wireshark 安装并加入 PATH),可选 capinfos,Python 3.x 仅标准库;抓包需 Npcap 驱动,部分环境需管理员权限。环境级配置 <skill-dir>/config.json 仅存工具路径(tshark_exe、capinfos_exe);工程级配置 <workspace>/.embeddedskills/config.json 存网络参数(interface、target、capture_filter、display_filter、duration、timeout_ms、scan_ports、capture_format、log_dir)。参数按 CLI > 工程级配置 > 状态文件 > 默认值的优先级解析,成功后写回工程配置。
使用流程:检查 tshark 可用性,缺失则提示安装并输出 status: error;无子命令时默认执行 iface;运行脚本输出统一 JSON(含 status、action、summary、details,错误时含 error.code 与 error.message)。协议映射可查 references/common_protocols.json。
限制:抓包受权限与 Npcap 约束,失败时优先排查权限、驱动、过滤器与接口选择;未提供扫描范围时默认单主机、小范围端口;除所列参数与命令外,其他功能暂未提供。