這個 AI 工作站是什麼
家裡的 Home Assistant 已經會開燈、關窗簾、按時提醒了，接下來這一章告訴你：多裝一個「AI 工作站」到 HA 裡面，是要拿來做什麼、跟手機上的 ChatGPT 差在哪、以及裝之前要先看你家的 HA 是不是那款可以裝的。
為什麼要學這個
你會翻開這本書，代表家裡的 Home Assistant（下稱 HA）已經裝好、電燈能點、窗簾會動、手機也收得到通知。到這一步，其實 80% 智慧家庭該有的都齊了。那為什麼還要多學一個東西？
因為接下來的門檻，不是「多買一個裝置」，而是「多一個會思考的幫手」。
- 你想寫一個「爸爸下班進家門，如果客廳沒人、外面在下雨，就把陽台燈開起來讓他看得到門口」——過去要學 YAML、學 template、學 trigger，一整晚都在 Google。
- 你想問「客廳要換冷氣，孩子睡覺會怕吵，2 坪半的房間應該選幾噸？」——過去你去論壇貼文，等三天。
- 你想做一支「開箱這台 Zigbee 開關」的短片放家族群組，讓阿嬤看得懂——過去你光是剪片就先卡兩天。
Woow HA Pi Agent（本書簡稱「Pi Agent」）就是把一個「會寫、會查、會剪、會跟你討論」的 AI 工作站，直接裝進你家的 HA 主機裡。它不是雲端服務，是你家的一台工作站；資料就存在 HA 硬碟上，你能隨時 snapshot 一起備份走。
Pi Agent 到底是什麼
把家裡想成一間小客廳。你原本有電視、有 Switch、有擴大機——這些都是「看得到的家電」。Pi Agent 是一台看不見的工作台，也在客廳，只是沒有實體。它會思考、會查 Google、會寫程式、會幫你出主意，幫忙做那些「你想做但不會做」的家事。
技術上白話講：Pi Agent 是一個 Home Assistant 附加元件（Add-on，HA 2026.2 起官方 UI 正式改稱 Apps，選單位置在「設定 → Apps」）。你在 HA 後台按一下「安裝」，它就會在你家 HA 主機上跑起來，然後在 HA 左邊側邊欄多出一個「Pi Agent」的圖示。點進去，你就跟這個 AI 工作站對話。
它裡面藏了什麼？講三個名字你會安心一點：
- pi-web：就是那個你會看到的網頁介面。它是這個 AI 工作站的「桌面」。
- pi coding agent：一個會讀、會寫、會執行檔案的 AI 引擎，藏在 pi-web 後面。你打字，它處理。
- 影片管線（pitch_video）：ffmpeg、Playwright、edge-tts、rclone 一整套剪片＋上傳工具，第一次啟動時它會自動下載約 720MB 檔案安裝好，之後你叫它剪片就能直接動手。
你完全不用記這三個名字，記「多一個工作站」就好。
它會幫你做的四件事
下面四件是它的主戰場，每一件都用家庭情境舉例，你就有畫面：
1. 幫你寫 HA 自動化（不用學 YAML）
你打字：「爸爸手機連上家裡 WiFi，且時間是晚上 6 點後，就把玄關燈開白光 30 秒。」它會自己去讀你 HA 有哪些裝置、想清楚要用哪個 trigger、寫出對的 YAML、幫你存進 HA。你只要確認「這樣對嗎？」按確定。整個過程不會叫你打一行程式。
2. 跟你討論家裡的事（買什麼、換什麼）
你問：「客廳要換冷氣，8 坪，2 大 1 小，孩子晚上會怕吵，預算 4 萬內，該選幾噸？」它會把幾家品牌的 EER、噪音值、變頻邏輯講給你聽，最後給你 2-3 個型號建議。它不是隨口回，因為它可以真的上網查現在的價格。
3. 幫你做影片（開箱、家事教學、給爸媽看）
你打字：「幫我做一支 1 分半的短片：開箱這台 Aqara 動作感應器，講三個賣點，配台灣女生的聲音，字幕繁體。」它會自己寫劇本、產旁白、抓畫面、剪好、燒字幕，最後給你一個 mp4 檔（甚至可以直接 rclone 上到你的 Google Drive）。第 17 章會整章教這個。
4. 教它一項「新手藝」給它學（Skills）
Skills 就是「AI 的一份 SOP」。舉例：你可以教它「每次講到冷氣，都要先問幾坪、幾個人、預算」——把這份 SOP 存下來，之後它每次遇到冷氣話題就照這個流程走。Skills 可以自己寫，也可以從 GitHub 上別人分享的直接裝。第 14 章會整章講。
和手機上的 ChatGPT 差在哪
很多人第一個問題是：「我手機都有 ChatGPT 了，幹嘛還多裝這個？」下面這張表講清楚：
| 比較項目 | 手機 ChatGPT App | Pi Agent（家裡） |
|---|---|---|
| 對話內容存哪裡 | OpenAI 雲端伺服器 | 你家 HA 主機的 /data/pi-agent/，snapshot 一起備份 |
| 能不能碰你家裝置 | 不行（它看不到你家的燈、感應器） | 可以（它就住在 HA 裡面，直接讀寫） |
| 要不要每個月付月費 | Plus 一個月 20 美金 | 不用月費；用你自己申請的 API 金鑰按量付費（GLM/DeepSeek 一個月常用者不到 100 元台幣） |
| 能不能自己教它新東西 | 只能給它 Custom Instructions，功能有限 | Skills 系統——你寫一份 SOP、或裝別人寫好的，它就學會 |
| 能不能挑不同 AI 模型 | 只能用 OpenAI 系列 | GLM、Claude、GPT、DeepSeek、Groq、MiniMax、OpenRouter 都可以在同一個 UI 裡切換 |
| 網路斷了 | 完全不能用 | UI 還在，只是問 AI 那一步要網路（AI 引擎在雲端）；HA 本身不受影響 |
能不能一開始就跑得動
Pi Agent 是 HA 的附加元件，所以先看你家 HA 是哪一款。HA 有四種安裝方式，只有兩種能裝附加元件：
| 你家 HA 是哪款 | 能裝 Pi Agent？ | 怎麼確認 |
|---|---|---|
| Home Assistant OS（HAOS，官方最推薦） | 可以 | 設定 → 系統 → 關於，會看到「Home Assistant OS」 |
| Home Assistant Supervised（Debian 上裝的完整版） | 可以 | 同上，會看到「Supervised」 |
| Home Assistant Container（Docker 只跑 core） | 不行 | 設定裡沒有「附加元件（Apps）」這個選項 |
| Home Assistant Core（Python 直裝） | 不行 | 同上 |
硬體最低門檻：
- 架構：amd64 或 aarch64（arm64）。x86 迷你電腦、Raspberry Pi 4/5、大部分 arm64 SBC 都可以。
- 記憶體：2 GB 起跳（跑得動但慢），推薦 4 GB 以上。
- 硬碟：至少留 5 GB 空間給
/data/pi-agent/（含影片管線那 720MB）。真的要剪影片建議留 20 GB。 - 網路：AI 呼叫需要對外，HA 主機要能上網。
5 分鐘 HA 回顧
這本書假設你 HA 已經裝好、登得進去。下面五件事你會做，這一章就過了。做不到請先回《HA 入住指南》把基礎打好再回來。
-
能登入 HA
在瀏覽器打
http://homeassistant.local:8123或你家 HA 的 IP，看到藍白登入卡片，輸入帳號密碼進得去。你必須是 Administrator（管理員）——附加元件（Apps）只有管理員看得到。如果你不是管理員，去找家裡的擁有者（Owner）幫你升級權限，或直接請他裝。 -
找得到左下角「設定」齒輪
登入後左邊側邊欄最下面，有個齒輪圖示
設定。這是你之後要進「附加元件」「系統」「人員」的入口。 -
設定裡看得到「附加元件（Apps）」
點齒輪 → 進「設定」頁 → 找到「附加元件」（HA 2026.2 起正式改名叫「Apps」，位置一樣在「設定」頁裡，兩個是同一個東西）。看得到這一項，代表你的 HA 是 HAOS 或 Supervised，這本書適用。看不到就是 Container/Core，這本書不適用。
-
認得左邊側邊欄
左邊那條垂直的圖示列——「首頁（Home，2026.2 起把預設面板改成新的 Home Dashboard，取代舊版 Overview；如果你懷念舊版，可以在「設定 → 儀表板」加回 Overview (legacy)）」「地圖」「能源」「歷史」…—Pi Agent 裝好後會在這裡多一顆圖示，跟這些並排。
-
找得到系統首頁
設定 → 系統，看得到「一般」「更新」「硬體」「備份」等分頁（HA 2026.2 起「開發者工具」也被歸進「設定」區的工具集中管理）。備份很重要——第 20 章會教怎麼把 Pi Agent 的對話一起備份走。
這本書怎麼讀
全書 22 章，分 6 大部分。每一部分是一個階段目標：
| 部分 | 章節 | 學完你會什麼 |
|---|---|---|
| 起步認識 | ch1-ch4 | 裝好 Pi Agent、認得介面、跑第一句話 |
| 先跟它聊起來 | ch5-ch9 | 申請第一支金鑰、用 GLM 對話、看懂 Session 與思考塊 |
| 多個 AI 一起用 | ch10-ch13 | 為什麼多接幾家、六家 provider 對照、Reasoning、切換模型 |
| Skills | ch14-ch16 | 教它一項新手藝、裝別人寫好的、自己寫一份 |
| 影片 | ch17-ch19 | 做出人生第一支 AI 剪的短片、發到 Drive |
| 家常維護 | ch20-ch22 | 對話與金鑰備份、升級注意、卡關手冊 |
兩種讀法：
- 趕時間 / 想快點玩到：照順序讀 ch1→ch2→ch5→ch6→ch7，大概一個晚上就有最小可用版本，能對話、能寫自動化。
- 愛研究 / 想榨乾它：全書照順序讀完，Skills 跟影片兩塊是「別人玩不到的東西」，值得花時間。
資料放哪裡（一句話說完）
這是最多人問的問題，一次講清楚：
- 對話紀錄：存在你家 HA 主機的
/data/pi-agent/，這裡也是 HA snapshot 會備份的位置。你把 HA 搬家，對話跟你走。 - API 金鑰（Provider Key）：從 v0.13.0 開始，金鑰只存在 pi-web 的 Models 面板（也就是存在
/data/pi-agent/models.json），HA 附加元件的設定頁不再放金鑰。這代表 snapshot 也會把金鑰一起備份走，你不用重新申請。 - Skills：你裝的每個 Skill 都在
/data/pi-agent/skills/，同上，跟著 snapshot 走。 - 影片工程檔：預設放
/data/pi-agent/home/pi-cwd-*/，snapshot 會排除中間檔（clips/、segments/）以免備份爆掉，但成品 mp4 會保留。
常見卡關
-
我根本沒裝 HA，怎麼辦？
先去《HA 新居入住指南》把 HA 從零裝好、登得進去、能點亮一顆燈。那本書大概 3 個晚上讀完，回頭再看這本會很順。這本書真的假設你 HA 已經會用。
-
我的 HA 找不到「附加元件（Apps）」
去「設定 → 系統 → 關於」看你的 HA 是哪款。看到「Home Assistant OS」或「Supervised」——正常，附加元件在「設定」頁裡（2026.2 前叫「附加元件」、之後叫「Apps」，可能被放進「設備與服務」附近）。看到「Container」或「Core」——這本書不適用，抱歉，你要嘛換裝 HAOS，要嘛去用 pi-web 的原生 npm 安裝方式（不在本書範圍）。
-
家人不喜歡「AI 在家裡」的想法
常見疑慮兩個：「它會不會偷聽？」「它會不會亂動我家東西？」白話回答：（1）Pi Agent 沒有麥克風、沒有攝影機，你不打字它不做事；（2）它動 HA 之前會先問你確認，你按確定它才動。可以先用 read-only 的方式讓它跑一週（只讓它讀狀態、不讓它改東西），家人看它多有用，接受度就會上來。
-
我很擔心資料外洩
三個定心丸：（a）金鑰是你自己去 AI 廠商申請的，錢也是算你的，你能隨時到廠商後台看今天送出去哪些請求；（b）對話都存本地
/data/pi-agent/，沒有第三方雲備份；（c）HA snapshot 會把金鑰＋對話＋Skills 一起打包，主機壞了直接還原。想再更嚴，可以只掛「中國區 GLM」或「歐盟區 OpenRouter」，避開特定司法管轄。 -
Raspberry Pi 4 / 2GB 跑得動嗎？
能跑聊天、能寫自動化，但影片管線會很慘（Playwright + Chromium 光跑起來就吃掉大半 RAM）。建議 Pi 4 就先玩前 16 章，第 17 章開始的影片主題等你換到 x86 迷你電腦或 Pi 5 / 8GB 再做。
常見問題
這跟 Nabu Casa 差在哪？我付月費有比較好嗎？
一定要 HAOS 嗎？我用 Docker 跑 HA Container 有辦法嗎？
npx pi-web，但你要自己弄反向代理、自己弄 systemd、自己處理 HA 的登入串接——這本書不會教。最推薦的路是把 HA 遷移成 HAOS 或 Supervised，之後所有 add-on 生態都能用（Node-RED、Frigate、Mosquitto…都是同一個道理）。