Dify DSL 批量导出工具完整安装与使用攻略 目录1. 概述2. 安装 NVM (Node Version Manager)3. 安装 Node.js4. 配置 NPM 路径5. 安装并使用 dify-dsl-pipe6. 常见问题排查7. 附录目录结构总览1. 概述1.1 dify-dsl-pipedify-dsl-pipe是一个 Node.js 命令行工具用于批量导出、导入和备份 Dify 应用的 DSL 配置文件。1.2 为什么需要这样一套环境组件作用NVM管理多个 Node.js 版本避免权限和环境冲突Node.js运行dify-dsl-pipe的运行时环境NPMNode.js 包管理器用于安装和管理工具dify-dsl-pipe批量导出 Dify 应用的 DSL 文件1.3 本文档约定所有大文件统一安装在D 盘避免占用 C 盘空间使用NVM而非 Docker更轻量、快速命令示例以Windows环境为准2. 安装 NVM (Node Version Manager)2.1 下载 NVM-Windows访问官方 GitHub Release 页面https://github.com/coreybutler/nvm-windows/releases下载nvm-setup.exe推荐或nvm-setup.zip❌ 不要下载nvm.exe纯命令行版、author-nvm.exe、Source code2.2 安装步骤右键nvm-setup.exe→“以管理员身份运行”安装向导关键配置步骤推荐路径说明NVM 安装路径D:\nvm存放 NVM 本体和所有 Node.js 版本Active Version LocationD:\opencli\nodejs当前使用版本的符号链接位置安装完成后以管理员身份打开命令提示符CMD或 PowerShell验证安装nvm --version可选配置国内镜像加速nvm node_mirror https://npmmirror.com/mirrors/node/ nvm npm_mirror https://npmmirror.com/mirrors/npm/3. 安装 Node.js3.1 通过 NVM 安装 LTS 版本nvm install --lts安装完成后输出类似Now using node v24.19.0 (64-bit)3.2 查看已安装版本nvm list输出示例24.19.03.3 激活指定版本nvm use 24.19.0输出Now using node v24.19.0 (64-bit)3.5 验证安装node -v npm -v4. 配置 NPM 路径4.1 为什么要配置默认情况下NPM 的全局包和缓存会存放在 C 盘用户目录下随着使用会越来越大。需要将其迁移到 D 盘。4.2 配置命令npm config set prefix D:\opencli\node_global npm config set cache D:\opencli\node_cache4.3 验证配置npm config get prefix npm config get cache预期输出D:\opencli\node_global D:\opencli\node_cache4.4 创建目录如果不存在mkdir D:\opencli\node_global -Force mkdir D:\opencli\node_cache -Force4.5 将全局包路径加入系统 PATH右键此电脑→属性→高级系统设置→环境变量在用户变量或系统变量中找到Path双击编辑点击新建添加D:\opencli\node_global点击确定保存5. 安装并使用 dify-dsl-pipe5.1 两种使用方式对比方式命令特点临时使用推荐npx dify-dsl-pipe ...每次自动下载最新版用完即走不占空间全局安装可选npm install -g dify-dsl-pipe永久安装之后可直接用dify-dsl-pipe命令5.2 导出命令使用邮箱/密码认证方式cd到备份的目标路径下 npx dify-dsl-pipeexport--urlhttp://localhost/console/api--email你的邮箱--password你的密码5.3 实际操作示例假设 Dify 是本地部署准备将导出的 DSL 文件保存到E:\dify备份# 1. 进入目标目录导出cdE:\mkdirdify备份cddify备份 npx dify-dsl-pipeexport--urlhttp://localhost/console/api--emailadminexample.com--passwordyour-password#导入cd/d E:\dify备份2 npx dify-dsl-pipeimport--urlhttp://localhost/console/api--email邮箱--password密码--source./dify-backup6. 常见问题排查6.1 PowerShell 中npm命令报错报错信息无法加载文件 D:\nmp\nodejs\npm.ps1因为在此系统上禁止运行脚本解决方法三选一方法一修改执行策略推荐Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned输入Y确认。方法二改用 CMD在开始菜单搜索cmd使用命令提示符而非 PowerShell。方法三临时绕过仅当前窗口Set-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass6.2 NVM 激活失败NVM_SYMLINK 被占用报错信息activation error: NVM_SYMLINK is set to a physical file/directory解决方法删除或重命名冲突目录Remove-Item-Recurse-Force D:\nmp\nodejs-ErrorAction SilentlyContinue创建正确的符号链接目录mkdir D:\opencli\nodejs设置环境变量NVM_SYMLINK D:\opencli\nodejs修改D:\nvm\settings.txt确保有symlink: D:\opencli\nodejs重新以管理员身份打开终端执行nvm use 24.19.06.3node命令找不到原因Node.js 未激活或 PATH 未配置。解决方法检查已安装版本nvm list激活对应版本nvm use 24.19.0确认D:\opencli\nodejs已加入系统 PATH7. 附录目录结构总览安装配置完成后你的 D 盘目录结构如下D:\ ├── nvm\ ← NVM 本体 │ ├── v24.19.0\ ← Node.js 源文件~200 MB │ ├── v20.17.0\ ← 其他已安装版本 │ └── settings.txt ← NVM 配置文件 │ └── opencli\ ← 统一工作目录 ├── nodejs\ ← 当前 Node.js 快捷方式符号链接 ├── node_global\ ← NPM 全局包如 dify-dsl-pipe✅ └── node_cache\ ← NPM 下载缓存 ✅结论所有大文件都在 D 盘C 盘仅占用几 KB 的配置文件。 Dify DSL 批量导出工具完整安装与使用攻
Dify DSL 批量导出工具完整安装与使用攻略 目录1. 概述2. 安装 NVM (Node Version Manager)3. 安装 Node.js4. 配置 NPM 路径5. 安装并使用 dify-dsl-pipe6. 常见问题排查7. 附录目录结构总览1. 概述1.1 dify-dsl-pipedify-dsl-pipe是一个 Node.js 命令行工具用于批量导出、导入和备份 Dify 应用的 DSL 配置文件。1.2 为什么需要这样一套环境组件作用NVM管理多个 Node.js 版本避免权限和环境冲突Node.js运行dify-dsl-pipe的运行时环境NPMNode.js 包管理器用于安装和管理工具dify-dsl-pipe批量导出 Dify 应用的 DSL 文件1.3 本文档约定所有大文件统一安装在D 盘避免占用 C 盘空间使用NVM而非 Docker更轻量、快速命令示例以Windows环境为准2. 安装 NVM (Node Version Manager)2.1 下载 NVM-Windows访问官方 GitHub Release 页面https://github.com/coreybutler/nvm-windows/releases下载nvm-setup.exe推荐或nvm-setup.zip❌ 不要下载nvm.exe纯命令行版、author-nvm.exe、Source code2.2 安装步骤右键nvm-setup.exe→“以管理员身份运行”安装向导关键配置步骤推荐路径说明NVM 安装路径D:\nvm存放 NVM 本体和所有 Node.js 版本Active Version LocationD:\opencli\nodejs当前使用版本的符号链接位置安装完成后以管理员身份打开命令提示符CMD或 PowerShell验证安装nvm --version可选配置国内镜像加速nvm node_mirror https://npmmirror.com/mirrors/node/ nvm npm_mirror https://npmmirror.com/mirrors/npm/3. 安装 Node.js3.1 通过 NVM 安装 LTS 版本nvm install --lts安装完成后输出类似Now using node v24.19.0 (64-bit)3.2 查看已安装版本nvm list输出示例24.19.03.3 激活指定版本nvm use 24.19.0输出Now using node v24.19.0 (64-bit)3.5 验证安装node -v npm -v4. 配置 NPM 路径4.1 为什么要配置默认情况下NPM 的全局包和缓存会存放在 C 盘用户目录下随着使用会越来越大。需要将其迁移到 D 盘。4.2 配置命令npm config set prefix D:\opencli\node_global npm config set cache D:\opencli\node_cache4.3 验证配置npm config get prefix npm config get cache预期输出D:\opencli\node_global D:\opencli\node_cache4.4 创建目录如果不存在mkdir D:\opencli\node_global -Force mkdir D:\opencli\node_cache -Force4.5 将全局包路径加入系统 PATH右键此电脑→属性→高级系统设置→环境变量在用户变量或系统变量中找到Path双击编辑点击新建添加D:\opencli\node_global点击确定保存5. 安装并使用 dify-dsl-pipe5.1 两种使用方式对比方式命令特点临时使用推荐npx dify-dsl-pipe ...每次自动下载最新版用完即走不占空间全局安装可选npm install -g dify-dsl-pipe永久安装之后可直接用dify-dsl-pipe命令5.2 导出命令使用邮箱/密码认证方式cd到备份的目标路径下 npx dify-dsl-pipeexport--urlhttp://localhost/console/api--email你的邮箱--password你的密码5.3 实际操作示例假设 Dify 是本地部署准备将导出的 DSL 文件保存到E:\dify备份# 1. 进入目标目录导出cdE:\mkdirdify备份cddify备份 npx dify-dsl-pipeexport--urlhttp://localhost/console/api--emailadminexample.com--passwordyour-password#导入cd/d E:\dify备份2 npx dify-dsl-pipeimport--urlhttp://localhost/console/api--email邮箱--password密码--source./dify-backup6. 常见问题排查6.1 PowerShell 中npm命令报错报错信息无法加载文件 D:\nmp\nodejs\npm.ps1因为在此系统上禁止运行脚本解决方法三选一方法一修改执行策略推荐Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned输入Y确认。方法二改用 CMD在开始菜单搜索cmd使用命令提示符而非 PowerShell。方法三临时绕过仅当前窗口Set-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass6.2 NVM 激活失败NVM_SYMLINK 被占用报错信息activation error: NVM_SYMLINK is set to a physical file/directory解决方法删除或重命名冲突目录Remove-Item-Recurse-Force D:\nmp\nodejs-ErrorAction SilentlyContinue创建正确的符号链接目录mkdir D:\opencli\nodejs设置环境变量NVM_SYMLINK D:\opencli\nodejs修改D:\nvm\settings.txt确保有symlink: D:\opencli\nodejs重新以管理员身份打开终端执行nvm use 24.19.06.3node命令找不到原因Node.js 未激活或 PATH 未配置。解决方法检查已安装版本nvm list激活对应版本nvm use 24.19.0确认D:\opencli\nodejs已加入系统 PATH7. 附录目录结构总览安装配置完成后你的 D 盘目录结构如下D:\ ├── nvm\ ← NVM 本体 │ ├── v24.19.0\ ← Node.js 源文件~200 MB │ ├── v20.17.0\ ← 其他已安装版本 │ └── settings.txt ← NVM 配置文件 │ └── opencli\ ← 统一工作目录 ├── nodejs\ ← 当前 Node.js 快捷方式符号链接 ├── node_global\ ← NPM 全局包如 dify-dsl-pipe✅ └── node_cache\ ← NPM 下载缓存 ✅结论所有大文件都在 D 盘C 盘仅占用几 KB 的配置文件。