SuperAPI AI 工具集

hses-packet-analysis

测试与质量

查看项目

更新于 10-16 06:45

技能介绍

用途:分析 HSES 协议数据包并生成 Markdown 报告,适用于调试 moto-hses 通信问题、验证协议实现正确性、调查机器人控制器异常响应,以及为故障排查报告生成证据。

主要能力:抓取 UDP 10040 端口流量,导出数据包文本,并按模板生成包含摘要、协议校验、通信时序、协议错误和数据包详情的报告。协议校验涵盖魔数 YERC、32 字节头部、保留字段、Division、ACK、块号、请求响应配对、服务码匹配和命令 ID 有效性。

使用方式:需先安装 tshark(sudo apt install tshark),并具备 hses-protocol 技能。输出目录由用户指定,未指定则用工作区根目录 logs/。流程为:mkdir -p <output_dir>;后台启动抓包 tshark -i any -w <output_dir>/hses_capture_<timestamp>.pcap -f "udp port 10040" &,sleep 2;运行应用(如 cargo test --test <test_name> 或 cargo run -- <args>);pkill -f "tshark.*hses_capture" 停止;用 tshark -r ... -T fields -e frame.number -e frame.time_relative -e data 导出文本;读取导出文件生成报告并保存为 hses_report_<timestamp>.md。报告须用英文。

限制:依赖 tshark 和 hses-protocol 技能;仅针对 UDP 10040 的 HSES 流量;时间戳格式为 YYYYMMDD_HHMMSS;错误码含义需参考 hses-protocol 技能。