> ## Documentation Index
> Fetch the complete documentation index at: https://agent-compass.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Qwen3-VL GUI

`qwen3vl_gui` Harness 把 [Qwen3-VL](https://github.com/QwenLM/Qwen3-VL) 作为 GUI 点击/触控定位 Harness，用于 [ScreenSpot](/zh/user_guide/modules/benchmarks/screenspot) 等 Benchmark。仅支持 `host_process` Environment。

它把被测 model 适配到 AgentCompass 的 `PreparedTask -> RunResult` 契约：把任务的截图与指令交给 VLM，取回目标点的坐标作为预测，无 Environment 交互。被测 model 凭据由命令行 `--model-*` 传入，需为 `openai-chat` 协议。

## 工作原理

* **无 Environment**：不启动容器、不装工具，直接把任务的截图（`media`）与指令发给 VLM。
* **定位预测**：model 返回目标控件的点击/触控坐标，Harness 取其为预测结果。
* **回收结果**：把预测与调用记录规整成单步轨迹，返回 `RunResult`；评分由 Benchmark（如 ScreenSpot）负责。

## 参数

该 Harness **无用户可配置参数**。定位行为完全由 Benchmark（如 `category`）与 model 配置驱动，`--harness-params` 无需传任何值。

## 运行示例

```bash theme={"system"}
agentcompass run \
  screenspot \
  qwen3vl_gui \
  qwen3-vl \
  --env host_process \
  --benchmark-params '{"category": "desktop"}' \
  --model-base-url "$MODEL_BASE_URL" \
  --model-api-key "$MODEL_API_KEY" \
  --model-api-protocol openai-chat
```

## 输出

Harness 为每个任务返回 `RunResult`：预测坐标、单步轨迹与执行状态。单任务详情与聚合结果由 Benchmark 写入 `results/<benchmark>/<model>/<run>/`（详见 [结果](/zh/user_guide/other_features/results)）。