made required changes in file CLAUDE_ZH.md
This commit is contained in:
21
CLAUDE_ZH.md
21
CLAUDE_ZH.md
@@ -1,10 +1,12 @@
|
||||
# n8n-workflows 仓库
|
||||
|
||||
## 概述
|
||||
|
||||
本仓库包含一系列 n8n 工作流自动化文件。n8n 是一款工作流自动化工具,可通过可视化节点界面创建复杂自动化。每个工作流以 JSON 文件形式存储,包含节点定义、连接和配置信息。
|
||||
|
||||
## 仓库结构
|
||||
```
|
||||
|
||||
```bash
|
||||
n8n-workflows/
|
||||
├── workflows/ # 主目录,包含所有 n8n 工作流 JSON 文件
|
||||
│ ├── *.json # 各个工作流文件
|
||||
@@ -14,7 +16,9 @@ n8n-workflows/
|
||||
```
|
||||
|
||||
## 工作流文件格式
|
||||
|
||||
每个工作流 JSON 文件包含:
|
||||
|
||||
- **name**:工作流标识符
|
||||
- **nodes**:节点对象数组,定义操作
|
||||
- **connections**:定义节点连接方式的对象
|
||||
@@ -24,6 +28,7 @@ n8n-workflows/
|
||||
- **createdAt/updatedAt**:时间戳
|
||||
|
||||
## 常见节点类型
|
||||
|
||||
- **触发节点**:webhook、cron、manual
|
||||
- **集成节点**:HTTP 请求、数据库连接器、API 集成
|
||||
- **逻辑节点**:IF、Switch、Merge、Loop
|
||||
@@ -33,14 +38,18 @@ n8n-workflows/
|
||||
## 使用本仓库
|
||||
|
||||
### 分析任务建议
|
||||
|
||||
分析本仓库工作流时:
|
||||
|
||||
1. 解析 JSON 文件,理解工作流结构
|
||||
2. 检查节点链路,确定功能实现
|
||||
3. 识别外部集成与依赖
|
||||
4. 考虑节点连接实现的业务逻辑
|
||||
|
||||
### 文档任务建议
|
||||
|
||||
记录工作流文档时:
|
||||
|
||||
1. 验证现有描述与实际实现的一致性
|
||||
2. 识别触发机制和调度计划
|
||||
3. 列出所有使用的外部服务和API
|
||||
@@ -48,7 +57,9 @@ n8n-workflows/
|
||||
5. 突出显示任何错误处理或重试机制
|
||||
|
||||
### 修改任务建议
|
||||
|
||||
修改工作流时:
|
||||
|
||||
1. 保持 JSON 结构和必要字段
|
||||
2. 维护节点 ID 的唯一性
|
||||
3. 添加/删除节点时更新连接
|
||||
@@ -57,17 +68,20 @@ n8n-workflows/
|
||||
## 关键注意事项
|
||||
|
||||
### 安全性
|
||||
|
||||
- 工作流文件可能在 webhook URL 或 API 配置中包含敏感信息
|
||||
- 凭证通常单独存储在 n8n 中,而不在工作流文件中
|
||||
- 谨慎处理任何硬编码的值或端点
|
||||
|
||||
### 最佳实践
|
||||
|
||||
- 工作流应有清晰、描述性的名称
|
||||
- 复杂工作流受益于文档节点或注释
|
||||
- 错误处理节点提高可靠性
|
||||
- 模块化工作流(调用子工作流)提高可维护性
|
||||
|
||||
### 常见模式
|
||||
|
||||
- **数据管道**:触发 → 获取数据 → 转换 → 存储/发送
|
||||
- **集成同步**:定时任务 → API调用 → 比较 → 更新系统
|
||||
- **自动化**:Webhook → 处理 → 条件逻辑 → 执行操作
|
||||
@@ -82,27 +96,32 @@ n8n-workflows/
|
||||
2. **文档生成**:创建解释工作流实现功能的描述,而不仅仅是包含哪些节点。
|
||||
|
||||
3. **故障排除**:常见问题包括:
|
||||
|
||||
- 节点连接不正确
|
||||
- 缺少错误处理
|
||||
- 循环中的低效数据处理
|
||||
- 应该参数化的硬编码值
|
||||
|
||||
4. **优化建议**:
|
||||
|
||||
- 识别冗余操作
|
||||
- 适用场景下建议批处理
|
||||
- 推荐添加错误处理
|
||||
- 建议拆分复杂工作流
|
||||
|
||||
5. **代码生成**:创建分析这些工作流的工具时:
|
||||
|
||||
- 处理各种 n8n 格式版本
|
||||
- 考虑自定义节点
|
||||
- 解析节点参数中的表达式
|
||||
- 考虑节点执行顺序
|
||||
|
||||
## 仓库特定信息
|
||||
|
||||
[在此处添加有关工作流、命名约定或特殊注意事项的任何特定信息]
|
||||
|
||||
## 版本兼容性
|
||||
|
||||
- n8n 版本:[指定这些工作流兼容的 n8n 版本]
|
||||
- 最后更新:[最后一次主要更新的日期]
|
||||
- 迁移说明:[任何特定版本的注意事项]
|
||||
|
||||
Reference in New Issue
Block a user