PART ONE
專案總覽|功能與應用場景
這是一個 Home Assistant 的自訂元件,主要功能是將多個獨立的實體(例如控制窗簾開合的兩個開關)結合成一個統一的「遮蓋物」實體。這讓使用者可以在 Home Assistant 介面中,像操作單一窗簾或捲門一樣,方便地控制這些組合設備的開啟、關閉與停止。
🔑 核心功能
- 實體組合功能
- 虛擬遮蓋物呈現
- 統一控制介面
- 支援多種實體類型
- 自訂開啟與關閉邏輯
- 狀態追蹤與模擬
📋 功能詳細說明
| 功能名稱 | 說明 |
|---|---|
| 將兩個開關合併為一個窗簾控制器 | 使用者有兩個智慧開關,一個控制窗簾開啟,另一個控制關閉。透過設定 woow_cover_entity,可以將這兩個開關合併為一個名為「臥室窗簾」的 cover 實體,從而在介面上獲得一個包含開啟、關閉和停止按鈕的整合控制器。 |
| 使用輸入布林值模擬車庫門 | 一個 DIY 的車庫門控制器使用兩個 input_boolean(一個用於觸發開啟/關閉,一個用於停止)來操作。此元件可以將這兩個輸入布林值整合成一個「車庫門」cover 實體,並可搭配一個二元感測器來顯示門的開關狀態,實現完整的 UI 控制與狀態顯示。 |
PART TWO
深入解析|執行環境與部署步驟
⚙️ 執行環境需求
- 運行此專案所需的軟體、硬體和相依套件
- 需要正常運行的 Home Assistant 實例,版本建議為 2023.4 或更高版本。
- 建議安裝 HACS 以簡化自訂元件的安裝與管理。
- 需要預先在 Home Assistant 中設定好您希望組合的實體,例如用於控制的開關(switch)或燈(light)。
🔧 部署安裝步驟
| 步驟 | 說明 |
|---|---|
| Step 1 | 確保您的 Home Assistant 正在運行且可正常存取。 |
| Step 2 | 若尚未安裝,請先安裝 HACS (Home Assistant Community Store)。 |
| Step 3 | 在 HACS 的「整合」頁面中,點擊右上角選單並選擇「自訂儲存庫」。 |
| Step 4 | 在儲存庫 URL 中輸入 \`https://github.com/WOOWTECH/woow_cover_entity\`,類別選擇「整合」,然後點擊「新增」。 |
| Step 5 | 在 HACS 中找到「Woow Cover Entity」,點擊「安裝」並依照指示完成。 |
| Step 6 | 重新啟動 Home Assistant 服務以載入元件。 |
| Step 7 | 在您的 \`configuration.yaml\` 檔案中,新增 \`cover\` 區塊並設定您的組合實體。 |
PART THREE
總結與展望|AI Agent 部署 Prompt
🤖 AI Agent 部署 Prompt
以下是用於部署此專案的 AI Agent Prompt,可直接複製使用:
複製此 Prompt 給 AI Agent,即可自動完成安裝、部署與測試
← 返回開源專案列表