# Flagent 多智能体并发框架

基于 Vercel AI SDK 的多智能体协作框架，面向 CTF 攻防与安全研究场景。采用 **MainAgent 主控 + 5 类专家 SubAgent** 架构，支持并发 ReAct、动态子智能体注册与权限管控。

## ✨ 特性

- **并发 ReAct 主控**：MainAgent 拥有全部工具并可直接执行，一次输出多个 `ACTIONS`（并发只读采集）与多个 `DELEGATE`（并发委派），统一思考再推进
- **侦察 → 分类 → 深挖**：非强制状态机的 prompt 工程方法论，先并发侦察再分类，避免未侦察就硬路由
- **5 类 CTF 专家子智能体**：`web` / `pwn` / `reverse` / `crypto` / `misc`，各自独立 context 与工具子集
- **动态子智能体**：`registerDynamicAgent` + `SPAWN_AGENT` —— 不落进预设类别的新题可按需 spawn 通用深挖 agent
- **后台任务管理**：`BackgroundManager` 单例驱动后台分析任务，6 态状态机（PENDING→RUNNING→{COMPLETED|CRASHED|CANCELLED|STUCK}），心跳机制 + 卡死检测（默认 90s 预警 / 5min 判死），CLI 30s 自动健康报告，`/bgstart` `/bg` `/status` `/kill` 命令
- **AbortSignal 取消 + 工具级超时**：MainAgent 每步检查取消信号，ToolExecutor 为每个工具注入 `Promise.race` 超时包装（默认 2min），任务级取消一键传播
- **PWN 专业反汇编**：集成 `objdump` / `checksec` / `radare2` / `ROPgadget` / `nm` 五大系统级工具，覆盖静态分析到 ROP gadget 搜索全链路
- **多平台 LLM 切换**：支持 `qianwen`（千问 DashScope）/ `bailian`（百炼 Workspace）/ `anthropic`（Anthropic API）三平台，CLI `/platform` 一键切换并写回配置
- **并发安全**：ContextManager Promise 链式锁、ToolExecutor 信号量限流（默认 8）、PermissionManager 双检锁
- **权限管控**：副作用工具（`command_exec` 等）逐次确认，本会话记忆，CLI `/permissions` 查看
- **上下文管理**：滑动窗口 + Token 超阈值自动 LLM 摘要，`/summarize` 手动触发
- **会话管理**：Claude-Code 式多会话，每会话独立上下文/权限/动态 agent，磁盘持久化（`.flagent/sessions/`），CLI `/new` `/sessions` `/switch` `/delete` 切换/恢复，可并行分析多道题
- **类型安全工具系统**：Zod v4 Schema 参数校验，`concurrent` / `requirePermission` 元数据标记
- **双入口**：CLI 终端交互 + VSCode 扩展（Webview 面板 + 命令面板），共用同一套 agent 构造工厂

## 🏗️ 项目结构

```
flagent/
├── src/
│   ├── llm/
│   │   ├── client.ts                # LLM 客户端（qianwen/bailian/anthropic 三平台）
│   │   ├── global-config.ts         # 全局 LLM 配置（平台/apiKey/workspaceId/model 持久化）
│   │   └── classify-error.ts        # LLM 错误分类器（超时/限流/配额/内容过滤）
│   ├── context/
│   │   └── context-manager.ts       # 上下文管理器（并发安全锁 + 滑动窗口 + 自动摘要）
│   ├── permissions/
│   │   └── permission-manager.ts    # 权限管理器（双检锁 + 会话记忆）
│   ├── tools/
│   │   ├── registry.ts              # 工具注册表（Zod 校验 + concurrent/requirePermission 元数据）
│   │   ├── web-tools.ts             # Web 攻防工具（15 个：http_request/port_scan/sql_injection_test/ssti_test…）
│   │   ├── pwn-tools.ts             # Pwn 工具（16 个：binary_analysis/pwn_objdump/pwn_checksec/pwn_radare2/pwn_rop_gadget/pwn_nm…）
│   │   ├── reverse-tools.ts         # 逆向工具（9 个：packer_detect/pseudocode_gen/js_deobfuscate…）
│   │   ├── crypto-tools.ts          # 密码学工具（11 个：rsa_advanced/lll_reduction/mt19937_predict…）
│   │   ├── misc-tools.ts            # 杂项工具（15 个：image_stego_check/traffic_analysis/memory_forensics/command_exec…）
│   │   ├── default-tools.ts         # 默认 mock 工具（web_search/code_search/file_read…）
│   │   ├── factory.ts               # createToolRegistry（5 套工具一次注册，跨会话共享）
│   │   └── index.ts
│   ├── agents/
│   │   ├── main-agent.ts            # 并发 ReAct 主控（多 ACTIONS/DELEGATE/PLAN/SPAWN_AGENT + AbortSignal + heartbeat）
│   │   ├── sub-agent.ts             # 子智能体（独立 context + 工具越权隔离）
│   │   ├── scheduler.ts             # 调度器（route + dispatchConcurrent + registerDynamicAgent）
│   │   ├── tool-executor.ts         # 统一工具执行（并发限流 + 权限 + 串行/并发分组 + 信号超时）
│   │   ├── background-manager.ts    # 后台任务管理器（6 态状态机 + 心跳/卡死/取消/健康检查）
│   │   ├── react-parser.ts          # ReAct 响应解析器（公共 + MainAgent 多动作解析）
│   │   ├── factory.ts               # createAgentSystem（CLI/VSCode 唯一装配真相源）
│   │   └── index.ts
│   ├── session/
│   │   ├── session-data.ts          # 会话序列化结构（SessionData/SerializableMessage）
│   │   ├── session-store.ts         # 磁盘持久化（.flagent/sessions/<id>.json）
│   │   ├── session.ts               # 单会话封装（agent 图 + 序列化/反序列化 + runBackground）
│   │   ├── session-manager.ts       # 会话集合管理（创建/切换/恢复/删除）
│   │   └── index.ts
│   ├── cli/index.ts                 # CLI 入口（SessionManager + 会话/平台/后台命令 + 30s 健康轮询）
│   ├── vscode/
│   │   ├── extension.ts             # VSCode 扩展入口（SessionManager + 侧边栏会话树 + 会话感知 webview）
│   │   ├── session-tree-provider.ts # 侧边栏会话树数据源（活跃高亮/点击切换）
│   │   ├── media/                   # 活动栏/按钮 SVG 图标
│   │   ├── package.json             # 扩展 manifest（视图/命令/菜单）
│   │   └── tsconfig.json
│   └── index.ts                     # 库导出
├── tests/                           # 测试用例（单元 + e2e + verify-background）
├── .env.example
├── tsconfig.json
└── package.json
```

## 🚀 快速开始

### 1. 安装依赖

```bash
npm install
```

### 2. 配置环境变量

```bash
cp .env.example .env
# 编辑 .env 填入真实 API Key
```

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `DASHSCOPE_API_KEY` | 阿里云百炼 API Key（qianwen/bailian 平台） | - |
| `ANTHROPIC_API_KEY` | Anthropic API Key（anthropic 平台） | - |
| `LLM_PLATFORM` | LLM 平台：`qianwen` / `bailian` / `anthropic` | `bailian` |
| `WORKSPACE_ID` | 百炼 Workspace ID（仅 bailian 平台） | `llm-v7cepeucys535ynp` |
| `MODEL_NAME` | 模型名称 | 平台相关（qwen3.8-max / claude-sonnet-4-20250514） |

也可在 CLI 中用 `/platform`、`/model`、`/apikey` 动态切换并持久化写盘。

### 3. 构建 & 运行 CLI

```bash
npm run build
npm run cli
```

### 4. CLI 交互命令

CLI 启动时自动恢复最近会话（若无历史会话，首次提问自动新建）。会话持久化到 `.flagent/sessions/`，重启后可 `/switch` 恢复（消息/权限/动态 agent/历史 steps 全还原）。

**会话管理**（每会话独立上下文/权限/动态 agent，可并行分析多道题）：

| 命令 | 说明 |
|------|------|
| `/new [标题]` | 新建会话并切为活动 |
| `/sessions` | 列出所有会话（标记当前活动会话） |
| `/switch <id>` | 切换会话（支持 id 短前缀；不在内存则从磁盘恢复） |
| `/delete <id>` | 删除指定会话（内存 + 磁盘） |
| `/title [标题]` | 查看或设置当前会话标题 |

**会话内命令**：

| 命令 | 说明 |
|------|------|
| `/help` | 显示帮助 |
| `/agents` | 查看所有子智能体（含动态注册的） |
| `/tools` | 查看所有可用工具 |
| `/context` | 查看当前会话上下文状态（消息数/Token/摘要） |
| `/summarize` | 手动生成对话摘要（窗口外消息压缩） |
| `/permissions` | 查看本会话已批准的副作用工具 |
| `/platform [qianwen\|bailian\|anthropic]` | 查看/切换 LLM 平台，写回全局配置 |
| `/model [名称]` | 查看/切换模型 |
| `/apikey [key]` | 查看/设置 API Key（屏蔽显示） |
| `/bgstart <任务描述>` | 启动后台分析任务（独立线程，前台不阻塞） |
| `/bg [任务ID]` | 列出所有后台任务或查看指定任务详情 |
| `/status [任务ID]` | 查看后台任务健康状态（含 thought/tool 历史） |
| `/kill <任务ID\|all>` | 取消后台任务 |
| `/clear` | 清除当前会话的对话历史与权限记忆 |
| `/exit` | 退出系统 |

后台任务运行期间，CLI 每 30 秒自动打印一次健康报告，若发现 STUCK / CRASHED 会红字提醒。

## 🧩 核心架构

### 并发架构总览

```
用户任务
  └─ MainAgent（主控，拥有全部工具）
       ├─ PLAN: 侦察目标 + 总体方案（可选，简单任务可跳过）
       ├─ ACTIONS: 并发只读采集（多个 concurrent 工具同时跑）
       │     └─ ToolExecutor（信号量限流 + 权限确认 + 工具级超时）
       ├─ SPAWN_AGENT: 按需注册通用深挖 agent（新题）
       └─ DELEGATE: 并发委派多个专家 SubAgent（各自独立 ReAct）
            └─ 统一落库观察 → 下一步统一思考 → FINAL_ANSWER

  后台模式：/bgstart → BackgroundManager
       ├─ 创建任务（PENDING→RUNNING）+ AbortController
       ├─ MainAgent.run(signal, toolTimeoutMs) → 每步 heartbeat()
       ├─ 健康检查（每 30s）：idleMs > 90s WARNING / > 5min STUCK
       └─ /kill → abort() → MainAgent 抛出 AbortError → CRASHED/CANCELLED
```

方法论（**侦察 → 分类 → 深挖**，非强制状态机）：
1. **侦察**：复杂任务第一步优先并发只读采集，先获取事实再判断，不在未侦察前凭字面猜类别硬路由
2. **分类**：基于观察自主归类（web/pwn/reverse/crypto/misc，或判断为新题）
3. **深挖**：MainAgent 继续用工具深入，或并发 DELEGATE 给专家；新题可 SPAWN_AGENT 自定义通用 agent

### ContextManager（上下文管理器）

- **并发安全**：`runLocked` Promise 链式锁串行化所有写入，`addMessagesBatch` 批量落库只触发一次锁
- **滑动窗口**：始终保留最近 N 条消息（默认 10 条）
- **自动摘要**：Token 超阈值时自动 LLM 压缩旧消息；`summarizeNow()` 支持手动触发
- **Token 估算**：按 `字符数 / 4` 估算

### ToolRegistry（工具注册表）

基于 Zod v4 Schema 的类型安全工具系统，每个工具带元数据：
- `concurrent: true` — 只读采集工具，可安全并发执行（如 `http_request`）
- `requirePermission: true` — 副作用工具，需逐次权限确认（如 `command_exec`）

`getToolDescriptions()` 将 Zod schema 推断为 JSON schema（用 `instanceof` 判定，跨 zod 版本稳健）。

### ToolExecutor（统一工具执行入口）

MainAgent 与所有 SubAgent 共用，统一权限与并发策略：
1. 串行确认所有 `requirePermission` 工具（PermissionManager 自带锁）
2. 拒绝的标记 `skipped` 不执行
3. `concurrent: true` 的只读工具**并发执行**（信号量限流，默认上限 8）；其余串行（保守避免副作用冲突）
4. 工具执行抛错 / Zod 校验失败均被捕获，返回 `success: false`
5. 保持原顺序返回结果

### PermissionManager（权限管理器）

- **会话记忆**：同一工具在本会话确认一次后不再询问（按工具名记忆）
- **双检锁**：fast-path 无锁读 `approved` → 未命中进锁 → **锁内复检**再询问，确保并发场景同一工具只弹一次窗
- **拒绝不记忆**：被拒的工具下次仍会询问（避免一次拒绝永久封锁）

### SubAgent（子智能体）

5 类 CTF 专家，各自独立 ContextManager（context 隔离）+ 共享 ToolExecutor（统一权限/并发），`maxSteps: 8`：

| 智能体 | 角色 | 工具数 | 代表工具 |
|--------|------|--------|----------|
| `web` | Web 攻防专家 | 15 | `http_request` `port_scan` `dir_bruteforce` `sql_injection_test` `xss_test` `ssti_test` `ssrf_test` `file_upload_test` `header_analysis` `dns_lookup` `ssl_info` |
| `pwn` | 二进制漏洞挖掘与利用专家 | 17 | `binary_analysis` `extract_strings` `vulnerability_scan` `disassemble` `hex_view` `elf_got_plt_analysis` `exploit_template` `nc_remote_client` `memory_layout` `pwn_static_analysis` `pwn_check_env` `pwn_run_exploit` `pwn_objdump` `pwn_checksec` `pwn_radare2` `pwn_rop_gadget` `pwn_nm` |
| `reverse` | 逆向工程与代码分析专家 | 11 | `binary_analysis` `disassemble` `packer_detect` `code_deobfuscate` `binary_compare` `apk_analysis` `pseudocode_gen` `js_deobfuscate` `dotnet_decompile` |
| `crypto` | 密码分析与破解专家 | 11 | `encode_decode` `hash_crack` `classical_cipher` `rsa_tool` `rsa_advanced` `aes_encrypt` `des_encrypt` `modular_arithmetic` `lll_reduction` `mt19937_predict` |
| `misc` | 隐写分析与取证专家 | 15 | `file_type_detect` `entropy_analysis` `image_stego_check` `qr_decoder` `archive_crack` `traffic_analysis` `memory_forensics` `file_search_content` `command_exec` |

**工具越权隔离**：SubAgent 仅能调用其 `toolNames` 集合内的工具，越权调用直接返回 `[工具越权]` 拒绝执行。

### Scheduler（调度器）

- `route(task)` — 单智能体直接路由（无 LLM）；多智能体用 LLM 分析任务语义选择最合适执行方
- `dispatchConcurrent(requests)` — **并发委派**多个 SubAgent，`Promise.all` 并发 `run()`，未找到的标记失败不影响其他
- `registerDynamicAgent(config)` / `unregisterDynamicAgent(id)` — 动态注册/注销通用 SubAgent（决策四：给新题留口子），id 唯一校验、toolNames 过滤到注册表

### MainAgent（并发 ReAct 主控）

一次 ReAct 步骤可同时输出：
- `PLAN` — 总体方案（可选，通常仅第一步）
- `ACTIONS` — 多个工具调用，并发执行
- `SPAWN_AGENT` — 动态注册通用 agent
- `DELEGATE` — 多个专家 agent，并发委派
- `FINAL_ANSWER` — 任务完成

工具采集与子智能体委派**同时并发推进**（`Promise.all`），结果统一落库供下一步思考。每步记录 `thought` / `action` / `observation` / `agentId` / `plan`。

`run()` 方法支持 `AbortSignal`（取消信号）和 `toolTimeoutMs`（工具级超时），每步 stepStart/planning/react 前检查信号，在 stepStart/toolStart/toolResult 等节点调用 `heartbeat()` 刷新活动时间戳。

### BackgroundManager（后台任务管理器）

单例模式（`getBackgroundManager()`），让耗时分析任务在后台运行，前台定时检查卡死/crash。

- **6 态状态机**：`PENDING → RUNNING → {COMPLETED | CRASHED | CANCELLED | STUCK}`
- **心跳机制**：`heartbeat()` 刷新 `lastActivityAt`；`markStart()` / `markStep()` / `markComplete()` / `markCrash()` 驱动状态流转
- **健康检查**：`healthCheck()` 按 `idleMs` 分三档：`HEALTHY`（< warn 90s）/ `WARNING`（>= 90s）/ `STUCK`（>= 5min 自动标记）
- **取消传播**：`cancel(taskId)` 触发 `AbortController.abort()`，MainAgent 每步检查信号后抛出 `AbortError`
- **工具级超时**：`toolTimeoutMs`（默认 2min）通过 `Promise.race` 包装每个工具执行，超时返回错误并建议调小阈值
- **清理**：`cleanup(retentionMs)` 清理已结束且超过保留窗口的任务
- **事件回调**：`onBackgroundEvent(taskId, event)` 将 AgentEvent（thought/tool/delegate 等）实时回调给调用方

## 🗂️ 会话管理（Session）

Claude-Code 式多会话，让 CLI 可在不同 session 分析不同题目，互不干扰。

- **隔离边界**：每会话独立 `ContextManager`（主对话）/ `MainAgent`（steps）/ `PermissionManager`（approved）/ `Scheduler`（预设+动态 agent）；跨会话共享无状态的 `ToolRegistry` 与 LLM client
- **持久化**：`.flagent/sessions/<id>.json`，存主对话（messages+summary）、历史 steps、已批准工具、动态 agent 配置；子 agent context 为瞬时态不持久化
- **恢复**：`Session.fromData` 重建 —— 预置 approved → `createAgentSystem` → `restoreMessages` → 重注册动态 agent → `setSteps`
- **首问自动命名**：`Session.run` 首次以任务前 30 字派生标题

作为库使用时，可直接用 `SessionManager` 驱动多会话：

```typescript
import { SessionManager, createToolRegistry, PermissionManager } from "flagent";

const toolRegistry = createToolRegistry();
const mgr = new SessionManager({
  toolRegistry,
  confirmFn: async () => true, // 自定义副作用工具确认
});

const sessionA = await mgr.create("题一");
await mgr.switch(sessionA.id);
await mgr.run("分析这道 web 题..."); // 在 sessionA 上下文内执行并自动持久化

const sessionB = await mgr.create("题二");
await mgr.run("分析这道 crypto 题..."); // 在 sessionB 上下文内执行，与 A 互不污染

// 重启后从磁盘恢复
const restored = await mgr.resume(sessionA.id);
```

## 🖥️ VSCode 扩展

```bash
cd src/vscode
npm install
npm run compile
```

> 需先在项目根目录 `npm run build` 生成 `dist/`（扩展的运行依赖会随扩展一并编译进 `out/`）。

**LLM 配置**（扩展专属）：通过 VSCode 设置 `flagent.*` 注入，优先级 **>** 项目根 `.env`。

| 设置项 | 默认值 | 说明 |
|--------|--------|------|
| `flagent.apiKey` | _(空)_ | DashScope API Key（**必填**），为空时发起对话会弹窗提示打开设置 |
| `flagent.workspaceId` | `llm-v7cepeucys535ynp` | DashScope workspace ID（会自动重算 `baseUrl`） |
| `flagent.model` | `qwen3.8-max` | 模型名称 |

修改 `settings.json` 后即时生效（无需重启窗口）；另可执行 `Flagent: 重新加载 LLM 配置` 手动刷新。

**侧边栏会话管理**：活动栏新增 **Flagent** 入口，侧边栏「会话」视图列出所有会话（活跃会话以蓝点标记、按更新时间倒序）。

| 操作 | 方式 |
|------|------|
| 新建会话 | 视图标题栏 `+` 按钮 / 命令面板 `Flagent: 新建会话` |
| 切换会话 | 点击会话项 / 命令面板 `Flagent: 切换会话` |
| 重命名 / 删除 | 会话项右键菜单 |
| 刷新列表 | 视图标题栏刷新按钮 |

会话持久化到工作区 `.flagent/sessions/`（与 CLI 共享同一目录），活动会话记忆在 `workspaceState`，重开窗口自动恢复。对话面板绑定当前会话，切换会话即重载该会话的消息历史。`Flagent: 显示状态` 会一并输出当前生效的 LLM 配置。

可用命令：`Flagent: 开始对话` / `Flagent: 打开对话面板` / `Flagent: 分析选中代码` / `Flagent: 清除当前会话上下文` / `Flagent: 显示状态` / `Flagent: 重新加载 LLM 配置` / 会话管理系列命令。

## 📦 作为库使用

```typescript
import {
  ContextManager,
  ToolRegistry,
  MainAgent,
  Scheduler,
  ToolExecutor,
  PermissionManager,
  BackgroundManager,
  getBackgroundManager,
  createWebTools,
  createPwnTools,
  createReverseTools,
  createCryptoTools,
  createMiscTools,
} from "flagent";

async function main() {
  // ① 构建工具注册表（concurrent/requirePermission 元数据）
  const toolRegistry = new ToolRegistry();
  for (const t of createWebTools().getAll()) toolRegistry.register(t);
  for (const t of createPwnTools().getAll()) toolRegistry.register(t);
  // ...其余工具集

  // ② 权限管理器（副作用工具确认）+ 统一工具执行入口（并发限流）
  const permissionManager = new PermissionManager(
    async (toolName, args) => {
      // 自定义确认逻辑，返回 true/false
      return true;
    }
  );
  const toolExecutor = new ToolExecutor(toolRegistry, permissionManager, 8);

  // ③ 调度器（注入 toolExecutor 供动态 agent 使用）
  const scheduler = new Scheduler(toolRegistry, toolExecutor);

  // ④ 动态注册一个通用深挖 agent（决策四）
  scheduler.registerDynamicAgent({
    id: "gen-custom",
    name: "自定义专家",
    role: "通用分析员",
    systemPrompt: "你是通用分析员…",
    toolNames: ["http_request", "file_type_detect"],
    maxSteps: 6,
  });

  // ⑤ MainAgent 主控
  const mainAgent = new MainAgent(
    new ContextManager(),
    toolRegistry,
    scheduler,
    toolExecutor,
    20 // maxSteps
  );

  const result = await mainAgent.run("分析 http://example.com 的安全性");
  console.log(result.finalAnswer);
  console.log(`步数: ${result.steps.length}, 耗时: ${result.duration}ms`);
}
```

## 🧪 测试

先 `npm run build` 生成 dist，再运行测试：

| 命令 | 范围 | 说明 |
|------|------|------|
| `npm test` / `npm run test:unit` | 阶段 0–10 单元 + 边界场景 + 后台/PWN 验证 | 325+ 项，无需网络/LLM（全 mock） |
| `npm run test:e2e` | 阶段 6/7/8/9/10 e2e | 5 项，真实 LLM + 网络抓取，需 `.env` |

测试覆盖：

- **`tests/stage{0..10}.test.js`** — 各阶段功能单元测试（stage10 覆盖会话序列化往返/磁盘持久化/切换恢复删除/上下文与权限隔离）
- **`tests/edge-cases.test.js`** — 边界场景与错误处理（重复注册/未知工具/参数校验失败/工具抛错/权限拒绝并发/工具越权/解析容错/zod schema 推断等）
- **`tests/verify-background.test.js`** — 后台任务管理器（10 项：单例/状态流转/心跳/卡死检测/取消/列表/清理/事件回调）+ PWN 专业工具 smoke（12 项：5 个工具的文件不存在/参数校验/注册元数据）
- **`tests/e2e-*.test.js`** — 端到端真实 LLM 验证（并发抓取/动态 agent/简单任务跳过工具/编程式构建/双会话隔离 + resume 还原）

## 🛠️ 技术栈

- **Vercel AI SDK v4**（`ai`、`@ai-sdk/openai`）— 统一接入千问 DashScope / 百炼 Workspace / Anthropic API（OpenAI 兼容模式）
- **Zod v4** — 运行时类型校验
- **TypeScript**（strict）— 类型安全
- **Node.js ≥ 18**

## 🧭 CTF 题型覆盖与扩展规划

### 当前覆盖（5 类预设 SubAgent + 66 个工具）

| 题型 | 覆盖度 | SubAgent | 工具数 | 说明 |
|------|--------|----------|--------|------|
| Web | 充分 | `web` | 15 | SQL注入/XSS/SSRF/SSTI/命令注入/文件包含/文件上传/反序列化/目录爆破/端口扫描/DNS/SSL 全覆盖 |
| Pwn | 充分 | `pwn` | 17 | 二进制分析/漏洞扫描/GOT-PLT/ROP gadget/checksec/objdump/radare2/pwntools 执行齐备 |
| Reverse | 充分 | `reverse` | 11 | 反汇编/伪代码/壳检测/混淆检测/APK/JS/.NET/Java 反编译齐全 |
| Crypto | 充分 | `crypto` | 11 | 古典密码/对称(RSA/AES/DES)/RSA高级攻击/格规约/MT19937/模运算齐全 |
| Misc | 较充分 | `misc` | 15 | 隐写(图片/音视频/文档)/流量分析/内存取证/压缩包爆破/二维码/文件识别齐备 |

### 缺失题型与扩展建议

以下题型在当前 CTF 赛事中高频出现但尚未覆盖，可通过 `Scheduler.registerDynamicAgent()` 动态注册或补入 `factory.ts` 扩展：

| 题型 | 优先级 | 建议 SubAgent | 建议核心工具 |
|------|--------|---------------|-------------|
| **Forensics 取证** | 高 | `forensics` | `disk_forensics`（磁盘镜像/dd/E01）、`filesystem_analyze`（NTFS/EXT4/APFS）、`registry_analyze`（Windows 注册表 hive）、`log_forensics`（事件日志/syslog）、`timeline_reconstruct`（MAC时间+日志重建）、`volatility_plugin`（Volatility 3 封装）、`pcap_deep_analyze`（协议还原/文件提取） |
| **Mobile 移动安全** | 高 | `mobile` | `apk_deep_analysis`（apktool反编译+资源解析）、`dex_decompile`（jadx DEX→Java）、`smali_edit`（Smali编辑+重打包）、`frida_hook`（动态hook脚本执行）、`ipa_analysis`（iOS IPA分析）、`ssl_pinning_bypass`（证书绑定绕过） |
| **Blockchain 区块链** | 中 | `blockchain` | `sol_disassemble`（Solidity反汇编）、`evm_decompile`（EVM字节码反编译）、`contract_audit`（漏洞审计）、`reentrancy_test`（重入攻击PoC）、`slither_scan`（Slither静态分析）、`tx_trace_analyze`（链上交易trace）、`rpc_query`（JSON-RPC查询） |
| **OSINT 开源情报** | 中 | `osint` | `web_search_real`（真实搜索引擎API）、`whois_lookup`、`social_media_search`（社交媒体关联）、`geo_locate`（GPS/IP地理定位）、`image_exif_analyze`（EXIF元数据）、`reverse_image_search`（反向图片搜索）、`subdomain_enum`（子域名枚举）、`wayback_lookup`（历史快照） |
| **Cloud 云安全** | 中低 | `cloud` | `iam_enum`（AWS/Aliyun IAM枚举）、`s3_bucket_scan`（对象存储权限检测）、`container_escape_test`（容器逃逸）、`k8s_attack`（K8s攻击）、`cloud_metadata_exploit`（元数据服务利用）、`terraform_audit`（IaC配置审计） |
| **IoT 物联网** | 中低 | `iot` | `firmware_extract`（binwalk固件提取）、`binwalk_scan`（签名扫描）、`uart_jtag_detect`（UART/JTAG接口识别）、`mqtt_analyze`（MQTT协议分析）、`coap_analyze`（CoAP协议分析）、`iot_protocol_fuzz`（协议Fuzz） |
| **AI/ML 对抗** | 低（前沿） | `aiml` | `prompt_injection_test`（Prompt注入）、`jailbreak_test`（越狱payload库）、`model_inversion`（模型逆向）、`adversarial_sample`（FGSM/PGD对抗样本）、`llm_leak_test`（系统提示泄露检测）、`model_fingerprint`（模型指纹识别） |

### 扩展方式

所有新题型均可通过两种方式接入，无需改动核心架构：

1. **动态注册**（推荐，运行时扩展）：
   ```typescript
   scheduler.registerDynamicAgent({
     id: "forensics",
     name: "取证专家",
     role: "数字取证与证据分析专家",
     systemPrompt: "你是取证专家…",
     toolNames: ["disk_forensics", "registry_analyze", "log_forensics", ...],
     maxSteps: 8,
   });
   ```

2. **预设注册**（编译时扩展）：在 [factory.ts](file:///Users/uqland/github/flagent/src/agents/factory.ts) 中新增 `SubAgent` 并 `scheduler.registerAgent()`，与现有 5 类预设 agent 并列。

新增工具按现有模式在对应 `src/tools/<category>-tools.ts` 中实现，通过 `createToolRegistry()` 自动注册。每个工具只需定义 Zod schema + `execute` 函数 + 元数据（`concurrent` / `requirePermission` / `category` / `timeout`）。

## 📝 License

MIT