PART ONE
專案總覽｜功能與應用場景
此 Home Assistant 自訂元件提供一個側邊欄面板，用於根據實體分配的區域進行組織和控制。它與「權限管理器」元件整合，僅顯示使用者有權存取的區域。面板提供一個包含 9 個網域類別（如燈光、溫控、窗簾）的摘要儀表板，以及每個網域和區域的詳細視圖，並為每個實體提供滑桿和按鈕等互動式控制項。
🔑 核心功能
- 區域實體管理
- 權限控制
- 多視圖顯示
- 互動式實體控制
- 即時更新
📋 功能詳細說明
| 功能名稱 | 說明 |
|---|---|
| 依區域集中控制智慧家庭設備 | 在 Home Assistant 側邊欄的「分區控制」面板中，使用者可以快速查看所有區域（如客廳、臥室、廚房）的設備狀態。點擊「客廳」區域，即可看到所有位於客廳的燈光、溫控器、窗簾等設備，並可直接在面板上進行開關、調整亮度或溫度等操作，無需在不同的儀表板之間切換。 |
| 為不同家庭成員設定專屬控制面板 | 結合 Permission Manager，管理者可以為家中的孩子設定一個僅能查看和控制他們自己房間（例如「兒童房」）設備的權限。當孩子登入 Home Assistant 時，他們的「分區控制」面板將只會顯示「兒童房」這個區域，無法看到或操作其他區域（如主臥室或書房）的智慧設備，確保了家庭設備的隱私和安全。 |
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_area_control 資料夾複製到 Home Assistant 的 custom_components 目錄中 |
| Step 2 | 重新啟動 Home Assistant 服務以載入新的元件 |
| Step 3 | 前往「設定」>「裝置與服務」，點擊「新增整合」並搜尋「Area Control」 |
| Step 4 | 依照設定流程完成整合的添加，面板將自動出現在側邊欄 |
| Step 5 | 點擊側邊欄的「分區控制」圖示，驗證是否能看到並控制已設定的區域與實體 |
PART THREE
總結與展望｜AI Agent 部署 Prompt
🤖 AI Agent 部署 Prompt
以下是用於部署此專案的 AI Agent Prompt，可直接複製使用：
複製此 Prompt 給 AI Agent，即可自動完成安裝、部署與測試
← 返回開源專案列表