smartai2dian0

大模型 2.0

项目须知

启动项目之前，请先查看项目开发规范。

将项目下载到本地

$ git clone xxxx@xxx.git

# 进入项目目录
$ cd xxxx

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

查看项目开发规范

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

$ npm run doc # localhost:5174

启动项目

$ npm start # localhost:5173

构建项目

$ npm run build

部署到测试环境

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

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

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

操作流程

# 本地构建
$ 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 浏览器环境。参考，此项目也不支持IE 浏览器环境。

相关资源

业务相关资源

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

对话系统参考小数。

在开发具体功能、页面时，应先检查大模型 2.0 改版需求文档，查看是否有相关说明。若有相关说明，则可能需要进一步沟通。

• 旧版小数项目-静态 登录账号：18811881188 验证码：123123
• 对话系统：小数 测试环境 登录账号：user4 密码：123456
• SmartAI 大模型平台 1.0 登录账号：admin 密码: 000000
• 大模型 2.0 改版需求文档
• 大模型 2.0 设计稿 第一版
• 大模型 2.0 设计稿 第二版

测试环境

• 内网测试环境地址：http://192.168.20.119:9303
• 外网测试环境地址：http://smartai.com:8293

技术相关资源

• vuejs
• vue-router
• pinia
• vue-i18n
• axios
• arco.design