自己寫 HA 藍圖：把自動化變成可以重複用的模板

charles

這篇的內容（8 段）

1. 什麼時候該做藍圖
2. 步驟 1：先確認沒有人做好了
3. 步驟 2：知道藍圖檔案放在哪
4. 步驟 4：讓 HA 讀到它
5. 步驟 10：分享出去
6. 除錯：三種症狀、三個查法
7. 一、改了藍圖但行為沒變
8. 三、建了自動化但沒反應

藍圖（Blueprint）就是「留了空格的自動化」。寫一次，之後每個房間填不同的實體，點幾下就建好一條。



這篇從「先找現成的」講到「寫一個自己的、能分享出去的」，中間每一步都有怎麼確認做對了。

什麼時候該做藍圖

訊號很明確：你複製貼上同一個自動化第三次的時候。

常見的三種：

• 每個房間一個「有人開燈、沒人關燈」
  
• 每個門窗一個「開超過五分鐘通知」
  
• 每顆無線按鈕一組「單擊、雙擊、長按」
  

步驟 1：先確認沒有人做好了

• 設定 → 自動化與場景 → 藍圖 分頁
  
• 右下角 匯入藍圖，貼上網址就會下載
  

找藍圖的地方：

• HA 官方論壇的 Blueprints Exchange 版 —— 最大宗，而且底下的討論串會告訴你有什麼雷
  
• GitHub 搜 `home assistant blueprint`
  

HA 內建就有一個感應燈藍圖（Motion-activated Light），不用下載。藍圖分頁裡本來就看得到。

你會看到什麼：匯入成功時畫面會跳出「已匯入」並秀出藍圖的名稱與說明。失敗的話會直接告訴你「不是有效的藍圖」——最常見的原因是貼了 GitHub 的網頁網址而不是 raw 網址（網頁網址抓回來的是 HTML 不是 YAML）。

步驟 2：知道藍圖檔案放在哪

自動化藍圖是一個 `.yaml` 檔，放在

1. <HA 的設定目錄>/blueprints/automation/<你的資料夾>/<檔名>.yaml

複製代碼

自己取的資料夾名稱可以隨便，取來分類用。

⚠ 用 File editor 或 Studio Code Server 應用程式編輯的人注意：在那些應用程式的容器裡，HA 的設定目錄叫 `/homeassistant`，不是 `/config`（`/config` 已經改成指該應用程式自己的私有目錄，2023 年底起）。

所以正確的路徑是

1. /homeassistant/blueprints/automation/my/motion_light.yaml

複製代碼

寫成 `/config/blueprints/...` 的話檔案會被存到一個 HA 永遠不會讀的地方，而且存檔完全成功、沒有任何錯誤。這是最難查的那種問題 —— 你會一直重新載入、一直重啟，而檔案根本不在 HA 看得到的地方。

用 Samba 或網路芳鄰連進去的人不受影響，那邊看到的 `config` 資料夾就是對的。



步驟 3：寫第一個藍圖（完整檔案，可以直接存）

把整段存成 `/homeassistant/blueprints/automation/my/motion_light.yaml`：

以下還有約 85% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入