n8n 自动化 — 快速构建与交付工作流

使用我们包含 2,061 个模板的模板库，构建、定制并交付 n8n 工作流。 参考路径：~/projects/n8n-workflows/ — 按集成（integration）文件夹浏览。 我们的 n8n 实例地址：localhost:5678（启动前需执行 fnm use 22）。 所有输出均存入：workspace/artifacts/。

适用场景

• 为客户（Upwork、Alfred 或直接客户）构建 n8n 工作流
• 基于模板库中的模板，针对特定用例进行定制
• 调试或优化现有 n8n 工作流
• 在实际构建前，设计工作流架构
• 评估工作流项目的交付周期
• 导入/导出工作流 JSON 文件

不适用场景

• 寻找 Upwork 职位（请使用 upwork-hunting 技能）
• 撰写客户提案（请使用 proposal-writing 技能）
• 不涉及 n8n 的通用编程任务
• Zapier / Make.com 工作流构建（平台不同，节点不可互换）

反面示例

• “帮我找 Upwork 上的自动化职位” → 不适用。应使用 upwork-hunting。
• “帮我写一个 Python 脚本” → 不适用。本技能专用于 n8n。
• “帮我部署 n8n 服务端” → 边界案例。基础设施搭建属于运维（ops）范畴，而非工作流构建；但凭据（credential）配置属于本技能范围。

边界情况

• 工作流中使用自定义 JavaScript（Code 节点）→ 适用。n8n 原生支持内联 JavaScript。
• 客户希望将 Zapier 工作流迁移至 n8n → 适用。可将 Zapier 的触发器（trigger）和动作（action）映射为 n8n 对应节点。
• 工作流需调用外部 API，但 n8n 尚未提供该集成节点 → 适用。可使用 HTTP Request 节点。
• 多工作流协同编排 → 适用。可使用 Execute Workflow 节点。

模板库快速参考

位置：~/projects/n8n-workflows/workflows/ 结构：workflows/[IntegrationName]/[id]_[integration]_[action]_[trigger].json

如何查找合适模板

# 列出某集成下的全部模板
ls ~/projects/n8n-workflows/workflows/Twilio/

# 全局搜索所有工作流
find ~/projects/n8n-workflows/workflows/ -name "*.json" | grep -i "shopify"

# 统计各集成目录下模板数量（取 Top 20）
ls ~/projects/n8n-workflows/workflows/ | while read d; do echo "$(ls ~/projects/n8n-workflows/workflows/$d/ | wc -l) $d"; done | sort -rn | head -20

热门集成目录（按 Upwork 需求排序）

工作流构建流程

步骤 1：需求分析

基于客户访谈，明确以下问题：

• 什么事件会触发该工作流？（Webhook、定时任务、表单提交、应用事件等）
• 需要执行哪些动作？（发送邮件、更新 CRM、创建记录等）
• 哪些数据需要流转？（字段、格式、转换逻辑）
• 需要何种错误处理机制？（重试策略、备用方案、告警通知）
• 需要哪些凭据？（API Key、OAuth 等）

步骤 2：匹配模板

# 搜索关键词相关模板
find ~/projects/n8n-workflows/workflows/ -name "*.json" | xargs grep -l "keyword" 2>/dev/null

也可直接按集成目录浏览。多数项目需组合 2–3 个模板完成。

步骤 3：导入与定制

1. 复制模板 JSON 内容
2. 在 n8n 中：菜单 → Import from File（或粘贴 JSON）
3. 更新凭据（客户自己的 API Key）
4. 调整字段映射（适配客户的实际数据结构）
5. 修改触发器设置（如客户 Webhook URL、定时表达式等）
6. 添加错误处理节点（Error Trigger → 发送通知）

步骤 4：测试

• 使用 n8n 的手动执行（Manual Execution）功能，逐节点验证
• 确认数据在各节点间正确流转
• 测试错误路径（例如：当某 API 不可用时的行为）
• 检查速率限制（尤其适用于批量操作）

步骤 5：文档编写与交付

每个交付的工作流均须包含如下说明：

## 工作流：[名称]
**触发器：** [启动条件]
**执行步骤：** [1. → 2. → 3.]
**所需凭据：** [列出]
**测试方式：** [如何验证其正常运行]
**维护说明：** [哪些环节易出问题及修复方法]

常用工作流模式

模式 1：触发 → 转换 → 执行

最基础且最常见的模式：事件发生 → 数据处理 → 执行动作。

[Webhook/表单/定时任务] → [Set/Code 节点：数据转换] → [发送邮件/更新 CRM/创建记录]

模式 2：触发 → 分支 → 多动作

根据条件判断执行不同路径。

[触发器] → [IF 节点：判断条件] → True：[动作 A] / False：[动作 B]

模式 3：定时批量处理

周期性执行批量任务。

[Cron/定时任务] → [从 Sheet/数据库获取数据] → [Loop：逐项处理] → [每项对应动作]

模式 4：Webhook API 接口

n8n 作为被其他服务调用的 API 端点。

[Webhook：接收请求] → [处理逻辑] → [Respond to Webhook：返回响应]

模式 5：多阶段流水线

含多个处理阶段的复杂工作流。

[触发器] → [丰富数据] → [路由/拆分] → [多项动作] → [聚合结果] → [最终动作]

模式 6：高容错工作流

面向生产环境、具备完整错误处理能力的工作流。

[触发器] → [Try：主流程] → [Catch：Error Trigger] → [通过 Slack/邮件告警]

节点速查表

凭据配置核对清单

交付客户前，请确保完成以下检查：

• 所有凭据均使用客户的 API Key（严禁使用我方密钥）
• OAuth Token 已绑定至客户的账号
• Webhook URL 指向客户的 n8n 实例（若为托管服务，则指向我方实例）
• 敏感信息未硬编码于节点中（应统一使用凭据存储）
• 凭据已在生产环境（非仅 sandbox）中验证有效

交付核对清单

• 工作流已使用真实数据完成端到端测试
• 已配置错误处理节点
• 文档齐全（含触发器、执行步骤、所需凭据、维护说明）
• 工作流 JSON 已导出备份
• 客户可独立导入并成功运行
• 已覆盖边缘场景测试（空数据、API 错误、速率限制等）
• 交付包中包含工作流正常运行的截图

工作量评估指南

我们的效率优势：模板可将上述耗时缩短 40–60%。

n8n 实例管理

启动 n8n：

eval "$(fnm env)" && fnm use 22 && nohup n8n start > /tmp/n8n.log 2>&1 &

访问地址：http://localhost:5678

通过 API 导入工作流：

curl -X POST http://localhost:5678/api/v1/workflows 
  -H "Content-Type: application/json" 
  -H "X-N8N-API-KEY: $N8N_API_KEY" 
  -d @workflow.json

已预配置的凭据：

• Twilio API Auth（ID: 2hP5kiyhResadXrF）
• 其余凭据将按客户需求另行配置