第二部 · 第 9 章

INI 結構與選項關係

依受管範本整理 INI 區段與設定責任,保留版本限制。

已撰寫

本章概覽

先說結論:你只會畫一張離線責任圖。把設定內容分進有標籤的抽屜。你不會填值、寫檔或套用設定。

目的
用有標籤的抽屜分清 INI 區段、選項與產生責任。
準備
一張空白紙與第 7–8 章的責任分類;不需要設定檔或執行中資料。
時間
約 20 分鐘。
系統變更
不修改 INI 或啟停 Add-on;只離線閱讀固定版本的受管範本。
預期結果
能把 INI 區段、選項與產生責任對應起來,不把範本視為可直接套用的現場設定。
停止條件
  • 需要填入真實環境值或把範本直接寫入系統。
  • 步驟要求套用設定、安裝或重新啟動 Add-on。

範圍與安全界線

本章只在紙上分類。不要貼入主機、位址、連接埠、裝置、序號、秘密或正式設定。不要讀取本機結果,也不要把範本當成目前設定。

本章不加入 repository、不安裝、不啟動。本站缺少核准的 immutable artifact/image digest 與來源到建置的證明,所以所有執行動作都被封鎖。

不要連接介面或 KNX bus。禁止群組讀取、群組寫入、telegram 傳送、ETS programming/download 與實體控制。紙上對照不能證明 daemon、listener、整合或 bus 成果。

核心概念

先看標籤,再看責任。不要往抽屜裡放任何現場資料。

有標籤的文件抽屜

先這樣想:辦公室用不同抽屜收不同類型的表單。抽屜標籤只說這裡負責收什麼,不表示表單已填好,也不表示有人已照表單工作。

正式名稱:INI 設定的區段、選項與受管範本責任;背景程式(daemon)是本章不驗證的執行角色。

選項是輸入類別。區段是整理方式。受管範本是來源材料。三者都不是現場結果。

你的圖只需要四個抽屜:「主要責任」「服務責任」「記錄責任」「介面責任」。若一項資料無法只靠固定來源歸類,就放進「待補證據」。

準備與前置條件

拿一張紙,畫出五個空框。前四框是四個責任抽屜。第五框是「待補證據」。每個框只放分類字樣。

  • 在紙張上方寫「離線責任圖」。
  • 寫明「不含實值」。
  • 寫明「未產生、未套用、未讀取執行結果」。
  • 把版本差異留給版本與相容性處理,不混用其他版本。

如果手邊資料帶有環境識別內容,不要抄寫。只記「需要授權人員在受控位置確認」。

分段步驟

  1. 先放主要責任。把整體串接與共同設定的角色放進主要抽屜。不要填任何值。
  2. 再放服務責任。把等待其他軟體交接的角色放進服務抽屜。不要推論服務已存在。
  3. 分開記錄責任。把訊息層級與記錄類別放進記錄抽屜。不要抄本機日誌。
  4. 分開介面責任。把裝置型、篩選型或網路型輸入只寫成類別。不要放路徑或端點。
  5. 標出來源邊界。每張分類卡註明它來自輸入規則或受管範本。不要把兩種來源寫成同一件事。
  6. 封閉結論。最後只寫「離線責任已對照」或「仍有缺口」。不要寫成已部署或可使用。

驗證與證據

完成品只能是一張不含實值的責任圖。它說明資料應由哪一類抽屜承接,不說明系統現在做了什麼。

  • 我有主要、服務、記錄、介面與待補證據五個抽屜。
  • 我分開標示輸入規則與受管範本。
  • 我的圖沒有主機、位址、連接埠、路徑、序號、秘密或正式設定。
  • 我沒有寫檔、套用、安裝、啟停或讀取執行結果,也沒有宣稱任何 bus 或整合成果。

下一步:前往第 10 章,用交接檢查點分清 driver、介面與 bus 的證據層。

故障排除

  • 不知道放哪個抽屜:放進待補證據。不要靠名稱猜。
  • 有人貼入正式值:停止分享並移除內容。責任圖只保留分類。
  • 範本看起來很完整:仍標成來源材料。完整外觀不代表已產生或已套用。
  • 輸入規則與範本對不上:分開記錄兩個來源,再標示缺口。不要自行補關係。
  • 有人要求立即套用:停止。本章沒有寫檔、安裝或啟停程序。

常見問題

進階補充:受管範本與來源輸入的技術邊界

Add-on 0.6.1 的固定輸入規則描述資料類型、是否可省略,以及來源是否宣告預設。固定受管 INI 範本則描述主要、服務、記錄與介面等區段角色。前者是來源輸入契約;後者是受管理的文字材料。

兩份來源可以支持離線責任對照,但不能支持範本產生方式、目前檔案內容、讀取結果或套用結果。來源預設的存在也不是環境建議。本章不提供任何執行環境交換格式或結果。

抽屜標籤就是設定值嗎?

不是。標籤只表示責任類別,不能拿來寫入系統。

範本完整就代表目前設定完整嗎?

不代表。範本與目前檔案是不同證據。

可以把來源預設當推薦嗎?

不可以。預設存在只是一項來源事實,不是正式環境建議。

對照完成仍不能證明 daemon 狀態嗎?

是。紙上分類不能證明程序、driver、listener、介面或 bus 狀態。

待補證據要怎麼處理?

保留分類與責任人。不要用本機讀取或猜測把空白補滿。

證據與來源

證據類別:source-bounded

功能對照:addon-options-schema、addon-managed-ini-template

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