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 後端環境來維持系統級的相容性和準確度。