上传文件

📖 节点概述

将本地文件（单个、多个或整个文件夹）上传到网页中。能够自动寻找触发上传的隐藏 <input type="file"> 元素，也可以应对现代拖拽、粘贴或 CDP 拦截等多种上传场景。你只需提供触发元素（如“选择文件”按钮）的定位器，并指定文件路径，节点会自动完成剩下的工作。

💡 使用场景：

• 表单附件提交：自动填写简历、报告、图片等文件上传字段。
• 批量素材导入：一次性将整个文件夹中的图片或文档上传到素材库。
• 富文本插入：在聊天框或编辑器中粘贴文件，触发自动上传。
• Dropzone 区域：处理通过拖拽实现上传的现代 UI。
• CDP 拦截上传：在文件选择弹窗出现时直接注入文件路径，无需模拟点击。

🎮 实战连线指南：如何正确使用它？

节点默认操作当前活动标签页，也可指定 Tab。需要提供一个用于触发文件选择的元素定位器（通常是一个按钮或输入框）。根据上传类型和页面实现方式，选择合适的“寻找模式”。

场景案例：自动上传简历文件

1. 打开招聘网站：进入简历投递页面。
2. 定位上传按钮：找到“上传简历”的按钮或输入框，使用【智能定位元素】获取其定位器（如 #uploadBtn 或 input[type="file"]），填入“元素定位”。
3. 选择上传类型：保持默认“单选文件”。
4. 设置文件路径：点击“本地路径”输入框右侧的 📁 按钮，选择你的简历文件（如 resume.pdf）。也可以将路径文本从其他节点动态传入。
5. 设置寻找模式：一般保持“智能嗅探”即可，它能自动找到与该按钮关联的隐藏 <input>。
6. 串联执行：将前置步骤的 Exec 输出连接到本节点，上传成功后 Exec 输出可连接【点击元素】提交表单。

场景案例：拖拽上传文件到 Dropzone 区域

1. 定位 Dropzone 区域：使用【智能定位元素】获取接收拖拽的方框选择器。
2. 选择上传类型：根据需求选择“多选文件”或“文件夹”。
3. 切换寻找模式：在高级选项中，将“寻找模式”改为“模拟拖拽 (现代 Dropzone 专属)”。节点会在页面中创建一个隐藏的文件输入，然后将文件赋予 DataTransfer，并模拟拖拽事件到目标区域。
4. 提供文件路径：对于多选文件，可以通过 |、, 或 ; 分隔多个路径，或者从“自定义”模式的文本框中每行输入一个路径。
5. 执行：节点会模拟完整的拖拽事件，页面会接收到文件并开始上传。

自定义路径模式：如果文件路径需要动态生成，或想传入一个文件路径列表，可以选择“自定义”上传类型。此时会出现多行文本输入框，每一行填写一个文件的绝对路径。也可以通过连线传入一个字符串列表。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

💎 小贴士：

• 如果页面上传按钮的样式不是标准的 input[type=file]，优先使用“智能嗅探”模式，它会自动找到隐藏的原生文件输入框。
• 使用“文件夹”上传时，会递归包含该文件夹下的所有文件，请确保文件夹内没有无关文件，以免上传失败或误传。
• 多选文件路径可以使用 |、, 或 ; 三种分隔符混合使用，节点会自动解析。
• 动态端口和控件会根据“上传类型”自动切换：选择“自定义”会出现多行文本输入框，其余模式为单行路径输入。
• 如果需要上传内存中的数据，本节点不适用，请改用“执行自定义 Python”节点构建请求。