Nuclei SDK中工作流执行问题的分析与解决

问题背景

在使用Nuclei项目的SDK时，开发者发现一个关键功能缺失：虽然可以通过WithTemplatesOrWorkflows选项加载工作流文件，但实际执行时这些工作流却无法正常运行。这个问题影响了需要自动化执行复杂扫描流程的场景。

技术分析

Nuclei SDK的核心执行逻辑位于sdk.go文件中的ExecuteCallbackWithCtx函数。当前实现存在一个明显的设计缺陷：

_ = e.engine.ExecuteScanWithOpts(context.Background(), e.store.Templates(), e.inputProvider, false)

这段代码仅传递了模板(Templates)给执行引擎，而完全忽略了工作流(Workflows)的传递。这与Nuclei命令行工具的行为不一致，命令行工具能够正确处理工作流执行。

问题影响

这个缺陷导致以下具体问题：

1. 工作流文件虽然能被成功加载到存储中
2. 执行引擎初始化过程没有报错
3. 但实际扫描阶段工作流完全被忽略
4. 开发者无法通过SDK实现复杂的多步骤扫描流程

解决方案

修复方案的核心思想是确保工作流能够被正确传递给执行引擎。具体实现需要考虑：

1. 修改执行逻辑，同时传递模板和工作流
2. 保持与Nuclei核心引擎的兼容性
3. 确保不影响现有模板执行功能
4. 维护SDK的简洁API设计

实现验证

通过修改后的SDK执行一个示例工作流，可以观察到：

1. 工作流文件被正确加载
2. 执行引擎识别并处理工作流定义
3. 工作流中的各个步骤按预期顺序执行
4. 最终输出符合预期的扫描结果

最佳实践建议

对于使用Nuclei SDK的开发者，建议：

1. 明确区分模板和工作流的使用场景
2. 复杂扫描流程优先使用工作流实现
3. 定期检查SDK版本以确保获取最新修复
4. 测试环境验证工作流执行效果

总结

Nuclei SDK的工作流执行问题是一个典型的功能实现不完整案例。通过分析执行流程并修正核心逻辑，可以恢复完整的工作流支持能力。这个修复不仅解决了功能缺失问题，也为开发者提供了更强大的自动化扫描能力。