docs: render architecture diagram with mermaid

Author: JE-Chen

README.md

@@ -112,31 +112,35 @@ pip install -r requirements.txt
 
 ## Architecture
 
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ CLI / MCP / GUI / Control Socket                                │
-└──────────────────┬──────────────────────────────────────────────┘
-                   │ action JSON
-┌──────────────────▼──────────────────────────────────────────────┐
-│ Action Executor (LD_* dispatch + safe builtins)                 │
-└──────────────────┬──────────────────────────────────────────────┘
-                   │ start_test
-┌──────────────────▼──────────────────────────────────────────────┐
-│ locust_wrapper_proxy (per-protocol task store)                  │
-└──────────────────┬──────────────────────────────────────────────┘
-                   │
-   ┌───────────────┴───────────────┬──────────────┬──────────────┐
-   ▼                               ▼              ▼              ▼
-HTTP / FastHttp  WebSocket  gRPC  MQTT  Raw TCP / UDP
-   │                               │              │              │
-   └───────────────┬───────────────┴──────────────┴──────────────┘
-                   │ Locust events
-   ┌───────────────┴───────────────┐
-   ▼                               ▼
-test_record_instance         Prometheus / InfluxDB / OTel
-   │
-   ├── HTML / JSON / XML / CSV / JUnit / Summary reports
-   └── SQLite persistence (cross-run comparison)
+```mermaid
+flowchart TD
+    subgraph Entry["Entry Surfaces"]
+        CLI[CLI]
+        MCP[MCP Server]
+        GUI[GUI]
+        SOCK[Control Socket]
+    end
+
+    Entry -- "action JSON" --> EXEC["Action Executor<br/>(LD_* dispatch + safe builtins)"]
+    EXEC -- "start_test" --> WRAPPER["locust_wrapper_proxy<br/>(per-protocol task store)"]
+
+    WRAPPER --> HTTP["HTTP / FastHttp"]
+    WRAPPER --> WS["WebSocket"]
+    WRAPPER --> GRPC["gRPC"]
+    WRAPPER --> MQTT["MQTT"]
+    WRAPPER --> RAW["Raw TCP / UDP"]
+
+    HTTP -- "Locust events" --> BUS([Locust Event Bus])
+    WS --> BUS
+    GRPC --> BUS
+    MQTT --> BUS
+    RAW --> BUS
+
+    BUS --> REC["test_record_instance"]
+    BUS --> METRICS["Prometheus / InfluxDB / OTel"]
+
+    REC --> REPORTS["HTML / JSON / XML / CSV / JUnit / Summary reports"]
+    REC --> SQLITE[("SQLite persistence<br/>(cross-run comparison)")]
 ```
 
 The dependency direction always points from the action layer down to Locust, never the other way around.

README/README_zh-CN.md

@@ -107,31 +107,35 @@ pip install -r requirements.txt
 
 ## 架构
 
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ CLI / MCP / GUI / 控制 Socket                                   │
-└──────────────────┬──────────────────────────────────────────────┘
-                   │ 动作 JSON
-┌──────────────────▼──────────────────────────────────────────────┐
-│ 动作 Executor（LD_* 派发 + 安全 builtin）                        │
-└──────────────────┬──────────────────────────────────────────────┘
-                   │ start_test
-┌──────────────────▼──────────────────────────────────────────────┐
-│ locust_wrapper_proxy（每协议 task store）                       │
-└──────────────────┬──────────────────────────────────────────────┘
-                   │
-   ┌───────────────┴───────────────┬──────────────┬──────────────┐
-   ▼                               ▼              ▼              ▼
-HTTP / FastHttp  WebSocket  gRPC  MQTT  原生 TCP / UDP
-   │                               │              │              │
-   └───────────────┬───────────────┴──────────────┴──────────────┘
-                   │ Locust 事件
-   ┌───────────────┴───────────────┐
-   ▼                               ▼
-test_record_instance         Prometheus / InfluxDB / OTel
-   │
-   ├── HTML / JSON / XML / CSV / JUnit / Summary 报告
-   └── SQLite 持久化（跨次比对）
+```mermaid
+flowchart TD
+    subgraph Entry["入口接口"]
+        CLI[CLI]
+        MCP[MCP Server]
+        GUI[GUI]
+        SOCK[控制 Socket]
+    end
+
+    Entry -- "动作 JSON" --> EXEC["动作 Executor<br/>(LD_* 派发 + 安全 builtin)"]
+    EXEC -- "start_test" --> WRAPPER["locust_wrapper_proxy<br/>(每协议 task store)"]
+
+    WRAPPER --> HTTP["HTTP / FastHttp"]
+    WRAPPER --> WS["WebSocket"]
+    WRAPPER --> GRPC["gRPC"]
+    WRAPPER --> MQTT["MQTT"]
+    WRAPPER --> RAW["原生 TCP / UDP"]
+
+    HTTP -- "Locust 事件" --> BUS([Locust Event Bus])
+    WS --> BUS
+    GRPC --> BUS
+    MQTT --> BUS
+    RAW --> BUS
+
+    BUS --> REC["test_record_instance"]
+    BUS --> METRICS["Prometheus / InfluxDB / OTel"]
+
+    REC --> REPORTS["HTML / JSON / XML / CSV / JUnit / Summary 报告"]
+    REC --> SQLITE[("SQLite 持久化<br/>(跨次比对)")]
 ```
 
 依赖方向永远是动作层 → Locust。

README/README_zh-TW.md

@@ -107,31 +107,35 @@ pip install -r requirements.txt
 
 ## 架構
 
-```
-┌─────────────────────────────────────────────────────────────────┐
-│ CLI / MCP / GUI / 控制 Socket                                   │
-└──────────────────┬──────────────────────────────────────────────┘
-                   │ 動作 JSON
-┌──────────────────▼──────────────────────────────────────────────┐
-│ 動作 Executor（LD_* 派發 + 安全 builtin）                        │
-└──────────────────┬──────────────────────────────────────────────┘
-                   │ start_test
-┌──────────────────▼──────────────────────────────────────────────┐
-│ locust_wrapper_proxy（每協定 task store）                       │
-└──────────────────┬──────────────────────────────────────────────┘
-                   │
-   ┌───────────────┴───────────────┬──────────────┬──────────────┐
-   ▼                               ▼              ▼              ▼
-HTTP / FastHttp  WebSocket  gRPC  MQTT  原生 TCP / UDP
-   │                               │              │              │
-   └───────────────┬───────────────┴──────────────┴──────────────┘
-                   │ Locust 事件
-   ┌───────────────┴───────────────┐
-   ▼                               ▼
-test_record_instance         Prometheus / InfluxDB / OTel
-   │
-   ├── HTML / JSON / XML / CSV / JUnit / Summary 報告
-   └── SQLite 持久化（跨次比對）
+```mermaid
+flowchart TD
+    subgraph Entry["入口介面"]
+        CLI[CLI]
+        MCP[MCP Server]
+        GUI[GUI]
+        SOCK[控制 Socket]
+    end
+
+    Entry -- "動作 JSON" --> EXEC["動作 Executor<br/>(LD_* 派發 + 安全 builtin)"]
+    EXEC -- "start_test" --> WRAPPER["locust_wrapper_proxy<br/>(每協定 task store)"]
+
+    WRAPPER --> HTTP["HTTP / FastHttp"]
+    WRAPPER --> WS["WebSocket"]
+    WRAPPER --> GRPC["gRPC"]
+    WRAPPER --> MQTT["MQTT"]
+    WRAPPER --> RAW["原生 TCP / UDP"]
+
+    HTTP -- "Locust 事件" --> BUS([Locust Event Bus])
+    WS --> BUS
+    GRPC --> BUS
+    MQTT --> BUS
+    RAW --> BUS
+
+    BUS --> REC["test_record_instance"]
+    BUS --> METRICS["Prometheus / InfluxDB / OTel"]
+
+    REC --> REPORTS["HTML / JSON / XML / CSV / JUnit / Summary 報告"]
+    REC --> SQLITE[("SQLite 持久化<br/>(跨次比對)")]
 ```
 
 依賴方向永遠是動作層 → Locust。