PART ONE
應用總覽｜適用場景與效益
空間： 客廳 智慧應效： 人感應燈光／迎賓模式／離家模式 智慧家庭類型： 智慧照明 ＋ 智慧感測 ＋ 智慧娛樂 應效概述： 當客廳無人時自動關閉燈光與電器；當感測器偵測到回家時自動開啟燈光、空調、音樂；無人時自動關閉電器並啟動安防模式
對人們幫助到的面向
- 健康： 減少接觸開關機會，降低病菌傳染風險
- 享受： 智能管家自動開關燈典與電器，增加生活舒適度與被迎接的感受
- 效率： 精準依照需求開關燈與電器，增加能源使用效率
房子變得有感應：客廳的「隱形管家」
想像一個畫面：你拖著疲憊的身體回到家，雙手提滿了菜和包包，勉強把遰匙插進門鎖。門一開，迎接你的是一片漆黑和悖熱。你得先放下東西、摸黑找開關、開燈、再去開冷氣，整個流程下來得花兩三分鐘。
現在再想像另一個畫面：門一打開，玊關的燈溫暖地亮起，客廳的主燈自動轉轉你最喖歡的亮度，冷氣已經提前降好溫度，背景輕輕播放著你愛聽的音樂。你什麼都不用做，只需要把東西放下來，往沙发一坐，就能開始享受這一天剩$��的時光。
這就是人感應燈光搭配迎賓模式的魔力。
雙手提滿發？進門燈光就為你亮起
迎賓模式的核心概念就是「你回來了，家準備好了」。透過人體存在感測器（不是傳統的紅外線動態感測器，是能偵測到「人還在不在」的毫米波雴達），系統可以精準判斷客廳有沒有人。
搭配門磁感測器或手機地理圍欄，系統知道你是「创到家」而不是「半夜起來上廁所」。這兩種情境的回應完全不同：回家要全套迎接，半夜走動只需要一盎微光。
迎賓模式 vs 傳統回家流程
更重要的是，這整個過程完全不需要用手觸碰任何開關。對於有小孩的家庭，這是一個實實在在的衛生升級。公共場所的門把、電梯按鈕、公車拉環上的細菌，你不會想把它帶到家裡每一個開關上。語音或自動感應控制，就是最好的「無接觸」方案。
告別「健忘症」，出門從此不回頭
離家模式解決的是另一個痛黮：出門後的焦慮。
「冷氣有沒有關？」「電視忘亦關吗？」「客廳的燈是不是還亮著？」你有沒有過已經走到换運站，還是決定折返回家檢查的經驗？這種「離家焦慮」看似小事，長期下侦卻是一種慢性的精神消耗。
人體存在感測器搭配離家判斷邏輯，當系統偵測到客廳超過一段時間沒有人（例如 15 分鐘），它會自動判斷你已經出門或去其他房間了。接下來：
- 客廳所有燈光自動關閉
- 冷氣自動關閉
- 電視和音響自動關閉
- 不必要的電器插座斷電
- 安防感測器自動啟動
你再也不需要出門前逐一檢查，系統已經幫你善後了。
離家模式的隱藏好處
除了省心，離家模式還有一個你可能沒注意到的好處 — 省電。根據台灣能源局的統計，一般家庭約有 10～15% 的電力消耗來自於「忘記關閉的電器待機耗電」。這些待機耗電看似微小，但一年累積下來可能多花好幾百元。
離家模式的自動斷電功能，幫你杜絕了這些不必要的浪費。
聰明省電，讓電費花在刀口上
人體存在感測器還有一個日常好用的功能：精準用電。
如果你只是進客廳拿個東西就走（停留不超過 2 分鐘），傳統的做法可能是開燈忘了關，等到半小時後才發現。人體存在感測器可以在偵測到你離開後，已遲 3～5 分鐘確認無人，然後自動關燈。
這跟傳統的紅外線動態感測器不同。傳統感測器只能偵測「移動」，你坐在沙發上看書不動的話，它會以為你不在，把燈關了。毫米波人體存在感測器可以偵測到呼吸和微小動作，只要你還在客廳，燈就不會關。
動態感測器 vs 人體存在感測器
半夜走動，只給你需要的微光
迎賓模式不是只有「回家」才有用。搭配時段判斷，半夜 11 點到早上 6 點之間，如果感測器偵測到客廳有人走動，系統不會用白天那種全亮模式嘇你一跳，而是只打開一盎低亮度的暖光小夜燈，亮度大約 5～10%，色溫 2700K 的暖橘色。
這種微光不會刺激視網膜，不會抑制褜黑激素分泌，讓你上完廁所回來還能很快入睡。這才是真正「懂你」的智慧照明。
一個月後你會發現的改變
- 回家變成一種享受 — 門一開，家就準備好了，午壓速度比以前快很多
- 出門不再焦慮 — 你知道系統會幫你善後，再也不用折返檢查
- 電費明顯降低 — 精準用電，忘記關燈的情況歸零
- 家人衛生升級 — 不碰開關，減少細菌傳播
- 半夜不再撞牆 — 微光自動亮起，安全又不干擾睡眠
- 心理安全感提升 — 離家時安防自動啟動，在外面也安心
想讓你家客廳也有隱形管家？
你不需要改裝潢，只需要幾顆感測器和智慧燈泡。下面我們會介紹這套設定的架構，以及一段可以直接交給 AI 幫你自動完成所有設定的提示詞。
PART TWO
深入解析｜技術原理與運作方式
以上說明這套人感應燈光與迎賓/離家模式在 Home Assistant 裡的架構，讓你了解背後大概做了哪些設定，不涉及任何程式碼。
🔌 實體（需要準備的設備）
人體存在感測器（domain: binary_sensor）
客廳的毫米波人體存在感測器（如 Aqara FP2、Hi-Link LD2410），放在能涵蓋整個客廳的位置。它提供「有人/無人」的狀態，是整套系統的核心。如果客廳很大，可能需要兩顆來涵蓋全部區域。
門磁感測器（domain: binary_sensor）
安裝在大門上的感測器，偵測大門的開/關狀態。搭配人體存在感測器，可以判斷「有人剛進門」（門開了且客廳偵測到人）的情境。
燈光（domain: light）
客廳所有可控燈具。支援調光和色溫的燈具效果最佳，可以在夜間模式時調到極暗暖光。
空誯（domain: climate）
客廳的冷氣或暖氣，用於迎賓模式啟動時自動開啟。
影音設備（domain: media_player）
電視、音響等，用於迎賓模式啟動時自動播放音樂。
電器插座（domain: switch）
需要在離家時斷電的電器，透過智慧插座控制。
手機定位（domain: device_tracker / person）
透過 HA Companion App 追蹤家庭成員的位置，用於判斷「回家」和「離家」。
輔助元件
- 迎賓模式開關（input_boolean）： 控制迎賓模式是否啟用。關閉時逵門不會自動觸發迎賓。
- 離家模式開關（input_boolean）： 控制離家自動判斷是否啟用。關閉時不會因為無人而自動關閉電器。
- 夜間模式開關（input_boolean）： 標記目前是否在夜間模式，影響感測器觸發的燈光亮度。
- 客廳無人計時器（timer）： 當客廳感測器變為無人時開始倒數，到時間後觸發離家邏輯。
為什麼需要計時器？ 你可能只是去廚房拿杯水，2 分鐘就回來了。如果一離開就馬上關燈關冷氣，等你回來又得重新開，很擾人。計時器設 10～15 分鐘的緩衝，確認你真的離開了才執行。
🎬 情境（Scene）
情境一：迎賓模式（白天） 客廳主燈開啟暖白光 70%、冷氣開啟設定溫度、音響播放預設音樂、窗簾依光線調整。
情境二：迎賓模式（夜間） 客廳僅開啟間接照明或氣氛燈 30% 暖光、冷氣開啟、音響低音量播放。
情境三：離家模式 所有燈光關閉、冷氣關閉、電視關閉、音響關閉、指定插座斷電。
情境四：夜間微光 僅開啟一盎小夜燈或燈帶 5% 極暗暖光（2700K），其他設備不動。
情境五：日間自動燈 白天有人但不是剛回家時，客廳維持適當亮度（依日光同步或固定值），不觸發冷氣和音樂。
進階技巧： 迎賓模式可以根據是誰回家來切換不同情境。例如爸爸回家播放煶士樂、媽媽回家播放流行音樂，靠手機定位判斷是哪位家庭成員觸發的。
📲 通知（Notification）— 選用
- 迎賓模式啟動時：「🏡 歡迎回家！燈光和冷氣已為您準備好。」
- 離家模式啟動時：「🔒 客廳已進入離家模式，所有設備已關閉。」
- 無人超時關閉時：「💡 客廳已超過 15 分鐘無人，已自動關閉燈光和電器。」
⚙️ 自動化（Automation）— 核心規則
自動化一：迎賓模式觸發
當大門門磁偵測到開門，且隨後客廳人體感測器偵測到有人，判斷為「有人回家」。根據目前時段，套用白天或夜間的迎賓情境。
自動化二：離家自動判斷
當客廳人體存在感測器從「有人」變為「無人」，啟動計時器開始倒數。倒數結束後如果感測器仍然是「無人」狀態，套用離家模式情境。
自動化三：計時器中途取消
如果計時器還在倒數時，人體感測器又偵測到有人（你只是去拿杯水回來了），自動取消計時器，不執行離家關閉。
自動化四：夜間模式切換
時間到晚上 11 點（或使用者設定的時間），自動開啟夜間模式標記。這會影響後續感測器觸發時的燈光行為（改為微光而非全亮）。早上 6 點自動關閉夜間模式。
自動化五：夜間微光觸發
夜間模式開啟時，如果客廳感測器偵測到有人走動，只開啟微光小夜燈，不開主燈和電器。離開後自動關閉微光。
自動化六：手機地理圍欄輔助（選用）
搭配手機定位，當所有家庭成員都離開 home zone，即使客廳感測器有小動物觸發也不啟動迎賓。反之，有手機進入 home zone 才允許迎賓觸發，減少誤判。
📋 腳本（Script）
- 「迎賓模式」按鈕 — 手動觸發迎賓情境（不等感測器）
- 「離家模式」按鈕 — 手動觸發離家關閉
- 「夜間模式開關」按鈕 — 手動切換夜間模式
- 「暫停感渫 30 分鐘」按鈕 — 暛時關閉自動感測（例如開派對時不想誌燈自動關）
🔧 進障擲充建議0
PART THREE
總結與展望｜重點回顧
將以下提示詞完整貼給 AI（ChatGPT / Claude 皆可），AI 會先引導你輸入連線資訊，接著自動進入你的 Home Assistant 完成所有設定，最後還會幫你測試確認一切正常運作，全程不需要你手動操作任何東西。
使用前小提醒： - 請確認你的 Home Assistant 已安裝並可正常登入 - 請確認你的人體感測器和門磁感測器已正確接入 HA - 權杖（Token）就像一把鑵匙，請不要分享給不信任的人 - 如果你的 HA 只能在家裡的區域網路存取，請確認操作時人在家中
你是一位 Home Assistant 自動化專家。
我要請你直接連線進入我的 Home Assistant，
幫我完整建置「客廳人感應燈光／迎賓模式／離家模式」，包含實體確認、情境建立、自動化建立與最終測試，全程不需要我手動操作。
---
【第一步：請先向我索取連線資訊】
在開始任何操作之前，請先詢問我以下兩項資訊：
1. 我的 Home Assistant 網址
（本機範例：http://homeassistant.local:8123，外紲範例：https://你的網址）
2. 我的長期存取權杖（Long-Lived Access Token）
取得方式：HA 右上角頭像 → 安全性 → 捲到最下方 → 「建立權杖」→ 複製後貼給你
取得這兩項資訊後，請使用 HA REST API 進行所有後續操作，不要請我手動設定任何東西。
若連線失敗，請明確告知我失敗原因，並請我重新確認資訊後再試。
連線成功後，請回覆「✅ 已成功連線到你的 Home Assistant（版本：xxxx）」讓我知道。
---
【第二步：自動探索客廳感測器與設備實體】
連線成功後，請呼叫 /api/states 取得所有實體，並自動篩選以下類別：
**🧍 人體存在感測器（domain: binary_sensor）**
篩選名稱或區域包含「客廳」「living」的人體感測器（occupancy、presence、motion）。
對每個感測器（請確認：
- `device_class`（是 occupancy/presence/motion 哪一種？）
- 目前狀態（on = 有人 / off = 無人）
- 是否為毫米波雴達型（可從設備名稱或製造商判斷）
列出時標示類型。
**🚪 門磁感測器（domain: binary_sensor，device_class: door/opening）**
篩選名稱包含「大門」「front_door」「entrance」「玄關」的門磁。
確認目前狀態（on = 開 / off = 關）。
**💡 燈光（domain: light）**
篩選客廳區域燈光，確認每盞燈支援的功能（亮度/色溫/RGB）。
**❄️ 空調（domain: climate）**
篩選客廳區域空調。
**📺 影音設備（domain: media_player）**
篩選客廳區域的媒體播放器。
**🔌 電器插座（domain: switch）**
篩選客廳區域的智慧插座。
**📱 手機定位（domain: person / device_tracker）**
列出所有已追蹤的家庭成員，確認是否有 home/not_home 狀態。
**📲 手機通知服務（domain: notify）**
列出所有可用的通知目標。
找到後條列給我確認，格式如下：
🧍 **找到的人體感測器：**
1. `binary_sensor.living_room_presence` — 客廳人體存在（毫米波雷達 ✅，目前：有人）
2. `binary_sensor.living_room_motion` — 客廳動態（PIR 紅外線，目前：無動態）
🚪 **找到的門磁感測器：**
1. `binary_sensor.front_door` — 大門（目前：關閉）
💡 **找到的燈光：**
1. `light.living_room_main` — 客廳主燈（亮度 ✅ / 色溫 ✅ / RGB ❌）
2. `light.living_room_ambient` — 客廳氣氛燈（亮度 ✅ / 色溫 ❌ / RGB ✅）
（其他類別同上格式）
若某類實體找不到（請告知可能原因並詢問是否跳過。
---
【第三步：建立輔助元件】
透過 API 建立以下輔助元件：
1. 迎賓模式開關：
- 名稱：迎賓模式
- entity_id：input_boolean.welcome_mode
- icon：mdi:home-heart
- 預設狀態：開啟
2. 離家自動判斷開關：
- 名稱：離家自動判斷
- entity_id：input_boolean.auto_away
- icon：mdi:home-export-outline
- 預設狀態：開啟
3. 夜間模式開關：
- 名稱：夜間模式
- entity_id：input_boolean.night_mode
- icon：mdi:weather-night
- 預設狀態：關閉
4. 客廳無人計時器：
- 名稱：客廳無人計時器
- entity_id：timer.living_room_empty
- duration：00:15:00（15 分鐘，後續可調整）
- icon：mdi:timer-outline
建立完成後請確認已出現在 /api/states 中，並回覆「✅ 輔助元件建立完成」。
---
【第四步：建立情境 — 請逐一詢問我每個實體的設定】
⚠️ 重要：在建立每個情境之前，你必須從第二步找到的實體清單中，**逐一詢問我每一個實體在該情境下的狀態**，不要自己假設任何預設值。
---
**關於「迎賓模式（白天）」情境，請逐一問我：**
燈光部分（對每一盞燈逐一詢問）：
1. `light.living_room_main`（客廳主燈）在白天迎賓時要開啟嗎？
2. 若開啟，亮度設多少？（百分比）
3. 若開啟，色溫設多少？（K 值）
4. （對下一盞燈重複，直到所有燈都問完）
空調部分：
5. 冷氣要開啟嗎？
6. 若開啟，溫度設多少？模式？風量？
影音部分：
7. 音響要開啟嗎？
8. 若開啟，播放什麼？音量多少？
9. 電視要開啟嗎？
窗簾部分（若有）：
10. 窗簾位置要怎麼設定？
---
**關於「迎賓模式（夜間）」情境，請逐一問我：**
11. 哪些燈要開啟？（通常只開間接照明或氣氛燈）
12. 開啟的燈亮度和色溫各設多少？
13. 主燈要關閉嗎？
14. 冷氣設定跟白天一樣嗎？如果不同，怎麼設？
15. 音響音量要降低嗎？降到多少？
---
**關於「離家模式」情境，請逐一問我：**
16. 哪些燈光要關閉？（逐一確認，有沉f��例外要保留的）
17. 冷氣要關閉嗎？
18. 電視和音響要關閉嗎？
19. 哪些電器插座要斷電？（逐一確認每個插座）
20. 有沒有任何設備離家時要「開啟」？（例如安防攝影機、掃地機器人）
---
**關於「夜間微光」情境，請逐一問我：**
21. 哪一盞燈要作為夜間微光燈？
22. 亮度設多少？（建議 5～10%）
23. 色溫設多少？（建議 2700K 暖光）
24. 其他所有燈光和設備是否維持現況不動？
---
**關於「日間自動燈」情境，請逐一問我：**
25. 白天有人在客廳但不是创回家時，燈光要怎麺設定？
26. 是跟隨日光同步模式的設定？還是固定亮度？
27. 其他設備（冷氣/音響）要怎麼處理？
---
取得我所有回答後，逐一建立情境並回覆摘要讓我核對。
---
【第五步：建立自動化 — 請先詢問觸發條件偏好】
建立前請先詢問我：
**迎賓相關：**
1. 迎賓模式要怎麼觸發？
a. 門磁 + 人體感測器（門開了且偵測到人 = 回家）
b. 手機定位（手機進入 home zone）
c. 兩者都用（更精準）
2. 迎賓模式觸發後，是否有冷卻時間？（例如 30 分鐘內不重複觸發，避免開關門太頻繁）
3. 如果家裡有寵物，是否需要排除寵物觸發？怎麼排除？（用手機定位 + 感測器雙重判斷）
**離家相關：**
4. 客廳無人多久後算「離家」？（建議 10～15 分鐘）
5. 離家判斷是否搭配手機定位做雙重確認？（有人在 home zone 就不觸發離家）
6. 離家關閉前是否需要推送確認通知？（例如「客廳 15 分鐘無人，即將關閉，要取消嗎？」）
**夜間相關：**
7. 夜間模式幾點開始？幾點結束？
8. 夜間偷測到人要開微光多久後自動關？（例如離開後 2 分鐘關）
**通知相關：**
9. 哪些事件要推送通知？（迎賓啟動/離家啟動/無人關閉/全部/不需要）
10. 通知推送到哪個裝置？
---
取得回答後，建立以下自動化：
**自動化一「迎賓模式觸發」：**
觸發條件：門磁從 off → on（門被打開），且 5 秒內客廳人體感測器變為 on
前提條件：
- input_boolean.welcome_mode 為開啟
- 冷卻時間內未重複觸發（若有設定）
- 至少一位家庭成員的手機在 home zone（若有設定定位雙重確認）
動作：
- 判斷目前時段（白天 or 夜間）
- 套用對應的迎賓情境
- 推送通知（若有設定）
**自動化二「離家自動判斷（計時器啟動）」：**
觸發條件：客廳人體存在感測器從 on → off（無人）
前提條件：input_boolean.auto_away 為開啟
動作：啟動 timer.living_room_empty 開始倒數
**自動化三「離家確認執行」：**
觸發條件：timer.living_room_empty 倒數結束（event: timer.finished）
前提條件：客廳人體感測器从然為 off
動作：
- 套用離家模式情境
- 推送通知（若有設定）
**自動化四「計時器取消」：**
觸發條件：客廳人體存在感測器從 off → on（有人回來了）
前提條件：timer.living_room_empty 為 active
動作：取消計時器
**自動化五「夜間模式自動切換」：**
觸發條件：時間到達用戶設定的夜間開始時間
動作：開啟 input_boolean.night_mode
恢復觸發：時間到達用戶設定的夜間結束時間
恢復動作：關閉 input_boolean.night_mode
**自動化六「夜間微光觸發」：**
觸發條件：客廳人體感測器偵測到有人
前提條件：input_boolean.night_mode 為開啟
動作：套用夜間微光情境
恢復條件：感測器變為無人，延遲用戶設定的時間後
恢復動作：關閉微光燈
---
【第六步（選用）：建立手動觸發腳本】
訢問我是否要建立以下腳本按鈕：
1. 「迎賓模式」腳本 — entity_id: script.welcome_home / icon: mdi:home-heart
2. 「離家模式」腳本 — entity_id: script.leave_home / icon: mdi:home-export-outline
3. 「夜間模式開/關」腳本 — entity_id: script.toggle_night_mode / icon: mdi:weather-night
4. 「暫停感測 30 分鐘」腳本 — entity_id: script.pause_sensors / icon: mdi:pause-circle
---
【第七步：驗收測試】
所有設定完成後，請依序執行以下測試並回報每項結果：
1. ✅ / ❌ 手動觸發迎賓模式（白天），確認燈光/冷氣/音樂依設定啟動
2. ✅ / ❌ 手動觸發迎賓模式（夜間），確認只有間接照明開啟
3. ✅ / ❌ 手動觸發離家模式，確認所有設備關閉
4. ✅ / ❌ 確認 timer.living_room_empty 可啟動和取消
5. ✅ / ❌ 開啟夜間模式，確認微光情境可正常觸發
6. ✅ / ❌ 確認 input_boolean 各開關可正常切換
7. ✅ / ❌ 推送一則測試通知（若有設定）
8. ✅ / ❌ 確認所有自動化已建立且狀態為啟用
若任何測試失敗，請說明原因並嘗試自動修正後重新測試，最多重試兩次。
---
【注意事項】
- 每個步驟完成後請告知我執行結果
- 若 API 回傳錯誤請說明原因並嘗試自行修正後重試
- 全程請使用繁體中文回覆
- 所有實體命名請使用英文 entity_id，但友善名稱請使用繡體中文
- 全部完成後，請列出所有已建立項目的摘要清單供我核對，格式如下：
✅ 輔助元件：input_boolean.welcome_mode（迎賓模式）
✅ 輔助元件：input_boolean.auto_away（離家自動判斷）
✅ 輔助元件：input_boolean.night_mode（夜間模式）
✅ 輔助元件：timer.living_room_empty（客廳無人計時器）
✅ 情境：scene.welcome_day（迎賓白天）
✅ 情境：scene.welcome_night（迎賓夜間）
✅ 情境：scene.away_mode（離家模式）
✅ 情境：scene.night_light（夜間微光）
✅ 情境：scene.daytime_auto（日間自動燈）
✅ 自動化：automation.welcome_trigger（迎賓模式觸發）
✅ 自動化：automation.away_timer_start（離家計時器啟動）
✅ 自動化：automation.away_confirm（離家確認執行）
✅ 自動化：automation.away_timer_cancel（計時器取消）
✅ 自動化：automation.night_mode_switch（夜間模式切換）
✅ 自動化：automation.night_light_trigger（夜間微光觸發）
✅ 腳本：script.welcome_home 等 ← 若有建立
✅ 測試：全部通過
---
【常見問題排除】
| 問題 | 可能原因 | 建議處理 |
|------|----------|----------|
| 連線逾時 | 網址錯誤或 HA 未啟動 | 請我確認網址並檡查 HA 是否運行中 |
| 403 Forbidden | Token 無效或過期 | 請我重新產生一組 Token |
| 找不到人體感測器 | 感測器未接入 HA | 確認感測器是否已透過 Zigbee/Wi-Fi 正確整合 |
| 迎賓沉h��發 | 镠磁或感測器狀態不正確 | 確認镠磁是否 on=開/off=關，感測器是否正常回報 |
| 離家太快觸發 | 計時器時間太短 | 調整 timer duration 為更長時間 |
| 寵物誤觸發 | 感測器靈敏度太高 | 調整感測器靈敏度或搭配手機定位雙重判斷 |
| 夜間微光不夠暗 | 燈泡最低亮度限制 | 有些燈泡 1% 跟 5% 差不多，需實際測試 |
| 定位判斷不準 | App 背景定位權限未開 | 確認 HA Companion App 定位設定 |
| 計時器沒取消 | 感測器恢復太慢 | 確認感測器的去抖動（debounce）設定 |
人感應燈光，就是要讓你的家學會「看見你」，在你需要的時候主動迎接，不需要時守靜守護。