# go-aicode-helper

**Repository Path**: netbycom/go-aicode-helper

## Basic Information

- **Project Name**: go-aicode-helper
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-12
- **Last Updated**: 2026-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Code Helper (AI 代码助手)

一款基于 Go + Vue 3 开发的全栈 AI 代码助手，支持多模型切换、分布式密钥管理、以及高性能 RAG（检索增强生成）知识库。

## 🚀 核心功能

- **多模型集成**：支持 DeepSeek, OpenAI, 智谱AI, SiliconFlow 等主流供应商，支持一键切换。
- **RAG 知识库**：
  - 支持 SQL、代码、文本等多格式文档上传。
  - 自动分片与高性能向量化索引。
  - 基于余弦相似度的精准语义检索。
  - 自动注入上下文，让 AI 深入理解您的业务逻辑。
- **代码专项操作**：内置“解释代码”、“生成单测”、“代码优化”等一键式快捷操作。
- **密钥负载均衡**：支持为同一个供应商配置多个 API Key，实现权重随机负载均衡。
- **极致渲染体验**：基于 JSON-SSE 协议的流式渲染，完美复现 Markdown 格式与打字机效果。

## 🛠️ 技术栈

- **后端**：Go 1.21+ / Gin Gonic / GORM / MySQL
- **前端**：Vue 3 / Vite / Element Plus / Axios / Markdown-it
- **AI 协议**：兼容 OpenAI 标准流式输出 (SSE)
- **向量化**：支持所有兼容 OpenAI Embeddings 接口的模型 (建议使用 BAAI/bge-m3)

## 📦 快速开始

### 1. 数据库准备
执行 `scripts/init.sql` 初始化数据库表结构。

### 2. 后端启动
```bash
# 进入项目根目录
go mod tidy
go run cmd/server/main.go
# 默认端口: 8280
```

### 3. 前端启动
```bash
cd frontend
npm install
npm run dev
# 默认访问地址: http://localhost:3000
```

## 📖 RAG 知识库配置指南

1. **添加供应商**：在管理后台添加 SiliconFlow 或 OpenAI 供应商。
2. **配置向量模型**：
   - 添加一个模型，展示名填 `text-embedding-3-small`。
   - **模型类型** 必须选择 `embedding`。
   - 真实模型 ID 填入供应商提供的 ID（如 `BAAI/bge-m3`）。
3. **上传文档**：在知识库页面上传您的业务文档，等待索引完成。
4. **开启对话**：在聊天界面勾选“知识库开启”，AI 将会自动参考您的文档进行回答。

## 📄 开源协议
MIT License