PART ONE
專案總覽｜功能與應用場景
此 Home Assistant 自訂整合讓使用者能直接在儀表板中管理分類筆記。它支援 Markdown 語法、重要筆記置頂，並提供一個獨立的側邊欄面板，方便快速存取與編輯，實現家庭自動化相關的資訊記錄。
🔑 核心功能
- 分類筆記
- Markdown 支援
- 釘選筆記
- 自訂側邊欄面板
- WebSocket API
📋 功能詳細說明
| 功能名稱 | 說明 |
|---|---|
| 記錄家庭設備維護日誌 | 使用 Markdown 格式，詳細記錄家中濾水器、空調濾網等耗材的更換日期、型號與下次更換提醒，並將此筆記置頂，方便隨時查閱。 |
| 建立智慧家庭自動化點子清單 | 在專屬的側邊欄面板中，快速新增一個名為「自動化點子」的分類，隨時記錄靈感，例如「當偵測到濕度低於 40% 時，自動開啟加濕器」，讓點子不再遺失。 |
PART TWO
深入解析｜執行環境與部署步驟
⚙️ 執行環境需求
- 運行此專案所需的軟體、硬體和相依套件
- 需要 Home Assistant 2023.1 或更高版本。建議使用 Home Assistant OS 或 Home Assistant Supervised 安裝方式，以獲得完整的附加元件支援。
- 建議至少 Raspberry Pi 4（2GB RAM）或同等級 x86 設備。若同時運行多個整合，建議 4GB RAM 以上。需要穩定的網路連線和足夠的儲存空間（至少 32GB SD 卡或 SSD）。
- 需要先安裝 HACS 整合商店，用於方便地安裝和管理此自訂元件。可透過 Home Assistant 的附加元件商店或手動安裝 HACS。
- Home Assistant 內建 Python 3.11+ 執行環境，無需額外安裝。此元件的相依套件會在安裝時自動處理。
🔧 部署安裝步驟
| 步驟 | 說明 |
|---|---|
| Step 1 | 將 custom_components/ha_note_record 資料夾複製到 Home Assistant 的 config/custom_components/ 目錄 |
| Step 2 | 重新啟動 Home Assistant 伺服器以載入新的整合 |
| Step 3 | 前往「設定」>「裝置與服務」，點選「新增整合」並搜尋「Note Record」 |
| Step 4 | 在設定流程中，新增第一個筆記分類，例如「家庭日誌」 |
| Step 5 | 安裝完成後，點擊側邊欄的「Note Record」圖示，即可開始新增與管理筆記 |
PART THREE
總結與展望｜AI Agent 部署 Prompt
🤖 AI Agent 部署 Prompt
以下是用於部署此專案的 AI Agent Prompt，可直接複製使用：
複製此 Prompt 給 AI Agent，即可自動完成安裝、部署與測試
← 返回開源專案列表