# aiCodeHelper

**Repository Path**: yNotEasy/ai-code-helper

## Basic Information

- **Project Name**: aiCodeHelper
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# aiCodeHelper

#### 介绍
AI Code Helper 是一个专为程序员打造的智能助手应用，旨在帮助开发者解决编程学习和求职面试中的各种问题。项目基于 LangChain4j 框架和阿里通义千问大模型构建，提供学习路线规划、项目建议、求职指导、面试题分享等核心功能
#### 主要特性
🤖 智能问答：基于通义千问大模型，提供编程技术解答

🔍 RAG 检索增强：从知识库检索相关内容，提升回答质量

🛠️ 工具调用：支持面试题搜索等外部工具集成

🔗 MCP 协议扩展：通过 Model Context Protocol 无缝扩展 AI 能力

🖼️ 多模态识别：支持图片上传和视觉理解

💬 持久化记忆：基于数据库的多轮对话管理，支持会话恢复

🛡️ 安全防护：输入内容安全检测，防止恶意输入

⚡ 流式响应：SSE 流式输出，实时交互体验
#### 软件架构
软件架构说明
技术组件	版本/说明	用途
Spring Boot	3.x	后端框架
LangChain4j	最新版	AI 服务编排
通义千问 (DashScope)	qwen-plus / qwen-vl-plus	大语言模型
MyBatis Plus	3.x	ORM 框架
MySQL	8.0+	数据库
Project Reactor	-	响应式流式处理
Resilience4j	-	熔断保护
MCP	-	模型上下文协议

#### 安装教程

1. 克隆项目
2. 配置数据库
3. 配置 application.yml     
4. 准备 RAG 知识库（可选）
5. 编译运行

#### 注意事项
多实例部署：ConversationMemoryBackingStore 使用进程内 ConcurrentHashMap 存储会话记忆。多实例部署时需要：

配置粘性会话（Sticky Session）

或改用 Redis 等共享存储方案

API Key 安全：建议通过环境变量或配置中心管理 API Key，避免硬编码：

bash
export DASHSCOPE_API_KEY=sk-xxxxxxxx
首次启动：RAG 文档向量化会占用一定时间，取决于文档数量和大小。日志中会显示处理进度。

MCP 服务：如不使用 MCP Web Search 功能，建议设置 app.mcp.enabled=false，避免启动时不必要的网络请求。

图片上传限制：默认 1MB 上限，压缩后仍超限会返回明确错误提示，引导用户使用更小的图片。

#### 参与贡献