PART ONE
專案總覽｜功能與應用場景
一個 Home Assistant 自訂整合，能將多個實體組合成一個虛擬設備，並支援與真實實體之間的雙向狀態同步與命令傳送。它允許使用者透過圖形化介面創建包含多種類型（如開關、感應器、燈光、風扇等）的虛擬裝置，並可透過 Jinja2 範本或線性內插進行數值轉換。
🔑 核心功能
- 支援10種平台
- 雙向傳送/接收綁定
- Jinja2 接收範本
- 無程式碼線性內插
- 圖形化設定流程
- 動態新增/編輯/移除實體
- 傳送時反向內插
📋 功能詳細說明
| 功能名稱 | 說明 |
|---|---|
| 智慧房間虛擬裝置 | 將一個房間內的多個智慧裝置，如一盞燈、一個溫濕度感應器、一個窗簾和一個風扇，整合成一個名為「書房」的虛擬裝置。使用者可以在儀表板上透過單一卡片集中查看所有狀態並進行控制，實現跨裝置的場景連動。 |
| 附燈吊扇整合控制 | 將一個吊扇（fan 實體）和其附帶的燈（light 實體）組合成一個單一的虛擬裝置。這樣不僅可以在 UI 上同時控制風扇轉速和燈光開關，還能將它們視為一個整體，簡化在自動化腳本中的邏輯。 |
PART TWO
深入解析｜執行環境與部署步驟
⚙️ 執行環境需求
- 運行此專案所需的軟體、硬體和相依套件
- 需要正常運行的 Home Assistant 實例，版本 2025.6.x 或更高。建議在 Home Assistant OS、Supervised 或 Container 環境中運行。
- 建議至少 1 核心 CPU、2GB RAM 和 10GB 儲存空間。需要穩定的網路連線以與實體設備通訊。
- 需要有權限存取 Home Assistant 的設定目錄，特別是 \`custom_components\` 資料夾，以便手動複製整合檔案。
- 雖然可以手動安裝，但推薦使用 Home Assistant Community Store (HACS) 來簡化安裝、更新和依賴管理。
🔧 部署安裝步驟
| 步驟 | 說明 |
|---|---|
| Step 1 | 將 \`custom_components/woow_virtual_entity/\` 目錄複製到您 Home Assistant 設定目錄下的 \`config/custom_components/\` 路徑中。 |
| Step 2 | 重新啟動 Home Assistant 服務以載入新的自訂整合。 |
| Step 3 | 前往 Home Assistant 的「設定」 > 「裝置與服務」。 |
| Step 4 | 點擊右下角的「新增整合」按鈕。 |
| Step 5 | 在搜尋框中輸入「WoowTech Virtual Entity」並選擇它。 |
| Step 6 | 依照設定精靈的引導，為您的虛擬裝置命名並選擇要包含的平台（實體類型）。 |
| Step 7 | 為每個選擇的平台配置其名稱、裝置類別、傳送/接收綁定以及其他相關選項。 |
PART THREE
總結與展望｜AI Agent 部署 Prompt
🤖 AI Agent 部署 Prompt
以下是用於部署此專案的 AI Agent Prompt，可直接複製使用：
複製此 Prompt 給 AI Agent，即可自動完成安裝、部署與測試
← 返回開源專案列表