| # 🌟 治愈系记录助手 - 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 版本以避免依赖冲突 |
|
|
