Hugging Face's logo

Spaces:
kernel14
/
Nora
Sleeping

App Files Community
Nora / README.md
GitHub Action
Deploy clean version of Nora
59bd45e
preview code
|
raw
history blame contribute delete
4.84 kB
metadata 
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 密钥

可选：

📖 使用说明

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

🔗 相关链接

📝 技术栈

  • 后端: FastAPI + Python 3.11
  • 前端: React + TypeScript + Vite
  • 物理引擎: Matter.js
  • AI 服务: 智谱 AI (GLM-4) + MiniMax
  • 部署: Hugging Face Spaces (Docker)

🔧 本地开发

启动后端服务 

# 安装依赖
pip install -r requirements.txt

# 配置环境变量（复制 .env.example 为 .env 并填写）
cp .env.example .env

# 启动服务（端口 8000）
python scripts/start_local.py

构建前端 

cd frontend
npm install
npm run build

局域网访问

  1. 启动后端后，会显示局域网访问地址（如 http://192.168.1.100:8000/）
  2. 其他设备连接同一 WiFi 后，使用该地址访问
  3. 如果无法访问，请参考 局域网访问快速修复指南

快速诊断：

# 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. 查看详细指南：局域网访问快速修复

问题：语音识别失败

原因：未配置 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/ 检查配额

📚 文档

📄 License

MIT License