鏈路失敗的文件化排解

本章概覽

先說結論：你只把固定文件中的症狀概念放進離線分流表。你不會重啟服務、試換 driver、探測 endpoint、連接 bus 或發布任何先前內部錯誤。

目的

依鎖定文件把鏈路症狀分層，並限制每一類證據能支持的結論。

準備

一張空白症狀分流表與兩份固定來源；不需要日誌或執行環境。

時間

約 20 分鐘。

系統變更

不重啟服務或連接 bus；只用去識別證據離線分類鏈路失敗。

預期結果

能按程序、listener、driver、介面與 bus 層級分類症狀，不把診斷嘗試寫成成功。

停止條件

• 步驟要求重新啟動 driver、服務、介面或 KNX 連線。
• 日誌仍含主機、端點、裝置路徑、序號或秘密。

範圍與安全界線

本章只分類文件，不分類現場。safe 安全只限離線唯讀固定來源，或完全不存取執行環境的占位分類。任何 live／running 環境的唯讀查看都是 approval-required 需核准。

• safe 安全：只閱讀鎖定的 Add-on 與 upstream 文件，並抄錄抽象症狀類別。
• isolated-test 隔離測試：另案必須先有明確書面核准、非正式測試環境、管理員在場、有限網路暴露與已驗證停損還原計畫；本章不進入。
• approval-required 需核准：查看或變更執行中環境都屬此類；即使唯讀也不是安全。本章不提供觀測程序。
• never-automate 永不自動化：不得群組讀寫，不得傳送 KNX telegram，不得執行 ETS programming／download，不得連接 KNX 介面或 bus，也不得實體控制。測試 bus 也不例外。

加入 repository、安裝或啟動還必須先有完整隔離閘門、書面核准、核准的 immutable artifact／image digest 與 source-to-build attestation。缺少任何一項就停止。

核心概念

程序層詞彙只能說明程序概念。listener 層詞彙只能說明監聽責任。driver 家族與文件化啟動失敗只能界定驅動文件範圍。介面與 bus 結果都不在本章證據內。

準備與前置條件

只準備兩份鎖定文件與一張空白表。不要帶入內部日誌、截圖或記憶中的錯誤。

• 來源欄只記固定來源識別與版本邊界，不記本機資料。
• 層級欄使用程序、listener、driver、介面與 bus 五類。
• 症狀欄只寫文件中的抽象狀態概念，不寫曾在某環境看到什麼。
• 證據上限欄先寫「只能支持文件分類，不能支持本地結果」。
• 停止欄寫來源不明、跨層推論、要求現場動作或出現識別資料。

早期內部鏈路錯誤不是本章公開結果。即使文字已遮蔽，也不能把它改寫成本站曾觀測、曾重現或曾驗證。

分段步驟

以下流程只做文件分類。每一步都停在紙上。

1. 鎖定來源。確認症狀概念來自本章列出的固定版本。來源不明就停止。
2. 選一個層級。依文件責任把概念放進程序、listener、driver、介面或 bus 欄。資訊不足就標成未分類。
3. 寫下證據上限。程序詞彙不能證明 listener；listener 詞彙不能證明 endpoint；driver 詞彙不能證明介面或 bus。
4. 列出未知項目。把相容性、硬體、接線、端點可達與 bus 狀態保持為未知，不選一個看起來合理的根因。
5. 排除內部結果。刪除任何「曾看到」「曾重現」「本機顯示」或類似敘述，只保留文件支撐的抽象分類。
6. 交給獨立覆核。確認每列都有來源、層級、證據上限與未知項目，而且沒有現場動作提示。

驗證與證據

完成結果只能是文件症狀分類表。本站沒有本地觀測來源，也沒有本地鏈路結果。

• 每個症狀概念都能對應固定來源與單一主要層級。
• 程序、listener、driver、介面與 bus 沒有被混成一個成功或失敗結論。
• 每列都清楚寫出能支持什麼，以及不能支持什麼。
• 硬體、接線、相容性、endpoint 可達與 bus 狀態都保持未知。
• 早期內部錯誤沒有被發布成觀測、重現或驗證結果。
• 表內沒有主機、端點、路徑、序號、帳號、秘密、位址、範圍或時間。

下一步：前往第 20 章，繼續整理 USB 與序列介面的離線故障分類。

故障排除

• 一個症狀像兩層：分成兩列，或標成未分類。不要用猜測選根因。
• 只有一般錯誤字樣：保留為未分類，等待精確文件證據。
• 有人貼入內部錯誤：移出公開表格，停止分享，並回到受控內部流程。
• 有人要求重新啟動：拒絕。本章沒有 restart procedure。
• 有人要求切換 driver 或探測 endpoint：拒絕。本章沒有 driver trial 或 endpoint probe procedure。
• 有人要求連接或測試 bus：拒絕。本章沒有 bus procedure，也不得以 telegram 或實體控制驗證。
• 分類文字洩漏環境：移除該列，改用來源中的抽象概念重新建立。

常見問題