此 context 描述可在即時或檔案模式中探索的 ROS 2 拓撲,以及用來呈現該拓撲的詞彙。
完整圖譜快照: 由後端或 JSON 檔案提供、未套用前端顯示篩選的完整 ROS 2 拓撲資料;也是 JSON 匯出的資料來源。 Avoid: 原始資料、未篩選畫面
可見圖譜快照: 由完整圖譜快照依目前顯示規則投影出的節點與邊集合;它不改變完整圖譜快照。 Avoid: 篩選後資料、畫面資料
顯示策略: 決定哪些 ROS 資源可出現在可見圖譜快照中的一組選擇規則;它是圖譜呈現模組的輸入,而非 UI 開關的集合。 Avoid: 篩選設定、畫面選項
圖譜選取: 使用者目前在可見圖譜快照中選定的一或多個 ROS 圖譜項目;項目變得不可見時,選取即清除。 Avoid: 隱藏選取、背景選取
可見邊: 來源與目標都位於可見圖譜快照中的關聯;任一端被顯示策略排除時,該關聯不出現在可見圖譜快照。 Avoid: 半可見關聯、孤立關聯
圖譜投影: 由完整圖譜快照與顯示策略產生可見圖譜快照的無副作用行為;它不依賴傳輸、檔案或執行期環境。 Avoid: 畫面更新、篩選流程
重名 ROS 節點: 在同一完整圖譜快照中,兩個以上 ROS 節點具有相同完整 ROS 名稱(namespace 加 node name)的異常狀態;僅 base name 相同而完整名稱不同的節點不是重名 ROS 節點。 Avoid: 同名 base name、跨 namespace 重名
ROS 節點實例: 一次實際啟動並參與 ROS 圖譜的 node;重名 ROS 節點仍是不同的 ROS 節點實例,必須分別顯示在圖譜中,即使其完整 ROS 名稱相同。 Avoid: 以完整名稱合併的 node、重名的單一節點
快照內觀測實例 ID:
僅在一份完整圖譜快照內用來區分 ROS 節點實例的唯一識別;所有 ROS 節點都依完整名稱內的 1 起算 discovery 序號取得它,並以 node:<完整名稱>#<序號> 作為 ID。它不是可跨快照追蹤的真實 node 身份。
Avoid: ROS node UUID、穩定實例 ID、程式實例 ID
名稱 fan-out 關聯: 當 ROS discovery 回報某完整 ROS 名稱的關聯,且該名稱對應多個重名 ROS 節點實例時,該關聯會連到所有同名實例。它用於優先揭露重名 ROS 節點,並不聲稱各實例皆實際參與該關聯。 Avoid: 實例歸屬正確性、未分派關聯、實例精確關聯
ROS 資源型態衝突: 同一 kind 與同一完整 ROS 名稱的 topic、service 或 action,觀測到兩個以上不同且已知的 ROS 型態字串時的異常狀態;型態字串只去除空白與去重,不推論別名或相容性。不同 kind 的同名資源與未知型態不是型態衝突。 Avoid: 跨 kind 衝突、未知型態衝突、同型態多端點
Action 型態衝突證據: 導出 action 型態時,產生該型態的 action 內部 channel 與其 ROS 型態的對應;它用於解釋 ROS 資源型態衝突,而不改變 action 的高階圖譜關聯。 Avoid: action 邊、推測 action 型態
Action 型態衝突折疊: action 內部 channel 的型態不一致只產生一筆高階 action 的 ROS 資源型態衝突;內部 channel 與型態只作為該筆衝突的證據,不各自產生底層資源衝突。 Avoid: action internal 衝突、重複 action 告警
異常摘要: 以完整圖譜快照中的異常為資料來源、持續顯示異常數量與可導覽項目的呈現;它與受影響圖譜項目的警示 badge 共同構成異常提示,且不是暫時通知或阻塞式對話框。 Avoid: toast、彈窗、可見項目計數
異常優先序: 異常摘要固定先列重名 ROS 節點,再列 ROS 資源型態衝突;同類異常以完整 ROS 名稱排序。此順序表達重名節點的較高處理優先權。 Avoid: 發現順序、嚴重度猜測、未排序異常
目前異常: 由最新完整圖譜快照導出的異常狀態;異常在第一次觀測時立即顯示,且重新排版與工作區重設不改變它。 Avoid: 異常歷史、已確認異常、Reset layout 異常
已恢復異常: 先前為目前異常、但最新完整圖譜快照已不再滿足條件的短暫呈現狀態;它顯示為已恢復並在五秒內淡出,若相同異常再次出現即回復為目前異常。它不形成可保存或匯出的異常歷史。 Avoid: 異常歷史、已確認異常、已消失異常
異常一致性: 對同一完整圖譜快照,Live mode 與 File mode 必須導出相同的目前異常;異常檢測依賴快照的圖譜事實,而非僅存在於 live transport 的暫態資料。 Avoid: 僅 live 異常、後端暫態異常
衍生異常: 由完整圖譜快照的圖譜事實以純規則導出的異常;它不是 graph JSON 欄位,亦不包含目前異常與已恢復異常以外的暫態呈現狀態。 Avoid: anomalies payload、序列化告警、異常事件
完整圖譜異常範圍: 完整圖譜快照中的所有資源均參與異常檢測,包含被顯示策略隱藏的系統資源與 action internals;顯示策略只能改變其是否直接出現在圖上,不能改變異常摘要。 Avoid: 可見圖譜異常範圍、隱藏資源豁免