SuperAPI AI 工具集

n8n-code-python

编程与开发

查看项目

更新于 10-15 20:30

技能介绍

用途:在 n8n 2.x 的 Code 节点中用原生 Python(language 设为 pythonNative)处理数据。资料建议优先使用 JavaScript、表达式或原生节点,仅在用户明确要求 Python 时使用。

主要能力与用法:节点配置为 {"language": "pythonNative", "mode": "runOnceForAllItems" | "runOnceForEachItem", "pythonCode": "..."},typeVersion 2。全量模式用 _items(字典列表,形如 {"json": {...}, "pairedItem": {...}}),逐项模式用 _item;变量只在对应模式存在,否则报 NameError。只能字典访问,如 it["json"]["name"] 或 .get(),点号访问会报 AttributeError。Webhook 数据在 ["body"] 下。返回建议全量模式用 [{"json": ...}],逐项模式用 {"json": ...};逐项模式返回 None 会丢弃该项,返回列表会报错。

限制:默认不允许任何 import(含 json、datetime、re),Cloud 完全禁止,自托管需管理员在 task-runner 配置中加白名单;requests、pandas、numpy 通常不可用。eval、exec、open、type、getattr、类定义、dunder 访问等被沙箱拦截。无 _node、$('Node')、_now、_today、_jmespath 等价物,需用 Merge、Edit Fields 或 JS 替代。二进制数据需在 JavaScript 中处理。每个 Python Code 节点约耗时 0.4 秒(冷启动约 1 秒)。静态拒绝或返回形状错误时可能静默透传输入,需实际测试运行确认。

适用场景:用户明确要求 Python、迁移旧 Pyodide 代码、无 import 的列表处理(过滤、聚合、去重、排序等)。资料另附 COMMON_PATTERNS.md 的 12 个免 import 模式。