# HomeBuddy

**Repository Path**: dealy/HomeBuddy

## Basic Information

- **Project Name**: HomeBuddy
- **Description**: HomeBuddy
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-27
- **Last Updated**: 2026-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HomeBuddy

家庭AI智能中枢 - 旧手机变身家庭智能终端

## 功能

- AI宠物互动（Live2D/动画角色，触摸交互）
- 语音对话（ASR + LLM + TTS）
- 智能家居控制（米家 via Home Assistant）
- 儿童学习（古诗、故事、口算）
- 定时提醒
- 声纹识别（识别家庭成员）

## 技术栈

- Kotlin 2.0 + Jetpack Compose + Material3
- Hilt DI + Room + Retrofit
- Dify API (对话编排)
- Home Assistant API (设备控制)
- Whisper / Android SpeechRecognizer (ASR)

## 构建

```bash
# 需要 Android Studio Ladybug+ 和 JDK 17+
./gradlew assembleDebug
```

## 配置

修改 `app/build.gradle.kts` 中的 BuildConfig：

```kotlin
buildConfigField("String", "DIFY_BASE_URL", "\"http://你的NAS地址:8080/v1/\"")
buildConfigField("String", "HA_BASE_URL", "\"http://你的NAS地址:8123/\"")
```

## 项目结构

```
app/src/main/java/com/homebuddy/app/
├── HomeBuddyApp.kt          # Application入口 (Hilt)
├── MainActivity.kt          # 主Activity
├── data/
│   ├── api/                  # 网络API (Dify, HA)
│   ├── local/                # 本地数据库 (Room)
│   └── model/                # 数据模型
├── service/
│   └── PetForegroundService  # 前台保活服务
├── viewmodel/                # ViewModels
└── ui/
    ├── theme/                # Material3主题
    ├── screens/              # 页面
    └── components/           # 可复用组件
```

## License

准备开源（MIT License）