​
PIG AI 集成指南

环境要求：

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

​
快速集成

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

​
1. 后端集成

​
源码改动

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

​
目录结构示意

├── pigx-common
│   ├── pigx-common-bom
│   │   └── pom.xml   # 新增了依赖，注意在全局公共依赖定义版本
├── pigx-knowledge
│   ├── Dockerfile
│   ├── pom.xml
│   ├── src
│   │   └── main
│   │       ├── java
│   │       └── resources

​
特殊调整

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

  • Chat2BI 问数功能：如需使用 AI 智能分析数据功能，需要更新 pigx-codegen 代码生成模块。该模块相对独立，可直接用 PIG AI 中的 pigx-codegen 替换您当前项目中的同名模块。

​
2. 前端集成

​
步骤

  1. 从 pigx-ai-ui 项目中复制所需文件到你的前端项目
  2. 合并 package.json 依赖
    • 仅添加新增的依赖，不要覆盖现有配置

​
需要复制的目录结构

├── public
│   └── bot                 # AI 机器人相关资源
├── src
│   ├── components
│   │   └── AiEditor        # 新增的 AI 编辑器源码
│   ├── api
│   │   └── knowledge       # AI 相关 API 接口
│   │       ├── aiBill.ts
│   │       ├── aiChatRecord.ts
│   │       ├── aiDataset.ts
│   │       ├── aiDocument.ts
│   │       ├── aiEmbedStore.ts
│   │       ├── aiFunc.ts
│   │       ├── aiGen.ts
│   │       ├── aiModel.ts
│   │       ├── aiPrompt.ts
│   │       ├── aiSlice.ts
│   │       └── ocr.ts
│   └── views
│       └── knowledge       # AI 功能页面组件
│           ├── aiBill
│           ├── aiChat
│           ├── aiChatRecord
│           ├── aiDataset
│           ├── aiDocument
│           ├── aiEmbedStore
│           ├── aiFunc
│           ├── aiModel
│           ├── aiPrompt
│           ├── aiSlice
│           └── ocr
└── package.json           # 项目依赖配置文件

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