5.10 工作流导入与导出（Workflow Import & Export）

Pop 工作流不仅允许你在可视化界面中构建自动化流程，还支持将完整工作流 导出为 JSON 文件，并在任意设备或团队成员之间进行 导入、分享、备份与恢复。

通过导入与导出功能，你可以：

保存工作流版本
分享给团队成员
构建可复用的行业模板
将工作流从开发环境迁移到生产环境
在多个设备间同步你的工程

本章节将介绍 Pop 工作流导入与导出的完整流程、JSON 文件结构、最佳实践与常见问题处理。

📤 一、导出工作流（Export Workflow）

你可以将当前工作流导出为 .json 文件。

导出方式：

打开任意工作流
点击右上角菜单「⋯」
选择 导出工作流（Export Workflow）

系统会下载一个 JSON 文件，包含：

节点信息（Nodes）
连线信息（Edges）
输入 / 输出参数定义
全局变量初始值
布局引用（如有）
模块（Modules）引用
节点配置与脚本内容（PSL）

这意味着一个工作流可以被完整还原。

📥 二、导入工作流（Import Workflow）

你可以随时使用本地的 JSON 文件重新创建一个工作流。

导入方式：

打开「工作流列表」
点击右上角的 导入工作流
选择 .json 文件
Pop 会自动还原完整画布

导入时系统会：

校验文件结构是否正确
自动修正节点 ID 冲突
在必要时重新生成节点序列号
兼容旧版本 JSON

🗂 三、工作流 JSON 文件结构说明

导出的 JSON 文件包含完整的工作流内容。

以下是结构示例（简化版）：

{
  "version": 2,
  "metadata": {
    "id": "wf_20240101_001",
    "name": "自动摘要生成",
    "created_at": "...",
    "updated_at": "..."
  },
  "nodes": [
    {
      "id": "node_1",
      "type": "input",
      "config": {},
      "position": { "x": 240, "y": 100 }
    },
    {
      "id": "node_2",
      "type": "llm",
      "config": {
        "model": "deepseek-chat",
        "prompt": "请总结以下内容：{{input.text}}"
      },
      "position": { "x": 420, "y": 260 }
    }
  ],
  "edges": [
    {
      "id": "edge_12_1",
      "source": "node_1",
      "target": "node_2",
      "sourcePort": "out",
      "targetPort": "text"
    }
  ],
  "inputs": [
    { "name": "text", "type": "text", "required": true }
  ],
  "outputs": [
    { "name": "summary", "from": "node_2.output" }
  ],
  "layout": {
    "id": "layout_001",
    "widgets": [...]
  }
}

每个字段的意义如下：

字段	说明
version	工作流 JSON 版本号，确保兼容性
metadata	工作流的元信息
nodes	工作流中所有节点
edges	节点之间的连线关系
inputs	输入参数定义
outputs	输出参数定义
layout	布局管理器绑定（如有）

🔄 四、导入与导出的兼容性

Pop 对 JSON 文件提供 强向后兼容性：

旧版本的 JSON 文件可以在新版本 Pop 中导入
缺失字段会自动填充默认值
版本号不匹配会提示升级
兼容不同 PC / Mac / Web 环境

你可以放心将工作流分享给其他 Pop 用户，即使他们的版本有所不同。

🧠 五、模块（Module）的导入导出

如果一个工作流包含模块（Module），导出 JSON 时会：

内联嵌入模块内容（默认方式）
或引用模块 ID（即将上线）

导入时：

模块会自动创建并加入工作流
子工作流结构会被完整恢复

这让你可以轻松构建可复用的行业级模板。

🧪 六、将工作流作为模板复用

你可以将工作流导出后：

上传到团队共享库
上传到 Pop 模板中心（未来版本）
创建行业解决方案模板

例如：

AI 写作助手模板
SEO 文案生成模板
财务报表分析模板
站点访问日志分析模板
知识库构建流水线模板

导出与导入功能让 Pop 成为一个真正的“可编排自动化平台”。

🚀 七、迁移工作流到另一台电脑

在电脑 A 导出工作流
将 JSON 文件复制到电脑 B
在电脑 B 导入工作流
画布、节点、配置、布局全部恢复

非常适合：

多设备办公
团队交接任务
迁移项目到新的 Pop 环境

🛠 八、常见问题（FAQ）

❓ 节点顺序混乱怎么办？

Pop 会自动重新计算并整理节点序列号。

❓ 导入时提示“JSON 格式错误”？

请检查文件是否被手动修改或损坏。

❓ 模型配置无法恢复？

如果导入设备没有相同模型，将提示重新选择模型。

❓ 布局没有恢复？

请确认导出的 JSON 中包含 layout 字段（旧版本可能不支持）。

🎯 九、小结

工作流的导入与导出功能是 Pop 自动化系统的重要能力：

可备份
可迁移
可共享
可作为模板复用
可跨设备协作

借助导入与导出，你可以轻松构建团队级、行业级的自动化工程工厂。