n8n-workflows/CLAUDE_ZH.md

n8n-workflows 仓库

概述

本仓库包含一系列 n8n 工作流自动化文件。n8n 是一款工作流自动化工具，可通过可视化节点界面创建复杂自动化。每个工作流以 JSON 文件形式存储，包含节点定义、连接和配置信息。

仓库结构

text

bash
n8n-workflows/
├── workflows/           

# 主目录，包含所有 n8n 工作流 JSON 文件
│   ├── *.json          

# 各个工作流文件
├── README.md           

# 仓库文档
├── claude.md           

# 本文件

 - AI 助手上下文
└── [其他文件]          

# 其他配置或文档文件
```text

text

text

#

# 工作流文件格式

每个工作流 JSON 文件包含：

- **name**：工作流标识符

- **nodes**：节点对象数组，定义操作

- **connections**：定义节点连接方式的对象

- **settings**：工作流级别配置

- **staticData**：执行间持久化数据

- **tags**：分类标签

- **createdAt/updatedAt**：时间戳

#

# 常见节点类型

- **触发节点**：webhook、cron、manual

- **集成节点**：HTTP 请求、数据库连接器、API 集成

- **逻辑节点**：IF、Switch、Merge、Loop

- **数据节点**：Function、Set、Transform Data

- **通信节点**：Email、Slack、Discord 等

#

# 使用本仓库

#

#

# 分析任务建议

分析本仓库工作流时：

1. 解析 JSON 文件，理解工作流结构

2. 检查节点链路，确定功能实现

3. 识别外部集成与依赖

4. 考虑节点连接实现的业务逻辑

#

#

# 文档任务建议

记录工作流文档时：

1. 验证现有描述与实际实现的一致性

2. 识别触发机制和调度计划

3. 列出所有使用的外部服务和API

4. 记录数据转换和业务逻辑

5. 突出显示任何错误处理或重试机制

#

#

# 修改任务建议

修改工作流时：

1. 保持 JSON 结构和必要字段

2. 维护节点 ID 的唯一性

3. 添加/删除节点时更新连接

4. 测试与 n8n 版本要求的兼容性

#

# 关键注意事项

#

#

# 安全性

- 工作流文件可能在 webhook URL 或 API 配置中包含敏感信息

- 凭证通常单独存储在 n8n 中，而不在工作流文件中

- 谨慎处理任何硬编码的值或端点

#

#

# 最佳实践

- 工作流应有清晰、描述性的名称

- 复杂工作流受益于文档节点或注释

- 错误处理节点提高可靠性

- 模块化工作流（调用子工作流）提高可维护性

#

#

# 常见模式

- **数据管道**：触发 → 获取数据 → 转换 → 存储/发送

- **集成同步**：定时任务 → API调用 → 比较 → 更新系统

- **自动化**：Webhook → 处理 → 条件逻辑 → 执行操作

- **监控**：定时 → 检查状态 → 问题告警

#

# AI 助手的有用上下文

协助处理此仓库时：

1. **工作流分析**：通过检查节点流程了解业务目的，而不仅仅是单个节点。

2. **文档生成**：创建解释工作流实现功能的描述，而不仅仅是包含哪些节点。

3. **故障排除**：常见问题包括：

   - 节点连接不正确

   - 缺少错误处理

   - 循环中的低效数据处理

   - 应该参数化的硬编码值

4. **优化建议**：

   - 识别冗余操作

   - 适用场景下建议批处理

   - 推荐添加错误处理

   - 建议拆分复杂工作流

5. **代码生成**：创建分析这些工作流的工具时：

   - 处理各种 n8n 格式版本

   - 考虑自定义节点

   - 解析节点参数中的表达式

   - 考虑节点执行顺序

#

# 仓库特定信息

[在此处添加有关工作流、命名约定或特殊注意事项的任何特定信息]

#

# 版本兼容性

- n8n 版本：[指定这些工作流兼容的 n8n 版本]

- 最后更新：[最后一次主要更新的日期]

- 迁移说明：[任何特定版本的注意事项]