HackerGPT-2.0 Agent模式全攻略：自动化安全测试核心功能与实战指南

一、功能定位：理解Agent模式的核心价值

定义安全测试自动化框架

Agent模式（自动化任务执行模块）是HackerGPT-2.0的核心功能，通过模拟安全专家思维流程，实现Web应用安全测试的智能化执行。其核心价值在于将传统手动渗透测试流程转化为可配置的自动化任务链，大幅提升测试效率。

两种工作模式对比

• 自动运行模式：适合快速扫描（平均耗时<5分钟），无需人工干预即可完成预设测试流程
• 每次询问模式：适合精细测试（需人工确认3-5个关键节点），在执行关键操作前向用户确认

二、核心组件：构建Agent工作流的关键模块

解析模式配置系统

「模式配置枚举」（路径：app/api/chat/schema.ts）通过z.enum(['auto-run', 'ask-every-time'] as const)定义Agent模式取值范围，确保输入合法性。原理：采用Zod类型验证机制，作用：限制用户选择范围，避免无效配置。

实现交互控制界面

「模式切换组件」（路径：components/messages/terminal-messages/ask-terminal-command-block.tsx）提供可视化模式切换功能：

<Select value={agentMode} onValueChange={setAgentMode}>
  <SelectItem value="auto-run">自动运行</SelectItem>
  <SelectItem value="ask-every-time">每次询问</SelectItem>
</Select>

构建状态管理机制

「自动运行偏好钩子」（路径：components/messages/terminal-messages/use-auto-run-preference.ts）通过localStorage存储用户偏好。原理：利用浏览器本地存储API，作用：实现状态记忆，确保用户偏好跨会话保持。

三、实践指南：从零开始使用Agent模式

部署项目环境

目标：在本地搭建可运行的HackerGPT-2.0环境
命令：

git clone https://gitcode.com/gh_mirrors/ha/HackerGPT-2.0
cd HackerGPT-2.0
npm install
npm run dev

预期结果：控制台显示"ready on http://localhost:3000"

配置工作模式

目标：设置Agent为自动运行模式
操作步骤：

1. 访问http://localhost:3000进入聊天界面
2. 打开设置面板，找到"Agent模式"选项
3. 选择"自动运行"并保存设置

执行安全测试任务

目标：对目标网站执行SQL注入检测
操作步骤：

1. 在聊天输入框输入"检测目标网站是否存在SQL注入漏洞"
2. 观察Agent侧边栏实时显示的测试进度
3. 等待测试完成，查看生成的漏洞报告

💡 技巧：复杂测试任务建议先使用"询问模式"验证关键步骤，确认无误后切换为"自动模式"批量执行。

四、扩展应用：定制Agent功能满足特定需求

开发自定义命令执行器

「终端命令执行器」（路径：lib/ai/tools/agent/terminal-command-executor.ts）支持扩展新测试命令。原理：采用插件化架构设计，作用：允许用户添加自定义安全测试命令，扩展Agent能力边界。

实现测试结果导出

「文件内容展示组件」（路径：components/messages/terminal-messages/file-content-block.tsx）支持测试报告导出。操作：点击测试结果面板的"导出"按钮，选择保存格式（JSON/HTML），获取结构化测试报告。

⚠️ 注意：自定义命令需通过安全审计，避免执行危险操作。建议在沙箱环境中测试新命令。

五、常见问题解决

问题1：Agent无法自动执行命令

解决方案：检查「Agent侧边栏」（路径：components/messages/terminal-messages/agent-sidebar.tsx）是否处于激活状态，通过useAgentSidebar钩子确认状态：

const { agentSidebar, setAgentSidebar } = useAgentSidebar();
if (!agentSidebar) setAgentSidebar(true); // 激活侧边栏

问题2：测试结果显示乱码

解决方案：检查「内容解析器」（路径：components/messages/terminal-messages/content-parser.ts）的编码处理逻辑，确保包含：

// 添加编码转换逻辑
const decodedContent = new TextDecoder('utf-8').decode(result);

通过本文介绍的功能定位、核心组件、实践指南和扩展应用，您可以充分利用HackerGPT-2.0的Agent模式构建自动化安全测试流程，提升Web应用安全测试的效率和准确性。