# AIHOME

**Repository Path**: onmousedown/aihome

## Basic Information

- **Project Name**: AIHOME
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🏠 AI Home - 智能家居控制系统

基于 AI 的智能家居控制系统，支持设备管理、场景联动、语音控制。

## 🎯 项目定位

- **目标用户**：个人/家庭使用
- **核心价值**：用 AI 让家居设备更智能，解放双手
- **技术路线**：全栈 JavaScript，低门槛易维护

---

## 🏗️ 整体架构

```
┌─────────────────────────────────────────────────────────┐
│                    用户交互层                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐    │
│  │   Web 端    │  │  微信小程序  │  │   APP 端    │    │
│  │  Vue3 +     │  │ UniApp +    │  │ Taro +      │    │
│  │  NaiveUI    │  │  uView      │  │  NutUI      │    │
│  └─────────────┘  └─────────────┘  └─────────────┘    │
└─────────────────────────────────────────────────────────┘
                          ↓ HTTP / WebSocket
┌─────────────────────────────────────────────────────────┐
│                    后端服务层                              │
│  ┌───────────────────────────────────────────────────┐ │
│  │              Express / NestJS                      │ │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐         │ │
│  │  │  用户    │ │  设备    │ │  场景    │         │ │
│  │  │  模块    │ │  模块    │ │  模块    │         │ │
│  │  └──────────┘ └──────────┘ └──────────┘         │ │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐         │ │
│  │  │  语音    │ │  数据    │ │  系统    │         │ │
│  │  │  控制    │ │  统计    │ │  配置    │         │ │
│  │  └──────────┘ └──────────┘ └──────────┘         │ │
│  └───────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────┐
│                    数据存储层                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐    │
│  │  SQLite     │  │   Redis     │  │  时序数据库 │    │
│  │  (主数据)   │  │ (缓存/队列) │  │  (设备状态) │    │
│  └─────────────┘  └─────────────┘  └─────────────┘    │
└─────────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────┐
│                    设备接入层                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐    │
│  │  MQTT 网关  │  │  HomeKit    │  │  自定义协议  │    │
│  └─────────────┘  └─────────────┘  └─────────────┘    │
└─────────────────────────────────────────────────────────┘
```

---

## 📁 项目结构（Monorepo）

```
aihome/
├── apps/                          # 应用层
│   ├── admin/                     # 管理后台（PC端）
│   │   ├── src/
│   │   │   ├── views/            # 页面
│   │   │   │   ├── devices/      # 设备管理
│   │   │   │   ├── scenes/       # 场景联动
│   │   │   │   ├── dashboard/    # 数据看板
│   │   │   │   ├── ai/           # AI 语音控制
│   │   │   │   └── settings/     # 系统设置
│   │   │   ├── components/       # 公共组件
│   │   │   ├── api/              # 接口封装
│   │   │   └── store/            # 状态管理
│   │   ├── package.json
│   │   └── vite.config.js
│   │
│   ├── mobile/                    # 移动端 H5 / 小程序
│   │   ├── src/
│   │   │   ├── pages/
│   │   │   ├── components/
│   │   │   └── store/
│   │   └── package.json
│   │
│   └── server/                    # 后端服务
│       ├── src/
│       │   ├── modules/          # 功能模块
│       │   │   ├── user/         # 用户模块
│       │   │   ├── device/       # 设备模块
│       │   │   ├── scene/        # 场景模块
│       │   │   ├── ai/           # AI 模块
│       │   │   └── stats/        # 统计模块
│       │   ├── middleware/       # 中间件
│       │   ├── utils/            # 工具函数
│       │   ├── config/           # 配置文件
│       │   └── main.js
│       ├── prisma/                # 数据库 ORM
│       │   └── schema.prisma
│       └── package.json
│
├── packages/                      # 共享层
│   ├── shared-types/              # 类型定义
│   ├── shared-utils/              # 工具函数
│   └── shared-ui/                 # UI 组件库
│
├── configs/                       # 配置文件
│   ├── nginx/                     # Nginx 配置
│   ├── docker/                    # Docker 配置
│   └── deploy/                    # 部署脚本
│
├── package.json
├── pnpm-workspace.yaml
└── README.md
```

---

## 🛠️ 技术栈选型

| 层级 | 技术选择 | 选择理由 |
|------|---------|---------|
| **前端框架** | Vue 3.4 + Vite 5 | 你最熟悉，开发效率最高 |
| **UI 组件库** | Naive UI（PC）/ uView（小程序） | 现代、美观、易用 |
| **状态管理** | Pinia | Vue3 官方推荐，简单好用 |
| **后端框架** | Express 4.x | 简单、轻量、生态完善 |
| **ORM** | Prisma | 类型安全，开发体验好 |
| **数据库** | SQLite（开发）/ PostgreSQL（生产） | SQLite 零配置，易于上手 |
| **实时通信** | Socket.io | WebSocket 封装，设备状态实时推送 |
| **AI 集成** | OpenAI / 字节豆包 / 阿里通义 | 主流大模型，支持函数调用 |
| **部署方式** | Docker + Docker Compose | 一键部署，易于维护 |

---

## 📦 核心功能模块

### 1. 用户模块 (`apps/server/src/modules/user/`)
- ✅ 用户注册/登录
- ✅ JWT 认证
- ✅ 用户信息管理
- ✅ 权限控制（家庭组/成员）

### 2. 设备模块 (`apps/server/src/modules/device/`)
- ✅ 设备添加/删除/编辑
- ✅ 设备状态查询
- ✅ 设备控制（开关、亮度、颜色等）
- ✅ 设备分组管理
- ✅ 设备状态历史记录
- ✅ 设备接入协议（HTTP、MQTT、WebSocket）

### 3. 场景联动模块 (`apps/server/src/modules/scene/`)
- ✅ 场景创建/编辑/删除
- ✅ 场景触发条件配置（IFTTT）
  - 时间触发：每天/每周/每月指定时间
  - 设备状态触发：某个设备状态改变
  - 环境触发：温度/湿度/光照达到阈值
- ✅ 场景执行动作配置
  - 控制多个设备状态
  - 发送通知
  - 调用第三方 API
- ✅ 场景手动/自动执行

### 4. AI 语音控制模块 (`apps/server/src/modules/ai/`)
- ✅ 语音转文字（ASR）
- ✅ 大模型意图理解
- ✅ 设备控制指令生成
- ✅ 文字转语音（TTS）
- ✅ 对话历史记录

### 5. 数据统计模块 (`apps/server/src/modules/stats/`)
- ✅ 设备在线时长统计
- ✅ 设备使用频率统计
- ✅ 能耗统计
- ✅ 场景执行统计
- ✅ 数据可视化图表

---

## 🗄️ 数据库设计（Prisma Schema）

```prisma
model User {
  id        Int      @id @default(autoincrement())
  username  String   @unique
  password  String
  email     String?
  avatar    String?
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
  devices   Device[]
  scenes    Scene[]
  homeId    Int?
  home      Home?    @relation(fields: [homeId], references: [id])
}

model Home {
  id        Int      @id @default(autoincrement())
  name      String
  members   User[]
  devices   Device[]
  scenes    Scene[]
  createdAt DateTime @default(now())
}

model Device {
  id          Int       @id @default(autoincrement())
  name        String
  type        String    // light, switch, sensor, etc.
  brand       String?
  model       String?
  status      Json      // 设备状态 JSON
  config      Json?     // 设备配置
  online      Boolean   @default(false)
  lastOnline  DateTime?
  homeId      Int?
  home        Home?     @relation(fields: [homeId], references: [id])
  userId      Int
  user        User      @relation(fields: [userId], references: [id])
  history     DeviceHistory[]
  createdAt   DateTime  @default(now())
  updatedAt   DateTime  @updatedAt
}

model DeviceHistory {
  id        Int      @id @default(autoincrement())
  deviceId  Int
  device    Device   @relation(fields: [deviceId], references: [id])
  status    Json
  eventType String   // state_change, online, offline
  createdAt DateTime @default(now())
}

model Scene {
  id          Int       @id @default(autoincrement())
  name        String
  description String?
  icon        String?
  enabled     Boolean   @default(true)
  conditions  Json      // 触发条件数组
  actions     Json      // 执行动作数组
  lastRunAt   DateTime?
  runCount    Int       @default(0)
  homeId      Int?
  home        Home?     @relation(fields: [homeId], references: [id])
  userId      Int
  user        User      @relation(fields: [userId], references: [id])
  createdAt   DateTime  @default(now())
  updatedAt   DateTime  @updatedAt
}

model SceneLog {
  id        Int      @id @default(autoincrement())
  sceneId   Int
  scene     Scene    @relation(fields: [sceneId], references: [id])
  trigger   String   // manual, auto, api
  success   Boolean
  error     String?
  createdAt DateTime @default(now())
}
```

---

## 🔌 API 接口设计

### 用户接口
```
POST   /api/user/register    # 注册
POST   /api/user/login       # 登录
GET    /api/user/profile     # 获取用户信息
PUT    /api/user/profile     # 更新用户信息
```

### 设备接口
```
GET    /api/devices              # 获取设备列表
POST   /api/devices              # 添加设备
GET    /api/devices/:id          # 获取设备详情
PUT    /api/devices/:id          # 更新设备
DELETE /api/devices/:id          # 删除设备
PUT    /api/devices/:id/control  # 控制设备
GET    /api/devices/:id/history  # 设备历史记录
```

### 场景接口
```
GET    /api/scenes               # 获取场景列表
POST   /api/scenes               # 创建场景
GET    /api/scenes/:id           # 获取场景详情
PUT    /api/scenes/:id           # 更新场景
DELETE /api/scenes/:id           # 删除场景
POST   /api/scenes/:id/run       # 手动执行场景
```

### AI 接口
```
POST   /api/ai/speech-to-text   # 语音转文字
POST   /api/ai/text-command     # 文字指令处理
POST   /api/ai/text-to-speech   # 文字转语音
```

---

## 🚀 开发路线图

| 阶段 | 内容 | 时间预估 |
|------|------|---------|
| **Phase 1** | 项目骨架搭建 + 用户模块 + 设备管理基础 | 1周 |
| **Phase 2** | 场景联动引擎 + 设备控制 | 1周 |
| **Phase 3** | AI 语音控制集成 | 1周 |
| **Phase 4** | 数据统计 + 可视化看板 | 1周 |
| **Phase 5** | 移动端 H5 / 小程序开发 | 2周 |
| **Phase 6** | 设备接入协议完善 + 稳定性优化 | 持续迭代 |

---

## 📝 启动命令

```bash
# 安装依赖
pnpm install

# 开发模式
pnpm dev:admin     # 后台前端
pnpm dev:server    # 后端服务
pnpm dev:mobile    # 移动端

# 生产构建
pnpm build:admin
pnpm build:server
pnpm build:mobile
```

---

## 🎯 设计亮点

1. **低门槛启动**：SQLite 数据库，无需额外安装，克隆就能跑
2. **前后端分离**：清晰的 API 契约，便于扩展多端
3. **模块化设计**：每个功能独立，便于维护和迭代
4. **AI 原生**：深度集成大模型，语音控制是核心竞争力
5. **可扩展架构**：设备接入层抽象，方便对接各种协议
6. **你熟悉的技术栈**：全量 Vue + Node.js 生态，无缝上手

---

**Next Step：** 确认这个架构可以，我立即开始写代码把项目骨架搭出来！