deployment/README_HF.md

---
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