导入导出与分享工作流
你可以将已调优好的采集规则导出为独立文件，随时用于本地备份、多电脑迁移，或直接发送给同事团队复用。
在使用前，必须先厘清两种不同的文件格式——它们导出和导入的入口各自独立，不能跨页面混用：
| 文件类型 | 包含内容 | 导出入口 | 导入入口 |
|---|---|---|---|
| 工作流文件 (单品规则) | 仅包含采集规则本身（字段定义、点击与翻页步骤） | 「主工作台」卡片右下角 | 「主工作台」右上角「导入」 |
| 任务包文件 (全家桶预设) | 包含工作流规则 + 批量目标网址清单 + 定时运行周期预设 | 「定时任务」卡片操作栏 | 「定时任务」右上角「导入」 |
⚠️ 两种文件不可混淆导入
从哪个页面导出的文件，就必须回到哪个页面导入。
若在「定时任务」页误选了工作流文件，系统会明确提示：
导入失败：第 N 条不是任务包（若这是工作流文件，请到工作流列表导入）
此时无需慌张，文件本身没有任何损坏，只需切换至「主工作台」重新导入即可。
一、导出工作流文件
适用场景：将一套通用的采集规则分享给同事，由对方自行在各自的网页上启动执行。
- 进入侧边栏「主工作台」。
- 找到对应的采集规则卡片，点击右侧功能栏的下载图标（鼠标悬停提示「下载此工作流」）。
- 浏览器会自动下载一个
.json文件至本地默认下载目录，文件名即为该工作流的名称。
二、导出定时任务包
适用场景：需要将一套完整的计划任务（包含几百条商品链接清单和每天定时运行的配置）整体打包迁移至另一台电脑长期挂机。
- 进入侧边栏「定时任务」。
- 找到对应的任务卡片，点击操作栏中的「下载任务包」按钮。
- 系统将导出包含任务名称、网址列表、触发频率及启用开关状态的综合任务包。
提示「工作流已不存在，无法下载」怎么办？
若任务引用的底层工作流被误删，任务包将失去执行核心而无法导出。点击「编辑」为该任务重新关联一个现存有效的工作流后，即可正常导出。
三、导入操作指南
两个导入入口均位于对应页面右上角，支持单文件批量导入（一份合规文件内包含多条规则时，系统支持一次性全部载入）：
- 导入工作流：在「主工作台」右上角点击「导入」→ 选择工作流
.json文件。成功后提示：「已导入 N 条工作流」。 - 导入任务包：在「定时任务」右上角点击「导入」→ 选择任务包
.json文件。成功后提示：「已导入 N 个任务」。
四、原子校验机制与常见报错排查
🛡️ 系统安全设计：先全量校验，后安全写入
为防止错误文件导致本地数据损坏，导入引擎采用全量原子预校验机制：
若一份包含多条规则的文件中有任意一条内容损坏或格式不符，系统将彻底拦截整份导入，绝不产生“写进一半、丢掉一半”的脏数据。你的本地环境绝不会被弄乱。
导入失败时的提示词对照与解决对策：
| 错误提示 | 根本原因 | 正确应对方案 |
|---|---|---|
| 导入失败：第 N 条不是任务包 | 在「定时任务」页误选了工作流文件 | 换到「主工作台」右上角重新导入 |
| 导入失败：文件不是有效的 JSON | 选错了本地文件（如选成了文本或图片） | 重新选择九头虫 Agent 导出的标准 .json 文件 |
| 导入失败：第 N 条不是有效的工作流 | 文件在传输过程中损坏，或人为修改了内部字段 | 联系源头重新导出一份未篡改的原文件 |
| 文件中没有可导入的内容 | 文件结构合法但内容为空 | 仅为提醒，确认源文件内是否包含已保存的规则 |
五、两个关键机制与工作流更新指引
1. 机制一：只增不覆，不自动去重
导入操作永远执行新增（Append），不会覆盖已有同名规则。
若同一份文件连续导入两次，主工作台中会出现两张名字一模一样的卡片。
💡 如何规范更新已有工作流？ 如果团队同步了一版修复后的新工作流：
- 先在「主工作台」找到旧卡片，将其重命名为
xxx-旧版备份。- 点击右上角导入新版本文件。
- 手动试跑一次新版本，确认采集合格后，点击旧卡片右下角的垃圾桶彻底删除旧版。
2. 机制二：任务包连带“启用状态”同步复原
导出任务包时若右上角开关处于开启状态，导入到新电脑后同样默认保持开启！
- 如果该任务设为“每 5 分钟跑一次”，导入后几分钟内可能就会自动唤起浏览器执行。
- 安全建议：导入任务包后，第一时间去「定时任务」列表中确认该卡片的开关状态，若暂时无需自动运行请手动关闭。
六、团队共享与数据安全边界
将工作流文件发送给第三方或团队成员时，可对照以下安全清单：
| 资产类型 | 是否会随文件导出 | 安全性说明 |
|---|---|---|
| 采集步骤与字段名称 | ✅ 会导出 | 包含你的业务逻辑提取要求。 |
| 初始目标网页网址 | ✅ 会导出 | 包含你抓取的目标网站链接（内部私有系统请留意脱敏）。 |
| 已采集到的业务数据 | ❌ 绝不导出 | 采集结果严格存放在「数据存储」中，与规则完全物理隔离。 |
| 飞书 App Secret / 授权凭据 | ❌ 绝不导出 | 敏感密钥仅留存你个人浏览器的本地沙盒中，外部人员无法读取。 |
| 自定义 AI 模型 API Key | ❌ 绝不导出 | 个人私有密钥属于全局配置，绝不会嵌入任何工作流文件。 |