 ![logo.png](https://developer.qcloudimg.com/http-save/yehe-2532455/5dce7417469b6bb0efa883376a62ca04.png)

# 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 智能体中台」的场景：多租户、登录鉴权、权限点、审计日志、定时任务、模型接入这些地基已经铺好，你只需要接自己的业务数据和业务系统。如果你只是想调一次大模型接口，这个仓库对你来说太重了。

 ![3.png](https://developer.qcloudimg.com/http-save/yehe-2532455/306e313e9c1f36a66b08750047e80ae1.png)


## 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` 可直接构建镜像。

 |

## 架构

![mermaid diagram](https://developer.qcloudimg.com/http-save/yehe-2532455/4c68d39d3129e541cb090b3a80d10666.png)

各层通过自己的 `ModuleInitializer` 暴露注册逻辑，由上层统一调用完成 DI 装配：`WebApi` 只负责启动与管道，业务契约留在 `Domain`，实现落在 `Application` 与 `RepositorieRps`。

## 目录

| 路径 | 内容 |
|---|---|
| [`App/`](App/) | 业务应用：Domain、Application、RepositorieRps、WebApi、WebApiMcp |
| [`Kevin/`](Kevin/) | 框架核心：EF Core（含慢查询拦截器）、Web 基础组件、25 个可插拔模块 |
| [`vue/kevin.web.vue/`](vue/kevin.web.vue/) | Vue 3 + Ant Design Vue 管理后台 |
| [`Test/`](Test/) | xUnit 单元测试、集成测试、共享测试基础设施 |
| [`Doc/`](Doc/) | 截图与文档资源 |
| [`InitData/`](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. 克隆代码

```bash
git clone https://gitee.com/netkevin-li/NetCoreKevin.git
cd NetCoreKevin
dotnet restore
```

GitHub 镜像：<https://github.com/junkai-li/NetCoreKevin>

### 2. 配置连接串

编辑 `App/WebApi/appsettings.json`：

```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`：

```powershell
Update-Database
```

或者用 CLI：

```bash
dotnet ef database update --project Kevin/Kevin.EntityFrameworkCore --startup-project App/WebApi
```

> [!TIP]
> 仓库里已经带了历次迁移记录，全新库直接 `Update-Database` 即可。只有改了实体才需要先 `Add-Migration "你的改动"` 再更新。

### 4. 启动后端

```bash
dotnet run --project App/WebApi
```

`launchSettings.json` 里已经指定 `ASPNETCORE_ENVIRONMENT=Development` 与 `http://localhost:9901`。

### 5. 启动管理后台

```bash
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

```bash
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 为例：

**云端服务（以智谱为例，[注册地址](https://open.bigmodel.cn)；换成其它 OpenAI 兼容服务的地址和 Key 即可）：**

```json
{
  "OllamaApiSetting": {
    "Url": "https://open.bigmodel.cn/api/paas/v4/embeddings",
    "DefaultModel": "embedding-3",
    "ApiKey": "your-api-key"
  }
}
```

**Ollama（本地，原生接口不传 ApiKey）：**

```json
{
  "OllamaApiSetting": {
    "Url": "http://localhost:11434/api/embeddings",
    "DefaultModel": "qwen3:4b"
  }
}
```

重排模型走 `AliRerankApiSetting`（默认 `qwen3-rerank`），不配也能用，只是检索结果不做二次排序。

### 3. 跑通第一个智能体

1. 登录后台，进入模型管理，配置对话模型与向量模型。
2. 新建知识库，选择向量模型（维度需与 `QdrantClientSetting.MemoryEmbeddingSize` 一致，默认 2048），上传文档等待向量化完成。
3. 新建智能体：选对话模型，绑知识库，按需勾选技能与记忆。
4. 新建对话，开始聊。
 

### 4. 用 Ollama 跑本地模型（可选）

- 支持 macOS、Windows、Linux 与 Docker 部署，官方下载：<https://ollama.com/download>
- 硬件建议：4 核以上 CPU、16GB 以上内存、足够的磁盘空间；想跑大模型或微调再上 NVIDIA GPU。
- 拉一个能跑得动的小模型先试：

```bash
ollama run qwen3:4b
```

然后在后台把对话模型的地址指向 `http://localhost:11434`。


### 5. 自动任务（Hangfire）

默认以 Redis 作为 Hangfire 存储，注入方式可在 `Kevin.Hangfire/ServiceCollectionExtensions` 里调整。

继承 `IModuleConfigTasks` 实现 `ConfigTasks`，任务会在启动时自动注册，并且可以直接调用应用服务：

```csharp
/// <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/快速开始.md)——`.qoder/repowiki/zh/content/` 下覆盖架构设计、核心模块、开发指南、API 接口、数据库设计、部署运维
- **系统文档**：[SYSTEM_DOCUMENTATION.md](SYSTEM_DOCUMENTATION.md)
- **教学专栏**：[CSDN](https://blog.csdn.net/weixin_42629287/category_13037923.html)
- **二次开发教程**：[基于 NetCoreKevin 新建项目](https://gitee.com/netkevin-li/ainet)

企业级 AI 智能体中台：.NET 10 做后端，Vue 3 做管理后台，知识库、技能、记忆、额度都在界面上配。

人工智能

后端

前端

消息队列

单元测试

文件存储

对象存储

服务器

数据库

Windows

Docker

容器

短信

Python

GitHub

Linux

Redis

MySQL

PaaS

SaaS

JSON

让每一个 Agent，都跑在云上

语音产品特惠新用户14.9元起


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

企业级 AI 智能体中台：.NET 10 做后端，Vue 3 做管理后台，知识库、技能、记忆、额度都在界面上配。-腾讯云开发者社区-腾讯云

企业级 AI 智能体中台：.NET 10 做后端，Vue 3 做管理后台，知识库、技能、记忆、额度都在界面上配。

企业级 AI 智能体中台：.NET 10 做后端，Vue 3 做管理后台，知识库、技能、记忆、额度都在界面上配。

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐