核心用法
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、对敏感工作流启用审批流程后再执行。