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 会识别意图、补充缺失信息，并自动组装命令执行，全程无需手动输入参数。
文档
| 文档 | 内容 |
|---|
| CLI 参数参考 | export / import / migrate / diff / lint / serve 所有参数详表 |
| 存储后端配置 | local / git / MinIO / AWS S3 / Cloudflare R2 / 阿里云 OSS / 腾讯云 COS / 火山云 TOS |
| 配置文件参考 | dify-pipe.yaml 完整字段说明 |
| 定时备份服务 | serve 模式、HTTP API 端点、cron 任务管理 |
| MCP Server 集成 | 配置 AI 工具直连 Dify |
多实例管理
运行 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
