open-source/quality-inspection-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

重命名项目为 quality-inspection-platform

Browse Source 
将仓库目录从 ai_auto_test 迁至 quality-inspection-platform，统一质量检测平台命名；MCP 环境变量新增 QIP_* 并兼容 AI_TEST_*。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
qihongkun 2026-05-22 15:49:59 +08:00
parent d810abdcee
commit a41f61bcf6
11 changed files with 43 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
README.md
View File

@ -1,6 +1,6 @@
# 质量检测平台
# 质量检测平台（quality-inspection-platform）
一个基于 `FastAPI` 的质量检测平台，提供三类能力：
仓库目录名：`quality-inspection-platform`。一个基于 `FastAPI` 的质量检测平台，提供三类能力：
- 接口定义管理
- Mock 数据管理
@ -83,7 +83,8 @@ python3 mcp_bridge.py
桥接默认读取环境变量：
- `AI_TEST_BASE_URL`，默认值是 `http://127.0.0.1:8000`
- `QIP_BASE_URL`，默认值是 `http://127.0.0.1:8000`（兼容旧名 `AI_TEST_BASE_URL`）
- `QIP_API_KEY`：`sto-` 开头的 API Key（兼容 `AI_TEST_API_KEY`）
完整配置见：

4
app/main.py
View File

@ -168,7 +168,7 @@ def _make_user_out(user: User) -> CurrentUserOut:
def _issue_auth_token(user: User) -> str:
secret = os.getenv("AUTH_TOKEN_SECRET", "ai-auto-test-dev-secret")
secret = os.getenv("AUTH_TOKEN_SECRET", "quality-inspection-dev-secret")
nonce = secrets.token_hex(8)
raw = f"{user.id}:{user.username}:{user.role}:{nonce}"
signature = hmac.new(secret.encode("utf-8"), raw.encode("utf-8"), hashlib.sha256).hexdigest()
@ -176,7 +176,7 @@ def _issue_auth_token(user: User) -> str:
def _resolve_user_by_token(token: str, db: Session) -> User | None:
secret = os.getenv("AUTH_TOKEN_SECRET", "ai-auto-test-dev-secret")
secret = os.getenv("AUTH_TOKEN_SECRET", "quality-inspection-dev-secret")
parts = (token or "").split(":")
if len(parts) != 5:
return None

2
app/services/loki.py
View File

@ -59,7 +59,7 @@ def _build_logql(method: str, url_path: str) -> str:
base = service_label
else:
service_key = os.getenv("LOKI_SERVICE_LABEL", "app").strip() or "app"
service_value = os.getenv("LOKI_SERVICE_VALUE", "").strip() or "ai-auto-test"
service_value = os.getenv("LOKI_SERVICE_VALUE", "").strip() or "quality-inspection-platform"
base = f'{{{service_key}="{service_value}"}}'
filters: list[str] = [base]

32
docs/mcp_install.md
View File

@ -11,7 +11,7 @@
## 1. 启动平台后端
```bash
cd /Users/qihongkun/work/My_app/ai_auto_test
cd /Users/qihongkun/work/My_app/quality-inspection-platform
# 可选：生产/共享环境建议开启，所有 MCP 调用必须带 API Key
# export MCP_REQUIRE_API_KEY=true
uvicorn app.main:app --host 127.0.0.1 --port 8000
@ -32,18 +32,18 @@ uvicorn app.main:app --host 127.0.0.1 --port 8000
"mcpServers": {
"quality-inspection-platform": {
"command": "python3",
"args": ["/Users/qihongkun/work/My_app/ai_auto_test/mcp_bridge.py"],
"args": ["/Users/qihongkun/work/My_app/quality-inspection-platform/mcp_bridge.py"],
"env": {
"AI_TEST_BASE_URL": "http://127.0.0.1:8000",
"AI_TEST_API_KEY": "sto-你的API密钥"
"QIP_BASE_URL": "http://127.0.0.1:8000",
"QIP_API_KEY": "sto-你的API密钥"
}
}
}
}
```
- `AI_TEST_BASE_URL`：平台后端地址。
- `AI_TEST_API_KEY`：**必须配置**。写操作与执行类工具（`workflow_run`、`workflow_batch_run`、`ssh_script_run` 等）无 Key 将返回 401；桥接会把 Key 放到 `Authorization: Bearer` 与 invoke body 的 `api_key` 字段。
- `QIP_BASE_URL`：平台后端地址（兼容旧环境变量 `AI_TEST_BASE_URL`）。
- `QIP_API_KEY`：**必须配置**（兼容旧名 `AI_TEST_API_KEY`）。写操作与执行类工具（`workflow_run`、`workflow_batch_run`、`ssh_script_run` 等）无 Key 将返回 401；桥接会把 Key 放到 `Authorization: Bearer` 与 invoke body 的 `api_key` 字段。
- 后端可选 `MCP_REQUIRE_API_KEY=true`：所有 MCP 工具（含只读、`GET /mcp/tools`）均要求 Key。
在平台 Web 端右上角「个人中心」生成 `sto-` 开头的 API Key。
@ -61,10 +61,10 @@ uvicorn app.main:app --host 127.0.0.1 --port 8000
"mcpServers": {
"quality-inspection-platform": {
"command": "python3",
"args": ["/Users/qihongkun/work/My_app/ai_auto_test/mcp_bridge.py"],
"args": ["/Users/qihongkun/work/My_app/quality-inspection-platform/mcp_bridge.py"],
"env": {
"AI_TEST_BASE_URL": "http://127.0.0.1:8000",
"AI_TEST_API_KEY": "sto-你的API密钥"
"QIP_BASE_URL": "http://127.0.0.1:8000",
"QIP_API_KEY": "sto-你的API密钥"
}
}
}
@ -78,9 +78,9 @@ uvicorn app.main:app --host 127.0.0.1 --port 8000
```bash
codex mcp add quality-inspection-platform \
--command python3 \
--args /Users/qihongkun/work/My_app/ai_auto_test/mcp_bridge.py \
--env AI_TEST_BASE_URL=http://127.0.0.1:8000 \
--env AI_TEST_API_KEY=sto-你的API密钥
--args /Users/qihongkun/work/My_app/quality-inspection-platform/mcp_bridge.py \
--env QIP_BASE_URL=http://127.0.0.1:8000 \
--env QIP_API_KEY=sto-你的API密钥
```
或在 `~/.codex/config.toml` 中：
@ -88,11 +88,11 @@ codex mcp add quality-inspection-platform \
```toml
[mcp.servers.quality-inspection-platform]
command = "python3"
args = ["/Users/qihongkun/work/My_app/ai_auto_test/mcp_bridge.py"]
args = ["/Users/qihongkun/work/My_app/quality-inspection-platform/mcp_bridge.py"]
[mcp.servers.quality-inspection-platform.env]
AI_TEST_BASE_URL = "http://127.0.0.1:8000"
AI_TEST_API_KEY = "sto-你的API密钥"
QIP_BASE_URL = "http://127.0.0.1:8000"
QIP_API_KEY = "sto-你的API密钥"
```
---
@ -104,7 +104,7 @@ printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
'{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"catalog_snapshot","arguments":{}}}' \
| AI_TEST_API_KEY=sto-你的API密钥 python3 mcp_bridge.py
| QIP_API_KEY=sto-你的API密钥 python3 mcp_bridge.py
```
预期：

2
docs/mcp_quickstart.md
View File

@ -21,7 +21,7 @@
- 工具发现：`GET /mcp/tools`
- 单次调用：`POST /mcp/invoke`
- 批量调用：`POST /mcp/invoke-batch`
- MCP 鉴权：在平台右上角「个人中心」生成 `sto-` 开头的 API Key，配置到 MCP Bridge 环境变量 `AI_TEST_API_KEY`，或在请求头使用 `Authorization: Bearer <api_key>` / `X-API-Key: <api_key>`。
- MCP 鉴权：在平台右上角「个人中心」生成 `sto-` 开头的 API Key，配置到 MCP Bridge 环境变量 `QIP_API_KEY`（兼容 `AI_TEST_API_KEY`），或在请求头使用 `Authorization: Bearer <api_key>` / `X-API-Key: <api_key>`。
- **写操作**（创建/更新资源）与 **执行类操作**（跑工作流、批跑、单节点、SSH 执行、重放）**必须**带有效 Key，禁止无 Key 回落为 superadmin。
- 可选 **`MCP_REQUIRE_API_KEY=true`**（后端环境变量）：所有 MCP 工具（含只读）均要求 Key；`GET /mcp/tools` 同样校验。

10
docs/mcp_tools_for_ai.md
View File

@ -10,7 +10,7 @@
## 0. Agent 必读（30 秒）
1. **先** `catalog_snapshot` 了解现有 apis / workflows / workflow_batches / mocks / folders / ssh_tree，避免重复创建。
2. **写操作与执行**必须带 `sto-` API Key（`Authorization: Bearer` 或桥接环境变量 `AI_TEST_API_KEY`）。
2. **写操作与执行**必须带 `sto-` API Key（`Authorization: Bearer` 或桥接环境变量 `QIP_API_KEY`，兼容 `AI_TEST_API_KEY`）。
3. **接口**用 `api_upsert`；**流程**用 `workflow_upsert` 或 `workflow_patch_json`；**跑批**固定三步：`workflow_batch_create` → `workflow_batch_update` → `workflow_batch_run`。
4. **排障**：`workflow_run_get` 看 request/response → `workflow_run_loki_link` 查日志。
5. 如果当前客户端没有显示某个工具，先确认平台 `GET /mcp/tools` 是否包含该工具，再刷新或重启 MCP 客户端。
@ -19,7 +19,7 @@
### 0.1 工具来源与客户端刷新
- 权威工具清单来自后端 `app/main.py` 的 `MCP_TOOL_SPECS`，平台通过 `GET /mcp/tools` 对外暴露。
- `mcp_bridge.py` 启动后会从 `AI_TEST_BASE_URL/mcp/tools` 拉取工具并转换为 MCP `tools/list`。
- `mcp_bridge.py` 启动后会从 `QIP_BASE_URL`（或兼容 `AI_TEST_BASE_URL`）的 `/mcp/tools` 拉取工具并转换为 MCP `tools/list`。
- Codex / Cursor / Claude 等客户端可能在会话启动时缓存工具列表；平台新增工具后，通常需要重启 MCP 客户端或重启会话。
- 如果客户端只显示部分工具，不代表平台没有该能力。先用 `/mcp/tools` 或本文档核对，再决定是否降级。
- Agent 更新本文档时，应以源码和 `/mcp/tools` 为准，不以单个客户端当前暴露的工具子集为准。
@ -48,8 +48,8 @@ MCP Bridge 通过环境变量访问平台：
| 环境变量 | 含义 | 示例 |
|----------|------|------|
| `AI_TEST_BASE_URL` | 质量检测平台后端地址 | `http://127.0.0.1:8000` |
| `AI_TEST_API_KEY` | `sto-` 开头的 API Key | `sto-...` |
| `QIP_BASE_URL` | 质量检测平台后端地址（兼容 `AI_TEST_BASE_URL`） | `http://127.0.0.1:8000` |
| `QIP_API_KEY` | `sto-` 开头的 API Key（兼容 `AI_TEST_API_KEY`） | `sto-...` |
Agent 通过 MCP 工具访问平台，不需要在业务项目中启动平台服务；平台进程由质量检测平台项目本身或共享服务负责。
@ -334,7 +334,7 @@ workflow_analyze_last_run → workflow_patch_json(只改变量/单节点 data)
| error / 现象 | 处理 |
|--------------|------|
| 401 MCP requires API Key | 配置 `AI_TEST_API_KEY` 或请求头 Bearer |
| 401 MCP requires API Key | 配置 `QIP_API_KEY`（或 `AI_TEST_API_KEY`）或请求头 Bearer |
| workflow folder not registered | 先 `folder_ensure` workflows |
| 仅 draft 批次可执行 | 已对 running/success 的 batch 再 run |
| unknown mcp tool | `GET /mcp/tools` 刷新名称 |

4
frontend-admin/package-lock.json generated
View File

@ -1,11 +1,11 @@
{
"name": "ai-auto-test-admin",
"name": "quality-inspection-admin",
"version": "0.0.1",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "ai-auto-test-admin",
"name": "quality-inspection-admin",
"version": "0.0.1",
"dependencies": {
"@codemirror/lang-json": "^6.0.2",

2
frontend-admin/package.json
View File

@ -1,5 +1,5 @@
{
"name": "ai-auto-test-admin",
"name": "quality-inspection-admin",
"private": true,
"version": "0.0.1",
"type": "module",

4
frontend-admin/src/auth/session.js
View File

@ -1,7 +1,7 @@
import { reactive } from "vue";
const TOKEN_KEY = "ai-auto-test-token";
const USER_KEY = "ai-auto-test-user";
const TOKEN_KEY = "quality-inspection-token";
const USER_KEY = "quality-inspection-user";
function loadUser() {
const raw = window.localStorage.getItem(USER_KEY);

2
frontend-admin/src/components/ProfileApiKeyPanel.vue
View File

@ -111,7 +111,7 @@ onMounted(() => {
:closable="false"
show-icon
title="MCP 连接说明"
description="在 Cursor / MCP 配置中设置环境变量 AI_TEST_API_KEY，或在请求头携带 Authorization: Bearer <api_key>。Key 以 sto- 开头。"
description="在 Cursor / MCP 配置中设置环境变量 QIP_API_KEY（或兼容旧名 AI_TEST_API_KEY），或在请求头携带 Authorization: Bearer <api_key>。Key 以 sto- 开头。"
/>
<section class="profile-api-key-panel__create">

12
mcp_bridge.py
View File

@ -24,8 +24,12 @@ from typing import Any
import httpx
BASE_URL = os.environ.get("AI_TEST_BASE_URL", "http://127.0.0.1:8000").rstrip("/")
API_KEY = os.environ.get("AI_TEST_API_KEY", "").strip()
def _env(primary: str, legacy: str, default: str = "") -> str:
return (os.environ.get(primary) or os.environ.get(legacy) or default).strip()
BASE_URL = _env("QIP_BASE_URL", "AI_TEST_BASE_URL", "http://127.0.0.1:8000").rstrip("/")
API_KEY = _env("QIP_API_KEY", "AI_TEST_API_KEY", "")
SERVER_NAME = "quality-inspection-platform"
SERVER_VERSION = "0.1.0"
PROTOCOL_VERSION = "2024-11-05"
@ -103,11 +107,11 @@ def handle_initialize(req_id: Any, _: dict[str, Any]) -> dict[str, Any]:
"capabilities": {"tools": {"listChanged": False}},
"serverInfo": {"name": SERVER_NAME, "version": SERVER_VERSION},
"instructions": (
"AI Auto API Test platform. Before complex tasks, read project file "
"Quality inspection platform (质量检测平台). Before complex tasks, read project file "
"docs/mcp_tools_for_ai.md (tool picker, auth, recipes). "
"Typical start: catalog_snapshot. "
"Batch runs: workflow_batch_create → workflow_batch_update → workflow_batch_run. "
"Writes and execution require sto- API Key (AI_TEST_API_KEY)."
"Writes and execution require sto- API Key (AI_TEST_API_KEY or QIP_API_KEY)."
),
},
)