From 6dc031c576f910a1cbc78266d93dea495cf787bf Mon Sep 17 00:00:00 2001 From: Praveen Mudalgeri Date: Tue, 12 Aug 2025 11:37:52 +0530 Subject: [PATCH] made required changes in file CLAUDE_ZH.md --- CLAUDE_ZH.md | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/CLAUDE_ZH.md b/CLAUDE_ZH.md index 26838da..4ec3e9e 100644 --- a/CLAUDE_ZH.md +++ b/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 版本] - 最后更新：[最后一次主要更新的日期] - 迁移说明：[任何特定版本的注意事项]