第一部 · 第 5 章

序列介面辨識與資料最小化

建立不公開裝置路徑或序號的介面盤點方法與停損點。

已撰寫

本章概覽

先說結論:這一章只做一張不含識別資料的候選分類表。你不會列出電腦目前看到的裝置,也不會找出適用硬體。完成表格,不等於硬體相容。

目的
用去識別特徵分類介面候選項,不猜測硬體是否適用。
準備
一張空白離線分類表,以及第 3、4 章的安全界線。
時間
約 15 分鐘。
系統變更
不修改 Home Assistant;只建立不含真實裝置路徑與序號的離線介面分類表。
預期結果
能用去識別特徵分類介面候選項,並把硬體可用性保持為未證實。
停止條件
  • 不得抄錄或公開真實裝置路徑、USB 序號或主機識別。
  • 步驟要求連接介面、KNX bus 或存取實體設備。

範圍與安全界線

你只整理「資料應怎麼分類」。不要執行裝置列舉。不要查看真實裝置路徑。不得抄錄真實序號。不得發布真實主機名稱、IP、端點、憑證或時間線索。若既有資料含這些內容,停止轉交,再依安全日誌指引處理。

本章不加入 repository、不安裝、不啟動。這些動作只有在完整隔離、書面核准,以及核准的 immutable artifact/image provenance 全部成立後,才可能另行評估。本站目前缺少核准的 artifact/image digest,所以不得執行。

也不要連接介面或 KNX bus。禁止群組讀取、群組寫入、telegram 傳送、ETS programming/download 與實體控制。

核心概念

先把候選項分清楚,再決定要問什麼。不要反過來用猜的。

只有號碼的寄物票

先這樣想:衣帽間給你「候選 A」與「候選 B」兩張票。票只用來區分兩件物品,不寫姓名、品牌或置物櫃位置。

正式名稱:去識別的序列介面候選分類。

候選代號只回答「是不是同一筆紀錄」。它不回答硬體型號、驅動相容性或 KNX bus 狀態。

分類表只放三種判斷:來源文件已說明、尚待人工複核、超出本章。看到候選存在,最多只能說「有一筆待分類資料」。不要寫成「已找到介面」或「可以使用」。

準備與前置條件

準備一張空白表。只建立下列欄位,不填任何環境實值:

  • 候選代號:使用「候選 A」這類無意義標籤。
  • 資料類別:文件事實、待複核問題或禁止公開資料。
  • 欄位角色:這筆資料是否可能屬於介面輸入。
  • 目前結論:一律從「硬體適用性未證實」開始。
  • 停止原因:記錄缺少核准、資料可能識別環境或來源版本不符。

不要準備終端機指令、裝置清單或截圖。本章沒有 live enumeration 程序。

分段步驟

以下全是離線紙上分類。你不需要接觸執行中環境。

  1. 先寫共同結論。在表頭寫「本表只做候選分類;硬體相容、驅動運作與 bus 狀態都未證實」。
  2. 建立中性代號。需要區分既有的去識別紀錄時,依序寫候選 A、候選 B。不要由路徑、序號、型號或位置產生代號。
  3. 分類資料角色。把每筆內容放入「文件事實」「待人工複核」或「不得公開」。沒有足夠內容時就標示未知。
  4. 寫下未證實事項。每個候選都註明硬體身分、驅動家族、適用性與 KNX bus 狀態未證實。
  5. 套用停止條件。若分類需要回看真實路徑、序號、主機或 live 裝置清單,就停止。不要用逐項啟動來找答案。
  6. 交給另一人複核。只交付去識別分類表。請複核者確認沒有環境識別資料,也沒有相容性宣稱。

驗證與證據

正確成果是一張分類表,不是一個裝置答案。用下面清單確認文字沒有越界。

  • 我的表格只有候選代號,沒有真實路徑、序號、主機、IP 或端點。
  • 我沒有執行 live enumeration,也沒有提供相關程序。
  • 每個候選都保留「硬體適用性未證實」。
  • 我沒有安裝、啟動、連接 bus、操作群組、ETS 或實體設備。

下一步:前往第 6 章。你只會從固定文件選出一個驅動家族供日後人工複核,不會試啟動。

故障排除

  • 不知道候選來自哪裡:標示「來源未知」並停止。不要回到 live 系統找答案。
  • 候選代號暗示型號或位置:重新改成無意義的字母代號,刪除舊副本。
  • 同事要求真實路徑:不提供。把需求轉成「需要複核哪一種欄位角色」。
  • 表格看起來像相容清單:在每列補上「硬體適用性未證實」,並移除推薦或肯定字眼。
  • 有人提議逐個啟動:停止。這不是本章的分類工作,也不能繞過隔離、核准與 artifact provenance。

常見問題

進階補充:固定來源實際支持到哪裡

Add-on 0.6.1 的固定初始化來源包含介面分類、裝置欄位處理、USB 值轉換與範本替換邏輯。這些只是來源程式行為。它沒有提供本機裝置清單,也不能證明任何候選硬體存在或相容。

需要核對版本邊界時,請看版本與相容性說明。不同版本不可直接外推。

候選 A 代表真的有一個裝置嗎?

不代表。它只是一張分類票,用來區分既有的去識別紀錄。

可以提供找裝置的指令嗎?

不可以。本章刻意不提供 live enumeration 程序,也不要求接觸執行中環境。

看到候選就能選驅動嗎?

不能。候選存在與驅動文件是不同證據。第 6 章也只做文件層候選,不證明相容。

可以把序號雜湊後當代號嗎?

不要。由識別值衍生的代號仍可能被串聯。直接使用無意義的候選字母。

分類表何時算完成?

資料已去識別、來源層級清楚、未證實事項與停止原因都在,才算完成。硬體仍維持未驗證。

證據與來源

證據類別:source-bounded

功能對照:addon-init-configuration-lifecycle

固定來源只支持文件所述範圍;本頁不代表任何本機、硬體、網路或 KNX 匯流排驗證結果。