NetCoreKevin
企业级 AI 智能体中台:.NET 10 做后端,Vue 3 做管理后台,知识库、技能、记忆、额度都在界面上配。
An enterprise AI-agent platform on .NET 10 — RAG, skills, memory, multi-tenancy and scheduled tasks, with a Vue admin console.
[!NOTE] NetCoreKevin 面向「要在企业内网里落一个 AI 助手 / SaaS 智能体中台」的场景:多租户、登录鉴权、权限点、审计日志、定时任务、模型接入这些地基已经铺好,你只需要接自己的业务数据和业务系统。如果你只是想调一次大模型接口,这个仓库对你来说太重了。
NetCoreKevin 是什么
把「企业里的 AI 助手」拆开,需要的东西其实就四样:
- 后端:
App/WebApi。.NET 10 + EF Core 10 + MySQL,按 Domain / Application / RepositorieRps / WebApi 四层拆分,API 带 v1、v2 版本。 - AI 能力:
Kevin/kevin.Module。kevin.AI.AgentFramework 基于 Microsoft Agent Framework,kevin.RAG 负责切分、向量化与重排,都在同一个进程里,不用额外起 Python 服务。 - 管理后台:
vue/kevin.web.vue。Vue 3 + Ant Design Vue,租户、用户、角色、智能体、知识库、技能、任务、API Key 全在界面上配。 - 底座:25 个可插拔模块——权限、缓存、消息队列、分布式锁、SignalR、Hangfire、对象存储、短信、邮件、代码生成器。
它不是脚手架 demo:装好依赖、跑完迁移就能登录后台,有菜单、有权限、有定时任务、有审计日志。
特点
智能体是配置出来的,不是写死的
- 提示词 / 模型 / 参数:每个智能体单独配置,对话模型与向量模型分开选,温度、上下文裁剪都能调。
- 技能动态加载:技能是
SKILL.md+ 脚本(.py/.ps1/.sh),后台能新建、在线编辑、随时启停,改完不用重新编译。 - 知识库(RAG):上传文档自动切分写入 Qdrant,检索结果过一遍
qwen3-rerank重排再喂给模型。 - 记忆:按「租户 + 智能体 + 用户」三维隔离存在 Qdrant,是否使用记忆挂在智能体开关上。
- 多智能体协同:主智能体可以把子任务派给其他智能体执行。
- 上下文压缩:按配置阈值压缩历史消息,长期使用不会越聊越慢、越聊越贵。
- 联网搜索:接入火山引擎豆包搜索,模型需要新信息时自己去查。
- 全模态:图片理解、语音转写(阿里 ASR)、文生图(生成后自动上传 OSS)。
能当企业底座用
- 一库多租户:共享库按
TenantId隔离,接口层强制过滤,不用每个租户各建一套库。 - RBAC 权限:菜单与 API 两个维度,权限点跟角色走;调试期可以用
IsOpenPermission一把关掉。 - 额度与审计:每用户每月 Token 额度由定时任务颁发、请求时扣减;审计日志、慢查询告警、分环境文件日志都内置。
- 对外集成:腾讯云 / 阿里云 / 七牛三种对象存储,腾讯与阿里短信,钉钉消息,RabbitMQ / CAP 消息总线,Consul 服务发现,SignalR 实时推送。
给别的客户端留了口子
- OpenAI 协议兼容接口:
GET /v1/models、POST /v1/chat/completions(支持 stream)。Cherry Studio、Dify、自研客户端只要配一个sk-开头的 Key 就能接进来;Key 在后台按用户和租户发放,权限校验、工具调用、聊天记录落库与网页端完全一致。 - MCP:
App/WebApiMcp提供 MCP 服务端,配置里也支持把现有 HTTP 接口包装成 MCP 工具,或把外部 MCP 服务接成智能体工具。
工程化
- 25 个可插拔模块:每个能力一个 csproj,通过
IModuleInitializer/IModuleConfigTasks自行注册,加能力不用改入口文件。 - 代码生成器:按实体一键生成仓储接口、仓储实现、服务接口、服务实现与控制器。
- 测试:xUnit 单元测试 + 集成测试,共享测试基础设施。
- 容器化:
App/WebApi/Dockerfile可直接构建镜像。
|
架构
各层通过自己的 ModuleInitializer 暴露注册逻辑,由上层统一调用完成 DI 装配:WebApi 只负责启动与管道,业务契约留在 Domain,实现落在 Application 与 RepositorieRps。
目录
| 路径 | 内容 |
|---|---|
App/ | 业务应用:Domain、Application、RepositorieRps、WebApi、WebApiMcp |
Kevin/ | 框架核心:EF Core(含慢查询拦截器)、Web 基础组件、25 个可插拔模块 |
vue/kevin.web.vue/ | Vue 3 + Ant Design Vue 管理后台 |
Test/ | xUnit 单元测试、集成测试、共享测试基础设施 |
Doc/ | 截图与文档资源 |
InitData/ | logo(svg + png)与省市区镇等初始化数据 |
快速开始
你需要准备
| 项 | 说明 |
|---|---|
| .NET SDK | 10.0+ |
| Node.js | 16+,只跑管理后台时需要 |
| MySQL | 8.0+,建议 utf8mb4 |
| Redis | 7.0+,缓存、Hangfire、SignalR 都用它 |
| Qdrant | 1.7+,知识库与记忆功能需要 |
| 模型服务 | 任意 OpenAI 协议兼容服务——OpenAI / 智谱 / DeepSeek / 通义等云端 API,或 Ollama 等本地部署,有一个即可 |
1. 克隆代码
git clone https://gitee.com/netkevin-li/NetCoreKevin.git
cd NetCoreKevin
dotnet restore
GitHub 镜像:github.com/junkai-li/N…
2. 配置连接串
编辑 App/WebApi/appsettings.json:
{
"ConnectionStrings": {
"dbConnection": "server=127.0.0.1;port=3306;database=kevin_app;user id=root;password=admin123",
"redisConnection": "127.0.0.1:6379,DefaultDatabase=0,password=123456"
}
}
同一个文件里还有 Hangfire、Consul、对象存储、模型服务等配置,按需覆盖;appsettings.Development.json 会覆盖同名项。
3. 初始化数据库
Visual Studio 的程序包管理控制台,默认项目选 Kevin.EntityFrameworkCore,启动项目选 App.WebApi:
Update-Database
或者用 CLI:
dotnet ef database update --project Kevin/Kevin.EntityFrameworkCore --startup-project App/WebApi
[!TIP] 仓库里已经带了历次迁移记录,全新库直接
Update-Database即可。只有改了实体才需要先Add-Migration "你的改动"再更新。
4. 启动后端
dotnet run --project App/WebApi
launchSettings.json 里已经指定 ASPNETCORE_ENVIRONMENT=Development 与 http://localhost:9901。
5. 启动管理后台
cd vue/kevin.web.vue
npm install
npm run serve
开发服务器已把 /VarApi 反向代理到 http://localhost:9901,不需要额外配跨域。
访问地址
| 服务 | 地址 |
|---|---|
| API | http://localhost:9901 |
| Swagger | http://localhost:9901/swagger |
| Hangfire 面板 | http://localhost:9901/pchangfire |
| 管理后台 | http://localhost:8080 |
Hangfire 面板默认走 Basic Auth,账号密码取 appsettings.json 的 HangfireSetting.userSetting(默认 admin / admin)。
默认账户
| 用户名 | 密码 | 租户 |
|---|---|---|
| admin | 123456 | 1000 |
[!WARNING] 以上都是本地开发默认值。上线前请替换数据库密码、
Jwt.Key、Hangfire 账号,以及AESInfo的 Key / IV——Key 与 IV 必须是 16/24/32 与 16 字节,且一旦变更,历史密文将无法解密。
AI 能力配置
1. 启动 Qdrant
docker run -d --name qdrant -p 6333:6333 -v qdrant_storage:/qdrant/storage qdrant/qdrant
QdrantClientSetting 默认指向 localhost,本机跑的话不用改。
2. 配置模型
向量模型与对话模型在后台「模型管理」里配,也可以直接改 appsettings.json。模型接入走 OpenAI 协议:只要服务商提供 OpenAI 兼容接口,填好地址、模型名和 Key 就能用——OpenAI、智谱、DeepSeek、通义、Kimi、vLLM、Ollama 都在支持范围内。下面以智谱和 Ollama 为例:
云端服务(以智谱为例,注册地址;换成其它 OpenAI 兼容服务的地址和 Key 即可):
{
"OllamaApiSetting": {
"Url": "https://open.bigmodel.cn/api/paas/v4/embeddings",
"DefaultModel": "embedding-3",
"ApiKey": "your-api-key"
}
}
Ollama(本地,原生接口不传 ApiKey):
{
"OllamaApiSetting": {
"Url": "http://localhost:11434/api/embeddings",
"DefaultModel": "qwen3:4b"
}
}
重排模型走 AliRerankApiSetting(默认 qwen3-rerank),不配也能用,只是检索结果不做二次排序。
3. 跑通第一个智能体
- 登录后台,进入模型管理,配置对话模型与向量模型。
- 新建知识库,选择向量模型(维度需与
QdrantClientSetting.MemoryEmbeddingSize一致,默认 2048),上传文档等待向量化完成。 - 新建智能体:选对话模型,绑知识库,按需勾选技能与记忆。
- 新建对话,开始聊。
4. 用 Ollama 跑本地模型(可选)
- 支持 macOS、Windows、Linux 与 Docker 部署,官方下载:ollama.com/download
- 硬件建议:4 核以上 CPU、16GB 以上内存、足够的磁盘空间;想跑大模型或微调再上 NVIDIA GPU。
- 拉一个能跑得动的小模型先试:
ollama run qwen3:4b
然后在后台把对话模型的地址指向 http://localhost:11434。
5. 自动任务(Hangfire)
默认以 Redis 作为 Hangfire 存储,注入方式可在 Kevin.Hangfire/ServiceCollectionExtensions 里调整。
继承 IModuleConfigTasks 实现 ConfigTasks,任务会在启动时自动注册,并且可以直接调用应用服务:
/// <summary>
/// AIKmssTasks 配置任务设置
/// </summary>
public class AIKmssModuleConfigTasks : IModuleConfigTasks
{
/// <summary>
/// 配置任务
/// </summary>
public Task<bool> ConfigTasks(IRecurringJobManager recurringJobManager)
{
recurringJobManager.AddOrUpdate<IAIKmssService>(
recurringJobId: "每6分钟检测是否有AI文档知识库需要处理", // 唯一 ID,后续修改或删除都用它
(s) => s.ProcessKmssVectorData(default),
"0 0/6 0/1 * * ? ",
new RecurringJobOptions
{
TimeZone = TimeZoneInfo.Local, // 指定时区,默认 UTC
}
);
return Task.FromResult(true);
}
}
项目结构
kevin.abp.core/
├── App/ # 业务应用
│ ├── Application/ # 应用服务层
│ ├── Domain/ # 领域层
│ ├── RepositorieRps/ # 仓储实现
│ ├── AppShare/ # 跨层共享 DTO
│ ├── WebApi/ # API 入口
│ └── WebApiMcp/ # MCP 服务端
├── Kevin/ # 框架核心
│ ├── Application/ # 核心服务(含 AI)
│ ├── Domain/ # 核心领域模型
│ ├── Kevin.EntityFrameworkCore/ # EF Core 实现(含慢查询拦截器、迁移)
│ ├── Kevin.Web.Basics/ # Web 基础组件(控制器、全局过滤器)
│ ├── RepositorieRps/ # 核心仓储实现
│ ├── kevin.Share/ # 共享 DTO、枚举、常量
│ └── kevin.Module/ # 可插拔模块(25 个)
│ ├── kevin.AI.AgentFramework/ # 智能体框架
│ ├── Kevin.RAG/ # 检索增强(Qdrant / Ollama / Rerank)
│ ├── Kevin.Authentication.Jwt/ # JWT 认证
│ ├── kevin.Permission/ # RBAC 权限
│ ├── kevin.Cache/ # 缓存
│ ├── Kevin.Hangfire/ # 任务调度
│ ├── Kevin.SignalR/ # 实时通信
│ ├── kevin.Cap/ · kevin.RabbitMQ/ # 消息总线
│ ├── Kevin.SMS/ · Kevin.Email/ · kevin.FileStorage/
│ ├── kevin.DistributedLock/ · Kevin.SnowflakeId/
│ └── ... # ASR、Consul、代码生成器等
├── Test/ # 测试套件
│ ├── Kevin.Web.Test/ # 单元测试(xUnit)
│ ├── Kvin.Integration.Tests/ # 集成测试
│ └── Testing.Shared/ # 共享测试基础设施
├── vue/kevin.web.vue/ # 管理后台(Vue 3 + Ant Design Vue)
├── Doc/ # 文档与截图
└── InitData/ # 初始化数据
功能模块
| 模块 | 功能 | 状态 |
|---|---|---|
| 用户 / 角色 / 权限 | 用户 CRUD、角色 CRUD、菜单与 API 权限点 | ✅ |
| 多租户 | 一库多租户、租户级数据隔离 | ✅ |
| AI 智能体 | 智能对话、工具调用、多智能体协同、上下文压缩 | ✅ |
| 知识库 | 文档上传、切分向量化、RAG 检索与重排 | ✅ |
| 技能(Skill) | 在线编辑、动态启停、脚本执行、地址白名单校验 | ✅ |
| 记忆 | 租户 + 智能体 + 用户三维隔离 | ✅ |
| 多模态 | 图片理解、语音转写、文生图 | ✅ |
| OpenAI 兼容 | /v1/models、/v1/chat/completions、Key 管理 | ✅ |
| 任务调度 | Hangfire 定时任务与面板 | ✅ |
| Token 额度 | 月度额度颁发、请求扣减 | ✅ |
| 文件存储 | 腾讯云 / 阿里云 / 七牛 | ✅ |
| 消息服务 | 钉钉消息、站内 SignalR 推送 | ✅ |
现状与不足
坦白说,下面这些是使用前应该知道的事实:
- 向量维度绑定模型:
MemoryEmbeddingSize默认 2048,对应智谱embedding-3;换 embedding 模型要同步改维度并重建集合,否则检索会报维度不匹配。 - 模型 Key 要自备:
OllamaApiSetting、AliRerankApiSetting、AliyunAsr、DoubaoSearchApiSetting默认留空或指向智谱示例,没配的能力不可用,也不会伪造结果。 - 迁移不会自动跑:项目没有启动时自动迁移,升级代码后要自己
Update-Database。 - 外部服务要自己开通:短信、邮件、对象存储的密钥默认是空值,用到时再去
appsettings.json填。 - 一键部署还没做:
docker-compose.yml目前是空文件,MySQL、Redis、Qdrant 需要自己准备,本地起三个容器即可。 - 前端构建链偏旧:Vue CLI 5(webpack),还没迁到 Vite。
- AI 默认值按通用场景给:提示词、上下文压缩阈值、工具编排这些默认值不一定适合你的业务,需要按场景调。
文档资源
- 项目 Wiki:快速开始——
.qoder/repowiki/zh/content/下覆盖架构设计、核心模块、开发指南、API 接口、数据库设计、部署运维 - 系统文档:SYSTEM_DOCUMENTATION.md
- 教学专栏:CSDN
- 二次开发教程:基于 NetCoreKevin 新建项目