stream-validator

stream-validator 技能为 WaveCap-SDR 生态系统提供了一套自动化诊断工具。它专为需要监控实时流性能、调试连接问题或验证不同负载条件下信号完整性的工程师与无线电爱好者所设计。通过直接与 WaveCap-SDR 后端 API 接口，此技能让用户能测量吞吐量、检测缓冲区欠载，并对传入的音频、频谱和 IQ 数据流进行定量分析。它弥合了原始数据传输与高层性能指标之间的鸿沟，对于分布式 SDR 架构中的基础设施监控、性能调优及排解流不稳定问题至关重要。

• 对服务器状态、设备枚举和活动捕获通道执行全面的健康检查。

• 验证流性能指标，包括连接建立时间、接收字节数以及 PCM、FFT 和复杂 IQ 数据的采样连续性。

• 分析信号质量特征，例如音频通道的 RMS 电平、峰值功率检测、静音阈值和削波指示器。

• 为 WebSocket 和 HTTP 流类型提供详细的诊断输出，实时识别丢包间隙、吞吐量偏差和延迟问题。

• 自动化服务器健康报告，包括订阅者计数和僵尸进程清理状态。

• 在执行验证指令前，请确保 WaveCap-SDR 服务器已在目标端口（默认为 8087）上运行。

• 使用 --verbose 标志以执行深度的音频质量分析，并检测如信号削波或意外静音等异常状况。

• 利用 --report 标志生成机器可读的 JSON 输出，以便集成至 CI/CD 流程或自动化基础设施监控仪表板。

• 预期吞吐量会随流类型而显著差异；关于 PCM16、FFT bin 和 IQ 采样率的基准性能目标，请参考技术文档。

• 适用于常见的 SDR 硬件平台如 RTL-SDR 和 SDRplay，并利用 Python 后端环境来维持系统级的兼容性和准确度。