# 🌟 治愈系记录助手 - SoulMate AI Companion

一个温暖、治愈的 AI 陪伴应用，帮助你记录心情、捕捉灵感、管理待办。

## ✨ 核心特性

- 🎤 **语音/文字快速记录** - 自动分类保存
- 🤖 **AI 语义解析** - 智能提取情绪、灵感和待办
- 💬 **AI 对话陪伴（RAG）** - 基于历史记录的个性化对话
- 🖼️ **AI 形象定制** - 生成专属治愈系角色（720 种组合）
- 🫧 **物理引擎心情池** - 基于 Matter.js 的动态气泡可视化

## 🚀 快速开始

### 在线使用

直接访问本应用即可使用完整功能！

### 配置 API 密钥

在 ModelScope 的环境变量中配置：

**必需：**
- `ZHIPU_API_KEY` - 智谱 AI API 密钥
  - 获取地址：https://open.bigmodel.cn/
  - 用途：语音识别、语义解析、AI 对话

**可选：**
- `MINIMAX_API_KEY` - MiniMax API 密钥
- `MINIMAX_GROUP_ID` - MiniMax Group ID
  - 获取地址：https://platform.minimaxi.com/
  - 用途：AI 形象生成

## 📖 使用说明

1. **首页快速记录**
   - 点击麦克风录音或在输入框输入文字
   - AI 自动分析并分类保存

2. **查看分类数据**
   - 点击顶部心情、灵感、待办图标
   - 查看不同类型的记录

3. **与 AI 对话**
   - 点击 AI 形象显示问候对话框
   - 点击对话框中的聊天图标进入完整对话
   - AI 基于你的历史记录提供个性化回复

4. **定制 AI 形象**
   - 点击右下角 ✨ 按钮
   - 选择颜色、性格、外观、角色
   - 生成专属形象（需要 MiniMax API）

5. **心情气泡池**
   - 点击顶部心情图标
   - 左右滑动查看不同日期的心情卡片
   - 点击卡片展开查看当天的气泡池
   - 可以拖拽气泡，感受物理引擎效果

## 📊 API 端点

- `POST /api/process` - 处理文本/语音输入
- `POST /api/chat` - 与 AI 对话（RAG）
- `GET /api/records` - 获取所有记录
- `GET /api/moods` - 获取情绪数据
- `GET /api/inspirations` - 获取灵感
- `GET /api/todos` - 获取待办事项
- `POST /api/character/generate` - 生成角色形象
- `GET /health` - 健康检查
- `GET /docs` - API 文档

## 🔗 相关链接

- [GitHub 仓库](https://github.com/kernel-14/Nora)
- [详细文档](https://github.com/kernel-14/Nora/blob/main/README.md)
- [智谱 AI](https://open.bigmodel.cn/)
- [MiniMax](https://platform.minimaxi.com/)

## 📝 技术栈

- **后端**: FastAPI + Python 3.11
- **前端**: React + TypeScript + Vite
- **物理引擎**: Matter.js
- **AI 服务**: 智谱 AI (GLM-4) + MiniMax
- **部署**: ModelScope (Gradio)

## 📄 License

MIT License

---

## 🚀 部署到 ModelScope

### 方法一：通过 Git 导入

1. 在 ModelScope 创建新的应用空间
2. 选择 "从 Git 导入"
3. 输入仓库地址：`https://github.com/kernel-14/Nora.git`
4. 选择 Gradio SDK
5. 配置环境变量（见上方配置说明）
6. 点击创建

### 方法二：手动上传

1. 克隆本仓库到本地
2. 在 ModelScope 创建新的应用空间
3. 上传所有文件
4. 确保 `configuration.json` 和 `app_modelscope.py` 在根目录
5. 配置环境变量
6. 启动应用

### 文件说明

- `app_modelscope.py` - ModelScope 入口文件
- `configuration.json` - ModelScope 配置文件
- `requirements_modelscope.txt` - Python 依赖（使用兼容的 Gradio 版本）
- `app/` - FastAPI 后端代码
- `frontend/dist/` - 前端构建产物
- `data/` - 数据存储目录

### 注意事项

- 确保 `frontend/dist/` 目录已包含构建好的前端文件
- 环境变量必须正确配置才能使用 AI 功能
- ModelScope 使用 Gradio 4.44.1 版本以避免依赖冲突