PART ONE
專案總覽｜功能與應用場景
此 Home Assistant 自訂元件能建立功能完整的虛擬風扇實體，具備完整的雙向狀態同步（TX/RX）能力。它允許將風扇的各項功能（如開關、速度、模式）委派給外部的 Home Assistant 實體進行控制，同時支援使用自訂腳本進行高階動作覆寫。
🔑 核心功能
- 雙向狀態同步
- 虛擬風扇實體
- 外部實體委派
- 可選的動作腳本覆寫
- Jinja2 數值轉換
- 線性插值映射
- UI 動態設定
📋 功能詳細說明
| 功能名稱 | 說明 |
|---|---|
| 將實體開關整合為風扇電源 | 使用者可以將一個 Zigbee 智慧插座（switch.smart_plug）指定為風扇的電源控制實體。當在 Home Assistant 介面中打開虛擬風扇時，該智慧插座會自動通電；反之，手動關閉插座也會同步更新虛擬風扇的狀態為關閉。 |
| 使用外部感測器數值動態調整風扇速度 | 一個 ESPHome 裝置透過 ADC 感測器（sensor.analog_input）讀取 0-1023 的原始數值。透過設定線性插值轉換（輸入 0-1023，輸出 0-100），感測器數值的變化能自動且平滑地對應到虛擬風扇 0-100% 的轉速，實現自動化風速調節。 |
PART TWO
深入解析｜執行環境與部署步驟
⚙️ 執行環境需求
- 運行此專案所需的軟體、硬體和相依套件
- 需要 Home Assistant 2025.6.x 或更高版本。建議在 Home Assistant OS、Supervised 或 Container 環境中運行。
- 建議在具備至少 1GB RAM 和 2 核心 CPU 的設備上運行，如 Raspberry Pi 4 或同等級的 NUC/伺服器。
- 需要穩定的區域網路連線，以便與 Home Assistant 中其他的實體和裝置進行通訊。
🔧 部署安裝步驟
| 步驟 | 說明 |
|---|---|
| Step 1 | 透過 Samba、SSH 或其他方式存取您的 Home Assistant 設定資料夾。 |
| Step 2 | 將 \`woow_fan_custom_component\` 資料夾從倉庫複製到 Home Assistant 的 \`custom_components\` 目錄下。 |
| Step 3 | 複製完成後，請重新啟動 Home Assistant 伺服器以載入新的自訂元件。 |
| Step 4 | 前往「設定」 > 「裝置與服務」，點擊右下角的「新增整合」。 |
| Step 5 | 在搜尋框中輸入「WoowTech Fan Entity」找到該元件並點擊進行設定。 |
| Step 6 | 依照設定流程的引導，填寫風扇名稱並綁定對應的控制實體。 |
PART THREE
總結與展望｜AI Agent 部署 Prompt
🤖 AI Agent 部署 Prompt
以下是用於部署此專案的 AI Agent Prompt，可直接複製使用：
複製此 Prompt 給 AI Agent，即可自動完成安裝、部署與測試
← 返回開源專案列表