File size: 2,808 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 | ---
title: Nora - 治愈系记录助手
emoji: 🌟
colorFrom: purple
colorTo: pink
sdk: docker
pinned: false
license: mit
---
# 🌟 治愈系记录助手 - SoulMate AI Companion
一个温暖、治愈的 AI 陪伴应用，帮助你记录心情、捕捉灵感、管理待办。
## ✨ 核心特性
- 🎤 **语音/文字快速记录** - 自动分类保存
- 🤖 **AI 语义解析** - 智能提取情绪、灵感和待办
- 💬 **AI 对话陪伴（RAG）** - 基于历史记录的个性化对话
- 🖼️ **AI 形象定制** - 生成专属治愈系角色（720 种组合）
- 🫧 **物理引擎心情池** - 基于 Matter.js 的动态气泡可视化
## 🚀 快速开始
### 在线使用
直接访问本 Space 即可使用完整功能！
### 配置 API 密钥
在 Space 的 **Settings → Repository secrets** 中配置：
**必需：**
- `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
- **部署**: Hugging Face Spaces (Docker)
## 📄 License
MIT License
|