用途：操作、配置、部署和排查meshcore-packet-capture，从MeshCore Companion电台捕获数据包，经BLE、串口或TCP传输，并可发布到MQTT（含LetsMesh）。仅限Companion电台；repeater或RoomServer捕获应使用meshcoretomqtt。
主要能力：支持ble、serial、tcp三种传输；MQTT发布（tcp/websockets，TLS可选，密码或Ed25519令牌认证）；可选载荷解码（解密GRP_TXT、解析ADVERT，加入decoded对象，被动观察无法解密TXT_MSG）；可选邻居表与区域scope发布；触发一次性零跳邻居发现（--neighbors-now/--neighbors-exit）；日志轮转（配合--output）；配置优先级为PACKETCAPTURE_环境变量>TOML(/etc/meshcore-packet-capture/config.toml及config.d/.toml)>旧版.env.local/.env；可用--config多次叠加并按顺序覆盖。
使用方式：优先使用命令行meshcore-packet-capture --help、--debug，或python3 -m meshcore_packet_capture。配置需填写一个IATA码和至少一个MQTT broker（LOC仅为占位）。先以--no-mqtt隔离验证连通性，再接入MQTT。部署支持pipx安装、托管安装（/opt与/etc及系统服务）、用户级systemd服务（./install.sh --user-service，卸载./uninstall.sh --user-service，可加--remove-venv）、macOS LaunchAgent/LaunchDaemon、Docker（BLE常需privileged，串口需设备映射）、NixOS的services.meshcore-packet-capture。
适用场景：MeshCore数据包本地捕获、MQTT发布、各种服务化部署与故障排查。
限制：不用于repeater/RoomServer捕获、通用MQTT管理或上游仓库代码改动；v2.2.0不提供--show-config或dry-run，需以实际--help为准；只读请求不得执行变更命令，首次变更需确认目标、范围与回滚；私钥不得写入公开技能或仓库；排查时不要删除安装或状态目录。