Home Assistant KNX 設定邊界

本章概覽

先說結論：你只會做一張離線設定工作表。表內只有占位文字、資料分類與審閱狀態，不會出現可套用的設定、真實值或連線位置。

目的

建立只有占位符與分類的 Home Assistant KNX 離線設定工作表。

準備

一張空白工作表與第 13 章的紙上責任圖；不需要開啟 Home Assistant。

時間

約 20 分鐘。

系統變更

不儲存 Home Assistant KNX 設定；只用占位資料建立離線設定檢核表。

預期結果

能辨認設定責任與變更前閘門，不填入真實端點，並把連線與整合成果維持未證實。

停止條件

• 需要輸入真實主機、端點、位址、秘密或裝置資料。
• 步驟要求儲存設定、重新載入整合或測試連線。

範圍與安全界線

工作表不能拿去執行。不要開啟執行中的 Home Assistant，不要提供 YAML、API、可貼上的欄位形狀、連線位置或任何實際值。

不加入 repository、不安裝、不啟動。只有實體隔離、書面核准，以及核准的 immutable artifact／image digest 與 source-to-build attestation 都齊全時，才能在本章之外另案評估；本章不提供授權。

禁止自動化群組讀取、群組寫入、telegram 傳送、ETS programming／download 與實體控制。離線工作表不證明 KNXD、KNX bus、ETS 或 Home Assistant 整合有任何成果。

核心概念

工作表的結論上限是「欄位責任可供人工審閱」。它不表示 Home Assistant 能接受任何設定，也不表示連線、整合或 bus 有結果。

準備與前置條件

先畫表頭，不填內容值。表頭只使用下列治理分類。

• 需求名稱：只寫一般用途，不寫環境名稱。
• 責任角色：記錄由哪種角色提供或審閱，不寫個人資料。
• 語意占位符：固定寫「待授權角色補充」。
• 資料分類：從可公開、受控、秘密、未知中擇一。
• 來源邊界：分開記錄文件快照與 Core 版本中繼資料。
• 審閱狀態與停止理由：只記分類，不記執行結果。

只要某一格需要真實資料或可執行形狀，立即停止。不要從舊檔、畫面、記憶或網路文章補入。

分段步驟

每一步都只處理紙上分類。

1. 寫工作表標題。註明「離線占位工作表；不可匯入、不可貼入、不可執行」。
2. 建立需求列。只用連線責任、整合責任、資料模型責任與核准責任等一般分類，不模仿設定欄位。
3. 加入占位文字。每列只填「待授權角色補充」，不要加入格式提示、預設值或示範值。
4. 加入資料分類。標出可公開、受控、秘密或未知；受控、秘密與未知都不得補入公開工作表。
5. 分開來源欄。分別記下文件快照支持的概念與 Core 版本中繼資料支持的登錄邊界，不寫成相容保證。
6. 做離線複查。確認沒有 YAML、API 形狀、連線位置、實際值或操作句，最後交給另一位審閱者。

驗證與證據

完成標準是安全地留下空白，不是把表格填滿。你要能從每列看出責任、分類、來源與停止理由。

• 工作表明確標成離線且不可執行。
• 每列只有一般需求、責任角色、占位文字與分類。
• 文件快照與 Core 版本中繼資料分開記錄。
• 沒有 YAML、API 形狀、連線位置、主機、位址、秘密、裝置資料或實際值。
• 沒有儲存、重新載入、測試連線或成果主張。

下一步：前往第 15 章，用標籤卡整理實體模型。

故障排除

• 占位符看起來像真實值：全部改回「待授權角色補充」。
• 工作表像可貼上的設定：移除層級、語法、資料形狀與欄位順序，只保留治理分類。
• 來源被寫成同一版本：拆成兩列，分別說明支持範圍與不能證明的事項。
• 有人要求查看執行中設定：停止離線流程，移交明確核准的唯讀範圍評估。
• 有人要求測試連線：停止。本章不提供測試或執行授權。
• 空白被誤認為遺漏：補上停止理由，不要猜值。

常見問題