# AIHomeManager

**Repository Path**: aaabackup/aihome-manager

## Basic Information

- **Project Name**: AIHomeManager
- **Description**: AI 家管家
一款微信小程序 + 移动 Web App，核心是"拍照即录入、问就找到、闲置一键挂闲鱼"。

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

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-19
- **Last Updated**: 2026-10-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 家管家

一款基于 AI 的家庭物品管理应用，核心是"拍照即录入、问就找到、闲置一键挂闲鱼"。

## 产品定位

解决家庭物品收纳"记不住、放哪、忘性大"的痛点，用 AI 把录入从 90 秒压到 8 秒、找物从 5 分钟压到 30 秒。

## 技术架构

```
┌─────────────────────┐
│   微信小程序前端     │
└──────────┬──────────┘
           │ HTTPS + JWT
┌──────────▼──────────┐
│  FastAPI 后端服务    │
│  - 物品管理          │
│  - AI 识别/找物/转卖 │
│  - 用户认证          │
└──────────┬──────────┘
           │
     ┌─────┴─────┐
     ▼           ▼
 PostgreSQL    对象存储
```

## 目录结构

```
AIHomeManager/
├── backend/                 # 后端服务 (FastAPI + Python)
│   ├── app/
│   │   ├── main.py          # 应用入口
│   │   ├── config.py        # 配置管理
│   │   ├── database.py      # 数据库连接
│   │   ├── models.py        # SQLAlchemy 模型
│   │   ├── schemas.py       # Pydantic 数据模型
│   │   ├── auth.py          # 认证逻辑
│   │   ├── routers/         # API 路由
│   │   │   ├── auth.py
│   │   │   ├── items.py
│   │   │   ├── categories.py
│   │   │   ├── locations.py
│   │   │   └── ai.py
│   │   └── services/        # 业务服务
│   │       ├── ai_service.py
│   │       └── storage_service.py
│   ├── requirements.txt
│   └── .env.example
├── android/                 # Android 客户端 (Kotlin + Jetpack Compose)
│   ├── app/
│   │   ├── src/main/java/com/aihomemanager/
│   │   │   ├── AIHomeApp.kt         # Application 入口
│   │   │   ├── MainActivity.kt      # 主 Activity + 导航
│   │   │   ├── data/                # 数据层
│   │   │   │   ├── model/Models.kt           # 数据模型
│   │   │   │   ├── api/ApiService.kt         # Retrofit 接口
│   │   │   │   ├── api/SessionManager.kt    # Token 管理
│   │   │   │   ├── api/AuthInterceptor.kt   # 请求拦截器
│   │   │   │   ├── AppRepository.kt         # 数据仓库
│   │   │   │   └── FileUtils.kt             # 文件工具
│   │   │   └── ui/                  # UI 层
│   │   │       ├── theme/           # 主题颜色
│   │   │       ├── navigation/      # 路由导航
│   │   │       ├── components/      # 通用组件
│   │   │       ├── screens/         # 9 个页面
│   │   │       │   ├── HomeScreen.kt        # 首页
│   │   │       │   ├── AddScreen.kt         # 拍照录入
│   │   │       │   ├── ListScreen.kt        # 物品列表
│   │   │       │   ├── DetailScreen.kt      # 物品详情
│   │   │       │   ├── FindScreen.kt        # AI 找物
│   │   │       │   ├── ResaleScreen.kt      # 一键转卖
│   │   │       │   ├── ProfileScreen.kt     # 个人中心
│   │   │       │   ├── LoginScreen.kt       # 登录注册
│   │   │       │   ├── LocationsScreen.kt   # 位置管理
│   │   │       │   └── CategoriesScreen.kt  # 分类管理
│   │   │       └── viewmodel/       # ViewModel
│   │   ├── src/main/res/            # 资源文件
│   │   └── build.gradle.kts
│   ├── build.gradle.kts
│   ├── settings.gradle.kts
│   └── gradle.properties
└── miniprogram/             # 微信小程序（备选前端）
    └── ...
```

## 核心功能

### 1. 📷 拍照录入
- 上传物品照片，AI 自动识别类别、品牌、颜色
- 自动生成物品名称和标签
- 手动补充存放位置等信息

### 2. 🔍 AI 找物
- 自然语言提问找物
- 理解模糊描述（颜色、品牌、用途等）
- 返回匹配结果和精确位置

### 3. 💰 一键转卖
- AI 自动生成闲鱼文案
- 智能估价建议
- 一键复制跳转闲鱼发布

## 快速开始

### 后端启动

```bash
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env  # 修改配置
uvicorn app.main:app --reload
```

API 文档：http://localhost:8000/docs

### Android 客户端启动

1. 用 Android Studio (Hedgehog 2023.1.1+) 打开 `android/` 目录
2. 等待 Gradle 同步完成
3. 修改 `AIHomeApp.kt` 中的 `BASE_URL` 为你的后端地址
   - 模拟器默认 `http://10.0.2.2:8000`（指向宿主机 localhost）
   - 真机需改为电脑局域网 IP，如 `http://192.168.1.100:8000`
4. 点击 Run 运行

> 注意：Android Manifest 已开启 `usesCleartextTraffic` 以支持 HTTP 调试

### 小程序启动（可选）

使用微信开发者工具导入项目根目录，选择 miniprogram 作为小程序目录。

## API 接口

### 认证
- `POST /api/auth/register` - 注册
- `POST /api/auth/login` - 登录

### 物品管理
- `GET /api/items` - 获取物品列表
- `POST /api/items` - 创建物品
- `GET /api/items/{id}` - 获取物品详情
- `PUT /api/items/{id}` - 更新物品
- `DELETE /api/items/{id}` - 删除物品
- `POST /api/items/recognize` - AI 识别物品
- `POST /api/items/{id}/use` - 记录使用

### 分类管理
- `GET /api/categories` - 获取分类列表
- `POST /api/categories` - 创建分类
- `PUT /api/categories/{id}` - 更新分类
- `DELETE /api/categories/{id}` - 删除分类

### 位置管理
- `GET /api/locations` - 获取位置列表
- `POST /api/locations` - 创建位置
- `PUT /api/locations/{id}` - 更新位置
- `DELETE /api/locations/{id}` - 删除位置

### AI 服务
- `POST /api/ai/find` - AI 找物
- `POST /api/ai/resale/generate` - 生成转卖文案

## 技术栈

**后端：**
- FastAPI - 高性能 Python Web 框架
- SQLAlchemy - ORM 框架
- PostgreSQL - 关系型数据库
- Pydantic - 数据验证
- python-jose - JWT 认证
- httpx - 异步 HTTP 客户端

**Android 客户端：**
- Kotlin + Jetpack Compose - 现代声明式 UI
- Material 3 - Material Design 组件
- Navigation Compose - 页面导航
- Retrofit + OkHttp - 网络请求
- Coil - 图片加载
- DataStore - Token 持久化
- CameraX - 相机功能
- MVVM 架构 - ViewModel + StateFlow

**微信小程序（备选）：**
- 微信小程序原生框架
- 原生 WXML/WXSS/JS

## MVP 路线图

- [x] 项目脚手架搭建
- [x] 数据库模型设计
- [x] 物品 CRUD API
- [x] 分类/位置管理
- [x] AI 识别接口（Mock）
- [x] AI 找物接口（Mock）
- [x] 转卖文案生成接口（Mock）
- [x] Android 客户端（Kotlin + Compose）
- [x] 小程序客户端（备选）
- [ ] 接入真实 AI 模型
- [ ] 图片上传到云存储
- [ ] 数据统计与可视化
- [ ] 闲置提醒功能