檢查映射
執行確定性檢查並回傳結構化發現。
遵循 ../../references/interaction-contract.md。
流程
- 執行
python3 <skill-dir>/scripts/run.py --input <map.json> --output <validation.json>。 - 根據
error、warning和hold分組發現。 - 根據程式碼和根本原因分組發現;在成品中包含具代表性的複合身份標示以及完整的受影響 ID 清單。
- 當存在錯誤或保留時,自動暫停最終生成。
輸出檔案
validation.json- 打開此報告。它列出已通過的檢查,並將問題依根本原因分組。它不會建立或修改映射。
完成需要每個檢查都有可見的通過、發現或跳過原因。
停止
- 當存在錯誤或保留(包括壓縮位編號)時,暫停最終生成。
- 不要猜測位元組順序、位元順序、位址慣例或暫存器區域。
- 僅接受單元 ID 1 至 247。禁止使用單元 ID 0,因為此套件不會產生廣播請求。此版本不接受 Modbus TCP 閘道器的單元 ID 0 和 255。
- 僅允許讀取功能碼 01 至 04。
- 停止寫入、廣播、探索或無界輪詢。
交接
- 發現需要人工證據:建議使用
review-evidence。 - 壓縮位或線圈編號未解決:保持保留狀態;不要建議使用
check-byte-order。 - 映射通過並經審查:建議使用
plan-reads。 - 來源仍為原始或混合狀態:建議使用
review-map。
使用路由、單元、區域、協定偏移量和邏輯點識別碼作為身份。僅允許讀取功能碼 01 至 04。