AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它提供了一个生产级别的应用骨架，拥有模块化 Compose 架构、10多种 AI 提供商支持、本地模型集成和清晰的职责分离，全部开源，可定制、可商业化或作为学习参考。

适合谁使用

学习大型 Jetpack Compose 模块化工程架构的 Android 开发者
开发 AI 伴侣或角色扮演聊天产品的团队
需要集成多种 AI API 或灵活切换提供商的人员
探索本地端侧模型推理以实现隐私和离线使用的工程师

典型使用场景

快速搭建 AI 伴侣应用原型，内置聊天、记忆和角色人格系统
作为模块化 Android 架构（Compose + Room）的参考工程
通过统一配置中心接入自有后端、本地或第三方 AI 模型
学习现代 Android 开发最佳实践，包括协程、Flow 和 WorkManager

项目优势

基于特性的高度模块化架构，依赖方向清晰，feature 模块之间无直接耦合
支持 OpenAI、DeepSeek、Gemini、Kimi、Groq 等 10 余种 AI 提供商及自定义兼容接口
内置本地模型框架 (LiteRT-LM)，支持离线推理和安全分类
Material 3 深色主题 UI，包含毛玻璃效果和根据设备性能自适应动画强度

使用前须知

无预置 API 密钥或可用 AI 服务，用户需自行配置 Base URL、API Key 和模型
安全模块 (core:security) 仅为占位，生产环境需替换为真实实现
大模型文件未包含，需通过 Git LFS 或发布包下载，应用内下载管理需自行完善

README 快速开始

LianYu / 恋语

面向 Android 的 AI 虚拟陪伴应用开源框架

AI Companion · Modular Android · Jetpack Compose · Local Model Ready · Open API Framework

快速开始 · 功能全景 · 系统架构 · API 配置 · 贡献者

🌌 项目定位

LianYu（恋语） 是一款 Android AI 虚拟陪伴应用的开源框架。它不是一个简单的聊天 Demo，而是一个围绕“长期陪伴、角色人格、记忆沉淀、多模态扩展、本地模型接入、模块化工程治理”构建的完整应用骨架。

本项目适合：

想学习 Kotlin + Jetpack Compose 大型 Android 工程架构 的开发者。
想二次开发 AI 伴侣、AI 角色聊天、AI 社交陪伴类产品的团队。
想接入 OpenAI-compatible API、本地模型、私有模型网关的个人或组织。
想参考 Room / Flow / Compose / WorkManager / 多模块拆分实践的 Android 工程师。

它提供了一套完整但可替换的产品基座：

角色系统 + 聊天系统 + 记忆系统 + 群聊系统 + 设置系统 + 本地模型框架 + 通知框架 + 主题框架

你可以把它当作：

一个 AI companion app starter kit。
一个 Compose 多模块工程样板。
一个可继续商业化或社区化的虚拟陪伴应用底座。
一个可替换后端、替换模型、替换 UI 风格的产品壳。

🌱 开源版声明

为了适合公开发布，本仓库已经整理为 Public Edition。

已移除

私有 AI 中继服务配置。
内置 Clove / cloveapi 相关服务器逻辑。
个人服务器地址、内置 token、内置 secret、私有 API key。
私有证书 pinning 和面向私有后端的请求签名。
Native 安全壳、VMP、反调试、OLLVM、shell payload、打包加固脚本。
发布 APK、私有安全文档、历史临时推送目录。

已保留

App 主体功能和模块化架构。
AI Provider 配置框架。
Room 数据库和 Repository 层。
Compose UI 与主题系统。
本地模型接入框架。
通知、WorkManager、微信/QQ Bot 等功能模块骨架。
core:security 最小 no-op 兼容层，方便下游替换实现。

需要你自行配置

AI API Base URL。
API Key。
模型名称。
推送平台参数。
签名证书。
是否接入自己的安全/加密/风控方案。

Public Edition 默认不会连接任何私有服务器，也不提供可直接使用的内置模型服务。

UI 占位提示

Public Edition 中保留的部分「自定义中继 / Partner / 连接测试」相关 UI 仅作为二次开发占位，用于展示原有设置入口和配置流程。

这些 UI 不会连接任何内置服务器，也不会自动分发 API Key。如果你需要使用对应能力，请在自己的 fork 中接入自有后端，或直接使用「自定义 API / OpenAI-compatible」配置填写自己的 Base URL 与 API Key。

✨ 功能全景

1. AI 伴侣聊天

单人伴侣聊天。
多轮上下文对话。
消息历史持久化。
AI 回复失败处理。
消息输入队列和异步处理。
用户消息与 AI 消息区分展示。
适配 OpenAI-compatible Chat Completions 风格接口。

2. 角色与伴侣管理

创建虚拟伴侣。
编辑角色资料。
角色头像、名称、设定、描述管理。
默认伴侣 seed 框架。
角色资料可扩展到人格、语气、背景故事、互动风格。

3. 群聊框架

群组数据结构。
群消息持久化。
多角色互动基础。
可扩展为多人 AI 剧场、虚拟社群、AI 角色扮演房间。

4. 记忆系统

记忆条目管理。
MemoryEntry 数据模型。
可扩展长期记忆、用户偏好、角色关系、重要事件。
为后续向量检索、RAG、上下文召回预留工程空间。

5. API 配置中心

支持多种 Provider 类型和自定义接口：

OpenAI
Claude / Anthropic
Gemini
DeepSeek
DashScope / 通义千问
Kimi

LianYu-app