名称： n8n-hub
描述： 集中式 n8n 中心，用于设计可靠的工作流（幂等性、重试、人工介入）并通过公共 REST API 进行操作。适用于规划、JSON 输出以及列出/发布/调试等生命周期操作。

n8n 中心

此技能融合了两个方向：
1) 设计：规划可靠的工作流，并可选择导出 workflow.json。
2) 操作：通过公共 REST API 管理工作流和执行记录。

可用性

• 免费试用计划无法访问公共 API。
• 需要使用升级版计划才能调用 API。

配置

建议的环境变量（或存储在 .n8n-api-config 文件中）：

export N8N_API_BASE_URL="https://your-instance.app.n8n.cloud/api/v1"  # 或 http://localhost:5678/api/v1
export N8N_API_KEY="your-api-key-here"

创建 API 密钥的位置：n8n 设置 → n8n API → 创建 API 密钥。

适用场景

• 您需要构建具备幂等性、重试机制、日志记录和审核队列的工作流。
• 您需要可导入的 workflow.json 文件以及操作手册模板。
• 您希望通过 API 列出、发布、停用或调试工作流/执行记录。

不适用场景

• 您需要纯代码自动化，不使用 n8n。
• 您希望绕过安全控制或隐藏审计追踪。

输入

必需项
- 触发器类型 + 调度计划/时区
- 成功标准和目标位置（电子邮件/云端硬盘/数据库）

可选项
- 现有的工作流 JSON
- 示例负载/记录
- 去重键

输出

• 默认：设计规范（节点、数据契约、故障模式）
• 按需提供：workflow.json + workflow-lab.md（来自 assets/workflow-lab.md）

认证请求头

所有请求必须包含：

X-N8N-API-KEY: $N8N_API_KEY

快速操作（API）

工作流：列出

curl -s -H "X-N8N-API-KEY: $N8N_API_KEY" "$N8N_API_BASE_URL/workflows" \
  | jq '.data[] | {id, name, active}'

工作流：详情

curl -s -H "X-N8N-API-KEY: $N8N_API_KEY" "$N8N_API_BASE_URL/workflows/{id}"

工作流：激活或停用

# 激活（发布）
curl -s -X POST -H "X-N8N-API-KEY: $N8N_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"","name":"","description":""}' \
  "$N8N_API_BASE_URL/workflows/{id}/activate"

# 停用
curl -s -X POST -H "X-N8N-API-KEY: $N8N_API_KEY" \
  "$N8N_API_BASE_URL/workflows/{id}/deactivate"

Webhook 触发器

curl -s -X POST "$N8N_API_BASE_URL/../webhook/{webhook-path}" \
  -H "Content-Type: application/json" \
  -d '{"key":"value"}'

执行记录：列出

curl -s -H "X-N8N-API-KEY: $N8N_API_KEY" \
  "$N8N_API_BASE_URL/executions?limit=10" \
  | jq '.data[] | {id, workflowId, status, startedAt}'

执行记录：重试

curl -s -X POST -H "X-N8N-API-KEY: $N8N_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"loadWorkflow":true}' \
  "$N8N_API_BASE_URL/executions/{id}/retry"

工作流设计清单

1. 确认触发器类型和调度计划/时区。
2. 定义输入、输出和验证规则。
3. 选择去重键以确保运行幂等性。
4. 添加可观测性（运行ID、日志、状态行）。
5. 添加重试策略和错误分支。
6. 将失败记录发送到审核队列。
7. 添加防护措施，防止静默失败。

端点索引

完整端点列表请参见 assets/endpoints-api.md。

注意事项与提示

• API 调试界面仅在自托管的 n8n 实例中可用，并使用真实数据。
• n8n API 节点可以从工作流内部调用公共 API。
• Webhook URL 不需要 API 密钥请求头。
• 执行记录数据可根据保留设置进行清理。