该项目主要面向于需要AI聊天陪伴的人群，### 3.1 个人情感陪伴
- **日常闲聊**：下班后、睡前的情感倾诉对象
- **角色扮演沉浸**：与喜爱的二次元/游戏角色"面对面"聊天
- **情绪支持**：低落时的鼓励和陪伴（非医疗用途）
### 3.2 社交/直播互动
- **虚拟主播**：直播间 AI 角色与观众实时互动
- **粉丝经济**：偶像角色 AI 化，粉丝付费与角色聊天
- **游戏 NPC**：将角色接入游戏引擎实现智能 NPC 对话
### 3.3 二次元/ACG 生态
- **漫展/主题店**：线下场景放置 AI 聊天终端
- **Cosplay 增强**：Coser + AI 语音对话让角色更立体
- **同人创作辅助**：创作者用 AI 模拟角色对话来辅助写作
### 3.4 桌面宠物/数字人
- **桌面 AI 女友**：Windows/macOS 桌面挂件形态
- **VR/AR 数字人**：结合 3D 模型在 VR 空间中进行对话
- **智能音箱集成**：将角色人格接入硬件设备
AI女友智能体是一个基于大语言模型的多模态 AI 伴侣系统，支持文字聊天、语音对话、视觉识别三种交互方式。用户可以与 4 位预设的二次元角色（爱莉希雅、流萤、爱弥斯、若曦）进行沉浸式角色扮演对话。系统提供Web 前端、Android 客户端、命令行三种使用方式，支持局域网内多设备接入。项目以DeepSeek为核心推理引擎，围绕其构建了一整套记忆管理、情绪模拟、时间感知、语音合成、人脸识别等周边系统，是一个从底层 Prompt 工程到上层前端交付的完整 AI 应用。
### 2.4 视觉交互 — 人脸识别 + AI 自然回应
基于 **OpenCV + YOLOv8** 的实时人脸识别系统：
- **人脸数据采集**：通过摄像头批量采集特定人物的面部图像
- **YOLOv8 训练**：自定义训练人物识别模型
- **视觉聊天**：识别到特定人物时，自动构建视觉上下文（谁出现了、什么时间、距上次见面多久），发送给 DeepSeek API 生成角色化自然回应
- **问候冷却机制**：20 秒冷却时间，避免重复打招呼
### 2.5 Web 服务 — 实时通信 + REST API
| 通信方式 | 用途 | 端点 |
|----------|------|------|
| **WebSocket** | 实时聊天（推荐） | `ws://ip:8080/ws/chat?character=爱莉希雅` |
| **REST API** | 角色管理、记忆管理、历史查询 | 10 个 HTTP 端点 |
| **静态文件** | Web 聊天界面 | `http://ip:8080/` |
WebSocket 协议支持 7 种消息类型：聊天、记忆 CRUD、心跳、自动提取通知等。前端纯原生 JS 实现，零框架依赖，响应式布局适配手机/平板。
### 2.6 记忆管理系统 — 三层记忆架构
这是项目最核心的工程难点之一，实现了三层记忆体系：
第一层：短期记忆（conversation_history）
第二层：运行时记忆（long_term_memory + 外部注入）
第三层：长期记忆（ConversationMemoryManager）
评论