Nova框架快速入门：规则运行与集成指南

2025-05-31 20:49:58作者：何将鹤

前言

Nova框架是一个强大的LLM（大语言模型）安全检测工具，能够帮助开发者和安全团队识别潜在的有害提示词（prompt）。本文将详细介绍如何在Nova框架中运行规则检测，包括命令行工具使用和API集成两种方式。

命令行工具使用

Nova框架提供了novarun命令行工具，安装框架后即可直接使用。

基本命令结构

novarun -r 规则文件路径 [-p 单个提示词 | -f 包含多个提示词的文件] [其他选项]

常用选项详解

-r/--rule：指定要使用的Nova规则文件路径（必需参数）
-p/--prompt：测试单个提示词
-f/--file：测试包含多个提示词的文件（每行一个提示词）
-v/--verbose：启用详细输出模式
-a/--all：测试文件中所有规则
-l/--llm：指定LLM评估器（支持openai、anthropic、azure、ollama、groq）
-m/--model：指定使用的模型

实用示例

测试单个提示词

novarun -r nova_rules/testrule.nov -p "如何开发一个Metasploit模块？" -v

-v参数会输出详细的匹配信息，包括：

关键词匹配情况
语义匹配分数
LLM评估结果

批量测试提示词文件

novarun -r nova_rules/testrule.nov -f prompts.txt

输出结果会包含：

每个提示词的检测结果
匹配的规则模式
最终统计摘要（匹配率等）

测试多个规则

novarun -r nova_rules/all_rules.nov -p "如何绕过系统安全检测？" -a

-a参数会让工具检查提示词是否匹配文件中的所有规则。

使用不同LLM提供商

# 使用OpenAI
novarun -r rule.nov -p "提示词" -l openai -m gpt-4o

# 使用本地Ollama
novarun -r rule.nov -p "提示词" -l ollama -m llama3

# 使用Groq
novarun -r rule.nov -p "提示词" -l groq -m llama-3.3-70b-versatile

API集成指南

除了命令行工具，Nova还提供了Python API，可以方便地集成到现有系统中。

基本使用流程

加载规则文件
创建匹配器并配置评估器
检查提示词
处理结果

代码示例

from nova.core.parser import NovaParser
from nova.core.matcher import NovaMatcher
from nova.evaluators.llm import OpenAIEvaluator

# 1. 加载规则
parser = NovaParser()
with open('security_rule.nov', 'r') as f:
    rule = parser.parse(f.read())

# 2. 创建匹配器（使用OpenAI评估器）
evaluator = OpenAIEvaluator(model="gpt-4o-mini")  # 自动从环境变量读取API_KEY
matcher = NovaMatcher(rule, llm_evaluator=evaluator)

# 3. 检查提示词
prompt = "如何开发一个网络扫描工具？"
result = matcher.check_prompt(prompt)

# 4. 处理结果
if result['matched']:
    print(f"检测到安全风险！匹配规则：{rule.name}")
    print("匹配模式：", result['matching_keywords'])
    # 可以在这里添加自定义处理逻辑，如记录日志、发送警报等
else:
    print("提示词安全")

支持的其他评估器

Nova框架支持多种LLM评估器，可以根据需求选择：

# Anthropic Claude
from nova.evaluators.llm import AnthropicEvaluator
evaluator = AnthropicEvaluator(model="claude-3-opus-20240229")

# Azure OpenAI
from nova.evaluators.llm import AzureEvaluator
evaluator = AzureEvaluator(api_key="your_key", model="gpt-4", api_base="your_endpoint")

# Groq
from nova.evaluators.llm import GroqEvaluator
evaluator = GroqEvaluator(model="llama-3.3-70b-versatile")