PART ONE
應用總覽｜適用場景與效益
空間： 客廳 智慧應用： 語音控制全場景 智慧家庭類型： 智慧語音助手 ＋ 智慧控制 應用概述： 透過智慧音箱語音控制煈光、電視、冷氣 窗簾
對人們幫助到的面向
- 健康： 減少接觸開關與遙控器，降低病菌感染機會
- 享受： 智能私人管家語音控制隨侍在側，彷彿住在五星級飯店
說一句話，家就動起來：客廳的「聲控私人管家」
你有沒有過這種經驗？剛在沙發上找到最舒服的姿勢，準備追劇，突然發現遙控器不在手邊。你左看右看，它可能在茶几另一頭、可能被抱枕蓋住了、可能掉進沙發縫裡了。好不容易找到，打開電視卻覺得冷氣太冷、燈光太亮，又得繼續找其他遙控器。
再想像另一個場景：你躺在沛癴上，雙手抱著孩子哄眡，燈光太亮可能吵醒寶寶，但你根本騰不出手去調燈。這時候如果能說一句「把燈調暗一點」，一切就解決了。
語音控制不只是「酷炫的科技玩具」，它解決的是生活中那些「雙手被佔」或「懶得起身」的真實痛點。
告別遙控器，你就是家裡的指揮官
在語音控制的客廳裡，你的聲音就是萬能遙控器。你可以用自然的口語對話來控制一切：
語音控制能做到的事
最厲害的是最後三句 — 這不是控制單一設備，而是一句話觸發整個場景模式。所有設備同時響應，原本要走好幾步、按好幾個開關的動作，縮短成一句話的時間。
減少接觸，給家人更乾淨的生活
語音控制有一個經常被忽略的好處 — 衛生。
你知道家裡哪個地方細菌最多嗎？不是馬桶，是遙控器和電燈開關。根據微生物學研究，家庭遙控器表面的細菌數量平均是馬桶座墊的 20 倍以上。因為每個人都會摸，但沒有人會定期消毒。
透過語音控制，你可以大幅減少觸摸遙控器和開關的頻率。對於家裡有幼童的家庭尤其重要：小孩什麼都摸、什麼都往嘴裡放，減少一個接觸媒介就少一分生病的風險。
對於有長輩的家庭（語音控制還解決了另一個問題 — 遙控器上的小按鈕。很多長輩眼睛不好，那些密密麻麻的按鈕根本看不清楚。用說的多簡單：「開燈」、「關冷氣」、「開電視」，不用看任何按鈕。
一人一句口令，全家都有自己的「管家」
語音控制可以搭配場景模式，讓每個家庭成員都有自己專屬的口令：
家庭成員專屬口令範例
這些口令不是固定的，你可以完全自訂。想叫什麼就叫什麼，系統都認得。
語音控制的技術選項
Home Assistant 支援多種語音助手整合方式，各有優紹點：
語音助手比較
隱私小提醒： Google Home 和 Alexa 的語音指令會上傳到雲端分析。如果你對隱私特別在意，可以考慮 HA 內建的 Assist 語音助手，搭配本地語音辨識引擎（如 Whisper），所有處理都在家裡完成，不會有任何資料外傳。
一個月後你會發現的改變
- 遙控器找不到也不慌 — 因為你根本不需要遙控器了
- 生活效率大幅提升 — 一句話完成以前要走好幾步的事
- 家人都說好用 — 連長輩和小孩都能輕鬆操作
- 更注重衛生 — 不知不覺減少了觸碰頻率
- 訪客超驚豔 — 朋友來家裡都會說「好厲害」
- 想回到以前已經不可能 — 用過語音控制就回不去了
想讓你家客廳也有聲控管家？
你只需要一個智慧音箱（或手機上的語音助手），搭配 Home Assistant 的場景和腳本，就能實現全場景語音控制。下面我們會介紹設定架構和 AI 提示詞。
PART TWO
深入解析｜技術原理與運作方式
以下說明語音控制全場景在 Home Assistant 裡的架構。
🔌 實體（需要準備的設備）
語音助手裝置
Google Home 音箱、Amazon Echo、Apple HomePod，或任何支援麥克風的裝置搭配 HA Assist。
所有已接入 HA 的設備
語音控制本身不需要額外設備，它控制的是已經在 HA 裡的設備：燈光、空調、窗簾、電視、音響、插座等。
已建立的場景和腳本
語音控制的「一句話觸發場景」依賴已經建立好的場景（Scene）和腳本（Script）。如果你已經設定好了觀影模式、離家模式等場景，語音只是另一種觸發方式。
輔助元件
- 語音控制開關（input_boolean）： 全局語音控制的總開關，關閉時語音指令不會執行任何動作（例如家裡有嬰兒睡覺時不想被誤觸發）。
- 語音回饋開關（input_boolean）： 控制語音助手是否在執行後用語音回覆確認（「好的，已幫你關燈」），有人喜歡有回覆，有人覺得吵。
🎬 情境（Scene）與腳本（Script）— 語音觸發的核心
語音控制不需要建立新的情境，它是利用已有的場景和腳本。但需要確保每個場景/腳本都有清楙的命名，這樣語音助手才能正確辨識。
命名建議： - 場景名稱使用日常用語：「觀影模式」而非「scene_movie_mode_v2」 - 腳本名稱使用動作語句：「打開觀影模式」而非「script.toggle_movie」
⚙️ 自動化（Automation）— 語音專用
自動化一：語音場景觸發入口
建立一個統一的語音入口腳本，收到語音指令後判斷關鍵字，分派到對應的場景或動作。
自動化二：語音回饋通知
當語音指令被執行後，透過智慧音箱的 TTS（文字轉語音）功能，回覆一句確認語（可開關）。
自動化三：誤觸發保護
設定語音控制的冷卻時間，同一個指令在 5 秒內不重複執行，避免電視囮聲或家人對話被誤判。
🔧 進階擴充建議
PART THREE
總結與展望｜重點回顧
使用前小提醒： - 請確認你已有一個語音助手裝置（Google Home / Alexa / HomePod / HA Assist） - 請確認你的 Home Assistant 已完成基本設備接入 - 語音控制建立在已有的場景和腳本之上，建議先完成其他設定再處理語音
你是一位 Home Assistant 自動化專家。
我要請你直接連線進入我的 Home Assistant，
幫我完整建置「客廳語音控制全場景」，包含確認已有的場景和設備、建立語音觸發腳本、整合語音助手、並測試所有語音指令，全程不需要我手動操作。
---
【第一步：請先向我索取連線資訊】
1. 我的 Home Assistant 網址
2. 我的長期存取權杖
連線成功後回覆「✅ 已成功連線到你的 Home Assistant（版本：xxxx）」。
---
【第二步：盤點已有的場景、腳本和設備】
連線後，請呼叫 /api/states 完整盤點：
**🎬 已建立的場景（domain: scene）**
列出所有場景，標示名稱和包含的設備。
**📋 已建立的腳本（domain: script）**
列出所有腳本，標示名稱和功能。
**💡 可控制的設備**
依類別列出所有已接入的客廳設備：
- 燈光（light）— 每盞燈的名稱
- 空誯（climate）— 型號和支援功能
- 窗簾（cover）— 是否支援位置控制
- 影音（media_player）— 電覆、音響
- 插座（switch）— 控制的設備
- 安防（alarm / input_select）— 安防模式選擇器
**🎙️ 語音助手**
- 是否有 Google Home 整合？（cloud.google_actions）
- 是否有 Alexa 整合？（cloud.alexa）
- 是否有 Apple HomeKit 整合？
- 是否有 HA Assist 設定？（conversation / stt / tts）
**📲 TTS 服務（text-to-speech）**
列出可用的 TTS 引擎（用於語音回饋）。
列出後詢問我：
1. 你主要想用哪個語音助手？（Google / Alexa / Siri / HA Assist）
2. 是否需要支援多個語音助手？
---
【第三步：建立輔助元件】
透過 API 建立：
1. 語音控制總開關：
- entity_id：input_boolean.voice_control
- icon：mdi:microphone
- 預設：開啟
2. 語音回饋開關：
- entity_id：input_boolean.voice_feedback
- icon：mdi:text-to-speech
- 預設：開啟
建立完成後回覆「✅ 輔助元件建立完成」。
---
【第四步：定義語音指令對照表 — 請逐一詢問我】
⚠️ 重要：請根據第二步盤點到的場景和設備，**逐一詢問我每一個語音指令要觸發什麼動作**。
---
**宮一設備控制指令，請逐一問我：**
對每個已接入的設備類型：
燈光：
1. 「打開客廳的燈」要開啟哪些燈？開到什麼亮度和色溫？
2. 「把燈調暗一點」每次降低多少？（例如 20%）
3. 「把燈誯亮一點」每次增加多少？
4. 「把燈調成暖色」色溫設多少 K？
5. 「把燈調成冷色」色溫設多少 K？
6. 「關燈」要關哪些燈？（全部/只關主燈）
空調：
7. 「開冷氣」預設溫度和模式是什麼？
8. 「冷氣誯刲 XX 度」是否有最低和最高限制？
9. 「關冷氣」是否同時關閉風扇？
窗簾：
10. 「把窗簾拉上」全關還是到指定位置？
11. 「窗簾開一半」精確設到 50% 嗮？
12. 「打開窗簾」全開 100% 嗎？
影音：
13. 「打開電視」是否同時切到預設頻道？
14. 「關電視」是否同時關音響？
15. 「音量大一點/小一點」每次誯多少？
---
**場景模式口令，請逐一問我：**
對每個已建立的場景：
16. 觸發「觀影模式」的口令想說什麼？（例如「我要看電影」/「電影時間」）
17. 觸發「離家模式」的口令？（例如「我要出門了」/「離家模式」）
18. 觸發「回家模式」的口令？
19. 觸發其他場景的口令？（逐一確認每個已建立的場景）
20. 「晚安」口令要觸發什麼動作？
---
**安防相關口令：**
21. 「啟動安防」要切到哪個安防模式？
22. 「解除安防」是否需要先確認身分？（語音確認 / 不需要）
---
**其他自訂口令：**
23. 你有沒有其他想自訂的口令？（例如「打掃」啟動掃地機器人）
24. 是否需要「全部關閉」的緊急口令？
---
取得回答後，我會根據你的設定建立所有語音觸發腳本。
---
【第五步：建立語音觸發腳本和自動化】
根據第四步的對照表，建立以下內容：
**為每個場景口令建立對應腳本：**
- script.voice_movie（口令觸發觀影模式）
- script.voice_leave（口令觸發離家模式）
- script.voice_come_home（口令觸發回家模式）
- （其他場景腳本依第四步回答建立）
**建立語音回饋自動化：**
- 每個腳本執行後，若 input_boolean.voice_feedback 為開啟，透過 TTS 回覆確認語
- 例如：觀影模式啟動後說「好的，已切換到觀影模式，祝您觀影愉快」
**建立誤觸發保護自動化：**
- 同一口令 5 秒內不重複執行
**整合語音助手：**
- 根據用戶選擇的語音助手平台，設定 expose 的實體和場景
- 如果是 Google Home：透過 Nabu Casa 或手動整合暴露場景和腳本
- 如果是 HA Assist：設定 intent 和 sentence 觸發
---
【第六步：語音助手平台整合設定 — 請依我選的平台操作】
**如果選 Google Home：**
- 確認已設定 Google Assistant 整合
- 將所有語音腳本暴露給 Google Home
- 設定 Google Home Routine 對應口令 → 觸發對應腳本
- 逐一詢問我每個 Routine 的口令用語
**如果選 HA Assist：**
- 確認已安裝語音辨識引擎（Whisper）和 TTS 引擎（Piper）
- 設定 intent_script 對應每個口令
- 建立 custom_sentences 宙義中文觸發語句
- 設定 conversation agent
**如果選 Alexa：**
- 確認已設定 Alexa 整合
- 暴露場景和腳本
- 設定 Alexa Routine
---
【第七步：驗收測試】
1. ✅ / ❌ 語音說「打開客廳的燈」，確認燈光開啟
2. ✅ / ❌ 語音說「把燈調暗一黮」，確認亮度降低
3. ✅ / ❌ 語音說「冷氣誯到 26 度」，確認空調回應
4. ✅ / ❌ 語音說「把窗簾拉上」，確認窗簾關閉
5. ✅ / ❌ 語音說場景口令（如「我要看電影」），確認觀影模式啟動
6. ✅ / ❌ 語音說「晚安」，確認客廳全關
7. ✅ / ❌ 確認語音回饋有正確的 TTS 回覆（若開啟）
8. ✅ / ❌ 快速重複說同一口令，確認不會重複觸發
9. ✅ / ❌ 關閉 input_boolean.voice_control，確認語音指令不執行
10. ✅ / ❌ 確認所有腳本和診動化已建立且啟用
"˦測試失敗，自動修正後重試，最多兩次。
---
【注意事項】
- e��程繁體中文回覆
- entity_id 英文，友善名稱繁體中文
- 完成後列出摘要：
✅ 輔助元件：input_boolean.voice_control（語音控制總開關）
✅ 輔助元件：input_boolean.voice_feedback（語音回饋開關）
✅ 語音腳本 × N（依建立數量）
✅ 自動化：語音回饋
✅ 自動化：誤觸發保護
✅ 語音助手整合：（Google / Alexa / Assist）
✅ 測試：全部通過
---
【常見問題排除】
| 問題 | 可能原因 | 建議處理 |
|------|----------|----------|
| 語音助手聽不懂 | 口令用語不在辨識範圍 | 換一種說法或在 Routine 中新增同義詞 |
| 只能控制單一設備不能觸發場景 | 場景未暴露給語音助手 | 確認場景/腳本已 expose |
| Google Home 說「我不知道怎麼做」 | HA Cloud 未連線或場景未同步 | 重新同步裝置 |
| HA Assist 辨識率低 | Whisper 模型太小 | 升級到 medium 或 large 模型 |
| TTS 回覆聲音太小 | 音響音量設定 | 調整 TTS 播放音量 |
| 電視回聲觸發 | 電視節目裡有類似口令 | 調整靈敏度或設定冷卻時間 |
| 口令重複觸發 | 沒設冷卻機制 | 確認誤觸發保護自動化已啟用 |
| 長輩不知道要說什麼 | 口令太複雜 | 簡化口令，貼一張指令表在牆上 |
語音控制，就是要把你的雙手還給你。你只要負貧發號施令，雜事讕家來辦。