NetCoreKevin

是基于 .NET 9 构建的企业级 AI中台智能体 SaaS 前后端分离架构，集成了 AI 知识库智能体、多智能体协同、聊天记录压缩策略、Skill技能管理、本地离线AI模型调用、智能体技能可控加载、AI联网搜索、智能体权限管控、一库多租户、分布式系统、微服务架构等核心能力。

📷 功能效果图

AI 智能体技能工具管理

动态管理	智能体配置	对话交互

多智能体协同和聊天记录压缩策略

多智能体动态配置管理	压缩策略配置	对话交互

Skill动态管理

界面管理	在线编辑	动态配置

AI 知识库系统

知识库管理	文档上传	智能问答

AI 智能体技能

技能列表	技能配置	技能执行

AI 智能体自动任务调度

任务列表	任务配置	执行记录

后台管理系统 (Vue3 + AntDesign)

用户管理	角色管理	权限管理	系统配置

✨ 技术亮点

🚀 快速开始

环境要求

• .NET SDK 9.0+
• Node.js 16+（前端）
• MySQL 8.0+
• Redis 7.0+
• Qdrant 1.7+（AI 功能）

配置步骤

1. 配置数据库连接

编辑 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"
  }
}

2. 初始化数据库

在 程序包管理控制台 执行：

# 选择 Kevin.EntityFrameworkCore 项目
Add-Migration "初始化数据库"
Update-Database

3. 启动后端

cd App/WebApi
dotnet run --environment Development

4. 启动前端（可选，管理后台）

cd vue/kevin.web.vue
npm install
npm run serve

前端开发服务器已将 /VarApi 反向代理到后端 http://localhost:9901，无需额外配置跨域。

5. 访问地址

默认账户

🧠 AI 智能体配置

AI智能体教程

• 第一步
• 请先完成上手教程在进行AI智能体教程
• 第二步
• 下载安装Qdrant--官网有教程 安装后配置json文件QdrantClientSetting 默认是localhost不需要动的
• 第三步
• 注册AI账户 教程以智谱AI为例 去[官网](https://open.bigmodel.cn)注册登录后获取APIKey
• 第四步
• 配置向量模型和对话模型默认如下

• 第五步
• 新建知识库选择向量模型(如果不选择请在json配置中配置)2048（默认）：最高精度，适合对准确性要求极高的场景===》配置智能体==》新建对话就OK了

🧰基于Ollama部署本地模型

• Ollama 支持多种操作系统，包括 macOS、Windows、Linux 以及通过 Docker 容器运行。
• Ollama 对硬件要求不高，旨在让用户能够轻松地在本地运行、管理和与大型语言模型进行交互。
• CPU：多核处理器（推荐 4 核或以上）。
• GPU：如果你计划运行大型模型或进行微调，推荐使用具有较高计算能力的 GPU（如 NVIDIA 的 CUDA 支持）。
• 内存：至少 8GB RAM，运行较大模型时推荐 16GB 或更高。
• 存储：需要足够的硬盘空间来存储预训练模型，通常需要 10GB 至数百 GB 的空间，具体取决于模型的大小。
• Ollama 官方下载地址：https://ollama.com/download
• 1.安装后运行模型 可根据电脑配置自由选择模型 可以使用qwen3:4b来进行测试
• ollama run qwen3:4b
• 系统配置如下

自动任务配置（Hangfire）

默认基于redis方式注册Hangfire可在Kevin.Hangfire.ServiceCollectionExtensions自行添加或调整注入方式

1.继承IModuleConfigTasks类实现ConfigTasks会在项目启动时自动注册任务，并且自动任务可以基于接口类直接调用应用服务

    /// 

    /// AIKmssTasks配置任务设置
    /// 

    public class AIKmssModuleConfigTasks : IModuleConfigTasks
    {  
        /// 

        /// 配置任务
        /// 

        public Task ConfigTasks(IRecurringJobManager recurringJobManager)
        {
            recurringJobManager.AddOrUpdate(
                recurringJobId: "每6分钟检测是否有AI文档知识库需要处理",      // 唯一的 ID，用于后续修改或删除
                (s) => s.ProcessKmssVectorData(default),
                "0 0/6 0/1 * * ? ", new RecurringJobOptions
                {
                    TimeZone = TimeZoneInfo.Local,        // 指定时区（默认UTC） 
                }
            );
            return Task.FromResult(true);
        } 
    }

1. 安装 Qdrant

# 使用 Docker 启动 Qdrant
docker run -p 6333:6333 qdrant/qdrant

2. 配置 AI 模型

智谱 AI：

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

Ollama 本地模型：

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

3. 使用流程

1. 注册 AI 账户获取 API Key
2. 在系统中配置模型
3. 创建知识库并上传文档
4. 配置智能体并绑定技能
5. 开始智能对话

📁 项目结构

kevin.abp.core/
├── App/                    # 业务应用模块
│   ├── Application/        # 应用服务层
│   ├── Domain/             # 领域层
│   ├── RepositorieRps/     # 仓储实现
│   └── WebApi/             # API 入口
├── Kevin/                  # 核心框架模块
│   ├── Application/        # 核心服务
│   │   └── Services/AI/    # AI 相关服务
│   ├── Domain/             # 核心领域模型
│   ├── Kevin.EntityFrameworkCore/  # EF Core 实现（含慢查询拦截器）
│   ├── Kevin.Web.Basics/   # Web 基础组件（控制器、全局过滤器）
│   ├── RepositorieRps/     # 核心仓储实现
│   ├── kevin.Share/        # 共享 DTO、枚举、常量
│   └── kevin.Module/       # 可插拔功能模块
│       ├── kevin.AI.AgentFramework/  # AI 智能体框架
│       ├── Kevin.RAG/      # RAG 检索增强（Qdrant/Ollama/Rerank）
│       ├── Kevin.Authentication.Jwt/ # JWT 认证
│       ├── kevin.Permission/         # RBAC 权限
│       ├── kevin.Cache/              # 缓存
│       ├── Kevin.Hangfire/           # 任务调度
│       ├── Kevin.SignalR/            # 实时通信
│       └── ...             # 短信、邮件、雪花ID、分布式锁等 30+ 模块
├── Test/                   # 测试套件
│   ├── Kevin.Web.Test/     # 单元测试（xUnit）
│   ├── Kvin.Integration.Tests/  # 集成测试
│   └── Testing.Shared/     # 共享测试基础设施
├── vue/kevin.web.vue/      # 前端管理后台（Vue3 + Ant Design Vue）
├── Doc/                    # 文档资源
└── InitData/               # 初始化数据

🛠️ 功能模块

📖 文档资源

• 项目 Wiki: 项目解析以及详细教程 —— 位于 .qoder/repowiki/zh/content/，涵盖架构设计、核心模块、开发指南、API 接口文档、部署运维等全套文档
• 快速入门详细文档: SYSTEM_DOCUMENTATION.md
• 教学文档: CSDN 专栏
• 新项目教程: 基于 NetCoreKevin 二次开发

🤝 交流社区

微信	交流群

📊 Star History

版本: v1.1（代码审查治理版）
License: MIT
维护者: NetCoreKevin 开发团队