| --- |
| title: Nora - 治愈系记录助手 |
| emoji: 🌟 |
| colorFrom: purple |
| colorTo: pink |
| sdk: docker |
| pinned: false |
| license: mit |
| --- |
| |
| # 🌟 治愈系记录助手 - SoulMate AI Companion |
|
|
| 一个温暖、治愈的 AI 陪伴应用，帮助你记录心情、捕捉灵感、管理待办。 |
|
|
| 目前已上线huggingface，体验链接：https://huggingface.co/spaces/kernel14/Nora |
|
|
| ## ✨ 核心特性 |
|
|
| - 🎤 **语音/文字快速记录** - 自动分类保存 |
| - 🤖 **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/) |
| - [Huggingface](https://huggingface.co/spaces/kernel14/Nora) |
|
|
| ## 📝 技术栈 |
|
|
| - **后端**: FastAPI + Python 3.11 |
| - **前端**: React + TypeScript + Vite |
| - **物理引擎**: Matter.js |
| - **AI 服务**: 智谱 AI (GLM-4) + MiniMax |
| - **部署**: Hugging Face Spaces (Docker) |
|
|
| ## 🔧 本地开发 |
|
|
| ### 启动后端服务 |
|
|
| ```bash |
| # 安装依赖 |
| pip install -r requirements.txt |
| |
| # 配置环境变量（复制 .env.example 为 .env 并填写） |
| cp .env.example .env |
| |
| # 启动服务（端口 8000） |
| python scripts/start_local.py |
| ``` |
|
|
| ### 构建前端 |
|
|
| ```bash |
| cd frontend |
| npm install |
| npm run build |
| ``` |
|
|
| ### 局域网访问 |
|
|
| 1. 启动后端后，会显示局域网访问地址（如 `http://192.168.1.100:8000/`） |
| 2. 其他设备连接同一 WiFi 后，使用该地址访问 |
| 3. 如果无法访问，请参考 [局域网访问快速修复指南](docs/局域网访问快速修复.md) |
|
|
| **快速诊断**： |
| ```bash |
| # Windows |
| scripts\test_lan_access.bat |
| |
| # 或访问诊断页面 |
| http://你的IP:8000/test-connection.html |
| ``` |
|
|
| ## 🐛 故障排查 |
|
|
| ### 问题：其他设备访问显示 "Load failed" |
|
|
| **原因**：防火墙阻止、网络隔离或 API 地址配置错误 |
|
|
| **解决方案**： |
| 1. 运行诊断工具：`scripts\test_lan_access.bat` |
| 2. 访问诊断页面：`http://你的IP:8000/test-connection.html` |
| 3. 查看详细指南：[局域网访问快速修复](docs/局域网访问快速修复.md) |
|
|
| ### 问题：语音识别失败 |
|
|
| **原因**：未配置 ZHIPU_API_KEY 或 API 配额不足 |
|
|
| **解决方案**： |
| 1. 检查 `.env` 文件中的 `ZHIPU_API_KEY` |
| 2. 访问 https://open.bigmodel.cn/ 检查配额 |
|
|
| ### 问题：AI 形象生成失败 |
|
|
| **原因**：未配置 MINIMAX_API_KEY 或 API 配额不足 |
|
|
| **解决方案**： |
| 1. 检查 `.env` 文件中的 `MINIMAX_API_KEY` 和 `MINIMAX_GROUP_ID` |
| 2. 访问 https://platform.minimaxi.com/ 检查配额 |
|
|
| ## 📚 文档 |
|
|
| - [功能架构图](docs/功能架构图.md) |
| - [API 配置说明](docs/API_配置说明.md) |
| - [局域网访问指南](docs/局域网访问指南.md) |
| - [局域网访问快速修复](docs/局域网访问快速修复.md) |
| - [心情气泡池功能说明](docs/心情气泡池功能说明.md) |
|
|
| ## 📄 License |
|
|
| MIT License |
|
|
