CampusMind-Agent
vnsjvn/CampusMind-Agent加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
大学宿舍凌晨两点,一位焦虑的大一新生对着屏幕发呆。期中考试将近,专业课作业堆积如山,和室友的关系也陷入微妙僵局。他打开学校的学生事务系统,翻遍了官网,却找不到一个可以倾诉的地方——心理咨询中心早已下班,而拨打24小时热线,又让他觉得"问题严重到必须打电话"。
这就是 CampusMind-Agent 试图解决的场景:在碎片化的深夜时刻,在学生还没走到危机边缘之前,填补那段被忽视的心理支持空白。
近年来,大学生心理健康问题日益受到关注。高校心理咨询中心普遍面临资源紧张困境:咨询师数量有限,学生预约等待时间长,而心理健康问题往往在深夜、独处时最为突出。同时,学生的困扰大多数是轻度到中度的焦虑、学业压力、人际关系问题,这类问题并不需要专业心理咨询师介入,却实实在在地影响着学生的日常生活和学习状态。
CampusMind-Agent 的设计思路正是面向这个 "灰色地带":用 AI 技术提供轻量级的情绪支持和信息陪伴,在专业干预之前搭建一道安全缓冲。值得注意的是,该系统并非要取代心理咨询师,而是充当第一道响应——倾听、评估、分类,根据风险等级决定是提供陪伴式对话,还是触发预警通知专业人员。
CampusMind-Agent 的核心是一个基于 LangGraph 的多智能体协作系统,每轮对话进入一个受限的 Agent 循环(最多 8 步),由控制器(Supervisor)根据对话状态决定调用哪个专业 Agent:
| Agent 角色 | 职责 | 技术亮点 |
|---|---|---|
| SupervisorAgent | 判断对话类型(闲聊/咨询/风险),分发任务 | 路由决策枢纽 |
| MemoryAgent | 管理短期(Redis)和长期(MySQL)对话记忆 | 上下文回填 + 摘要生成 |
| KnowledgeAgent | 执行 RAG 检索,从知识库获取校园资源信息 | 混合检索(语义+关键词) |
| RiskGuardianAgent | 心理风险评估,高风险触发预警 | LLM JSON 评估 + 词典硬兜底 |
| CompanionAgent | 处理学业、编程、校园事务等日常对话 | 日常陪伴 |
| CounselorAgent | 生成专业心理支持回复,结合记忆+RAG+风险评估 | 综合决策 |
这种设计将"风险识别"与"日常陪伴"解耦——CompanionAgent 负责轻松对话,而 RiskGuardianAgent 在后台静默评估,两者互不干扰,避免了单一 Agent 既要"共情"又要"评判"的角色冲突。
系统实现了"按需检索"的智能 RAG 策略:SupervisorAgent 先判断对话意图,只有涉及知识库查询的对话(咨询类)才会进入 RAG 链路。普通闲聊不会触发向量检索,有效降低了 token 消耗和响应延迟。
RAG 部分采用三层检索融合:
text-embedding-3-small 语义匹配当 ChromaDB 或 OpenAI API 不可用时,系统自动降级到纯 BM25 模式,保证演示环境不中断。
系统采用 MySQL + Redis 双存储:MySQL 存储完整业务数据(聊天记录、用户信息、风险台账),Redis 专门负责短期对话记忆。这种分离设计让数据库查询更轻量,Redis 承担高频读写,避免 MySQL 过载。
系统引入了 Model Context Protocol (MCP),将 Excel 报告写入和风险通知封装为标准工具,后端通过 MCP Client 调用这些工具。这种设计让工具扩展更加规范,新增功能只需注册新工具,无需改动核心代码。

项目提供了完整的 原生 HTML/CSS/JS 前端:学生端支持 SSE 流式输出(打字机效果),管理后台可查看风险预警报告。界面功能清晰,Basic Auth 实现角色隔离(学生 vs 管理员)。
但部署的挑战相当现实——系统依赖六个外部服务:Python 运行时、MySQL 数据库、Redis 缓存、ChromaDB 向量库、可选但推荐的 Ollama 本地模型推理服务(加载 GGUF 微调模型),以及 SMTP 邮件服务。其中任何一个缺失都会导致部分功能降级或不可用。更重要的是,项目没有提供 Dockerfile 或 docker-compose,需要手动逐个安装配置。
此外,项目无 LICENSE 文件,商业使用存在法律风险。无开源许可证意味着代码版权归属不明确,企业直接使用可能面临法律纠纷。
值得关注的亮点:
明显的局限:
mindbridge-qwen2.5-7b-ft 模型需要手动下载配置,Ollama 环境准备繁琐CampusMind-Agent 所属的"AI 校园心理健康"赛道正在快速成长。2024年11月的一篇 arXiv 论文(An AI-Assisted Multi-Agent Dual Dialogue System to Support Mental Health Care Providers)显示,研究界已在探索多智能体在心理咨询场景中的应用。CampusMind-Agent 的架构与该研究思路高度吻合,体现了将学术研究落地的尝试。
从增长角度看,该项目 stars 仅 2,fork 1,尚处于非常早期的阶段。其设计理念和代码质量(LangGraph 编排、RAG 三层融合、技能模块化)具有较高的技术参考价值,但实际可用性和稳定性需要社区验证。
CampusMind-Agent 是一个技术架构有亮点、落地门槛高的校园心理健康 AI 系统。它将多智能体协作、RAG 检索增强、风险评估和数据闭环整合在一个系统中,设计思路清晰,代码结构规范。适合作为 AI 心理支持系统的参考架构 和 LangGraph 多 Agent 开发的实战教材。
但对于希望快速部署使用的团队,该项目的高依赖复杂度(MySQL+Redis+ChromaDB+Ollama)和缺失的容器化支持是现实障碍。如果你是教育科技领域的研究者,或正在构建类似的心理支持系统,这个项目值得深入研究其 Agent 协作设计和 RAG 降级策略。