Dify 应用 DSL 的一站式管道工具,涵盖导出、导入、备份、迁移、定时服务与 MCP Server 集成。
无需安装,通过 npx 命令即可直接使用。
功能特性
快速上手
方式一:命令行直接使用
无需安装,通过 npx 即可直接运行:
# 将所有应用导出到 ./dify-backup
npx dify-dsl-pipe export --url https://your-dify.com/console/api --token YOUR_TOKEN
# 也可以使用邮箱和密码认证
npx dify-dsl-pipe export --url https://your-dify.com/console/api \
--email [email protected] --password your-password
# 导入到目标实例(建议先以预览模式确认)
npx dify-dsl-pipe import --url https://target-dify.com/console/api --token TOKEN \
--source ./dify-backup --dry-run
# 交互式初始化配置文件
npx dify-dsl-pipe init
# 一条命令跨实例迁移:默认预演,确认后加 --yes 执行
npx dify-dsl-pipe init --name prod --url https://dify.prod.com/console/api --token PROD_TOKEN
npx dify-dsl-pipe init --name staging --url https://dify.staging.com/console/api --token STAGING_TOKEN
npx dify-dsl-pipe migrate --from prod --to staging # 预演
npx dify-dsl-pipe migrate --from prod --to staging --yes # 执行导入
# 对比备份与线上差异;--check 发现漂移即退出码 1(CI 用)
npx dify-dsl-pipe diff --profile prod --source ./dify-backup --check
# 离线检查备份目录能否干净导入
npx dify-dsl-pipe lint --source ./dify-backup
--url需指向 Console API,地址以/console/api结尾。
导入(
import/migrate)的 workflow / advanced-chat 应用默认只写入草稿,目标实例的 Service API / Web App 不会立即生效;加--publish在导入后自动发布(覆盖导入时线上仍运行旧发布版本,发布后才切换)。
方式二:通过 Agent Skill 使用
在支持 Skill 协议的 AI 工具(Claude Code、Cursor、OpenCode 等)中安装 Skill,通过显式调用驱动操作:
# 安装 Skill
npx skills add linhai0872/dify-dsl-pipe
安装后,在 AI 对话中用 /dify-dsl-pipe 显式唤起,然后描述你的需求:
/dify-dsl-pipe帮我把生产环境的所有 workflow 应用备份到本地,地址是 https://dify.example.com/console/api
Skill 会识别意图、补充缺失信息,并自动组装命令执行,全程无需手动输入参数。
文档
多实例管理
运行 npx dify-dsl-pipe init 交互式创建,或手动建立 dify-pipe.yaml:
instances:
- name: prod
url: "https://dify.prod.com/console/api"
token: "prod-token"
- name: staging
url: "https://dify-staging.com/console/api"
token: "staging-token"
profiles:
prod:
instance: prod
storage:
type: local
path: "./backup/prod"
staging:
instance: staging
storage:
type: local
path: "./backup/staging"
npx dify-dsl-pipe export --profile prod
npx dify-dsl-pipe import --profile staging --source ./backup/prod
从旧版迁移
原 Python 版(dify-dsl-exporter)用户:配置文件格式已完全变更,请运行 npx dify-dsl-pipe init 重新生成 dify-pipe.yaml。认证方式向下兼容,仍支持 email+password;存储后端统一为 --storage s3 + --s3-endpoint,各云厂商 endpoint 配置详见存储后端文档。
License
MIT