n8n 文件与二进制数据指南
帮助你在 n8n 中正确传递文件、处理二进制数据，并让 AI 工具和聊天界面可靠使用文件。
内容明确区分$json与$binary，建议私有存储、签名URL、短期过期、避免硬编码文件名，并提示上传失败和404应进入错误分支，具备一定的数据流透明度与隐私意识。扣分在于未提供完整的权限最小化、凭据隔离、用户确认、回滚或删除恢复方案；外部存储和公开URL仍可能产生外部数据暴露。
主线概念、代码示例、Merge同步屏障、executeOnce以及多种反模式相互一致，也说明应检查执行结果。扣分在于仅静态文档，没有可执行测试或CI证据；不少字段依赖n8n版本并要求另行get_node确认，异常分支只被引用而未完整定义，不能证明关键路径稳定可复现。
触发条件覆盖文件、PDF、图片、上传下载、$binary、AI工具和聊天图片，且说明同一工作流无代理边界时不需要存储舞步，并披露不同聊天平台的输入输出差异。扣分在于非适用范围和语义排除条件仍不够系统，未提供中文使用支持，也未评估中国大陆网络及各外部存储服务的可达性。
文档按主说明、专题文件、README和清单分层，包含示例、反模式、FAQ式排错、集成关系、限制、MIT许可证和1.0.0版本信息。扣分在于维护责任、变更日志和明确更新路径不足；README对技能数量存在14、15及路由层描述差异，部分关键实现依赖其他未提供文件。
提供了可直接改写为n8n工作流的JSON、JavaScript、Merge和存储键模式，能覆盖二进制丢失、代理工具边界和聊天展示等核心问题。扣分在于没有该技能关键路径的实际产出或执行证据，平台字段和存储实现仍需用户补充，完成任务通常还需要版本核对、凭据配置和运行验证。
README和技能文件列出n8n官方文档作为事实来源，并要求通过n8n_test_workflow和n8n_executions检查二进制是否存活。扣分在于本次仅有静态材料，未提供可验证的CI、提交测试套件或第三方复现记录；来源链接虽被提及但本评估不输出证据URL，关键断言覆盖有限。
- 不要把文档中的字段名和Merge配置直接视为所有n8n版本都适用；部署前应在目标版本确认节点参数并执行实际工作流。
- 对用户上传文件默认使用私有、最小权限、短期过期的存储策略，并核实外部存储服务在目标网络环境中的可达性。
- 该技能只提供模式和示例，不应替代对凭据权限、公开URL、保留周期、错误分支和清理流程的实际审查。
这个 Skill 能做什么，适合哪些场景？
该技能专门处理 n8n 工作流中的文件、图片、PDF、附件、上传下载和多模态输入。它明确区分存放结构化数据的 $json 与存放文件字节的 $binary，并说明如何读取、写入及在转换节点后保留二进制数据。对于 AI Agent 工具，它要求先将文件存储起来，再通过 JSON 传递键或 URL；对于聊天界面，则要求使用可访问的 HTTPS 图片 URL。它适合已经使用 n8n 和 n8n-mcp、经常遇到文件丢失或工具无法接收附件问题的用户。
说明如何从 HTTP Request、磁盘文件、云存储、邮件附件和 AI 媒体节点生成 $binary；指导使用 binaryPropertyName、responseFormat 和 getBinaryDataBuffer 读取文件；展示如何在 Code 节点中重新附加 binary；使用 Edit Fields 的保留选项或 Merge 的 combineByPosition 模式恢复被转换节点移除的二进制；设计 AI Agent 工具的文件上传、存储键传递和结果 URL 返回流程；指导将图片上传到对象存储或网盘并把 URL 发送到聊天界面；建议通过 n8n_test_workflow 和 n8n_executions 检查二进制是否在节点输出中存活。
- n8n 工作流开发者下载 PDF 或图片后，发现文件内容错误地出现在 $json 中。
- 自动化工程师使用 Code、IF 或 Edit Fields 节点处理数据后，发现下游邮件或上传节点找不到附件。
- AI Agent 构建者需要让工具读取用户上传的文件，或让工具生成文件并返回给用户。
- 聊天机器人开发者需要在 Slack、Discord、Teams、Telegram 或嵌入式 Webhook Chat 中展示生成的图片。
- 需要验证文件是否在工作流某个节点被静默丢弃的 n8n 调试人员。
这个 Skill 有哪些优点和局限？
- 清楚解释 $json 与 $binary 的职责边界，并覆盖常见文件丢失原因。
- 提供 HTTP 下载、Code 节点、Merge、AI Agent 工具和聊天图片的具体处理模式。
- 明确指出二进制不能跨越 AI 工具边界，也不能直接由聊天客户端读取。
- 包含反模式、验证步骤和与其他 n8n 技能的衔接说明。
- 依赖 n8n 工作流环境，并以 n8n-mcp 工具协作为前提。
- 不会提供 CDN、对象存储或文件托管；用户必须自行选择并配置存储后端。
- Data Tables、Code 节点完整沙箱细节和 Custom Code Tool 细节由其他技能负责。
- 材料没有提供该单项技能在不同 n8n 版本或独立平台上的测试结果。
如何安装这个 Skill？
该技能属于 czlonkowski/n8n-skills 的 15 技能集合。Claude Code 插件方式可运行：/plugin install czlonkowski/n8n-skills。手动安装时，先克隆仓库：git clone https://github.com/czlonkowski/n8n-skills.git，然后复制目标技能目录：cp -r n8n-skills/skills/n8n-binary-and-data ~/.claude/skills/。README 还说明可在 Claude.ai 中下载并上传单个技能文件夹；API/SDK 的详细安装步骤未在提供的材料中展开。
如何使用这个 Skill？
安装后，在相关 n8n 问题中直接提问，例如：“如何在 n8n 中读取 PDF 并把它传给 AI Agent 工具？”或“为什么 Merge 后附件消失了？”技能会在涉及文件、图片、PDF、附件、$binary、binaryPropertyName、读取 PDF、发送图片、Merge 丢失二进制或聊天图片 CDN 时自动激活。使用 n8n-mcp 时，可结合 get_node 确认节点字段，并用 n8n_test_workflow 和 n8n_executions 检查实际执行结果。