HACS 完整說明：怎麼裝、怎麼挑、以及它的風險

charles

HACS 是 HA 的第三方擴充商店。

但在裝之前，你應該先知道它跟官方整合的差別。



HACS 是什麼、不是什麼

• 它不是官方的
  
• 它是一個「幫你從 GitHub 下載擴充」的工具
  
• 裡面的東西沒有經過 HA 團隊審核
  
• 作者可能隨時停止維護
  

實際的風險：

• 自訂整合的程式碼在你的 HA 裡以完整權限執行
  
• HA 升級之後可能壞掉
  
• 作者跑掉之後沒人修
  

但它也是 HA 生態最有價值的一部分 ——
很多功能只有 HACS 有。

怎麼判斷一個 HACS 擴充值不值得裝

• GitHub 星星數（幾百顆以上比較安心）
  
• 最後一次更新是什麼時候（超過一年沒更新要小心）
  
• Issues 有沒有人在回
  
• 有沒有清楚的 README
  
• HA 論壇上有沒有討論串
  

最重要的一條：

官方整合能做到的事，不要裝 HACS 的版本。

安裝 HACS

HA 2024 之後變簡單了：

1. # SSH 進 HA
2. wget -O - https://get.hacs.xyz | bash -

複製代碼

或者用「Get HACS」附加元件。

然後：

• 重啟 HA
  
• 設定 → 裝置與服務 → 新增整合 → HACS
  
• 用 GitHub 帳號授權
  

十個真正值得裝的

一、card-mod

用 CSS 改任何卡片的樣式。

1. type: tile
2. entity: light.客廳
3. card_mod:
4.   style: |
5.     ha-card {
6.       font-size: 20px;
7.       --tile-color: orange;
8.     }

複製代碼

為什麼必裝：HA 內建沒有任何改樣式的方法。

二、auto-entities

自動列出符合條件的實體。

用途：

• 所有離線的裝置
  
• 所有電量低於 20% 的
  
• 所有開著的燈
  
• 某個區域的所有實體
  

好處：加了新裝置會自動出現，不用改儀表板。

三、Mushroom Cards

一整套漂亮的卡片。

不過：HA 內建的 Tile 卡片現在已經很接近了，
Mushroom 的優勢在於更多的客製選項。

四、Bubble Card

手機優先的設計，彈出式控制面板。

如果你主要用手機，這個值得試。

五、ApexCharts Card

比內建圖表強大太多。

• 多條線疊在一起
  
• 自訂顏色、單位、時間範圍
  
• 可以畫預測、目標線
  
• 可以用模板轉換資料
  

範例：一週的用電趨勢

1. type: custom:apexcharts-card
2. graph_span: 7d
3. span:
4.   end: day
5. header:
6.   show: true
7.   title: 一週用電
8. series:
9.   - entity: sensor.每日用電
10.     type: column
11.     group_by:
12.       func: max
13.       duration: 1d

複製代碼

六、Browser Mod

讓 HA 可以控制瀏覽器本身。

• 在特定的平板上跳出視窗
  
• 自動切換到某一頁
  
• 播放聲音
  
• 把平板當成一個媒體播放器
  

做壁掛平板控制面板的話這個很重要。

七、Scheduler Card

一個視覺化的排程介面。

• 家人可以自己設定「幾點開什麼」
  
• 不用改 YAML
  
• 比 input_datetime 好用太多
  

八、Alarmo

完整的居家警報系統。

• 佈防 / 撤防
  
• 進出延遲
  
• 密碼鍵盤
  
• 分區
  

比自己用 automation 拼要完整很多。

九、Frigate 整合

（如果你用 Frigate 的話）

十、Adaptive Lighting



自動根據時間調整色溫和亮度。

• 早上偏冷白、晚上偏暖黃
  
• 模擬自然光的變化
  
• 可以設定「睡眠模式」
  

這個對睡眠品質真的有差（晚上的藍光會抑制褪黑激素）。

設定：

1. adaptive_lighting:
2.   - name: 客廳
3.     lights:
4.       - light.客廳
5.     min_color_temp: 2200
6.     max_color_temp: 5500
7.     sleep_brightness: 10
8.     sleep_color_temp: 2000
9.     take_over_control: true
10.     detect_non_ha_changes: true

複製代碼

take_over_control: true 很重要 ——
你手動調了之後，它就不會再自動改（直到燈關掉重開）。

沒有這個的話，你調了它又改回去，會很煩。

幾個「大家都推但我覺得可以不用」的

• 很多美化用的卡片 —— 裝了覺得酷，用兩週就膩，但拖慢載入速度
  
• 功能重複的整合 —— 官方有的就用官方的
  
• 需要一直維護的 —— 每次 HA 更新都要擔心會不會壞
  

HACS 的維護

更新

• HACS 會顯示有更新的項目
  
• 但不要無腦更新 —— 先看 release notes
  
• 自訂整合的更新要重啟 HA
  
• 自訂卡片的更新要清瀏覽器快取（Ctrl+Shift+R）
  

HA 升級之前

• 先看你裝的 HACS 項目有沒有說「支援某版本」
  
• 大版本更新（例如 2026.x）容易壞
  
• 先備份
  

自訂整合壞掉的症狀

• HA 啟動變超慢
  
• 日誌裡一堆錯誤
  
• 某些實體不見了
  

緊急處理：

1. # SSH 進去，把那個整合的資料夾改名
2. mv /config/custom_components/壞掉的整合 /config/custom_components/壞掉的整合.disabled
3. # 重啟 HA

複製代碼

這樣 HA 就會忽略它。

怎麼減少風險

• 裝的數量越少越好
  
• 定期檢查有沒有已經不維護的
  
• 升級 HA 之前先備份
  
• 記錄你為什麼裝每一個（三個月後你會忘記）
  

一個實用的習慣：

在 configuration.yaml 最上面寫註解：

1. # HACS 裝的東西與用途：
2. #   card-mod        改卡片樣式（全部儀表板都用到）
3. #   auto-entities   「需要注意的裝置」卡片
4. #   apexcharts      能源頁的圖表
5. #   adaptive-lighting  客廳和臥室的自動色溫

複製代碼

---

下一篇：MQTT 深入 ——
它是很多整合的底層，懂了可以做很多事。