中文|English

AntSK

使用 .Net 9 + Blazor + Semantic Kernel 打造的 AI 知识库与智能体平台

AntSK 是一个基于 .NET 9 和 Blazor 技术栈构建的企业级 AI 知识库和智能体平台，集成了 Semantic Kernel 和 Kernel Memory，提供完整的 AI 应用开发解决方案。

📋 目录

• ⭐ 核心功能
• 🏗️ 技术架构
• 🔄 系统工作流程
• 🛠️ 技术栈
• 📁 项目结构
• 🚀 特色功能
• ⛪ 应用场景
• ✏️ 功能示例
• ❓ 如何开始
• 🔧 开发指南
• 📊 性能优化建议
• 💕 贡献者
• 🚨 使用协议
• ☎️ 联系我

⭐ 核心功能

• 语义内核 (Semantic Kernel)：采用领先的自然语言处理技术，准确理解、处理和响应复杂的语义查询，为用户提供精确的信息检索和推荐服务。

• 内存内核 (Kernel Memory)：具备持续学习和存储知识点的能力，AntSK 拥有长期记忆功能，累积经验，提供更个性化的交互体验。

• 知识库：通过文档（Word、PDF、Excel、Txt、Markdown、Json、PPT）等形式导入知识库，可以进行知识库问答，支持本地 bge-embedding 向量模型，以及 bge-rerank 重排模型。

• 文生图：集成 StableDiffusion 本地模型，支持文生图功能。

• GPTs 生成：支持创建个性化的 GPT 模型，助您构建专属的 AI 智能体。

• API 接口发布：将内部功能以 API 的形式对外提供，便于开发者将 AntSK 集成进其他应用。

• API 插件系统：开放式 API 插件系统，允许第三方开发者或服务商轻松将其服务集成到 AntSK，增强应用功能。

• .Net 插件系统：开放式 DLL 插件系统，支持开发者将业务功能编译为标准格式的 DLL 进行集成。

• 联网搜索：AntSK 支持联网搜索，实时获取最新信息，确保用户获取的资料总是最及时、最相关的。

• 模型管理：适配和管理不同厂商的模型。支持 llama.cpp 所兼容的 GGUF 格式，以及 LlamaFactory 和 Ollama 运行的离线模型。

• 国产信创：AntSK 支持国产模型和国产数据库，可在信创环境下运行。

• 模型微调：规划中，将基于 LlamaFactory 进行模型微调。

🏗️ 技术架构

graph TB
    subgraph "用户界面层"
        UI[Blazor前端界面]
        API[Web API接口]
    end
    
    subgraph "应用服务层"
        Chat[聊天服务]
        KMS[知识库服务]
        Plugin[插件服务]
        Model[模型管理服务]
        Auth[认证服务]
    end
    
    subgraph "领域核心层"
        SK[Semantic Kernel]
        KM[Kernel Memory]
        Embedding[向量嵌入]
        Function[函数调用]
    end
    
    subgraph "基础设施层"
        DB[(数据库)]
        Vector[(向量数据库)]
        File[文件存储]
        OCR[OCR服务]
        SD[StableDiffusion]
    end
    
    subgraph "AI模型层"
        OpenAI[OpenAI]
        Local[本地模型]
        LlamaFactory[LlamaFactory]
        Ollama[Ollama]
        Spark[讯飞星火]
    end
    
    subgraph "插件系统"
        NetPlugin[.NET插件]
        APIPlugin[API插件]
        FuncPlugin[函数插件]
    end
    
    UI --> Chat
    UI --> KMS
    UI --> Plugin
    UI --> Model
    API --> Auth
    
    Chat --> SK
    KMS --> KM
    Plugin --> Function
    
    SK --> OpenAI
    SK --> Local
    SK --> LlamaFactory
    SK --> Ollama
    SK --> Spark
    
    KM --> Vector
    KM --> Embedding
    
    Chat --> NetPlugin
    Chat --> APIPlugin
    Chat --> FuncPlugin
    
    KMS --> DB
    KMS --> File
    Model --> DB
    
    OCR --> SD
    
    style SK fill:#e1f5fe
    style KM fill:#e8f5e8
    style UI fill:#fff3e0
    style API fill:#fff3e0

🔄 系统工作流程

graph TD
    A[用户输入] --> B{输入类型}
    
    B -->|文档上传| C[文档解析]
    B -->|聊天对话| D[对话处理]
    B -->|API调用| E[API处理]
    
    C --> F[文档分块]
    F --> G[向量化处理]
    G --> H[存储到知识库]
    
    D --> I{是否需要知识库}
    I -->|是| J[知识库检索]
    I -->|否| K[直接调用LLM]
    
    J --> L[向量搜索]
    L --> M[相关性排序]
    M --> N[构建Prompt]
    
    K --> O[LLM推理]
    N --> O
    
    O --> P{是否需要插件}
    P -->|是| Q[插件调用]
    P -->|否| R[生成回复]
    
    Q --> S[执行函数]
    S --> T[合并结果]
    T --> R
    
    E --> U[权限验证]
    U --> V[业务逻辑]
    V --> W[返回结果]
    
    R --> X[用户界面展示]
    W --> X
    
    style A fill:#e1f5fe
    style O fill:#e8f5e8
    style H fill:#fff3e0
    style X fill:#f3e5f5

🛠️ 技术栈

后端技术

• .NET 9: 最新的 .NET 框架，提供高性能和现代化开发体验。
• Blazor Server: 基于服务器端渲染的现代 Web UI 框架。
• Semantic Kernel: 微软开源的 AI 编排框架。
• Kernel Memory: 知识库和向量存储管理。
• SqlSugar: 高性能 ORM 框架，支持多种数据库。
• AutoMapper: 对象映射框架。

AI & ML 技术

• OpenAI GPT: 支持 GPT-3.5/GPT-4 系列模型。
• Azure OpenAI: 企业级 OpenAI 服务。
• 讯飞星火: 科大讯飞大语言模型。
• 阿里云通义千问: 阿里云大语言模型。
• LlamaFactory: 本地模型微调和推理。
• Ollama: 本地模型运行环境。
• Stable Diffusion: 文生图模型。
• BGE Embedding: 中文向量嵌入模型。
• BGE Rerank: 重排序模型。

存储技术

• PostgreSQL: 主数据库存储。
• SQLite: 轻量级数据库支持。
• Qdrant: 向量数据库。
• Redis: 缓存和向量存储。
• Disk/Memory: 本地存储方案。

前端技术

• Ant Design Blazor: 企业级 UI 组件库。
• Chart.js: 数据可视化。
• Prism.js: 代码高亮。

📁 项目结构

AntSK/
├── src/
│   ├── AntSK/                          # 主应用（Blazor Server）
│   │   ├── Components/                 # 自定义组件
│   │   ├── Controllers/                # Web API 控制器
│   │   ├── Pages/                      # Blazor 页面
│   │   │   ├── ChatPage/               # 聊天相关页面
│   │   │   ├── KmsPage/                # 知识库管理