@hupan56/wlkj 2.7.12 → 3.1.2

package/templates/qoder/scripts/validation/test/autotest_opencli.py

@@ -0,0 +1,646 @@
+# -*- coding: utf-8 -*-
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
+"""autotest_opencli.py — 真功能测试执行器 (OpenCLI 复用已登录 Chrome).
+
+与 autotest_run.py 平级, 镜像同一个 task.json 契约, 执行引擎换成 OpenCLI.
+吃同样的 --task 文件, 吐同样结构的 result JSON, 便于 _compare_engines.py 并排对比.
+
+用法: python autotest_opencli.py --task <任务文件> [--session <名>]
+  任务文件 JSON: {
+    "page_path": "/veh/vehicle/vehAffair/insurance",
+    "page_name": "保险管理",
+    "cases": [ {case_id, title, steps:[{intent,desc,value,anchor,check,expect_api}], expected} ]
+  }
+
+与 autotest_run.py 的差异:
+  - 登录态: 不伪造 localStorage. 直接 bind 到用户手动登好的真实 Chrome tab (无验证码/无 RSA).
+  - 执行:   每步 subprocess 调 opencli browser <session> <cmd>, 全 stdout JSON 解析.
+  - 断言:   兼容旧 check (行数/URL/body文本), 新增 expect_api 抓 network 验后端 JSON 字段值.
+
+前置: 用户先手动 Chrome 登录目标环境 + 装好 OpenCLI 扩展 + doctor green.
+"""
+import json, sys, time, os, re, argparse, subprocess
+
+# ===== 配置 (路径自检测, 与 autotest_run.py 一致) =====
+SCRIPTS = os.path.dirname(os.path.abspath(__file__))
+# test 目录在 .qoder/scripts/test, 回项目根要上 3 级.
+# 用"向上找含 .qoder 的目录"兜底, 避免 ../.. 层级写错 (autotest_run.py 的同款 bug).
+_d = SCRIPTS
+while _d != os.path.dirname(_d):
+    if os.path.isdir(os.path.join(_d, '.qoder')):
+        PROJECT = _d
+        break
+    _d = os.path.dirname(_d)
+else:
+    PROJECT = os.path.normpath(os.path.join(SCRIPTS, '..', '..', '..'))
+
+
+def _read_developer():
+    """读 .qoder/.developer 拿当前开发者, 身份隔离用 (绝不 fallback, 防串号)."""
+    dev_file = os.path.join(PROJECT, '.qoder', '.developer')
+    if os.path.isfile(dev_file):
+        for ln in open(dev_file, encoding='utf-8'):
+            if ln.strip().startswith('name='):
+                return ln.strip().split('=', 1)[1].strip()
+    raise RuntimeError('未检测到开发者身份(.qoder/.developer)。请先运行 /wl-init。')
+
+
+DEVELOPER = _read_developer()
+MEMBER_DIR = os.path.join(PROJECT, 'workspace', 'members', DEVELOPER)
+AUTOLEARN = os.path.join(SCRIPTS, 'autotest.py')
+BASE = 'https://icsqas.inforecloud.com'
+
+# OpenCLI 默认 session 名 (一次对比/一个任务用一个, 避免缓存串)
+DEFAULT_SESSION = 'wltest'
+
+
+# ===== OpenCLI 环境探测 (友好诊断 + 回退指引) =====
+# opencli 的绝对路径缓存 (跨平台 PATH 解析). 50 人环境各异, subprocess 不一定继承到
+# Git Bash/cmd 的完整 PATH, 所以要主动从 npm 全局目录 + PATHEXT 里找.
+_OPENCLI_BIN = None
+
+
+def _find_opencli():
+    """定位 opencli 可执行文件绝对路径. 返回路径或 None.
+    顺序: 直接 PATH → npm bin -g → 常见全局目录. 缓存结果."""
+    global _OPENCLI_BIN
+    if _OPENCLI_BIN:
+        return _OPENCLI_BIN
+    # 1. 直接试 PATH (可能成功)
+    try:
+        subprocess.run(['opencli', '--version'], capture_output=True, timeout=10,
+                       shell=(os.name == 'nt'))
+        _OPENCLI_BIN = 'opencli'
+        return _OPENCLI_BIN
+    except (FileNotFoundError, OSError):
+        pass
+    # 2. 问 npm 全局 bin 目录在哪
+    candidates = []
+    try:
+        r = subprocess.run(['npm', 'bin', '-g'], capture_output=True, timeout=10,
+                           shell=(os.name == 'nt'), text=True)
+        if r.returncode == 0 and r.stdout.strip():
+            d = r.stdout.strip()
+            candidates.append(os.path.join(d, 'opencli'))
+            candidates.append(os.path.join(d, 'opencli.cmd'))
+            candidates.append(os.path.join(d, 'opencli.cmd'))
+    except Exception:
+        pass
+    try:
+        r = subprocess.run(['npm', 'root', '-g'], capture_output=True, timeout=10,
+                           shell=(os.name == 'nt'), text=True)
+        if r.returncode == 0 and r.stdout.strip():
+            candidates.append(os.path.join(r.stdout.strip(), '..', '.bin', 'opencli'))
+            candidates.append(os.path.join(r.stdout.strip(), '..', 'opencli'))
+    except Exception:
+        pass
+    # 3. 检查每个候选
+    for c in candidates:
+        if c and os.path.isfile(c):
+            _OPENCLI_BIN = c
+            return _OPENCLI_BIN
+    return None
+
+
+def _opencli_ready():
+    """逐级探测 opencli 环境, 返回 (ok, diagnosis).
+    diagnosis = {stage, reason, fix, fallback}. 让没装 opencli 的人零报错自动回退."""
+    # Stage 1: opencli CLI 是否安装/可定位 (跨平台 PATH 兜底)
+    bin_path = _find_opencli()
+    if not bin_path:
+        return False, _diag('cli', 'opencli 未安装或不在 PATH',
+            'npm i -g @jackwener/opencli', '不装也行, 用 playwright 引擎 (autotest_run.py)')
+    global _OPENCLI_BIN
+    _OPENCLI_BIN = bin_path
+
+    # Stage 2: doctor (daemon + 扩展连接) —— 按行状态标记精准解析
+    try:
+        r = _run(['doctor'], timeout=20)
+        out = (r.stdout + r.stderr).decode('utf-8', 'ignore')
+    except Exception as e:
+        return False, _diag('doctor', 'opencli doctor 执行失败: %s' % str(e)[:60],
+            '重试 opencli doctor', '回退 playwright 引擎')
+    lo = out.lower()
+    lines = [ln.strip() for ln in out.splitlines() if ln.strip()]
+
+    # 按 doctor 的逐行 [OK]/[MISSING]/[FAIL] 标记判断, 不做全文 grep (避免误判)
+    def _line_status(key):
+        """返回某关键组件那行的标记: ok / missing / fail / none."""
+        for ln in lines:
+            if key in ln.lower():
+                low = ln.lower()
+                if '[ok]' in low: return 'ok'
+                if '[missing]' in low: return 'missing'
+                if '[fail]' in low: return 'fail'
+        return 'none'
+
+    # daemon
+    if _line_status('daemon') != 'ok':
+        return False, _diag('daemon', 'opencli daemon 未运行',
+            'opencli daemon start', '回退 playwright 引擎')
+    # 扩展 (最常见的卡点)
+    if _line_status('extension') != 'ok':
+        ext_dir = os.path.join(os.path.expanduser('~'), 'opencli-extension')
+        return False, _diag('extension', 'OpenCLI 浏览器扩展未连接',
+            'Chrome → chrome://extensions/ → 开发者模式 → 加载已解压 → 选 %s → 启用它' % ext_dir,
+            '不装扩展也行, 用 playwright 引擎')
+    # connectivity 综合
+    if _line_status('connectivity') == 'fail':
+        return False, _diag('connect', '浏览器桥接连通性失败',
+            '确保 Chrome 开着 + OpenCLI 扩展启用, 跑 opencli daemon restart',
+            '回退 playwright 引擎')
+    return True, {}
+
+
+def _diag(stage, reason, fix, fallback):
+    """结构化诊断: 让上层决定是"提示后中止"还是"提示后回退"."""
+    return {'stage': stage, 'reason': reason, 'fix': fix, 'fallback': fallback}
+
+
+def _print_not_ready(d, base_url, explicit=False):
+    """没就绪时打印友好提示. explicit=用户显式要 opencli → 给详细修复; 否则侧重回退."""
+    print('')
+    print('╔══ OpenCLI 引擎未就绪 ════════════════════════════════════════')
+    print('║ 阶段: %s' % d['stage'])
+    print('║ 原因: %s' % d['reason'])
+    print('║ ────────────────────────────────────────────────────────────')
+    print('║ 怎么修: %s' % d['fix'])
+    if not explicit:
+        print('║')
+        print('║ ✅ 已自动回退: 改用 playwright 引擎跑 (autotest_run.py)')
+        print('║    playwright 开箱即用, 不需要装 opencli/扩展/登录.')
+        print('║    opencli 是可选增强 —— 被验证码/数据断言卡住时再装即可.')
+    print('╚══════════════════════════════════════════════════════════════')
+    print('')
+
+
+def _print_bind_fail(info, base_url, explicit=False):
+    """bind 失败(扩展连了但没登/没聚焦)的友好提示."""
+    print('')
+    print('╔══ OpenCLI 无法绑定已登录标签页 ══════════════════════════════')
+    print('║ 原因: %s' % str(info)[:58])
+    print('║ ────────────────────────────────────────────────────────────')
+    print('║ 怎么修:')
+    print('║   1. 在 Chrome 里打开 %s' % base_url)
+    print('║   2. 手动登录 (账号密码 + 验证码, 你过一次即可)')
+    print('║   3. 把登录成功的标签页切到最前台')
+    print('║   4. 重新跑本命令')
+    if not explicit:
+        print('║')
+        print('║ ✅ 已自动回退: 改用 playwright 引擎 (它自己处理登录)')
+    print('╚══════════════════════════════════════════════════════════════')
+    print('')
+
+
+# ===== subprocess 调 opencli 命令的统一封装 =====
+
+
+# ===== subprocess 调 opencli 命令的统一封装 =====
+def _run(args, timeout=30):
+    """跑一条 opencli 命令, 返回 subprocess.CompletedProcess.
+    args 不含 'opencli' 前缀. stdout 是 JSON 时由调用方解析.
+    用定位到的绝对路径 (_OPENCLI_BIN), 绕开 subprocess PATH 不全的坑."""
+    exe = _OPENCLI_BIN or 'opencli'
+    cmd = [exe] + [str(a) for a in args]
+    try:
+        return subprocess.run(cmd, capture_output=True, timeout=timeout,
+                              shell=(os.name == 'nt' and not os.path.sep in exe))
+    except subprocess.TimeoutExpired as e:
+        class _TO:
+            returncode = 75  # TEMPFAIL (opencli sysexits 约定)
+            stdout = b''
+            stderr = ('timeout %ds: %s' % (timeout, ' '.join(cmd))).encode()
+        return _TO()
+
+
+def _run_json(args, timeout=30):
+    """跑 opencli 命令并解析 stdout JSON. 失败返回 ({}, rc)."""
+    r = _run(args, timeout=timeout)
+    try:
+        j = json.loads(r.stdout.decode('utf-8', 'ignore')) if r.stdout else {}
+    except Exception:
+        j = {}
+    return j, r.returncode
+
+
+def _anchor_to_flags(anchor):
+    """把 anchor {role,name,placeholder,field,text} 转 opencli 的 --role/--name 等 flag.
+    opencli 的 click/type/fill 支持语义 flag, 比 CSS 稳."""
+    if not anchor:
+        return []
+    flags = []
+    role = anchor.get('role', '')
+    name = anchor.get('name', '')
+    ph = anchor.get('placeholder', '')
+    field = anchor.get('field', '')
+    text = anchor.get('text', '')
+    # opencli --role 用 ARIA role; 这里 anchor.role 是我们自己的语义角色
+    if role and role in ('button', 'textbox', 'link', 'tab', 'checkbox', 'radio', 'menuitem'):
+        flags += ['--role', role]
+    if name:
+        flags += ['--name', name]
+    elif ph:
+        flags += ['--label', ph]  # placeholder 当 label 找
+    elif text:
+        flags += ['--text', text]
+    if field and not (name or ph or text):
+        # 退化: input[name=xxx] → CSS
+        flags += ['--css', "input[name='%s']" % field]
+    return flags
+
+
+# ===== 登录态: bind 到用户已登录的真实 Chrome tab =====
+def init_session(session):
+    """绑定到用户手动登好的 Chrome tab. 复用真实登录态, 无验证码/无伪造."""
+    j, rc = _run_json(['browser', session, 'bind'], timeout=20)
+    if rc != 0:
+        return False, j.get('error', {}).get('message', 'bind 失败 (rc=%d)' % rc)
+    url = j.get('url', '')
+    return True, url
+
+
+def unbind_session(session):
+    """解绑, 保留用户 tab (不关闭)."""
+    try:
+        _run(['browser', session, 'unbind'], timeout=15)
+    except Exception:
+        pass
+
+
+# ===== 表格等待 (与 autotest_run.py 等价语义) =====
+def _wait_table_stable(session, max_wait=8):
+    """轮询页面 .vxe-body--row 行数 (用 eval), 等表格加载稳定."""
+    deadline = time.time() + max_wait
+    zero_streak = 0
+    last = -1
+    while time.time() < deadline:
+        # eval 只读, 数行数 (与 autotest_run.py 同样的 DOM 判据)
+        r = _run(['browser', session, 'eval',
+                  "document.querySelectorAll('.vxe-body--row').length"], timeout=8)
+        try:
+            n = int(re.search(r'\d+', r.stdout.decode('utf-8', 'ignore') or '0').group())
+        except Exception:
+            n = 0
+        if n > 0:
+            time.sleep(0.6)
+            r2 = _run(['browser', session, 'eval',
+                       "document.querySelectorAll('.vxe-body--row').length"], timeout=8)
+            try:
+                n2 = int(re.search(r'\d+', r2.stdout.decode('utf-8', 'ignore') or '0').group())
+            except Exception:
+                n2 = 0
+            if n2 >= n:
+                return n2
+        else:
+            zero_streak += 1
+            if zero_streak >= 3:
+                return 0
+        time.sleep(0.5)
+    return last
+
+
+# ===== 单步执行 (镜像 autotest_run.py:138 exec_step 的结构) =====
+def exec_step(session, step, timeout=8):
+    """执行一步, 返回 (ok, detail). 镜像 autotest_run.py exec_step 的契约."""
+    intent = step.get('intent', '')
+    desc = step.get('desc', '')
+    anchor = step.get('anchor', {}) or {}
+    val = step.get('value', '')
+
+    try:
+        if intent == 'goto':
+            url = BASE + val if val.startswith('/') else val
+            _run(['browser', session, 'open', url], timeout=20)
+            time.sleep(2)
+            _wait_table_stable(session, max_wait=8)
+            return True, 'navigated'
+
+        if intent == 'fill':
+            flags = _anchor_to_flags(anchor)
+            if not flags:
+                return False, '元素未找到(anchor 空:%s)' % desc
+            r = _run(['browser', session, 'fill'] + flags + [str(val)], timeout=timeout)
+            j = {}
+            try:
+                j = json.loads(r.stdout.decode('utf-8', 'ignore')) if r.stdout else {}
+            except Exception:
+                pass
+            if r.returncode != 0:
+                err = j.get('error', {}).get('code', 'rc=%d' % r.returncode)
+                return False, '元素未找到(%s/%s)' % (desc, err)
+            # fill 带 verified 字段 (opencli 设值后会读回校验)
+            verified = j.get('verified', False)
+            return (bool(verified), 'filled' if verified else 'verify_fail(actual=%s)' % j.get('actual'))
+
+        if intent == 'click':
+            flags = _anchor_to_flags(anchor)
+            if not flags:
+                return False, '元素未找到(anchor 空:%s)' % desc
+            r = _run(['browser', session, 'click'] + flags, timeout=timeout)
+            time.sleep(1.5)
+            j = {}
+            try:
+                j = json.loads(r.stdout.decode('utf-8', 'ignore')) if r.stdout else {}
+            except Exception:
+                pass
+            if r.returncode != 0:
+                err = j.get('error', {}).get('code', 'rc=%d' % r.returncode)
+                return False, '元素未找到(%s/%s)' % (desc, err)
+            ml = j.get('match_level', '?')
+            mn = j.get('matches_n', '?')
+            return True, '%s(匹配%s)' % (ml, mn)
+
+        if intent == 'observe':
+            return True, 'observed'
+
+        if intent == 'extract':
+            # 优先 expect_api (network 抓后端响应, 强断言)
+            if step.get('expect_api'):
+                return _check_api(session, step['expect_api'])
+            # 否则走旧语义: body 文本包含 check 关键词
+            check = step.get('check', '')
+            r = _run(['browser', session, 'eval', "document.body.innerText"], timeout=10)
+            body = r.stdout.decode('utf-8', 'ignore') if r.stdout else ''
+            if check:
+                hit = check in body
+                return (hit, '命中:%s' % check if hit else '未命中:%s' % check)
+            return True, 'extracted(no check)'
+
+        if intent == 'assert':
+            return _check_assert(session, step.get('check', ''))
+
+    except Exception as e:
+        return False, str(e)[:60]
+    return False, '未知intent:%s' % intent
+
+
+# ===== 旧 check 断言 (兼容 autotest_run.py 的行数/URL/文本语义) =====
+def _check_assert(session, check):
+    """镜像 autotest_run.py 的 assert 分支: rows>/rows==/url_contains/input_empty."""
+    if not check:
+        return True, 'assert(no check)'
+    if check.startswith('rows>'):
+        n = int(check[5:])
+        _wait_table_stable(session, max_wait=6)
+        r = _run(['browser', session, 'eval', "document.querySelectorAll('.vxe-body--row').length"], timeout=8)
+        try:
+            rows = int(re.search(r'\d+', r.stdout.decode('utf-8', 'ignore') or '0').group())
+        except Exception:
+            rows = 0
+        return (rows > n, '行数%d>%d' % (rows, n) if rows > n else '行数%d<=%d' % (rows, n))
+    if check.startswith('rows=='):
+        n = int(check[6:])
+        _wait_table_stable(session, max_wait=6)
+        r = _run(['browser', session, 'eval', "document.querySelectorAll('.vxe-body--row').length"], timeout=8)
+        try:
+            rows = int(re.search(r'\d+', r.stdout.decode('utf-8', 'ignore') or '0').group())
+        except Exception:
+            rows = 0
+        return (rows == n, '行数=%d' % rows)
+    if check.startswith('url_contains'):
+        kw = check.split(':', 1)[1] if ':' in check else ''
+        r = _run(['browser', session, 'get', 'url'], timeout=8)
+        cur = r.stdout.decode('utf-8', 'ignore').strip() if r.stdout else ''
+        return (kw in cur, 'url含%s' % kw if kw in cur else 'url不含%s' % kw)
+    if check.startswith('input_empty:'):
+        field = check.split(':', 1)[1]
+        r = _run(['browser', session, 'eval', "document.querySelector(\"input[name='%s']\")?.value||''" % field], timeout=8)
+        v = r.stdout.decode('utf-8', 'ignore').strip().strip('"') if r.stdout else ''
+        return (v == '', '框值=%r' % v)
+    return True, 'assert(未知check:%s)' % check[:20]
+
+
+# ===== 新增: expect_api 网络断言 (OpenCLI 核心增量) =====
+def _check_api(session, expect):
+    """抓 network 验证后端 JSON 字段值. expect = {endpoint, jsonpath, equals, filter?}.
+
+    流程: wait xhr(endpoint) → network 找 key → detail 拉 body → jsonpath 取值比对.
+    这是 OpenCLI 相对 playwright 链路最强的增量: 直接断言后端返回, 不依赖 DOM 渲染.
+    """
+    endpoint = expect.get('endpoint', '')
+    jp = expect.get('jsonpath', '')
+    want = expect.get('equals')
+    filt = expect.get('filter', '')
+
+    # 1. 等目标请求完成 (endpoint 作为 url 片段匹配)
+    if endpoint:
+        _run(['browser', session, 'wait', 'xhr', endpoint, '--timeout', '10000'], timeout=15)
+
+    # 2. 读 network 列表 (默认 list 模式, 含 shape 不含 body, 省 token)
+    args = ['browser', session, 'network']
+    if filt:
+        args += ['--filter', filt]
+    j, rc = _run_json(args, timeout=15)
+    if rc != 0 or not j:
+        return False, 'network读取失败(%s)' % j.get('error', {}).get('code', 'rc=%d' % rc)
+    entries = j.get('entries', [])
+    if not entries:
+        return False, 'network无捕获(可能被默认过滤, 试加 --all 或检查endpoint)'
+
+    # 3. 找匹配 endpoint 的 entry (url 含 endpoint 片段)
+    entry = None
+    for e in entries:
+        if endpoint in (e.get('url', '') or '') or endpoint in (e.get('key', '') or ''):
+            entry = e
+            break
+    if not entry:
+        keys = [e.get('key', '?') for e in entries[:5]]
+        return False, '未捕获%s(captured:%s)' % (endpoint, keys)
+    key = entry.get('key', '')
+
+    # 4. 拉完整 body (--detail <key>)
+    dj, drc = _run_json(['browser', session, 'network', '--detail', key], timeout=15)
+    if drc != 0:
+        return False, 'detail读取失败(%s)' % dj.get('error', {}).get('code', 'rc=%d' % drc)
+    body = dj.get('body')
+    if body is None:
+        return False, 'body为空(shape:%s)' % dj.get('shape')
+
+    # 5. jsonpath 取值 (轻量实现, 只支持点路径, 不引依赖)
+    actual = _dig(body, jp.lstrip('$.').lstrip('.'))
+    ok = (actual == want)
+    return ok, '%s=%s(期望%s)' % (jp, _short(actual), _short(want))
+
+
+def _dig(obj, path):
+    """简单点路径取值: data.total / data.rows[0].id. 不引 jsonpath 依赖."""
+    if not path:
+        return obj
+    cur = obj
+    for part in re.split(r'\.', path):
+        # 处理数组下标 rows[0]
+        m = re.match(r'([^\[]+)(\[(\d+)\])?', part)
+        if not m:
+            return None
+        key = m.group(1)
+        idx = m.group(3)
+        if isinstance(cur, dict) and key in cur:
+            cur = cur[key]
+        elif isinstance(cur, list) and key.isdigit() and int(key) < len(cur):
+            cur = cur[int(key)]
+        else:
+            return None
+        if idx is not None and isinstance(cur, list) and int(idx) < len(cur):
+            cur = cur[int(idx)]
+    return cur
+
+
+def _short(v, n=30):
+    s = str(v)
+    return s if len(s) <= n else s[:n] + '...'
+
+
+# ===== 跑一个用例 (镜像 autotest_run.py:199 run_case) =====
+def run_case(session, case):
+    cid = case.get('case_id', '?')
+    steps = case.get('steps', [])
+    details = []
+    all_ok = True
+    for step in steps:
+        ok, detail = exec_step(session, step)
+        details.append('%s:%s(%s)' % (step.get('intent', '?'), '✓' if ok else '✗', detail))
+        if not ok:
+            all_ok = False
+            break  # 失败即停 (前置步骤失败后续无意义)
+    return {'case_id': cid, 'title': case.get('title', ''), 'pass': all_ok,
+            'expected': case.get('expected', ''), 'details': details}
+
+
+# ===== 沉淀锚点 (与 autotest_run.py 一致, 复用 autotest.py learn) =====
+def collect_anchors(session):
+    """从当前页面收集可交互元素锚点 (用 eval, 与 autotest_run.py 同样的选择器)."""
+    js = '''()=>{const out=[];document.querySelectorAll('button,.ant-tabs-tab,input[placeholder],input[name],[role=tab]').forEach(el=>{const name=(el.innerText||el.getAttribute('placeholder')||el.getAttribute('name')||'').trim();const role=el.getAttribute('role')||(el.tagName==='INPUT'?'textbox':el.tagName.toLowerCase());if(name&&name.length<25&&!/^[0-9\s]+$/.test(name))out.push({role,name});});return out.slice(0,30);}'''
+    r = _run(['browser', session, 'eval', js], timeout=10)
+    try:
+        els = json.loads(r.stdout.decode('utf-8', 'ignore')) if r.stdout else []
+    except Exception:
+        els = []
+    seen = set(); uniq = []
+    for el in els:
+        k = (el.get('role'), el.get('name'))
+        if k not in seen:
+            seen.add(k); uniq.append(el)
+    return uniq
+
+
+def sediment(page_path, anchors):
+    if not anchors:
+        return 0
+    try:
+        pj = json.dumps({'url': page_path, 'elements': [
+            {'role': a.get('role'), 'name': a.get('name'), 'desc': a.get('name')} for a in anchors
+        ]}, ensure_ascii=False)
+        subprocess.run([sys.executable, AUTOLEARN, 'learn', '--url', page_path, '--page-json', pj],
+                       capture_output=True, timeout=20)
+        return len(anchors)
+    except Exception:
+        return 0
+
+
+# ===== 主 =====
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument('--task', required=True, help='任务文件 JSON')
+    ap.add_argument('--session', default=DEFAULT_SESSION, help='OpenCLI session 名 (默认 wltest)')
+    ap.add_argument('--url', default='', help='临时覆盖 base url')
+    ap.add_argument('--force-opencli', action='store_true',
+                    help='强制用 opencli 引擎, 没装也不回退 (默认: 没装自动回退 playwright)')
+    args = ap.parse_args()
+
+    global BASE
+    if args.url:
+        BASE = args.url.rstrip('/')
+
+    task = json.load(open(args.task, encoding='utf-8'))
+    page_path = task['page_path']
+    cases = task.get('cases', [])
+
+    # 1. 环境探测 (没装/没连 → 友好提示; 隐式调用时自动回退 playwright, 50 人零报错)
+    ok, diag = _opencli_ready()
+    if not ok:
+        _print_not_ready(diag, BASE, explicit=args.force_opencli)
+        # 显式要 opencli 但没装 → 中止 (用户明确要它, 不能偷换引擎)
+        if args.force_opencli:
+            result = {'engine': 'opencli', 'error': 'OPENCLI_NOT_READY(%s)' % diag.get('stage'),
+                      'case_results': [], 'page': page_path}
+            print(json.dumps(result, ensure_ascii=False))
+            sys.exit(1)
+        # 隐式调用 → 自动回退 playwright (开箱即用的关键)
+        print('>>> 自动转用 playwright 引擎 (autotest_run.py) ...')
+        runner = os.path.join(SCRIPTS, 'autotest_run.py')
+        cmd = [sys.executable, runner, '--task', args.task]
+        if args.url:
+            cmd += ['--url', args.url]
+        r = subprocess.run(cmd, cwd=PROJECT)
+        sys.exit(r.returncode)
+
+    session = args.session
+    t0 = time.time()
+    result = {'page': page_path, 'page_name': task.get('page_name', ''),
+              'engine': 'opencli', 'case_results': [], 'anchors_count': 0, 'error': '', 'video': ''}
+    try:
+        # 2. 绑定已登录 tab (复用真实登录态, 这一步替代 get_token + init_session 整条链)
+        bound, info = init_session(session)
+        if not bound:
+            _print_bind_fail(info, BASE, explicit=args.force_opencli)
+            if args.force_opencli:
+                result['error'] = 'BIND_FAIL: ' + str(info)
+                print(json.dumps(result, ensure_ascii=False))
+                sys.exit(1)
+            print('>>> 自动转用 playwright 引擎 ...')
+            runner = os.path.join(SCRIPTS, 'autotest_run.py')
+            r = subprocess.run([sys.executable, runner, '--task', args.task], cwd=PROJECT)
+            sys.exit(r.returncode)
+        print('  已绑定: %s' % info)
+
+        # 3. 先 goto 目标页
+        _run(['browser', session, 'open', BASE + page_path], timeout=20)
+        time.sleep(2.5)
+        _wait_table_stable(session, max_wait=8)
+
+        # 4. 跑每个用例
+        for case in cases:
+            _run(['browser', session, 'open', BASE + page_path], timeout=20)  # 每用例前重新 goto
+            time.sleep(2)
+            cr = run_case(session, case)
+            result['case_results'].append(cr)
+            tag = '✓' if cr['pass'] else '✗'
+            print('  %s %s %s' % (tag, cr['case_id'], cr['title'][:30]))
+            for d in cr['details']:
+                print('      %s' % d)
+
+        # 5. 收集沉淀
+        anc = collect_anchors(session)
+        result['anchors_count'] = len(anc)
+        sediment(page_path, anc)
+
+    except Exception as e:
+        result['error'] = str(e)[:100]
+    finally:
+        # 解绑 (保留用户 tab)
+        unbind_session(session)
+
+    result['duration'] = round(time.time() - t0, 1)
+    passed = sum(1 for c in result['case_results'] if c['pass'])
+    total = len(result['case_results'])
+    result['summary'] = '%d/%d 通过' % (passed, total)
+    print()
+    print('汇总: %s 锚点%d 耗时%ss %s' % (result['summary'], result['anchors_count'], result['duration'], result['error']))
+    # 结果写文件 (与 autotest_run.py 同样的 _run.json 命名, 加 engine 区分)
+    out = args.task.replace('.json', '_opencli.json')
+    json.dump(result, open(out, 'w', encoding='utf-8'), ensure_ascii=False, indent=2)
+    print('结果: %s' % out)
+
+
+if __name__ == '__main__':
+    main()