# 大模型 2.0

## 项目须知

该分支为最早 116 大模型 2.0 版本，仍使用 socket，后续仅服务于上海版本
启动项目之前，请先查看`项目开发规范`。

### 将项目下载到本地

```bash
$ git clone xxxx@xxx.git

# 进入项目目录
$ cd xxxx

# 安装项目所需依赖
$ npm install
```

### 查看项目开发规范

项目规范约定了一些开发过程中需要遵守的一些规则，有助于项目的`可持续性`、`可维护性`。

```bash
$ npm run doc # localhost:5174
```

### 启动项目

```bash
$ npm start # localhost:5173
```

### 构建项目

```bash
$ npm run build
```

### 部署到测试环境

该项目的部署已经与自动化部署集成，只是由于`gitlab`所在服务器环境影响，此项目的部署为`半自动`部署，核心流程如下：

1. 本地开发机器上进行构建: `npm run build`
2. `gitlab`服务器进行`dist`文件发布

> 注意：`dist`目录需要被`git`进行追踪。

**操作流程**

```bash
# 本地构建
$ npm run build
# 本地构建中...
# .......
# 构建结束 本地开发机器上已存在构建后（更新后）的 dist 目录

# 将本地更改提交到git仓库
$ git add
$ git commit -m 'build: 测试环境部署'
$ git push
```

> 另外：部署时应注意保证关联项目正常，参阅下方`关联项目`。

## 关联项目

此项目通过`微前端`、`iframe` 等方式`嵌入了`其他几个相关项目，涉及到的项目如下：

- 小数(无界微前端嵌入) 可通过路由`/xiaoshu`访问。
- dify(iframe 嵌入) 可通过`智能体`菜单查看，对于`dify`类型的智能体，进入`智能体详情`，可以看到嵌入的 `dify` 页面。
- ragflow(接口调用，非页面嵌入) 此项目中，智能体管理时，调用了`ragflow`的一些接口。在`知识库管理`、`智能体管理`部分存在相关接口调用。

此项目涉及到`ragflow`和`dify`的接口如下：

- `ragflow`接口：知识库管理所有接口、智能体管理中`知识问答助理`所有接口，
- `dify`接口：智能体管理中，`聊天助手`、`智能Agent`、`工作流应用`所有接口。

对于环境`http://192.168.20.119:9303/`，与此相关的项目路径如下：

- 小数 `http://smartai.com:8401/`
- ragflow `http://smartai.com:8294`
- dify `http://smartai.com:8295`

> 可从配置文件`public/config.js`文件中查看相关路径

`smartai2.0`项目部署前，应保证关联的这几个项目部署无误。如果`smartai2.0`项目在运行过程中出现了异常，尤其是上面提到的几个关键位置，在排错时，应该考虑与此关联的项目。

由于`dify`是通过服务端渲染的方式开发，使用微前端嵌入过程中出现了一些棘手的问题，故采用`iframe`的方式嵌入，为了嵌入成功，对 dify 源码做了部分更改，更改内容可查看`/docs/other-platform-dify.md`中的记录。部署时，应和`dify`管理人员确定无误。如果在后续对`dify`做了新的调整，也应该在`/docs/other-platform-dify.md`中进行补充记录。

## 兼容与支持程度

注意：由于 `Vue3` 不再支持 `IE 浏览器`环境，`ArcoVue` 也不再支持 `IE 浏览器`环境。[参考](https://arco.design/vue/docs/start#Vue-%E7%89%88%E6%9C%AC)，此项目也不支持`IE 浏览器`环境。

## 相关资源

### 业务相关资源

`权限系统`、`智能体管理`、`知识库管理`在`SmartAI 大模型平台 1.0`都能找到对应的页面，交互方面可做参考。

`对话系统`参考`小数`。

在开发具体功能、页面时，应先检查[大模型 2.0 改版需求文档](https://note.youdao.com/ynoteshare/index.html?id=079cd5646c91c18c347505fb271d0e19&type=note&_time=1733222191533)，查看是否有相关说明。若有相关说明，则可能需要进一步沟通。

- [旧版小数项目-静态](http://47.97.223.247/) 登录账号：`18811881188` 验证码：`123123`
- [对话系统：小数 测试环境](http://192.168.20.119:9301/) 登录账号：`user4` 密码：`123456`
- [SmartAI 大模型平台 1.0](http://192.168.20.116:8103/#/knowledgeLib) 登录账号：`admin` 密码: `000000`
- [大模型 2.0 改版需求文档](https://note.youdao.com/ynoteshare/index.html?id=079cd5646c91c18c347505fb271d0e19&type=note&_time=1733222191533)
- [大模型 2.0 设计稿 第一版](https://www.figma.com/design/qV5j9okRkPQZ5HXbTq2EMl/SmartAl%E5%A4%A7%E6%A8%A1%E5%9E%8B%E5%B9%B3%E5%8F%B0?node-id=0-1&t=PQswrqVcnsLWyUZ2-1)
- [大模型 2.0 设计稿 第二版](https://www.figma.com/design/mnOQvzIeYeof8vv520qAvL/%E5%A4%A7%E6%A8%A1%E5%9E%8B2.0?node-id=0-1&node-type=canvas&t=xiXMAJnMYHJ8gPEA-0)

### 测试环境

- 内网测试环境地址：[http://192.168.20.119:9303](http://192.168.20.119:9303)
- 外网测试环境地址：[http://smartai.com:8293](http://smartai.com:8293)

### 技术相关资源

- [vuejs](https://cn.vuejs.org/)
- [vue-router](https://router.vuejs.org/zh/)
- [pinia](https://pinia.vuejs.org/zh/)
- [vue-i18n](https://www.npmjs.com/package/vue-i18n)
- [axios](https://github.com/axios/axios)
- [arco.design](https://arco.design/)