N8n Code Python 说明文档

# n8n Python 代码技能 关于在 n8n 代码节点中编写 Python 代码的专家指南。 --- ## ⚠️ 重要提示：优先使用 JavaScript **95% 的使用场景请使用 JavaScript。** n8n 中的 Python **没有外部库**（没有 requests、pandas、numpy）。 **何时使用 Python**： - 您有复杂的 Python 特定逻辑 - 您需要 Python 标准库功能 - 您比 JavaScript 更熟悉 Python **何时使用 JavaScript**（推荐）： - HTTP 请求（提供 `$helpers.httpRequest`） - 日期/时间操作（包含 Luxon 库） - 大多数数据转换 - 拿不准的时候 --- ## 本技能涵盖内容 ### 核心概念 1. **关键限制**：无外部库 2. **数据访问**：`_input.all()`, `_input.first()`, `_input.item` 3. **Webhook 注意事项**：数据位于 `_json["body"]` 下 4. **返回格式**：必须返回 `[{"json": {...}}]` 5. **标准库**：json, datetime, re, base64, hashlib 等 ### 5 大错误预防 本技能强调**错误预防**： 1. **ModuleNotFoundError**（尝试导入外部库） 2. **空代码 / 缺少 return** 3. **KeyError**（未使用 .get() 的字典访问） 4. **IndexError**（未进行边界检查的列表访问） 5. **错误的返回格式** 这 5 个错误是 Python 代码节点中最常见的。 --- ## 技能激活 当您执行以下操作时，此技能将激活： - 在代码节点中编写 Python - 询问 Python 的限制 - 需要了解可用的标准库 - 排查 Python 代码节点错误 - 处理 Python 数据结构 **示例查询**： - "我可以在 Python 代码节点中使用 pandas 吗？" - "如何在 Python 中访问 webhook 数据？" - "有哪些可用的 Python 库？" - "编写 Python 代码来处理 JSON" - "为什么找不到 requests 模块？" --- ## 文件结构 ### SKILL.md (719 行) **快速入门**与概览 - 何时使用 Python 与 JavaScript - 关键限制（无外部库） - 模式选择（所有项目 vs 每个项目） - 数据访问概览 - 返回格式要求 - 标准库概览 ### DATA_ACCESS.md (703 行) **完整的数据访问模式** - `_input.all()` - 处理所有项目 - `_input.first()` - 获取第一项 - `_input.item` - 当前项（每个项目模式） - `_node["Name"]` - 引用其他节点 - Webhook 正文结构（关键陷阱！） - 模式选择指南 ### STANDARD_LIBRARY.md (850 行) **可用的 Python 模块** - json - JSON 解析 - datetime - 日期/时间操作 - re - 正则表达式 - bas