你的语言，就是它的脚本语言

# 健康检查
curl http://127.0.0.1:7799/api/health

# 设备列表
curl http://127.0.0.1:7799/api/devices

# 点击屏幕中心（活跃设备，归一化坐标）
curl -X POST http://127.0.0.1:7799/api/a11y/tap \
  -H "Content-Type: application/json" \
  -d '{"coord_type":"norm","x":0.5,"y":0.5}'

# 查找「登录」按钮出现后点击
curl -X POST http://127.0.0.1:7799/api/a11y/wait-and-click \
  -d '{"selector":{"text":"登录","clickable":true},"timeout_ms":8000}'

import requests

BASE = "http://127.0.0.1:7799"

def api(path, **body):
    return requests.post(f"{BASE}{path}", json=body, timeout=30).json()

# 等待「登录」按钮出现并点击
api("/api/a11y/wait-and-click",
    selector={"text": "登录", "clickable": True}, timeout_ms=8000)

# 本地验证码识别（无 image 时自动抓当前画面）
api("/api/captcha/recognize", type="CharMixed")

# 读出当前界面的节点树
POST /api/a11y/tree

# 等待「登录」可点击节点出现，出现即点
POST /api/a11y/wait-and-click
{ "selector": { "text": "登录", "clickable": true },
  "timeout_ms": 8000 }

// 字符类：返回文本
{ "image": "iVBORw0KGgo...", "type": "CharMixed" }
// → { "ok": true, "data": { "text": "x8Gk", "elapsed_ms": 42 } }

// 滑块类：返回缺口偏移（nx 为归一化偏移，直接喂 swipe）
{ "path": "设备序列号", "type": "Slide", "slider": "iVBORw...",
  "region": { "x": 0, "y": 0.25, "width": 1, "height": 0.33 } }
// → { "data": { "offset": 187, "nx": 0.358, "elapsed_ms": 12 } }

// 点选类：返回目标框中心归一化坐标 + 置信度
{ "image": "iVBORw...", "type": "Click" }
// → { "data": { "boxes": [ { "nx": 0.068, "ny": 0.103, "score": 0.81 } ] } }

import asyncio, json, websockets

async def main():
    async with websockets.connect("ws://127.0.0.1:7800/ws/events") as ws:
        while True:
            evt = json.loads(await ws.recv())
            if evt["type"] == "device.online":
                print("上线:", evt["data"]["alias"])

asyncio.run(main())

curl http://127.0.0.1:7799/docs.md -o heimao-api.md