自訂執行節點是什麼？
自訂執行節點是連接到 Qaptly Desktop 的第三方擴展，提供額外的自動化功能。使用統一執行節點協議 (UPP)，您可以建立能夠執行以下操作的執行節點：- 控制 WiFi 網絡(掃描、連接、斷開)
- 管理 IoT 設備(智慧家居、感測器)
- 與硬體互動(GPIO、串口)
- 在遠端設備上執行自訂命令
- 發送即時事件通知
使用情境
網路測試
建立基於 Raspberry Pi 的 WiFi 控制器，測試應用在不同網路條件下的行為：- 在測試執行期間切換 WiFi 網絡
- 模擬網路斷開
- 監控信號強度和延遲
物聯網自動化
在測試情境中控制 IoT 設備：- 智慧燈、恆溫器、門鎖
- 溫度、濕度、動作感測器
- 自訂硬體整合
遠端命令執行
在遠端設備上執行命令：- 在嵌入式系統上運行指令碼
- 控制測試設備
- 管理測試基礎設施
工作原理
網路部署:
<qaptly_desktop_ip> 是執行 Qaptly Desktop 的機器在區域網路中的 IP 位址（例如：192.168.1.100）。⚠️ 安全性: UPP 專為內部網路使用而設計。請勿暴露到公共網際網路。主要特性
自我描述
執行節點使用 JSON Schema 宣告自己的功能。Qaptly 動態發現執行節點支援的動作。預設安全
- 首次連接需要使用者批准
- 用於認證的預先共用金鑰
- 內部網路部署（不暴露到公共網際網路）
即時事件
執行節點可以發送事件來通知 Qaptly 狀態變更：wifi.connected- WiFi 連接已建立sensor.temperature_changed- 溫度讀數已更新- 針對您的使用情境的自訂事件
語言無關
使用支援以下功能的任何語言實現執行節點：- WebSocket 用戶端
- JSON 序列化
- 您的平台(Python、Node.js、Go、Rust、C++ 等)
架構
UPP 與 Qaptly 的內部執行節點(Android、iOS、macOS 自動化)獨立。您的自訂執行節點：- ✅ 獨立運行
- ✅ 透過 WebSocket 連接
- ✅ 宣告自己的功能
- ✅ 不干擾內部執行節點
協議基礎
訊息格式
所有訊息使用 UTF-8 編碼的 JSON：連接流程
- 連接 - 執行節點透過 WebSocket 連接
- 註冊 - 發送執行節點資訊和功能
- 認證 - 使用者批准(首次)或驗證金鑰
- 執行 - Qaptly 發送命令，執行節點回應
- 事件 - 執行節點發送即時事件(選項)
- 心跳 - 保持連接活躍(每 30 秒)
開始使用
準備好建立您的第一個自訂執行節點了嗎？快速入門
15 分鐘內建立簡單的 WiFi 控制器
協議參考
完整的協議規範
認證
安全性和金鑰管理
範例
完整的實作範例
需求
若要開發自訂執行節點，您需要：- 開發環境：支援 WebSocket 的任何語言
- Qaptly Desktop：0.15.0 版或更新版本
- 目標設備(選項)：Raspberry Pi、Arduino 或任何網路設備