N8n 1.0.2

核心用法

n8n 技能提供完整的 n8n 自动化平台管理能力，通过 REST API 实现工作流生命周期管理。支持 Shell 脚本与 Python API 两种调用方式，涵盖工作流列表查询、激活/停用、执行记录追踪、手动触发执行及调试排错等核心功能。

主要功能模块：

• 工作流管理：查询全部或活跃工作流、获取详情、批量启停
• 执行监控：查看历史执行记录、筛选特定工作流执行、获取详细日志
• 手动触发：支持带参数触发工作流，便于测试与应急执行
• 调试排错：快速定位失败执行、分析错误模式、一键停用异常工作流

显著优点

1. 双模式调用：Shell 脚本适合运维场景快速操作，Python API 便于集成到现有系统
2. 完整生命周期覆盖：从开发测试到生产监控的全阶段管理能力
3. 灵活的执行追踪：支持按工作流 ID 过滤、限制返回数量，便于大数据量场景
4. 调试友好：--pretty 格式化输出、详细的错误信息、清晰的故障排查指南

潜在缺点与局限性

• 环境依赖：需要提前配置 Python 虚拟环境及环境变量，首次 setup 步骤较多
• 单点认证：依赖单一的 API Key 认证，缺乏多因素验证机制
• 权限粒度粗：API Key 通常具备实例级权限，无法细粒度控制到单个工作流
• 无内置缓存：频繁调用可能受 n8n 实例 API 限流影响

适合人群

• 自动化工程师：需要批量管理数十至数百个工作流
• DevOps/运维人员：负责 n8n 实例稳定性监控与故障响应
• 低代码开发者：在 n8n 中构建复杂自动化后，需要程序化控制工作流
• 技术团队负责人：需要审计工作流执行状态与资源使用

常规风险

• 密钥泄露风险：API Key 存储在 shell 环境变量中，存在被进程导出或日志记录的可能
• 误操作风险：一键停用/删除可能影响生产关键流程，建议配合变更管理流程
• 网络暴露：若 N8N_BASE_URL 使用公网地址且未启用 HTTPS，存在中间人攻击风险
• 执行注入：手动触发时的 --data 参数若包含用户输入，需防范 JSON 注入攻击

建议生产环境启用 n8n 的访问日志审计、定期轮换 API Key、对敏感工作流启用审批流程后再执行。

核心用法

n8n Skill 是一款面向 n8n 自动化平台的管理型工具，通过 REST API 接口实现对工作流的远程操控。用户可通过命令行脚本或 Python API 完成工作流的列出、详情查看、激活/停用、手动触发执行、执行记录查询等核心操作。支持环境变量配置认证信息，提供结构化的 JSON 输出和美化展示选项，便于集成到自动化运维脚本或 CI/CD 流程中。

显著优点

1. 操作全面覆盖：完整支持 n8n 工作流的生命周期管理，从日常监控到故障调试均有对应命令
2. 双重调用方式：既提供便捷的 Shell 脚本接口，也支持 Python 程序化调用，满足不同场景需求
3. 安全认证机制：API 密钥和实例地址均从环境变量读取，无硬编码敏感信息泄露风险
4. 输出友好可读：内置 --pretty 美化输出选项，降低 JSON 解析门槛
5. 轻量依赖设计：仅依赖 requests 标准库，无臃肿第三方包，部署快速

潜在缺点与局限性

1. 依赖版本未锁定：requests 库使用 >=2.28.0 宽松版本约束，存在供应链更新风险
2. 输入验证不足：workflow_id 等参数未做严格格式校验，极端情况下可能引发路径遍历问题
3. 网络超时缺失：当前实现未配置请求超时参数，网络异常时可能长时间阻塞
4. 错误粒度较粗：异常处理统一为通用捕获，难以区分认证失败、API 限流、实例不可用等具体场景
5. 来源为个人开发者：维护者 pntrivedy 属 T3 级别，长期维护承诺需持续观察

适合的目标群体

• DevOps 工程师：需要批量管理多个 n8n 实例、集成到运维自动化体系
• 自动化运维人员：负责监控工作流健康状态、处理执行失败的日常巡检
• n8n 重度用户：拥有大量工作流、需要远程激活/停用而不频繁登录 UI 的场景
• CI/CD 集成场景：需要在部署流程中自动触发特定工作流的开发团队

使用风险

• 供应链风险：requests 库版本未锁定，建议自行固定到 2.32.3 等稳定版本
• 网络可用性：完全依赖目标 n8n 实例的网络可达性，建议配置超时和重试机制
• 权限泄露：API 密钥存储于环境变量，需确保 ~/.zshrc 等配置文件权限正确（建议 600）
• 误操作风险：activate/deactivate/execute 等命令直接影响生产工作流，建议在执行前二次确认
• 数据一致性：手动触发执行时若传递数据格式错误，可能导致工作流执行异常但返回成功状态码