# Packetry USB 2.0 协议分析工具

> Great Scott Gadgets 推出的 USB 2.0 协议分析应用，可配合 Cynthion 分析仪实时捕获，也可浏览已捕获的流量，处理高速、全速和低速 USB 的物理层数据包。其 GTK 4 界面提供分层视图，可将高层事件逐级展开为事务和数据包，另有按时间顺序排列的事务视图和数据包视图；设备面板则根据解码后的描述符（包括 HID 报告描述符）汇总每个观察到的设备。捕获以 LINKTYPE_USB_2_0 链路类型的 pcap 文件打开和保存，v0.5.0 还加入了带有非数据包事件自定义块的 pcapng 格式。

- 类型：工具
- 目标：协议
- 类别：协议分析工具
- 关联：基础工具
- 来源复核于：2026-10-19
- 收录于：2026-10-31
- 原始资源：<https://github.com/greatscottgadgets/packetry>
- 一手来源：<https://github.com/greatscottgadgets/packetry/blob/5a7f98b77aa00519ecf7e811c9f26c6534966d05/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/packetry/>
- 记录 JSON：<https://awesomerea.org/resources/packetry/record.json>
- 英文版：[English](https://awesomerea.org/resources/packetry/index.md)

## 使用条件与局限

- 审阅时的版本为 v0.5.0，于 2025-09-30 发布，提供 Windows 安装程序和 Linux x86_64 AppImage；快速入门指南介绍在 macOS 上通过 Homebrew 安装。所审阅的 main 分支提交领先 47 个提交，包含界面、依赖和最低 Rust 版本等改动，而 Cargo.toml 仍标为 0.5.0。
- 实时捕获需要 Cynthion 分析仪，并安装其主机软件、用 cynthion update 更新；代码还会探测 iCE40-usbtrace 设备，但文档未涉及。查看已有的捕获文件无需硬件。
- 从源码构建需要 Rust 1.93+（依据 README 和 Cargo.toml；快速入门指南仍写 1.85.1），以及可通过 pkg-config 找到的 GTK 4 头文件。文档警告不要使用 --all-features 构建，其中的可选功能用于调试和测试，会影响正常使用。
- 捕获数据来自使用者自己的 USB 设备和总线。文档指出分层视图中的数据包可能不按时间顺序显示。采用 BSD-3-Clause 许可。

## 一手来源

1. <https://github.com/greatscottgadgets/packetry/blob/5a7f98b77aa00519ecf7e811c9f26c6534966d05/README.md>
2. <https://github.com/greatscottgadgets/packetry/blob/5a7f98b77aa00519ecf7e811c9f26c6534966d05/docs/source/what_is_packetry.rst>
3. <https://github.com/greatscottgadgets/packetry/blob/5a7f98b77aa00519ecf7e811c9f26c6534966d05/docs/source/quick_start.rst>
4. <https://github.com/greatscottgadgets/packetry/blob/5a7f98b77aa00519ecf7e811c9f26c6534966d05/docs/source/user_interface.rst>
5. <https://github.com/greatscottgadgets/packetry/blob/5a7f98b77aa00519ecf7e811c9f26c6534966d05/CHANGELOG.md>
6. <https://github.com/greatscottgadgets/packetry/blob/5a7f98b77aa00519ecf7e811c9f26c6534966d05/Cargo.toml>
7. <https://github.com/greatscottgadgets/packetry/blob/5a7f98b77aa00519ecf7e811c9f26c6534966d05/src/backend/mod.rs#L32-L40>
8. <https://github.com/greatscottgadgets/packetry/blob/5a7f98b77aa00519ecf7e811c9f26c6534966d05/LICENSE>
9. <https://github.com/greatscottgadgets/packetry/releases/tag/v0.5.0>

## 同分区更多条目：协议

- [Caring Caribou 汽车 CAN 总线安全探索工具](https://awesomerea.org/zh/resources/caringcaribou/index.md) · 工具
- [protodump Protobuf 定义恢复工具](https://awesomerea.org/zh/resources/protodump/index.md) · 工具
- [CAN Commander CAN 总线逆向工具](https://awesomerea.org/zh/resources/can-commander/index.md) · 工具
- [CAN 负载自动逆向分析流水线](https://awesomerea.org/zh/resources/can-reverse-engineering/index.md) · 工具
- [Deluder 应用流量拦截工具](https://awesomerea.org/zh/resources/deluder/index.md) · 工具
- [PiCCANTE 树莓派 Pico 车辆 CAN 总线工具](https://awesomerea.org/zh/resources/piccante/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。