File size: 3,675 Bytes
59bd45e | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 | # 🌟 治愈系记录助手 - 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 版本以避免依赖冲突
|