跳到主要内容

n8n Binary and Data 技能

在 n8n 节点、代理工具和聊天界面之间完整保留文件字节和元数据。

社区 · Romuald Członkowski
作者Romuald Członkowski
许可证MIT
来源czlonkowski/n8n-skills · GitHub 上的 SKILL.md
项目官网docs.n8n.io
适用于Claude Code · Codex、Gemini CLI、Cursor、Copilot
读取源文件日期

n8n Binary and Data 技能: 在 n8n 节点、代理工具和聊天界面之间完整保留文件字节和元数据。

追踪二进制字段,转换时保留它,并通过适当的存储键或 URL 暂存文件。

摘自该技能的 SKILL.md: # n8n Binary and Data

这是 Romuald Członkowski 发布的社区技能,未经我们或 Anthropic 审核。技能可以让智能体运行代码、读取文件或访问网络。安装前请阅读它的 SKILL.md 和文件夹中的每个脚本,留意任何与其声称用途不符的内容。

功能

  1. 追踪二进制字段,转换时保留它,并通过适当的存储键或 URL 暂存文件。

产出内容

  • 二进制属性映射、文件传输方案,以及每步字节保留检查。

适用场景

  • 找出这个 n8n 工作流在哪一步丢失 PDF 二进制字段。

不适用的场景

  • 把说明文件当成远程服务、验证或部署成功的保证。

所需条件

  • 需要兼容的 n8n-mcp 服务器和真实工作流数据。在线管理需要已授权的 n8n 实例;关联服务与托管可能另收费。

技能包含的文件

文件或文件夹用途
SKILL.md入口说明与任务专用流程。
BINARY_BASICS.md此流程使用的配套参考资料。
AGENT_TOOL_BINARY.md此流程使用的配套参考资料。
CDN_REQUIREMENT.md此流程使用的配套参考资料。

2026-11-17 在仓库中查到的许可证:MIT。

示例提示词

安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。

  • 找出这个 n8n 工作流在哪一步丢失 PDF 二进制字段。
  • 为代理工具规划通过存储键传入图片的方案。
  • 在 JSON 转换过程中保留附件。

如何安装 n8n-binary-and-data

准备工作流程

官网链接指向 n8n 产品文档,不是社区 MCP 安装器。n8n-mcp 需另装;托管及关联服务可能收费。安装前请检查插件 hooks。

复制技能文件夹到其他代理不会安装 Claude Code 插件钩子。执行前检查实时工具结构并审核写入操作。

技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:

Claude Code:从插件市场安装

  1. 在终端中用 claude 启动 Claude Code。
  2. 添加插件市场(每台电脑一次):
    /plugin marketplace add czlonkowski/n8n-skills
  3. 安装插件。Claude Code 会先显示插件详情:确认它会添加哪些内容(技能、Hooks、MCP 服务器),然后选择安装给你自己、给该仓库的所有人,还是仅在该仓库中给你自己使用。
    /plugin install n8n-mcp-skills@n8n-mcp-skills
  4. 输入 / 查找 /n8n-mcp-skills:n8n-binary-and-data,或直接提出任务。

也可以不进入会话,直接在 shell 中运行:

claude plugin marketplace add czlonkowski/n8n-skills
claude plugin install n8n-mcp-skills@n8n-mcp-skills

插件会整体安装,因此会附带其他技能,包括 n8n-agents, n8n-code-javascript, n8n-code-python, n8n-code-tool, n8n-error-handling, n8n-expression-syntax, n8n-mcp-tools-expert, n8n-multi-instance, n8n-node-configuration, n8n-self-hosting, n8n-subworkflows, n8n-validation-expert, n8n-workflow-patterns, using-n8n-mcp-skills。

Claude Code:把文件夹复制到技能文件夹

把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p ~/.claude/skills
cp -R n8n-skills/skills/n8n-binary-and-data ~/.claude/skills/

Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /n8n-binary-and-data,或直接描述任务。

在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。

Codex、Gemini CLI、Cursor 和 GitHub Copilot

这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p .agents/skills
cp -R n8n-skills/skills/n8n-binary-and-data .agents/skills/
智能体项目文件夹用户文件夹说明
OpenAI Codex
.agents/skills/
~/.agents/skills/
输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。
只安装你信任的技能. Anthropic 的建议是只使用可信来源的技能,其他技能在使用前要读完每个文件:技能可能以其描述中未提及的方式,指示智能体运行命令、读取文件或发送数据。

这些步骤的来源

已于 2026-11-14 对照各厂商的文档核实:

独立字段

用运行时二进制辅助方法读取字节,不要假设 data 字段是内联 base64。检查执行输出是否保留二进制数据。

存储与隐私

按目标平台和访问要求选择存储。敏感文件应使用受保护或签名 URL,默认不要公开发布。

关于 n8n-binary-and-data 的常见问题

本网站会执行技能吗?

不会,这是基于源码的安装指南,技能由您配置的代理环境执行。

这里核实了完整云端流程吗?

没有,因此不提供通用云端上传及 API 执行步骤;仍须满足源码的本地依赖与宿主能力。

文件内容存放在 $json 吗?

通常文件字节属于 $binary;$json 存放结构化字段和元数据。

代理工具能传递原始二进制文件吗?

源文档描述的是仅支持 JSON 的工具边界。先暂存文件,再传键或 URL,并核对实际运行环境。

更多 AI 技能

相关技能

技能分类