高性能萝卜子！基于claude code记忆压缩方式的情感伴侣
English · 快速上手 · 功能亮点 · 技术栈 · 文档 · License
| 深色模式 | 浅色模式 |
|---|---|
 |
 |
 |
 |
大多数 AI 聊天工具每次打开都像失忆了一样 —— 你昨天刚说过最喜欢珍珠奶茶，今天它又问你"你喜欢喝什么？"
ATRI 不一样。它的核心是一套仿人脑记忆的三层压缩系统：每轮对话自动清洗噪声，每 26 轮生成事件级摘要，每 4 个摘要再提炼出长期画像。配合 mem0 的跨会话向量检索，你聊过的偏好、情绪变化、未完成话题，它都能记住并在合适的时刻想起。
简单来说：聊得越久，它越懂你。
ATRI 同时也是一个功能完整的 AI 角色伴侣平台 —— Live2D 形象、语音对话、角色定制、多用户隔离，开箱即用。
项目名称取自游戏《ATRI -My Dear Moments-》的女主角亚托莉，也是我最喜欢的高性能萝卜子
- 三层压缩：L1 规则清洗 → L3 事件级摘要 → L4 模式级画像，上下文永不丢失
- 长期记忆：通过 mem0 保存跨会话的用户事实、偏好和情感趋势
- 可恢复：
chat_history是 source of truth，short_term_memory损坏时可自动重建 - 会话隔离：每个角色、每个用户独立记忆空间
- 流式输出：WebSocket 实时推送 LLM 分片，逐字显示，无等待感
- 聊天管理：ChatGPT 风格的侧边栏 —— 历史列表、自动标题、新建 / 删除
- 角色切换：多角色人设，每个角色拥有独立记忆和问候语
- 实时时间感知：AI 知道"现在几点"，对话更自然
- Live2D 舞台：后端托管模型资源，前端 PixiJS 渲染，支持表情和待机动画
- 双布局：
- 双主题：深色 / 浅色一键切换
- 自定义背景：上传喜欢的图片，调节透明度
- AIRI 风格 UI：参考 AIRI 的青绿色调设计语言
- ASR 语音输入：支持 Faster Whisper / Whisper.cpp / OpenAI Whisper / 浏览器原生 Web Speech API
- TTS 语音输出：支持 Edge TTS / GPT-SoVITS / SiliconFlow / CosyVoice3
- 浮动播放器：自定义进度条、拖动 seek、队列显示
- 模块化开关：ASR 和 TTS 均为可选插件，按需启用
- 本地友好：关闭认证即可单机使用，零配置上手
- 公网就绪：GitHub OAuth + JWT + 白名单，开启后多用户数据隔离
- 配置分层：
config.yaml引用各子配置，模块化管理 - OAuth 状态校验：防止 OAuth 登录流程被 CSRF、旧回调或跨账号串号混淆
- JWT 保护：使用 HttpOnly Cookie 承载会话，避免 JWT 暴露在 URL、日志或前端可读存储中
请阅读 快速上手指南 开始安装和配置。
后端启动后也可以访问自动生成的 API 文档：
- Swagger UI:
http://localhost:8430/docs - OpenAPI JSON:
http://localhost:8430/openapi.json
| 层 | 技术 |
|---|---|
| 后端框架 | FastAPI + Uvicorn |
| LLM | OpenAI 兼容接口（DeepSeek、SiliconFlow 等） |
| 记忆 | 三层压缩 + mem0（SaaS / Qdrant 本地部署） |
| 存储 | 本地 JSON（可扩展数据库） |
| 认证 | GitHub OAuth + JWT |
| 前端框架 | Vue 3 + TypeScript + Vite |
| 状态管理 | Pinia |
| 样式 | UnoCSS |
| Live2D | PixiJS + pixi-live2d-display |
| 语音 | ASR / TTS 多提供商工厂模式 |
| 文档 | 说明 |
|---|---|
| 架构文档 | ATRI 的项目整体架构和开发文档入口 |
| 认证系统使用指南 | GitHub OAuth 配置与白名单管理 |
| ASR 配置说明 | 语音识别提供商配置 |
| TTS 配置说明 | 语音合成提供商配置 |
| 角色创建指南 | 角色人设、头像与问候语 |
atri/
├── src/ # 后端源码
│ ├── agent/ # ChatAgent + Persona
│ ├── memory/ # 三层记忆压缩 + 会话管理
│ ├── llm/ # LLM 调用层（工厂模式）
│ ├── asr/ # ASR 提供商
│ ├── tts/ # TTS 提供商
│ ├── auth/ # 认证系统
│ ├── storage/ # 存储抽象层
│ ├── routes/ # FastAPI 路由
│ └── utils/ # 配置加载 + 日志
├── config/ # 分层配置文件
├── prompts/ # 角色人设 + 压缩 Prompt
├── data/ # 运行时数据 / 头像 / Live2D 模型
├── tests/ # 后端测试
└── atri-webui/ # 前端（子模块）
ATRI 当前已经具备完整的 Web 对话体验：持久化记忆、角色管理、ASR/TTS、Live2D 舞台、认证与部署基础。后续开发会围绕“更自然的交互、更丰富的感知、更完整的部署形态”持续推进。
已完成
- 三层记忆压缩与持久化存储：支持会话历史、短期记忆、长期记忆和角色隔离。
- Web 端基础体验：支持聊天、角色切换、设置页、Live2D 舞台和普通聊天模式。
- 语音链路：已接入 ASR 与 TTS，并支持多提供商配置。
- 部署与认证基础：支持本地部署、云端部署、GitHub OAuth、JWT 和白名单访问控制。
近期计划
- 新增"插件式"翻译模块，作用于 llm calling 层与 TTS/前端消费之间
- 优化移动端 Web 适配，提升云部署后的手机访问体验。
- 增强 TTS 流式播放链路，减少长回复的语音等待时间。
- 引入 VAD 实时语音控制，让对话从“按键录音”逐步转向自然语音交互。
- 完善 Live2D 与普通聊天模式下的界面一致性和交互细节。
- 持续打磨 UI。目前前端设计参考 AIRI，感谢 AIRI 项目的优秀设计基础。
长期方向
- 视觉理解能力，让 ATRI 可以“看见”图像、屏幕或摄像头输入。
- MCP 集成，为 ATRI 接入外部工具、文件、搜索和自动化能力。
- PC 客户端，提供更稳定的桌面端使用体验。
- Android 移动端，补齐移动设备上的原生体验。
欢迎参与 ATRI 的开发！请阅读 CONTRIBUTING.md 了解：
- 开发环境搭建
- 分支与 PR 流程
- 代码规范
- 开发文档导读 — 根据你参与的模块（后端 / 前端 / TTS / ASR / Live2D）选择性阅读
docs/developments/下的设计文档
ATRI 的诞生离不开以下优秀项目的启发和参考：
- Open-LLM-VTuber — ASR / TTS 工厂模式参考
- AIRI — 前端 UI 设计、Live2D 集成参考
- mem0 — 长期记忆基座