PART ONE
專案總覽｜功能與應用場景
這是一個 Home Assistant 的自定義組件，它提供一個側邊欄面板，讓使用者可以根據標籤來組織、查看和控制智慧家庭中的各種實體。此組件與 WOOWTECH 的另一個權限管理工具 \`ha_permission_manager\` 深度整合，能夠根據不同使用者的權限，僅顯示其有權存取的設備標籤，從而實現更精細的家庭設備分權管理。
🔑 核心功能
- 基於標籤的實體控制
- 權限感知
- 多語言支援
- 原生 HA 風格介面
- 領域摘要儀表板
📋 功能詳細說明
| 功能名稱 | 說明 |
|---|---|
| 依空間標籤管理設備 | 將客廳的所有智慧設備（燈光、溫控、窗簾）都加上「客廳」標籤。在 Label Control 面板中，點擊「客廳」標籤，即可集中查看和控制所有相關設備，無需在不同的設備頁面之間切換。 |
| 為訪客設定臨時控制權限 | 家中有訪客時，可以建立一個「訪客模式」標籤，並將部分允許訪客控制的設備（如客廳燈、空調）加入此標籤。再透過 \`ha_permission_manager\` 將此標籤的「有限控制」權限授予訪客帳號，讓他們只能控制指定的設備，確保其他私人設備的隱私與安全。 |
PART TWO
深入解析｜執行環境與部署步驟
⚙️ 執行環境需求
- 運行此專案所需的軟體、硬體和相依套件
- 需要 Home Assistant 2023.1 或更高版本。建議使用 Home Assistant OS 或 Home Assistant Supervised 安裝方式，以獲得完整的附加元件支援。
- 建議至少 Raspberry Pi 4（2GB RAM）或同等級 x86 設備。若同時運行多個整合，建議 4GB RAM 以上。需要穩定的網路連線和足夠的儲存空間（至少 32GB SD 卡或 SSD）。
- 需要先安裝 HACS 整合商店，用於方便地安裝和管理此自訂元件。可透過 Home Assistant 的附加元件商店或手動安裝 HACS。
- Home Assistant 內建 Python 3.11+ 執行環境，無需額外安裝。此元件的相依套件會在安裝時自動處理。
🔧 部署安裝步驟
| 步驟 | 說明 |
|---|---|
| Step 1 | 將 \`ha_label_control\` 目錄複製到 Home Assistant 的 \`custom_components\` 資料夾中 |
| Step 2 | 重新啟動 Home Assistant 服務以載入新的自定義組件 |
| Step 3 | 前往「設定」>「裝置與服務」，點擊「新增整合」並搜尋「Label Control」 |
| Step 4 | 依照設定流程完成整合的添加 |
| Step 5 | 在側邊欄點擊「標籤控制」面板，驗證是否能看到已設定的標籤與對應的實體。 |
PART THREE
總結與展望｜AI Agent 部署 Prompt
🤖 AI Agent 部署 Prompt
以下是用於部署此專案的 AI Agent Prompt，可直接複製使用：
複製此 Prompt 給 AI Agent，即可自動完成安裝、部署與測試
← 返回開源專案列表