Dify DSL 批量導(dǎo)出工具完整安裝與使用攻略 目錄1. 概述2. 安裝 NVM (Node Version Manager)3. 安裝 Node.js4. 配置 NPM 路徑5. 安裝并使用 dify-dsl-pipe6. 常見問題排查7. 附錄目錄結(jié)構(gòu)總覽1. 概述1.1 dify-dsl-pipedify-dsl-pipe是一個(gè) Node.js 命令行工具用于批量導(dǎo)出、導(dǎo)入和備份 Dify 應(yīng)用的 DSL 配置文件。1.2 為什么需要這樣一套環(huán)境組件作用NVM管理多個(gè) Node.js 版本避免權(quán)限和環(huán)境沖突Node.js運(yùn)行dify-dsl-pipe的運(yùn)行時(shí)環(huán)境NPMNode.js 包管理器用于安裝和管理工具dify-dsl-pipe批量導(dǎo)出 Dify 應(yīng)用的 DSL 文件1.3 本文檔約定所有大文件統(tǒng)一安裝在D 盤避免占用 C 盤空間使用NVM而非 Docker更輕量、快速命令示例以Windows環(huán)境為準(zhǔn)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→“以管理員身份運(yùn)行”安裝向?qū)шP(guān)鍵配置步驟推薦路徑說明NVM 安裝路徑D:\nvm存放 NVM 本體和所有 Node.js 版本Active Version LocationD:\opencli\nodejs當(dāng)前使用版本的符號(hào)鏈接位置安裝完成后以管理員身份打開命令提示符CMD或 PowerShell驗(yàn)證安裝nvm --version可選配置國內(nèi)鏡像加速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 驗(yàn)證安裝node -v npm -v4. 配置 NPM 路徑4.1 為什么要配置默認(rèn)情況下NPM 的全局包和緩存會(huì)存放在 C 盤用戶目錄下隨著使用會(huì)越來越大。需要將其遷移到 D 盤。4.2 配置命令npm config set prefix D:\opencli\node_global npm config set cache D:\opencli\node_cache4.3 驗(yàn)證配置npm config get prefix npm config get cache預(yù)期輸出D:\opencli\node_global D:\opencli\node_cache4.4 創(chuàng)建目錄如果不存在mkdir D:\opencli\node_global -Force mkdir D:\opencli\node_cache -Force4.5 將全局包路徑加入系統(tǒng) PATH右鍵此電腦→屬性→高級系統(tǒng)設(shè)置→環(huán)境變量在用戶變量或系統(tǒng)變量中找到Path雙擊編輯點(diǎn)擊新建添加D:\opencli\node_global點(diǎn)擊確定保存5. 安裝并使用 dify-dsl-pipe5.1 兩種使用方式對比方式命令特點(diǎn)臨時(shí)使用推薦npx dify-dsl-pipe ...每次自動(dòng)下載最新版用完即走不占空間全局安裝可選npm install -g dify-dsl-pipe永久安裝之后可直接用dify-dsl-pipe命令5.2 導(dǎo)出命令使用郵箱/密碼認(rèn)證方式cd到備份的目標(biāo)路徑下 npx dify-dsl-pipeexport--urlhttp://localhost/console/api--email你的郵箱--password你的密碼5.3 實(shí)際操作示例假設(shè) Dify 是本地部署準(zhǔn)備將導(dǎo)出的 DSL 文件保存到E:\dify備份# 1. 進(jìn)入目標(biāo)目錄導(dǎo)出cdE:\mkdirdify備份cddify備份 npx dify-dsl-pipeexport--urlhttp://localhost/console/api--emailadminexample.com--passwordyour-password#導(dǎo)入cd/d E:\dify備份2 npx dify-dsl-pipeimport--urlhttp://localhost/console/api--email郵箱--password密碼--source./dify-backup6. 常見問題排查6.1 PowerShell 中npm命令報(bào)錯(cuò)報(bào)錯(cuò)信息無法加載文件 D:\nmp\nodejs\npm.ps1因?yàn)樵诖讼到y(tǒng)上禁止運(yùn)行腳本解決方法三選一方法一修改執(zhí)行策略推薦Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned輸入Y確認(rèn)。方法二改用 CMD在開始菜單搜索cmd使用命令提示符而非 PowerShell。方法三臨時(shí)繞過僅當(dāng)前窗口Set-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass6.2 NVM 激活失敗NVM_SYMLINK 被占用報(bào)錯(cuò)信息activation error: NVM_SYMLINK is set to a physical file/directory解決方法刪除或重命名沖突目錄Remove-Item-Recurse-Force D:\nmp\nodejs-ErrorAction SilentlyContinue創(chuàng)建正確的符號(hào)鏈接目錄mkdir D:\opencli\nodejs設(shè)置環(huán)境變量NVM_SYMLINK D:\opencli\nodejs修改D:\nvm\settings.txt確保有symlink: D:\opencli\nodejs重新以管理員身份打開終端執(zhí)行nvm use 24.19.06.3node命令找不到原因Node.js 未激活或 PATH 未配置。解決方法檢查已安裝版本nvm list激活對應(yīng)版本nvm use 24.19.0確認(rèn)D:\opencli\nodejs已加入系統(tǒng) PATH7. 附錄目錄結(jié)構(gòu)總覽安裝配置完成后你的 D 盤目錄結(jié)構(gòu)如下D:\ ├── nvm\ ← NVM 本體 │ ├── v24.19.0\ ← Node.js 源文件~200 MB │ ├── v20.17.0\ ← 其他已安裝版本 │ └── settings.txt ← NVM 配置文件 │ └── opencli\ ← 統(tǒng)一工作目錄 ├── nodejs\ ← 當(dāng)前 Node.js 快捷方式符號(hào)鏈接 ├── node_global\ ← NPM 全局包如 dify-dsl-pipe? └── node_cache\ ← NPM 下載緩存 ?結(jié)論所有大文件都在 D 盤C 盤僅占用幾 KB 的配置文件。