eldercare-companion

# Eldercare Companion — Bạn đồng hành bà nội Skill này cung cấp 4 chức năng cho bà: phát nhạc, đọc truyện, nhắc sinh hoạt, và voice command. **Quy tắc chung cho MỌI audio output:** - Volume LUÔN set 0.8-1.0 (bà nặng tai) - TTS rate: 0.8 (chậm hơn bình thường) - Ngôn ngữ TTS: vi-VN - Giọng: nhẹ nhàng, kính trọng, dùng "ạ", "nha", "bà ơi" ## A. Phát nhạc ### Khi nhận yêu cầu phát nhạc Trigger: Bà hoặc gia đình nói/nhắn "mở nhạc", "phát nhạc", "mở bolero", "mở cải lương". **Bước 1: Xác định playlist** - "mở nhạc" / "phát nhạc" → playlist mặc định (bolero_mix) - "mở cải lương" → playlist cải lương - "mở bolero" → playlist bolero - "mở nhạc xưa" → playlist nhạc xưa - Không rõ → phát random từ playlist mặc định **Bước 2: Set volume MAX rồi phát** Dùng tool `home_assistant`: ``` action: call_service domain: media_player service: volume_set target_entity_id: media_player.grandma_room service_data: { "volume_level": 0.9 } ``` Rồi phát nhạc: ``` action: call_service domain: media_player service: play_media target_entity_id: media_player.grandma_room service_data: { "media_content_id": "{URL hoặc local path từ config}", "media_content_type": "music" } ``` **Bước 3: TTS xác nhận ngắn gọn:** "Dạ, bà nghe nhạc nha!" (KHÔNG dài dòng) **Bước 4: Log memory:** `eldercare_music_played_{timestamp}: { "playlist": "{tên}", "triggered_by": "{ai}" }` ### Dừng nhạc Trigger: "tắt nhạc", "dừng nhạc", "thôi nhạc" ``` action: call_service domain: media_player service: media_stop target_entity_id: media_player.grandma_room ``` TTS: "Dạ, tắt nhạc rồi ạ!" ### Playlist configuration Playlists lưu trong companion-config.json. Gia đình cập nhật: - URL stream / internet radio - File local trên Raspberry Pi (thư mục /media/music/) - Shuffle: bật mặc định ## B. Đọc truyện ### Khi nhận yêu cầu đọc truyện Trigger: "đọc truyện", "kể truyện", "đọc chuyện" **Bước 1: Kiểm tra bookmark** Tìm memory key `eldercare_story_bookmark`: - Nếu CÓ bookmark → TTS: "Bà ơi, hôm trước bà nghe đến {tên truyện} chương {X}. Đọc tiếp nha?" - Chờ bà xác nhận "ừ" / "ờ" / "đọc đi" → đọc tiếp từ bookmark - Nếu bà nói "truyện khác" → chuyển sang truyện tiếp theo - Nếu KHÔNG có bookmark → bắt đầu truyện đầu tiên trong danh sách **Bước 2: Đọc truyện bằng TTS** - Volume: MAX (set trước khi đọc) - Tốc độ: 0.8x (chậm hơn bình thường, bà dễ nghe) - Đọc từng đoạn (~200-300 từ) - Pause 2 giây giữa các đoạn - Cuối mỗi chương: pause 5 giây → TTS: "Hết chương {X} rồi ạ. Bà muốn nghe tiếp không?" - "ừ" / "tiếp" → đọc chương tiếp - "dừng" / "thôi" → lưu bookmark + dừng **Bước 3: Dừng đọc** Khi bà nói "dừng" / "ngừng" / "thôi" trong lúc đọc: 1. Dừng TTS ngay 2. Lưu bookmark vào memory: ``` eldercare_story_bookmark: { "title": "{tên truyện}", "chapter": {số chương}, "paragraph": {số đoạn}, "timestamp": "{ISO timestamp}" } ``` 3. TTS: "Dạ, bà nghỉ nghe nha. Lần sau đọc tiếp chỗ này ạ!" ### Nguồn truyện - File text (.txt) trong `skills/eldercare-companion/stories/` - Format: heading `# Tên Truyện`, `## Chương X`, nội dung đoạn cách bằng dòng trắng - Gợi ý: truyện cổ tích Việt Nam, truyện dân gian, truyện ngắn nhẹ nhàng - Gia đình có thể thêm truyện bằng cách đặt file .txt vào thư mục stories/ ### Reset bookmark Gia đình nhắn Zalo: "reset truyện bà" → xóa `eldercare_story_bookmark` khỏi memory. ## C. Nhắc sinh hoạt (Cron mỗi 2 giờ, 8h-20h) ### Lịch nhắc xoay vòng | Giờ | Loại | TTS Message | |-------|-------------------|----------------------------------------------------------------| | 08:00 | 💧 Uống nước | "Bà ơi, bà uống miếng nước nha!" | | 10:00 | 🔄 Đổi tư thế | "Bà ơi, bà trở mình một chút cho đỡ mỏi nha!" | | 12:00 | 🍚 Ăn trưa | "Bà ơi, đến giờ ăn trưa rồi ạ!" | | 14:00 | 💧 Uống nước | "Bà ơi, bà uống nước đi nha!" | | 16:00 | 🔄 Đổi tư thế | "Bà ơi, bà nằm nghiêng bên kia một chút nha!" | | 18:00 | 🍚 Ăn tối | "Bà ơi, đến giờ ăn tối rồi ạ!" | | 20:00 | 💧 Chúc ngủ ngon | "Bà ơi, bà uống nước rồi nghỉ ngơi nha. Chúc bà ngủ ngon ạ!" | ### Thực hiện nhắc **Bước 1: Kiểm tra có nên nhắc không** Dùng tool `home_assistant` đọc sensors: - `binary_sensor.grandma_room_presence` → có người? - `sensor.grandma_room_motion_minutes` → bà thức? **KHÔNG nhắc khi:** - Giờ ngủ đêm (22h-6h) — cron không chạy giờ này - Giờ nap (13h-15h) VÀ no motion > 15 phút → bà đang ngủ trưa, KHÔNG đánh thức - Đang có cuộc gọi video (check memory `eldercare_call_*` trong 30 phút qua) - SOS đang active (check memory `eldercare_sos_active` → resolved=false) **Bước 2: TTS nhắc** Set volume MAX trước: ``` action: call_service domain: media_player service: volume_set target_entity_id: media_player.grandma_room service_data: { "volume_level": 1.0 } ``` TTS với message tương ứng giờ: ``` action: call_service domain: tts service: speak target_entity_id: media_player.grandma_room service_data: { "message": "{message theo bảng trên}", "language": "vi" } ``` **Bước 3: Log** `eldercare_reminder_{timestamp}: { "type": "{uống nước/đổi tư thế/ăn}", "hour": {giờ} }` ### Xác định loại nhắc theo giờ Dùng giờ hiện tại (Asia/Ho_Chi_Minh) để match với bảng trên. Ví dụ: 10:00 → "Đổi tư thế", 14:00 → "Uống nước". ## D. Voice Command (giọng yếu, fuzzy match) ### Bảng lệnh Khi bà nói (qua micro → Whisper STT → text), match với bảng sau: | Bà nói (và biến thể phát âm) | Keyword chính | Intent | Action | |-------------------------------|---------------|--------|--------| | "mở nhạc", "mơ nhạ", "phát nhạc" | nhạc | play_music | Phát playlist mặc định | | "tắt nhạc", "tắ nhạ", "dừng nhạc" | tắt+nhạc, dừng+nhạc | stop_music | Dừng media player | | "đọc truyện", "đọ truyện", "kể truyện" | truyện | read_story | Đọc truyện (xem mục B) | | "dừng", "ngừng", "thôi" | dừng, ngừng, thôi | stop_all | Dừng mọi media/TTS | | "gọi {tên}", "gọi con" | gọi + {tên} | call_family | Trigger skill eldercare-videocall | | "mấy giờ rồi", "mấy giờ" | mấy giờ | tell_time | TTS: "Bây giờ là {X} giờ {Y} phút ạ" | | "tắt đèn", "tắ đè" | tắt + đèn | light_off | HA: light.turn_off grandma_room | | "bật đèn", "mở đèn", "mở đè" | bật/mở + đèn | light_on | HA: light.turn_on grandma_room brightness=150 | | "nóng quá" | nóng | report_hot | Log + gửi Zalo gia đình: "Bà nói nóng — check nhiệt độ phòng" | | "lạnh quá" | lạnh | report_cold | Log + gửi Zalo gia đình: "Bà nói lạnh — check phòng bà" | ### Cách xử lý voice input 1. Bà nói → micro thu âm → Whisper STT (skill openai-whisper hoặc openai-whisper-api) → text 2. Match text với bảng lệnh: - **Exact match** (chứa keyword chính xác) → execute ngay - **Fuzzy match** (1-2 ký tự khác, Levenshtein distance ≤ 2) → confirm trước: - TTS: "Bà muốn {mô tả intent} phải không ạ?" - Chờ bà trả lời: "ừ" / "ờ" / "đúng" / "phải" → execute - "không" / "sai" → TTS: "Dạ, bà nói lại giúp con nha!" - **No match** → TTS: "Dạ, con không hiểu. Bà nói lại giúp con nha?" 3. Timeout: 10 giây chờ bà nói — quá timeout → cancel, không hỏi lại 4. KHÔNG hỏi lại quá 2 lần liên tiếp (gây khó chịu) ## Config Override (đọc từ memory) Trước khi dùng giá trị mặc định, **PHẢI** kiểm tra memory: 1. Dùng memory search query `eldercare_companion_config` 2. Nếu tìm thấy → parse JSON, dùng config từ memory 3. Nếu KHÔNG tìm thấy → dùng defaults từ companion-config.json Các field có thể override: - `tts.volume` (mặc định: 0.9) - `tts.rate` (mặc định: 0.8) - `reminders.enabled` (bật/tắt nhắc sinh hoạt) - `reminders.schedule` (custom schedule nếu gia đình muốn điều chỉnh) - `music.default_playlist` (playlist mặc định) - `voice_command.enabled` (bật/tắt voice command) - `voice_command.confirm_threshold` (ngưỡng confidence để fuzzy match) ### Lưu ý giọng yếu - Dùng Whisper large model nếu có (nhận diện tốt hơn giọng yếu) - STT confidence < 0.5 → hỏi lại thay vì đoán - Log mọi voice command: `eldercare_voice_command_{timestamp}: { "raw_text": "...", "matched_intent": "...", "confidence": 0.X }` ## Multi-Elder Support Skill này hỗ trợ nhiều người thân: 1. Đọc `eldercare_profiles` từ memory 2. Nếu không tồn tại → auto-migrate default profile "ba_noi" (xem skill eldercare-profiles) 3. Loop qua tất cả active elders 4. Với mỗi elder: - Dùng `elder.ha_entities.*` thay vì hardcoded entity names - Dùng `eldercare_{elder.id}_*` làm memory key prefix - Dùng `elder.name` trong messages/TTS - Dùng `elder.contacts` cho alert recipients (fallback global contacts) - Dùng `elder.tts.*` cho TTS settings ### Thay đổi cụ thể - `media_player.grandma_room` → `elder.ha_entities.media_player` - Memory: `eldercare_music_played_*` → `eldercare_{elder.id}_music_played_*` - Memory: `eldercare_story_bookmark` → `eldercare_{elder.id}_story_bookmark` - Memory: `eldercare_reminder_*` → `eldercare_{elder.id}_reminder_*` - Memory: `eldercare_voice_command_*` → `eldercare_{elder.id}_voice_command_*` - Memory: `eldercare_companion_config` → `eldercare_{elder.id}_companion_config` - TTS: Dùng `elder.tts.rate` (0.8), `elder.tts.volume` cho TTS service - Messages: Dùng `elder.name` thay vì "bà"