Dify工具使用全场景:dify-web修改编译指南(源码解读篇·第1期)

我的场景

最近一直在研究dify怎么用,怎么用好,要想研究深了,还是得看源码,首先就是要把界面改改,当前的界面太素了,不了解web源码,没法改。所以静下来看了看源码,发现也不难,正好给大家也分享一下修改过程 。

下载源码

github 地址:
https://github.com/langgenius/dify

下载到本地,通过工具打开源码,如下图:

进入dify的web目录:

先安装依赖:

yarn install

下载完后运行:

yarn dev

先测试能否正常启动,这里前提你得安装nodejs。

如果能正常不启动,则可以开始修改源码了,这里只做一下验证,具体要怎么修改,则看每个人自己的需求了。

我现在想在头部增加一个“天工开智镜”的文字,首先要找着前端入口,然后要找着头部前端代码的位置 ,经过分析源码位置如下图:


修改后重启,即可发现代码已经生效。


这样说明代码位置找到了,因此,如果要在生产环境修改,则需要打镜像发布。然后再重启dify。

操作如下:

构建代码

npm run build

1

启动 web 服务

npm run start
# or
yarn start
# or
pnpm start

如果npm run build时遇到cp不是内部命令错误

可用git bash来解决。npm run build 时报 cp 不是内部命令错误_cp' 不是内部或外部命令,也不是可运行的程序-CSDN博客

如果 只想修改部分代码,则直接把修改的内容放在宿主机上,然后通过docker 启动时挂载到容器里就行了。

提交代码、镜像打包。

注:要对源码进行构建:

yarn build

然后,我们直接使用`node
.next/standalone/server.js` 命令启动了构建后的服务器。服务器成功启动并监听在 http://localhost:3000 端口。

node .next/standalone/server.js
通过分析项目构建目录,我发现yarn build命令(实际执行next build)将代码构建到了web/.next目录下,主要包含以下关键部分:
1. standalone目录:包含了可独立运行的生产环境代码
    - server.js - 主服务器文件
   - .next目录 - 包含了客户端代码
   - package.json - 项目依赖配置
2. static目录:存放静态资源文件
3. server目录:包含服务器端渲染所需的代码
这种构建结构使得应用可以作为独立服务运行,不需要依赖整个项目源码。根据package.json中的start脚本,运行时会将static目录复制到standalone/.next/下,确保静态资源可以正确访问。

把构建后的代码放在docker宿主机下。