JLC Docs
PIG
AI
PIG
AI

PIG AI 集成指南

环境要求

仅支持 PIGX 5.X 及以上版本，进行源码集成。PIG AI 技术栈：SpringBoot 3 + JDK 17 + Vue 3

快速集成

本指南将帮助你将 PIG AI 功能快速集成到现有的 PIGX 5.X 项目中。集成过程分为后端和前端两部分。

特别说明

本章节只会介绍涉及 AI 的部分，请具备 PIGX 的基础。PIGX 服务端模块说明

1. 后端集成

源码改动

  1. 将 pigx-aigc 模块复制到你的现有项目中
  2. 检查并补充依赖，如发现缺少依赖，请从最新的 PIGX-AI 版本的 common 模块中复制相关依赖

目录结构示意

├── pigx-common
│   ├── pigx-common-bom       # 统一管理依赖版本
│   ├── pigx-common-neo4j     # Neo4j 图数据库支持
│   ├── pigx-common-milvus    # Milvus 向量数据库支持
│   ├── pigx-common-seekdb    # SeekDB 向量数据库支持
│   └── pigx-common-mcp       # MCP 协议支持
├── pigx-aigc                 # AI 核心模块（原 pigx-knowledge）
│   ├── pigx-aigc-api         # 公共 API 模块（实体、DTO、Feign 客户端）
│   ├── pigx-aigc-biz         # 业务逻辑模块（Controller、Service、Mapper）
│   ├── Dockerfile
│   └── pom.xml

特殊调整

  • 文件存储功能：PIG AI 使用了增强版的文件存储能力，需要更新 SysFileController 相关接口代码。请确保使用 PIG AI 版本中的文件控制器实现，以支持 AI 相关的文件处理需求。

2. 前端集成

步骤

  1. 从 pigx-ai-ui 项目中复制所需文件到你的前端项目
  2. 合并 package.json 依赖
依赖合并注意事项

仅添加新增的依赖，不要覆盖现有配置

需要复制的目录结构

├── public
│   └── bot                       # AI 机器人相关静态资源
├── src
│   ├── components
│   │   ├── AiEditor              # AI 富文本编辑器组件
│   │   └── AiDocumentEditor      # AI 文档编辑器组件
│   ├── api
│   │   └── knowledge             # AI 相关 API 接口
│   │       ├── aiBill.ts         # 账单管理
│   │       ├── aiChatRecord.ts   # 对话记录
│   │       ├── aiCodeReview.ts   # 代码评审
│   │       ├── aiData.ts         # 数据管理
│   │       ├── aiDataField.ts    # 数据字段
│   │       ├── aiDataset.ts      # 数据集管理
│   │       ├── aiDatasetUser.ts  # 数据集用户
│   │       ├── aiDatasource.ts   # 数据源管理
│   │       ├── aiDataTable.ts    # 数据表管理
│   │       ├── aiDocument.ts     # 文档管理
│   │       ├── aiEmbedStore.ts   # 向量存储
│   │       ├── aiFlow.ts         # AI 工作流
│   │       ├── aiFunc.ts         # 函数工具
│   │       ├── aiGen.ts          # 代码生成
│   │       ├── aiMcpConfig.ts    # MCP 配置
│   │       ├── aiModel.ts        # 模型管理
│   │       ├── aiOpsInspection.ts# 运维巡检
│   │       ├── aiPoster.ts       # 海报生成
│   │       ├── aiPromptTemplate.ts # 提示词模板
│   │       ├── aiProofreading.ts # 文档校对
│   │       ├── aiReportConf.ts   # 报表配置
│   │       ├── aiSecurity.ts     # 安全管理
│   │       ├── aiSkills.ts       # 技能管理
│   │       ├── aiSlice.ts        # 切片管理
│   │       ├── aiTerminology.ts  # 术语管理
│   │       ├── aiWritter.ts      # AI 写作
│   │       ├── dashboard.ts      # 数据看板
│   │       ├── documentConvert.ts# 文档转换
│   │       ├── html2Docx.ts      # HTML 转 Word
│   │       ├── ocr.ts            # OCR 识别
│   │       ├── storage.ts        # 存储管理
│   │       └── storageGroup.ts   # 存储分组
│   └── views
│       └── knowledge             # AI 功能页面组件
│           ├── aiBill            # 账单管理
│           ├── aiChat            # 智能对话
│           ├── aiChatRecord      # 对话记录
│           ├── aiCodeReview      # 代码评审
│           ├── aiData            # 数据管理
│           ├── aiDataset         # 数据集管理
│           ├── aiDatasource      # 数据源管理
│           ├── aiDataTable       # 数据表管理
│           ├── aiDocument        # 文档管理
│           ├── aiEditor          # AI 编辑器
│           ├── aiEmbedStore      # 向量存储
│           ├── aiFlow            # AI 工作流
│           ├── aiMcpConfig       # MCP 配置
│           ├── aiModel           # 模型管理
│           ├── aiOpsInspection   # 运维巡检
│           ├── aiPoster          # 海报生成
│           ├── aiPromptTemplate  # 提示词模板
│           ├── aiProofreading    # 文档校对
│           ├── aiReport          # 报表管理
│           ├── aiSecurity        # 安全管理
│           ├── aiSkills          # 技能管理
│           ├── aiSlice           # 切片管理
│           ├── aiStorage         # 存储管理
│           ├── aiTerminology     # 术语管理
│           ├── aiWritter         # AI 写作
│           └── ocr               # OCR 识别
└── package.json                  # 项目依赖配置文件
集成完成

完成以上步骤后，重启项目即可使用 PIG AI 的全部功能。如遇到问题，请查看控制台日志。

本页目录