langchain4j-aideepin-admin
基于 LangChain4j + Vue3 的企业级知识库 RAG 管理后台,支持多模型平台一键接入
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
基于 LangChain4j + Vue3 的企业级知识库 RAG 管理后台,支持多模型平台一键接入
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
想象这样的场景:一家法律咨询公司,需要让 AI 助手精准回答数千份合同文档中的条款;一家制造业企业,想把积累了几十年的技术手册变成可检索的智能问答系统。传统的关键词搜索早已力不从心,而通用大模型又无法准确回答私有领域的问题——这时,LangChain4j-AIDeepin Admin 提供了第三条路。
这是一款基于 LangChain4j 框架构建的 Java 版检索增强生成(RAG)管理后台,由开发者 moyangzhan 主导开发。其用户端 Web 产品 AIDeepin(www.aideepin.com)已在生产环境中运行,为企业和个人用户提供 AI 对话、知识库检索、AI 绘图、工作流编排等能力。该项目已被归档,功能已迁移至 langchain4j-aideepin monorepo 的 admin-web/ 目录下继续维护,截至分析时母仓库已获得 1,344 Stars,说明项目整体获得了较高的社区认可。
图 1:AI 模型管理 — 支持配置多平台模型接入,包括千问、硅基流动、OpenAI、Ollama、DeepSeek 等主流平台
管理后台的技术栈选择非常务实:Vue 3 作为前端框架,搭配 Naive UI 组件库(基于 TypeScript),用 Vite 作为构建工具。这套组合在国内企业级后台开发中非常常见——上手门槛低、组件丰富、生态成熟。相比 React + Ant Design 的组合,Naive UI 的设计语言更年轻化,主题定制也更灵活。
后端则基于 Spring Boot + LangChain4j,这是 Java 生态中做 LLM 应用的事实标准。相比 Python 生态的 LangChain,Java 版本的 LangChain4j 让企业可以复用现有的 Java 技术栈,降低了技术债务和运维复杂度。LangChain4j 支持向量检索、提示词管理、工具调用等核心能力,使得知识库检索质量有保障。
前端通过 Axios 与后端 API 通信,Pinia 管理全局状态,Vue Router 处理路由,Vue I18n 实现国际化。项目使用 Tailwind CSS 做样式定制,TypeScript 贯穿全栈,代码规范方面引入了 ESLint + Prettier + CommitLint 的完整质量门禁。
图 2:知识库管理 — 支持文档上传、分块策略配置、向量检索与知识图谱双模式检索
管理后台允许管理员配置多个 AI 模型平台。目前已验证支持的平台包括:千问(通义千问)、硅基流动、OpenAI、Ollama 和 DeepSeek。每个平台可单独配置 API Key、端点地址、模型名称和参数(温度、最大 Token 数等)。
这一设计使得系统具备了模型无关性——企业可以随时切换底层模型,而无需修改上层业务逻辑。随着大模型厂商的快速迭代,这种灵活性尤为重要。
知识库是 RAG 系统的核心。管理后台支持:文档上传(支持多种格式)、文档分块(Chunk)策略配置、向量检索参数调优,以及知识图谱模式检索。
知识图谱检索是一个亮点功能——传统向量检索只考虑语义相似性,知识图谱模式则可以建模实体之间的关系,提升复杂问答场景的准确率。项目支持 Neo4j 作为图数据库(可选配置),体现了技术选型的前瞻性。
图 3:AI 工作流编排 — 可视化节点编辑,支持条件分支、并行执行、LLM 调用、知识库查询、人工反馈等节点类型
标准的 RBAC(基于角色的访问控制)用户体系,支持角色创建、权限分配、用户状态管理。这是企业级应用的基础能力,无需赘述。
图 4:用户管理 — 支持角色权限配置、用户状态管理
提供邮件服务配置(支持 SMTP)、AES 加密密钥管理、环境变量配置等。邮件功能可用于用户注册验证、密码重置等场景;AES 密钥用于敏感信息的本地加密存储。
图 5:系统配置 — 邮件服务、环境变量、AES 密钥等核心配置项
支持多角色、多会话管理,可为每个会话配置不同的系统提示词、模型和参数。流式输出(Streaming)带来接近实时的对话体验。管理后台可以查看和管理所有用户的对话记录。
图 6:AI 对话控制台 — 多角色、多会话、流式输出
对于开发者而言,最关心的就是能不能快速跑起来。
好消息是该项目提供了 完整的一键部署方案。根目录的 docker/docker-compose.yml 定义了完整的微服务架构:
Nginx 根据路径分发请求:/api/ → 后端 API,/admin/ → 管理前端,/ → 用户前端。这种单节点全服务架构非常适合中小规模部署。
部署的唯一门槛是需要自行准备一个 PostgreSQL 数据库实例(版本未明确要求,Spring Boot 生态通常支持 PostgreSQL 12+)。项目提供了详细的 .env 配置模板,涵盖数据库连接、Redis、邮件服务、AES 密钥等所有必填项。官方文档建议服务器内存不低于 8GB,以容纳 Java 进程的堆内存(默认 JAVA_OPTS: -Xms1024m -Xmx2048m)。
对于低内存(<8GB)服务器,文档也贴心地提供了分步构建指南,避免 Docker 构建时 OOM。
没有任何项目是完美的,LangChain4j-AIDeepin Admin 也不例外。
第一,项目已归档。 本仓库(langchain4j-aideepin-admin)已停止维护,代码迁移至 monorepo。这意味着如果基于本仓库进行二次开发,需要注意后续更新不在本仓库进行。不过由于 MIT 许可证,继续使用和 fork 均无法律风险。
第二,文档质量参差不齐。 管理后台的 README 仅有一句话指向新仓库,缺乏详细的部署文档和 API 文档。如果不参考新仓库的文档,开发者可能需要花较多时间摸索。
第三,数据库需要额外配置。 不像一些"All-in-Docker"的方案,该项目要求开发者自行搭建和初始化 PostgreSQL。对于非 Java 技术栈的团队,数据库初始化脚本和迁移工具的缺失可能造成一定障碍。
第四,Neo4j 图数据库为可选。 虽然系统设计了知识图谱检索功能,但 Neo4j 在 docker-compose 中被注释掉了,需要手动取消注释才能启用。这意味着知识图谱功能的上手需要额外的配置步骤。
第五,监控与可观测性不足。 项目没有看到内置的监控(Prometheus/Grafana)或日志聚合方案,在生产环境中追踪问题可能需要自行集成。
适合的场景:
不太适合的场景:
LangChain4j-AIDeepin Admin 是一个务实的企业级 AI 知识管理后台。它没有追求最前沿的技术噱头,而是在 Vue 3 + Spring Boot + LangChain4j 这套成熟组合上,构建了完整的知识库 RAG 链路。docker-compose 一键部署降低了使用门槛,多模型平台支持赋予了灵活的选择空间。
尽管项目本体已归档,但迁移至 monorepo 后仍在活跃维护,母仓库 1,344 Stars 的体量证明了其市场价值。如果你正在寻找一个 Java 生态的 RAG 管理后台方案,这是一个值得认真评估的选项。
注意:本仓库已归档,建议基于 langchain4j-aideepin monorepo 进行二次开发和部署。