御策天检 · AI 测试平台

# 御策天检 · AI 测试平台

<div align="center">
  <img src="Enterprise_AI_QA_Agent/agent_web/public/logo.svg" alt="御策天检 Logo" width="140"/>

  ![License](https://img.shields.io/badge/License-MIT-blue.svg)
  ![Python](https://img.shields.io/badge/Python-3.11%2B-green.svg)
  ![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)
  ![FastAPI](https://img.shields.io/badge/FastAPI-0.115.0-009688.svg)
  ![LangGraph](https://img.shields.io/badge/LangGraph-orchestration-1C3C3C.svg)
  ![Vue](https://img.shields.io/badge/Vue-3.5-4FC08D.svg)
  ![Electron](https://img.shields.io/badge/Electron-31.7-9FEAF9.svg)
  ![Browser--Use](https://img.shields.io/badge/Browser--Use-0.11.1-FF6B35.svg)
</div>

> **御策天检**（英文代号 AI Test Agent / Enterprise AI QA Agent）是一套面向质量保障场景的 AI 测试系统仓库。
> 仓库内并存**两代产品**：早期的一站式 Web 测试平台，和当前正在迭代的 Agent 工作台。

---

## E-API 赞助支持

本项目获得 **E-API** 赞助支持。E-API 提供聚合模型 API 服务（中转站），可用于开发者工具和 AI 应用的模型接入。

新用户通过下方专属链接注册，可获得 **5 元产品额度**：

[领取 E-API 新用户 5 元产品额度](https://eapi.site/register?aff=KZQTHE)

邀请码：`KZQTHE`

> **推广说明**：以上链接为赞助推广链接。你通过该链接注册或消费后，我可能获得 E-API 提供的推广返佣。E-API 及本推广活动与 GitHub 官方无关。产品额度、可用范围及返佣结算以 E-API 活动页面的现行规则为准。

赞助商信息在系统内也是可见的，不只是写在 README 里：

- **前端入口**：桌面端 / Web 顶栏右侧的赞助商轮播 logo + 列表弹窗（`agent_web/src/components/layout/SponsorEntry.vue`，15 种语言均有文案）
- **读取接口**：`GET /api/v1/sponsors`（只返回 `enabled=true` 的记录，无需鉴权）
- **数据来源**：MySQL 表 `system_sponsor_config`，首次启动自动写入默认记录（E-API → `https://api.ewo.so/`，类型「中转站」）
- **Logo 资源**：`Enterprise_AI_QA_Agent/agent_web/public/sponsors/e-api.png`
- 当前未提供后台 CRUD 界面，新增/修改赞助商直接维护该表

---

## 一、系统总览：仓库里有两个项目

| | **Enterprise_AI_QA_Agent**（当前迭代） | **Web 版**（已停止迭代） |
|---|---|---|
| 目录 | `Enterprise_AI_QA_Agent/Agent_Server` + `Enterprise_AI_QA_Agent/agent_web` | 根目录 `Agent_Server/` + `agent_web_server/` |
| 定位 | 企业级 QA 场景的**多 Agent 编排工作台**：会话 / 事件流 / 审批 / 回放 / 任务池 / 报告 / 知识图谱 | 一站式**智能自动化测试平台**：用例生成 → 浏览器执行 → Bug 分析 → 报告邮件 |
| 后端 | FastAPI + **LangGraph** + Pydantic v2，`/api/v1` 前缀，21 组路由，14 种模式（8 实装 + 6 占位），54 个 Skill | FastAPI + Browser-Use 0.11.1 + 自研 LLM 适配器层（11 个 Provider） |
| 前端 | Vue 3.5 + Vite 6 + Naive UI + TypeScript，9 个视图，15 种 locale，**Electron 桌面端**（产物 `御策天检.exe`），VitePress 手册 | Vue 3.4 + Vite 5 + Naive UI，56 个 `.vue` 页面 |
| 存储 | PostgreSQL(运行时 + pgvector 向量记忆) + MySQL(配置) + Memgraph(图谱) + Redis(分布式锁) + **RustFS**(产物对象存储) | MySQL + Qdrant(页面知识库) + **MinIO**(接口文件) |
| 状态 | **活跃**，提交持续到 2026-08-27 | **冻结**，仅作历史与参考实现保留 |
| 详细文档 | [Enterprise_AI_QA_Agent/README.md](Enterprise_AI_QA_Agent/README.md) | 本文第四章 + `PROJECT_DESIGN.md`（本地文件，已被 `.gitignore` 排除，不在仓库内） |

### 关于迭代状态（说明白，避免误解）

- **Web 版已经不再迭代。** 按本仓库的提交记录：`Agent_Server/` 与 `agent_web_server/` 的最后一笔代码改动是 **2026-04-15**（仓库自另一账号迁移导入），此后仅 **2026-06-26** 动过一次 `.env.example`（3 行）。`agent_web_server/` 全部历史只有一笔提交。它是上一代方案，功能仍然完整可跑，但**不会再补新特性，也不会跟进安全/依赖升级**。
- **`Enterprise_AI_QA_Agent` 是唯一在推进的分支。** 它不是 Web 版的简单改名，而是换了骨架：从"平台内置流程 + 脚本执行器"改成"注册中心 + LangGraph 图编排 + 可观测工作台"。
- **节奏偏慢是事实，原因是主业。** 这个项目是我下班后和周末做的，工作忙的时候可能几周不动；但每次动手都按 [AGENTS.md](Enterprise_AI_QA_Agent/AGENTS.md) 的纪律走（先查证、根因修复、完成必验证），所以提交粒度小、带测试。不要按"开源项目的更新频率"来评估它。
- **不要交叉复制代码。** 两代项目的对象存储客户端、模型适配层、路由前缀都不一样（MinIO vs RustFS、自研 `llm/providers` vs `application/model_adapters`、`/api/*` vs `/api/v1/*`）。Web 版里有价值的部分是**测试领域策略本身**（止损、模糊匹配、瞬态 UI 感知、JSON 修复管线、平台适配器），这些思路在 Enterprise 版里以 Harness/Skill 的形式重做。

### 品牌与命名对照

| 名称 | 出现位置 |
| --- | --- |
| 御策天检 | 产品中文名：前端顶栏、Electron 产物、VitePress 手册、设计文档 |
| AI Test Agent / `Ai_Test_Agent` | 仓库名、Web 版后端 `APP_TITLE = "AI Test Agent API"` |
| Enterprise AI QA Agent | Enterprise 版 `.env` 中的 `APP_NAME`、其 README 标题 |

---

## 二、Enterprise_AI_QA_Agent（当前项目）

参考 `claude_code_ui_Agent` 的运行骨架构建，目标是"能规划、能调工具、能审批、能中断恢复、能出报告"的 AI 测试运行骨架，而不是一个聊天页面。后端应用版本 `0.2.0`。

### 2.1 三层骨架

1. **`registry/`** —— Agent / Tool / Model / Skill / MCP / Mode 六大注册中心，新增能力优先接这里。当前注册 **45 个 Agent**、**57 个 Tool**。
2. **`graph/` + `runtime/`** —— LangGraph 组织运行链路，沉淀可恢复、可审批、可中断、可重放的执行状态机（`planner → permission_gate → model_invoker → tool_executor → finalizer / reexpander`）。
3. **`agent_web` + `api/routes`** —— 前端是工作台（会话、事件流、审批、回放），后端不是单一 `/chat`，而是 session shell + event stream + approval + dispatch 的统一运行接口。

### 2.2 测试模式（注册 14 种 = 8 实装 + 6 占位）

`Agent_Server/src/modes/`，全部在 `registry/modes.py` 注册。**已实装 8 种**：

| 模式 | 说明 |
| --- | --- |
| `api_testing_mode` | 链路最完整：API 文档解析 → 端点圈定 → 依赖规划 → 前置条件解析 → 执行 → 验证/评估 → 报告，含子代理协调与任务池 |
| `performance_testing_mode` | 需求接入 → 负载建模 → k6 / JMeter 引擎 Docker 化执行 → 结果解析 → 失败分析 → 报告；含目标保护（`PERFORMANCE_TARGET_ALLOWLIST`、VU/RPS/时长上限、smoke 前置） |
| `security_testing_mode` | 基于 Docker（Kali）运行器的安全测试编排，含攻击链循环与漏洞库落库（`agent_security_bugs`） |
| `ui_automation_mode` | UI 自动化（Playwright CLI Runtime）+ UI 录制编排 + 回放执行器 |
| `compatibility_testing_mode` | 产品探查 → 环境矩阵 → 用例生成 → 审批 → 运行器分发 → 结果聚合 |
| `smoke_testing_mode` | 冒烟测试（计划目录 / 版本 / 运行历史 / 回归候选四张表，方案需人工确认） |
| `code_review_mode` | 多角色辩论式代码评审 |
| `default_mode` | 默认对话模式 |

**另 6 种为占位模式**（manifest 标 `"placeholder": True`、`harness_key=placeholder_testing_harness`、`activation_policy=explicit_only

... (truncated)