🌟 治愈系记录助手 - 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 形象生成
📖 使用说明
首页快速记录
- 点击麦克风录音或在输入框输入文字
- AI 自动分析并分类保存
查看分类数据
- 点击顶部心情、灵感、待办图标
- 查看不同类型的记录
与 AI 对话
- 点击 AI 形象显示问候对话框
- 点击对话框中的聊天图标进入完整对话
- AI 基于你的历史记录提供个性化回复
定制 AI 形象
- 点击右下角 ✨ 按钮
- 选择颜色、性格、外观、角色
- 生成专属形象（需要 MiniMax API）
心情气泡池
- 点击顶部心情图标
- 左右滑动查看不同日期的心情卡片
- 点击卡片展开查看当天的气泡池
- 可以拖拽气泡，感受物理引擎效果
📊 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 文档
🔗 相关链接
📝 技术栈
- 后端: FastAPI + Python 3.11
- 前端: React + TypeScript + Vite
- 物理引擎: Matter.js
- AI 服务: 智谱 AI (GLM-4) + MiniMax
- 部署: ModelScope (Gradio)
📄 License
MIT License
🚀 部署到 ModelScope
方法一：通过 Git 导入
- 在 ModelScope 创建新的应用空间
- 选择 "从 Git 导入"
- 输入仓库地址：
https://github.com/kernel-14/Nora.git - 选择 Gradio SDK
- 配置环境变量（见上方配置说明）
- 点击创建
方法二：手动上传
- 克隆本仓库到本地
- 在 ModelScope 创建新的应用空间
- 上传所有文件
- 确保
configuration.json和app_modelscope.py在根目录 - 配置环境变量
- 启动应用
文件说明
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 版本以避免依赖冲突