PART ONE
專案總覽｜功能與應用場景
此 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 | 在 HACS 的自訂儲存庫中新增 https://github.com/WOOWTECH/ha_permission_manager 並下載 |
| Step 2 | 根據 HACS 提示重新啟動 Home Assistant 服務 |
| Step 3 | 前往「設定」>「裝置與服務」，點擊「新增整合」並搜尋「Permission Manager」 |
| Step 4 | 依照設定精靈的指示完成安裝，系統會自動註冊管理面板 |
| Step 5 | 進入側邊欄新增的「權限控制面板」，確認可以看到使用者和權限矩陣介面 |
PART THREE
總結與展望｜AI Agent 部署 Prompt
🤖 AI Agent 部署 Prompt
以下是用於部署此專案的 AI Agent Prompt，可直接複製使用：
複製此 Prompt 給 AI Agent，即可自動完成安裝、部署與測試
← 返回開源專案列表