@hupan56/wlkj 2.7.11 → 3.0.0

package/templates/qoder/scripts/{autotest.py → test/autotest.py}

@@ -1,1751 +1,1174 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-QODER Pipeline - 浏览器自动化测试 (用例生成 + 运行编排)
-
-设计原则 (遵循规则 8: QoderWork 只做可选增强, 绝不强依赖):
-    - 本脚本是"用例生成器 + 运行编排器", 不内嵌任何浏览器驱动库
-      (不 import playwright/selenium —— PM 本机装不动)。
-    - 真正"开浏览器点击"由 QoderWork 的 Browser Use / Computer 控制连接器
-      在运行时承担 (Agent 读 run 指令后调用连接器)。
-    - 纯 Qoder IDE / CLI 无连接器 → 静默降级为"人工核对清单", 不报错不阻塞。
-    - 本地 (workspace/tasks/<task>/autotest-cases.jsonl) 是唯一事实源。
-
-用例格式 (autotest-cases.jsonl, 每行一条):
-    {
-      "case_id": "AT-login-001",
-      "title": "正确账号密码登录成功",
-      "platform": "web", "env": "test",
-      "preconditions": "已注册账号 test/123456",
-      "steps": [
-        {"action": "goto", "target": "{{base_url}}/login"},
-        {"action": "fill", "target": "input[placeholder=账号]", "value": "{{ask:登录账号}}"},
-        {"action": "fill", "target": "input[type=password]", "value": "{{ask:登录密码}}"},
-        {"action": "click", "target": "button.login-btn"},
-        {"action": "assert_visible", "target": ".home-page", "desc": "跳到首页"}
-      ],
-      "expected": "登录成功进入首页, 右上角显示用户名"
-    }
-    steps.action 取值: goto / click / fill / select / assert_visible /
-                       assert_text / wait / screenshot / (可扩展)
-
-占位符 (run 时注入):
-    {{base_url}}  — 按环境(test/pre/prod)解析的目标域名
-    {{ask:描述}}  — 需要用户提供的测试数据(账号/密码/手机号等)。
-                    生成用例时: 凡是需要真实测试数据的, 用 {{ask:描述}} 占位, 绝不编造。
-                    执行时: 用 --data '{"登录账号":"test","登录密码":"123456"}' 传入;
-                    未提供的会列清单提示补齐后再执行。
-                    敏感数据(密码/验证码)建议走 --data 命令传, 避免明文进对话记录。
-
-域名解析优先级: --url > --env(查 config.yaml) > 报错
-
-Usage:
-    python autotest.py generate <task> [--env test|pre|prod] [--platform web|app]
-    python autotest.py run <task>     [--env ...] [--url <url>] [--platform ...]
-                                      [--case <case_id> ...] [--data '<json>']
-                                      [--record <result>]
-    python autotest.py quick --cases '<JSON用例>' [--desc '<描述>'] [--env ...]
-                              [--url <url>] [--platform ...] [--data '<json>']
-                              [--record <result>]   # 快速测试, 不需任务/PRD
-    python autotest.py list <task>
-    python autotest.py report <task>
-
-Exit: 0 = 成功, 1 = 一般错误(含缺测试数据)
-"""
-
-import argparse
-import json
-import os
-import sys
-from datetime import datetime
-from pathlib import Path
-
-if sys.platform == 'win32':
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-    except (AttributeError, IOError):
-        pass
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-
-from common.paths import get_repo_root, get_tasks_dir, get_developer, MEMBERS_DIR, index_path  # noqa: E402
-from common.task_utils import load_task_json, resolve_task_dir  # noqa: E402
-
-# ---------------------------------------------------------------------------
-# 路径常量
-# ---------------------------------------------------------------------------
-
-BASE = get_repo_root()
-CONFIG_PATH = os.path.join(str(BASE), '.qoder', 'config.yaml')
-HISTORY_PATH = os.path.join(str(BASE), '.qoder', 'learning', 'autotest-history.jsonl')
-# 个人测试数据文档: workspace/members/{dev}/autotest-data.yaml
-# ✅ 用户可见、自己填(在个人文件夹里); ✅ .gitignore 覆盖(workspace/members/*/autotest-data.yaml),
-#    team_sync 永不 push/共享。跟 .signing_key/exports/journal 同级隔离。
-# ⚠️ config.yaml 是团队共用会 push, 绝不能放账号密码。
-LOCAL_DATA_FILENAME = 'autotest-data.yaml'
-# 登录态记录(同目录, 同样 gitignored): 记住哪个环境已登录, 避免重复登录(尤其验证码慢)
-LOGIN_STATE_FILENAME = 'autotest-login-state.yaml'
-CASES_FILENAME = 'autotest-cases.jsonl'
-
-SUPPORTED_ENVS = ['test', 'pre', 'prod']
-SUPPORTED_PLATFORMS = ['web', 'app']
-# steps.action 白名单 (生成时校验; 不在表内 → 警告但不阻塞)
-KNOWN_ACTIONS = {
-    'goto', 'click', 'fill', 'select', 'hover', 'press',
-    'assert_visible', 'assert_text', 'assert_not_visible',
-    'wait', 'screenshot', 'scroll', 'upload',
-    'solve_captcha',  # 验证码: QoderWork Agent 用自带视觉识别(截图→算数学题→填入)
-}
-
-# ── 意图式 step (A方案: 意图+锚点) ──
-# 新格式: {intent, desc, anchor?, value?} —— 执行时靠 read_page 的 a11y 树语义匹配,
-# 有 anchor(role/name/placeholder)则确定性命中(快), 无则 LLM 兜底(self-heal)。
-# ref 不存(会变), 只存稳定锚点。兼容旧 action 式(有 action 字段=legacy)。
-KNOWN_INTENTS = {
-    'goto',       # 导航: {intent:'goto', desc:'登录页', value:'{{base_url}}/auth/login'}
-    'observe',    # 读页面: {intent:'observe'} 触发一次 read_page 拿 a11y 树
-    'click',      # 点击: {intent:'click', desc:'登录按钮', anchor:{role:'button',name:'登录'}}
-    'fill',       # 填表: {intent:'fill', desc:'账号框', value:'{{ask:登录账号}}', anchor:{placeholder:'尊敬的管理员'}}
-    'extract',    # 语义断言: {intent:'extract', desc:'是否已进入首页(离开登录页)'}
-    'ask_human',  # 人机协同: {intent:'ask_human', desc:'请手动完成验证码并点登录'}
-    'assert',     # 确定性断言: {intent:'assert', desc:'URL 不再是 /auth/login'}
-}
-# anchor 允许的稳定锚点 key (role/name 来自 a11y 树, placeholder/text 来自属性; 都不随刷新变)
-ANCHOR_KEYS = {'role', 'name', 'placeholder', 'text'}
-
-
-def is_intent_step(s):
-    """step 是新意图式(有 intent 字段)还是旧命令式(有 action 字段)。"""
-    return isinstance(s, dict) and 'intent' in s and 'action' not in s
-
-
-# ---------------------------------------------------------------------------
-# 配置加载 (仿 common.feishu._load_config: yaml 优先, 缺失则简单解析)
-# ---------------------------------------------------------------------------
-
-def load_config_section(section='autotest'):
-    """加载 config.yaml 的指定段。PyYAML 不可用时尽力解析 autotest 段。"""
-    try:
-        import yaml
-        with open(CONFIG_PATH, encoding='utf-8') as f:
-            full = yaml.safe_load(f) or {}
-        return full.get(section) or {}
-    except Exception:
-        # PyYAML 缺失或解析失败 —— 简单兜底 (只兜 default_env, base_url 解析仍报错)
-        return _fallback_parse_autotest()
-
-
-def _fallback_parse_autotest():
-    """无 PyYAML 时的极简兜底: 只抓 default_env。base_url 解析交给上层报错。"""
-    config = {}
-    try:
-        with open(CONFIG_PATH, encoding='utf-8') as f:
-            for line in f:
-                if line.strip().startswith('default_env:'):
-                    val = line.split(':', 1)[1].strip().strip('"').strip("'")
-                    config['default_env'] = val
-                    break
-    except Exception:
-        pass
-    return config
-
-
-def resolve_base_url(env, platform, override=None):
-    """解析目标域名。优先级: override(--url) > config > None。
-
-    Returns: (base_url, source)  source ∈ {'cli', 'config', 'none'}
-    """
-    if override:
-        return override.rstrip('/'), 'cli'
-    cfg = load_config_section('autotest')
-    envs = cfg.get('environments') or {}
-    env_cfg = envs.get(env) or {}
-    plat_cfg = env_cfg.get(platform) or {}
-    url = (plat_cfg.get('base_url') or '').strip()
-    if url:
-        return url.rstrip('/'), 'config'
-    return None, 'none'
-
-
-# ---------------------------------------------------------------------------
-# 个人测试数据文档 (workspace/members/{dev}/autotest-data.yaml)
-#   ✅ 用户可见, 自己填(就在个人文件夹里)
-#   ✅ .gitignore 覆盖 (workspace/members/*/autotest-data.yaml) → team_sync 永不 push
-#   ⚠️ config.yaml 是团队共用会 push, 绝不能放账号密码
-# ---------------------------------------------------------------------------
-
-def _require_developer():
-    """获取当前开发者名, 身份缺失直接抛错。
-
-    健壮性: 绝不 fallback 到 'default'。多人共用 workspace 时,
-    无身份 = 会写到共享垃圾目录 = 串号。必须先 /wl-init 确立身份。
-    """
-    dev = get_developer()
-    if not dev:
-        raise RuntimeError(
-            '未检测到开发者身份(无 .qoder/.developer)。请先运行 /wl-init 注册身份。'
-            ' (多人共用 workspace 时, 身份隔离靠它——没身份会串到别人的目录)'
-        )
-    return dev
-
-
-def local_data_path():
-    """当前开发者的个人测试数据文档路径。
-
-    workspace/members/{dev}/autotest-data.yaml —— 用户能直接看到、编辑。
-    """
-    dev = _require_developer()
-    return Path(str(MEMBERS_DIR)) / dev / LOCAL_DATA_FILENAME
-
-
-def load_local_test_data(env=None, platform=None):
-    """读个人测试数据文档。返回扁平 {描述: 值} 字典(已按 env/platform 合并)。
-
-    优先级(文档内): 指定 env+platform 的 > 仅 platform > 仅 env > 顶层通用。
-    文档不存在/解析失败 → {} (不报错)。
-
-    文档格式 (autotest-data.yaml):
-        # 顶层 = 通用(所有环境/平台都可用)
-        测试手机号: "13800000000"
-
-        # 按平台分(不分环境)
-        web:
-          登录账号: admin
-        app:
-          登录账号: appuser
-
-        # 按环境分
-        test:
-          登录账号: testuser
-          登录密码: "123456"
-
-        # 精确到 环境+平台 (优先级最高)
-        prod:
-          web:
-            登录账号: prod-admin
-    """
-    p = local_data_path()
-    if not p.is_file():
-        return {}
-    try:
-        import yaml
-        with open(str(p), encoding='utf-8') as f:
-            raw = yaml.safe_load(f) or {}
-    except ImportError:
-        raw = _parse_yaml_fallback(p)
-    except Exception:
-        return {}
-    if not isinstance(raw, dict):
-        return {}
-    # 合并优先级: 通用 < env < platform < env.platform
-    merged = {}
-    # 顶层(非 env/platform 的键)
-    for k, v in raw.items():
-        if k in SUPPORTED_ENVS or k in SUPPORTED_PLATFORMS:
-            continue
-        if isinstance(v, dict):
-            continue
-        merged[str(k)] = v
-    if platform and isinstance(raw.get(platform), dict):
-        for k, v in raw[platform].items():
-            if not isinstance(v, dict):
-                merged[str(k)] = v
-    if env and isinstance(raw.get(env), dict):
-        for k, v in raw[env].items():
-            if not isinstance(v, dict):
-                merged[str(k)] = v
-        # env.platform (精确)
-        if platform and isinstance(raw[env].get(platform), dict):
-            for k, v in raw[env][platform].items():
-                merged[str(k)] = v
-    return merged
-
-
-def _parse_yaml_fallback(p):
-    """无 PyYAML 时, 极简解析顶层 "key: value"(不支持嵌套)。"""
-    data = {}
-    try:
-        for line in p.read_text(encoding='utf-8').splitlines():
-            line = line.rstrip()
-            if not line.strip() or line.lstrip().startswith('#'):
-                continue
-            if line.startswith(' ') or line.startswith('\t'):
-                continue  # 跳过嵌套行(无 yaml 库时不解析嵌套)
-            if ':' not in line:
-                continue
-            k, _, v = line.partition(':')
-            data[k.strip()] = v.strip().strip('"').strip("'")
-    except Exception:
-        pass
-    return data
-
-
-def save_local_test_data(key, value, env=None, platform=None):
-    """原子写一条测试数据到个人文档。
-
-    策略: 没指定 env/platform → 写顶层; 指定了 → 写到对应嵌套块。
-    保留文档里已有的其他内容。
-    """
-    import yaml as _yaml
-    p = local_data_path()
-    os.makedirs(str(p.parent), exist_ok=True)
-    # 读已有(保留注释做不到, 但数据完整保留)
-    existing = {}
-    if p.is_file():
-        try:
-            with open(str(p), encoding='utf-8') as f:
-                existing = _yaml.safe_load(f) or {}
-        except Exception:
-            existing = {}
-    if not isinstance(existing, dict):
-        existing = {}
-    # 定位写入点
-    if env and platform:
-        existing.setdefault(env, {})
-        if not isinstance(existing[env], dict):
-            existing[env] = {}
-        existing[env].setdefault(platform, {})
-        if not isinstance(existing[env][platform], dict):
-            existing[env][platform] = {}
-        existing[env][platform][key] = value
-    elif env:
-        existing.setdefault(env, {})
-        if not isinstance(existing[env], dict):
-            existing[env] = {}
-        existing[env][key] = value
-    elif platform:
-        existing.setdefault(platform, {})
-        if not isinstance(existing[platform], dict):
-            existing[platform] = {}
-        existing[platform][key] = value
-    else:
-        existing[key] = value
-    from common.atomicio import atomic_write_text
-    header = ('# 个人测试数据 (本地, 已 gitignore, 不会 push/共享给团队)\n'
-              '# 用 autotest.py set-data 管理, 或直接编辑本文件。\n'
-              '# 顶层=通用; web/app=按平台; test/pre/prod=按环境; 环境.平台=最精确(优先级最高)\n\n')
-    atomic_write_text(str(p), header + _yaml.safe_dump(
-        existing, allow_unicode=True, sort_keys=False, default_flow_style=False))
-
-
-def init_local_data_doc():
-    """生成带注释的空模板文档(若不存在)。"""
-    p = local_data_path()
-    if p.is_file():
-        return str(p), False  # 已存在, 不覆盖
-    os.makedirs(str(p.parent), exist_ok=True)
-    from common.atomicio import atomic_write_text
-    template = (
-        '# 个人测试数据 (本地, 已 gitignore, 不会 push/共享给团队)\n'
-        '# 在这里填你的测试账号/密码。每个人只填自己的 members/{自己}/autotest-data.yaml。\n'
-        '#\n'
-        '# 结构(优先级从低到高):\n'
-        '#   顶层 key        → 所有环境/平台通用\n'
-        '#   web: / app:     → 按平台分\n'
-        '#   test: / pre: / prod:  → 按环境分\n'
-        '#   环境.平台        → 最精确, 优先级最高\n'
-        '#\n'
-        '# 用例里用 {{ask:描述}} 占位, 描述要跟这里的 key 一致(如 {{ask:登录账号}})。\n\n'
-        '# ===== 通用(不分环境/平台) =====\n'
-        '测试手机号: "13800000000"\n\n'
-        '# ===== 按平台 =====\n'
-        'web:\n'
-        '  登录账号: admin\n'
-        'app:\n'
-        '  登录账号: appuser\n\n'
-        '# ===== 按环境(test/pre/prod) =====\n'
-        'test:\n'
-        '  登录账号: testuser\n'
-        '  登录密码: "123456"\n'
-        '  # 也可精确到 环境+平台:\n'
-        '  # web:\n'
-        '  #   登录账号: test-web-admin\n'
-    )
-    atomic_write_text(str(p), template)
-    return str(p), True
-
-
-# ---------------------------------------------------------------------------
-# 登录态记录 (workspace/members/{dev}/autotest-login-state.yaml, gitignored)
-#   QoderWork 保持同一个浏览器会话 → 登录一次后 cookie 不丢 → 后续测新功能
-#   直接 goto 目标页, 不用重复登录(尤其数学题验证码慢)。
-# ---------------------------------------------------------------------------
-
-def login_state_path():
-    dev = _require_developer()
-    return Path(str(MEMBERS_DIR)) / dev / LOGIN_STATE_FILENAME
-
-
-def load_login_state():
-    """读登录态。返回 {env: {platform: {time, url}}} 或 {}。"""
-    p = login_state_path()
-    if not p.is_file():
-        return {}
-    try:
-        import yaml
-        with open(str(p), encoding='utf-8') as f:
-            data = yaml.safe_load(f) or {}
-        return data if isinstance(data, dict) else {}
-    except Exception:
-        return {}
-
-
-def is_logged_in(env, platform):
-    """该 env/platform 是否已标记登录。返回 (bool, time_str)。"""
-    state = load_login_state()
-    entry = (state.get(env) or {}).get(platform)
-    if isinstance(entry, dict):
-        return True, entry.get('time', '')
-    return False, ''
-
-
-def mark_logged_in(env, platform, base_url):
-    """标记某 env/platform 已登录(登录用例 pass 后调用)。"""
-    import yaml as _yaml
-    from common.atomicio import atomic_write_text
-    p = login_state_path()
-    os.makedirs(str(p.parent), exist_ok=True)
-    state = load_login_state()
-    state.setdefault(env, {})
-    state[env][platform] = {
-        'time': datetime.now().isoformat()[:19],
-        'url': base_url,
-    }
-    atomic_write_text(str(p), '# 登录态记录 (本地, gitignored)。'
-                       'QoderWork 保持会话, 登录一次后后续直接 goto 目标页。\n'
-                       + _yaml.safe_dump(state, allow_unicode=True, sort_keys=False))
-
-
-def clear_login_state(env=None, platform=None):
-    """清除登录态。env/platform 都不给 = 全清。"""
-    from common.atomicio import atomic_write_text
-    p = login_state_path()
-    state = load_login_state()
-    if env is None and platform is None:
-        state = {}
-    elif env and platform:
-        (state.get(env) or {}).pop(platform, None)
-    elif env:
-        state.pop(env, None)
-    elif platform:
-        for e in list(state.keys()):
-            (state.get(e) or {}).pop(platform, None)
-    if state:
-        atomic_write_text(str(p), '# 登录态记录 (本地, gitignored)\n'
-                           + __import__('yaml').safe_dump(
-                               state, allow_unicode=True, sort_keys=False))
-    elif p.is_file():
-        p.unlink()
-
-
-# ---------------------------------------------------------------------------
-# 测试页锚点索引 (data/index/test-pages.json, 团队共享)
-#   A方案核心: 记住"页面→稳定锚点(role/name/placeholder)", 下次测同页直接命中, 跳过 LLM。
-#   只存稳定锚点(不随刷新变), 绝不存 ref(会变)。
-# ---------------------------------------------------------------------------
-
-def test_pages_path():
-    """data/index/test-pages.json 路径(团队共享, 随 team_sync 分发)。"""
-    return index_path('test_pages')
-
-
-def _load_test_pages():
-    """读 test-pages.json。不存在返回空骨架。"""
-    from common.atomicio import safe_read_json
-    p = test_pages_path()
-    data = safe_read_json(str(p), default=None)
-    if not isinstance(data, dict):
-        return {'version': '1.0', 'updated': '', 'pages': {}, 'stats': {'total_pages': 0, 'total_anchors': 0}}
-    data.setdefault('pages', {})
-    data.setdefault('stats', {})
-    return data
-
-
-def _save_test_pages(data):
-    """原子写 test-pages.json, 自动更新 updated + stats。"""
-    from common.atomicio import atomic_write_json
-    data['updated'] = datetime.now().isoformat()[:19]
-    pages = data.get('pages', {})
-    n_anchors = sum(len(pg.get('elements', [])) for pg in pages.values())
-    data['stats'] = {'total_pages': len(pages), 'total_anchors': n_anchors}
-    atomic_write_json(str(test_pages_path()), data)
-
-
-def _normalize_url_pattern(url, base_url=None):
-    """把完整 URL 规整成可复用的 pattern(去域名, 保留路径)。
-
-    https://icsqas.inforecloud.com/auth/login → /auth/login
-    已是相对路径 → 原样返回。
-    """
-    if not url:
-        return '/'
-    u = url.strip()
-    if base_url and u.startswith(base_url):
-        return u[len(base_url):] or '/'
-    # 去 protocol + domain
-    if '://' in u:
-        u = u.split('://', 1)[1]
-        if '/' in u:
-            u = '/' + u.split('/', 1)[1]
-        else:
-            u = '/'
-    if not u.startswith('/'):
-        u = '/' + u
-    # 去 query (?redirect=...) —— 登录页常带 redirect, 不影响页面元素
-    u = u.split('?', 1)[0]
-    return u or '/'
-
-
-def learn_page_anchors(url_pattern, elements, intent_map=None):
-    """把一批页面元素锚点沉淀进 test-pages.json。
-
-    elements: read_page 返回的元素列表, 每个含 role/name/placeholder/text/ref(等)。
-              只提取稳定锚点(role/name/placeholder/text), 丢弃 ref/坐标。
-    intent_map: 可选 {元素描述: {intent, anchor}} —— AI 标注"这个元素对应什么意图"。
-                有则把 intent 一起存, recall 时能直接生成 step。
-    返回 (新增数, 总数)。
-    """
-    intent_map = intent_map or {}
-    data = _load_test_pages()
-    pages = data['pages']
-    existing = pages.get(url_pattern, {}).get('elements', [])
-    # 以 anchor 的规范化签名去重
-    def _sig(el):
-        a = el.get('anchor', {})
-        return '|'.join('%s=%s' % (k, a.get(k, '')) for k in sorted(a))
-    seen_sigs = {_sig(e) for e in existing}
-    new_anchors = []
-    for el in elements:
-        if not isinstance(el, dict):
-            continue
-        # 从 read_page 元素提取稳定锚点
-        anchor = {}
-        for k in ANCHOR_KEYS:
-            v = el.get(k)
-            if v:
-                anchor[k] = str(v)
-        if not anchor:
-            continue  # 无稳定锚点的元素(只有 ref/坐标)不存
-        desc = el.get('desc') or el.get('name') or el.get('text') or ''
-        # 查 intent_map: 用 desc/name 匹配
-        im = None
-        for key, val in intent_map.items():
-            if key in desc or desc in key:
-                im = val
-                break
-        entry = {
-            'desc': desc,
-            'anchor': anchor,
-            'intent': (im or {}).get('intent', el.get('intent', '')),
-        }
-        sig = _sig(entry)
-        if sig in seen_sigs:
-            continue
-        seen_sigs.add(sig)
-        new_anchors.append(entry)
-    merged = existing + new_anchors
-    pages[url_pattern] = {
-        'elements': merged,
-        'last_seen': datetime.now().isoformat()[:19],
-    }
-    data['pages'] = pages
-    _save_test_pages(data)
-    return len(new_anchors), len(merged)
-
-
-def recall_page_anchors(url_pattern):
-    """查某页已沉淀的锚点。返回 elements 列表(可能空)。"""
-    data = _load_test_pages()
-    pg = data.get('pages', {}).get(url_pattern)
-    if not pg:
-        return []
-    return pg.get('elements', [])
-
-
-# ---------------------------------------------------------------------------
-# 任务 / 用例文件 IO
-# ---------------------------------------------------------------------------
-
-def _cases_path(task_dir):
-    return Path(task_dir) / CASES_FILENAME
-
-
-def read_cases(task_dir):
-    """读取某任务的全部用例 (list[dict])。无文件返回 []。"""
-    p = _cases_path(task_dir)
-    if not p.is_file():
-        return []
-    cases = []
-    for lineno, raw in enumerate(p.read_text(encoding='utf-8').splitlines(), 1):
-        raw = raw.strip()
-        if not raw:
-            continue
-        try:
-            cases.append(json.loads(raw))
-        except json.JSONDecodeError as e:
-            print('警告: %s 第 %d 行 JSON 损坏, 跳过 (%s)' % (p.name, lineno, e),
-                  file=sys.stderr)
-    return cases
-
-
-def write_cases(task_dir, cases):
-    """原子覆盖写全部用例为 jsonl。"""
-    from common.atomicio import atomic_write_text
-    p = _cases_path(task_dir)
-    lines = [json.dumps(c, ensure_ascii=False, sort_keys=True) for c in cases]
-    atomic_write_text(str(p), '\n'.join(lines) + ('\n' if lines else ''))
-
-
-# ---------------------------------------------------------------------------
-# 用例骨架生成 (脚本只造结构; 业务步骤由 AI 读 skill 后填充)
-# ---------------------------------------------------------------------------
-
-def _skeleton_case(task_name, case_no, platform, env):
-    """造一条占位用例骨架。AI 应在此基础上据 PRD 补充 steps/expected。
-
-    骨架自带一条示范: 凡是需要真实测试数据(账号/密码)的地方, 用
-    {{ask:描述}} 占位 —— 执行时会提示收集, 绝不编造。
-    """
-    cid = 'AT-%s-%03d' % (task_name, case_no)
-    return {
-        'case_id': cid,
-        'title': '（待补充）用例 %d 标题' % case_no,
-        'platform': platform,
-        'env': env,
-        'preconditions': '',
-        'steps': [
-            {'action': 'goto', 'target': '{{base_url}}/', 'desc': '打开页面'},
-            # 需要真实测试数据时用 {{ask:描述}} 占位, 例:
-            #   {'action':'fill','target':'#account','value':'{{ask:登录账号}}'}
-            {'action': 'assert_visible', 'target': 'body', 'desc': '页面正常加载'},
-        ],
-        'expected': '（待补充）预期结果',
-    }
-
-
-def generate_skeleton(task_dir, env, platform, count=3):
-    """为任务生成 count 条骨架用例 (不覆盖已有; 追加)。"""
-    task_name = Path(task_dir).name
-    existing = read_cases(task_dir)
-    start_no = len(existing) + 1
-    new_cases = [_skeleton_case(task_name, start_no + i, platform, env)
-                 for i in range(count)]
-    write_cases(task_dir, existing + new_cases)
-    return new_cases
-
-
-def validate_cases(cases, strict=False):
-    """校验用例结构, 返回 (ok, warnings)。strict=True 时缺字段视为错误。"""
-    warns = []
-    ids = set()
-    for i, c in enumerate(cases, 1):
-        cid = c.get('case_id', '')
-        if not cid:
-            warns.append('第 %d 条缺 case_id' % i)
-        elif cid in ids:
-            warns.append('case_id 重复: %s' % cid)
-        else:
-            ids.add(cid)
-        for f in ('title', 'steps', 'expected'):
-            if f not in c:
-                warns.append('%s 缺字段 %s' % (cid or ('第%d条' % i), f))
-        steps = c.get('steps') or []
-        if not isinstance(steps, list):
-            warns.append('%s steps 不是数组' % cid)
-            continue
-        for j, s in enumerate(steps, 1):
-            if not isinstance(s, dict):
-                warns.append('%s step%d 不是对象' % (cid, j))
-                continue
-            # 新意图式: 校验 intent + anchor 结构
-            if is_intent_step(s):
-                it = s.get('intent', '')
-                if it and it not in KNOWN_INTENTS:
-                    warns.append('%s step%d 未知 intent: %s' % (cid, j, it))
-                if not s.get('desc') and it not in ('observe',):
-                    warns.append('%s step%d (intent=%s) 缺 desc' % (cid, j, it))
-                anc = s.get('anchor')
-                if anc is not None:
-                    if not isinstance(anc, dict):
-                        warns.append('%s step%d anchor 不是对象' % (cid, j))
-                    elif not any(k in ANCHOR_KEYS for k in anc):
-                        warns.append('%s step%d anchor 无稳定键(需 %s 之一)'
-                                     % (cid, j, '/'.join(sorted(ANCHOR_KEYS))))
-            else:
-                # 旧命令式: 校验 action
-                act = s.get('action', '')
-                if not act:
-                    warns.append('%s step%d 既无 intent 也无 action' % (cid, j))
-                elif act not in KNOWN_ACTIONS:
-                    warns.append('%s step%d 未知 action: %s' % (cid, j, act))
-    return (len(warns) == 0) if strict else True, warns
-
-
-# ---------------------------------------------------------------------------
-# 共享: 解析环境+注入数据 / 打印执行计划 (run 和 quick 复用)
-# ---------------------------------------------------------------------------
-
-def _resolve_env_platform(args):
-    """解析域名 + 校验。返回 (base, src) 或 (None, None)。"""
-    base, src = resolve_base_url(args.env, args.platform, override=getattr(args, 'url', None))
-    if base is None:
-        print('✗ %s 环境未配 base_url, 无法执行测试。' % args.env)
-        print('  解决方式 (任选其一):')
-        print('    1. 命令行临时指定: --url https://你的地址')
-        print('    2. 配 config.yaml: autotest.environments.%s.%s.base_url'
-              % (args.env, args.platform))
-        return None, None
-    return base, src
-
-
-def _inject_and_check_data(cases, args):
-    """注入 base_url + 测试数据, 检查完整性。返回 (cases, ok)。ok=False 表示缺数据已提示。"""
-    cases = _inject_base_url(cases, getattr(args, '_base', ''))
-    local_data = load_local_test_data(env=args.env, platform=args.platform)
-    try:
-        cli_data = json.loads(args.data) if getattr(args, 'data', None) else {}
-    except json.JSONDecodeError as e:
-        print('✗ --data 不是合法 JSON: %s' % e)
-        print('  示例: --data \'{"登录账号":"test","登录密码":"123456"}\'')
-        return cases, False
-    merged = dict(local_data)
-    merged.update(cli_data)
-    cases, missing = inject_data(cases, merged)
-    if missing:
-        print('=' * 60)
-        print('⚠️ 需要测试数据才能执行 (%d 项)' % len(missing))
-        print('=' * 60)
-        print('以下用例引用了真实测试数据(账号/密码/手机号等), 不能编造:')
-        for i, desc in enumerate(missing, 1):
-            print('  %d. %s' % (i, desc))
-        print('-' * 60)
-        print('请向用户收集后, 用 --data 传入:')
-        print('  --data \'{"%s":"<值>", "%s":"<值>"}\''
-              % (missing[0], missing[1] if len(missing) > 1 else missing[0]))
-        print()
-        print('常用账号预置到个人文档(不进 git, 团队看不到):')
-        print('  python .qoder/scripts/autotest.py set-data 登录账号 test --env test')
-        return cases, False
-    return cases, True
-
-
-def _fmt_anchor(anc):
-    """格式化 anchor 为简短可读串, 如 "button '登录'" 或 "placeholder='尊敬的管理员'"。"""
-    if not isinstance(anc, dict) or not anc:
-        return ''
-    parts = []
-    for k in ('role', 'name', 'placeholder', 'text'):
-        v = anc.get(k)
-        if v:
-            parts.append("%s='%s'" % (k, v))
-    return ' '.join(parts)
-
-
-def _fmt_step(s, with_value=True):
-    """格式化单步为可读文本。支持新意图式(intent+anchor)和旧命令式(action+target)。"""
-    desc = s.get('desc', '')
-    # ── 新意图式 ──
-    if is_intent_step(s):
-        it = s.get('intent', '?')
-        anc = s.get('anchor')
-        val = s.get('value')
-        anchor_str = _fmt_anchor(anc)
-        if it == 'ask_human':
-            return '%-12s ⏸ %s' % ('人机协同', desc or '(请用户操作)')
-        if it == 'extract':
-            return '%-12s ✓ %s' % ('extract', desc or '(语义断言)')
-        if it == 'observe':
-            return '%-12s 👁 %s' % ('observe', desc or '读取页面可交互元素')
-        if it == 'goto':
-            return '%-12s → %s' % ('goto', val or desc or '')
-        # click / fill / assert
-        tag = '[锚点: %s]' % anchor_str if anchor_str else '(待匹配·LLM兜底)'
-        extra = ''
-        if val is not None:
-            extra = '  输入=%s' % val
-        return '%-12s %s %s%s' % (it, tag, desc, extra)
-    # ── 旧命令式(兼容) ──
-    act = s.get('action', '?')
-    tgt = s.get('target', '')
-    val = s.get('value')
-    if act == 'solve_captcha':
-        fill = s.get('fill_target', '')
-        detail = '截图 %s → 用视觉识别(算数学题) → 答案填入 %s' % (tgt, fill)
-        if desc:
-            detail += ' (%s)' % desc
-        return '%-16s %s' % (act, detail)
-    detail = tgt
-    if with_value and val is not None:
-        detail = '%s  输入=%s' % (tgt, val)
-    return '%-16s %s%s' % (act, detail, ('  — ' + desc) if desc else '')
-
-
-def _print_execution_plan(cases, base, src, env, platform, title, record_hint):
-    """打印执行编排指令 (QoderWork 浏览器执行 / 纯 Qoder 降级人工核对)。
-
-    record_hint: 回收结果时的命令提示文本 (run 用任务名, quick 用 --quick)。
-    """
-    is_qw, qw_hint = _detect_qoderwork()
-    print('=' * 60)
-    print('浏览器自动化测试 · 执行编排')
-    print('=' * 60)
-    print('测试: %s' % title)
-    print('环境: %s   平台: %s' % (env, platform))
-    print('目标: %s   (来源: %s)' % (base, src))
-    print('用例: %d 条' % len(cases))
-    print('-' * 60)
-
-    if is_qw:
-        print()
-        print('🧩 QoderWork 浏览器执行 (已检测到: %s)' % qw_hint)
-        print('请用 Browser Use / Computer 控制连接器, 按下列要求执行:')
-        print()
-        print('1. 打开浏览器, 访问: %s' % base)
-        print('2. 逐条执行用例 (共 %d 条):' % len(cases))
-        for c in cases:
-            print('   ▸ %s  %s' % (c.get('case_id', '?'), c.get('title', '')))
-            for s in (c.get('steps') or [])[:6]:
-                print('       %s' % _fmt_step(s))
-            print('       预期: %s' % c.get('expected', ''))
-        print()
-        print('3. 每条用例记录 pass/fail, 跑完回传结果:')
-        print('   %s' % record_hint)
-        print('   (或直接把结果贴给我, 我帮你出报告)')
-    else:
-        print()
-        print('[非 QoderWork 或未授权浏览器连接器 → 降级为人工核对]')
-        print('目标地址: %s' % base)
-        print()
-        for c in cases:
-            print('□ %s  %s' % (c.get('case_id', '?'), c.get('title', '')))
-            for s in (c.get('steps') or [])[:4]:
-                print('    %s' % _fmt_step(s))
-            print('    预期: %s' % c.get('expected', ''))
-            print()
-        print('在 QoderWork 桌面端 (Settings → Connectors 授权浏览器/Computer)')
-        print('可让 Agent 自动执行; 结果用 --record 回传出报告。')
-    print('-' * 60)
-
-
-# ---------------------------------------------------------------------------
-# 子命令: generate
-# ---------------------------------------------------------------------------
-
-def cmd_generate(args):
-    task_dir = resolve_task_dir(args.task)
-    if not task_dir.is_dir():
-        print('任务不存在: %s' % args.task)
-        print('提示: python .qoder/scripts/task.py list  查看已有任务')
-        return 1
-    task = load_task_json(task_dir) or {}
-
-    env = args.env
-    base, src = resolve_base_url(env, args.platform)
-    # generate 不强求域名 (用例用 {{base_url}} 占位), 但提示一下
-    if base is None:
-        print('提示: %s 环境未配 base_url, 用例将用 {{base_url}} 占位, '
-              'run 时再注入 (或在 config.yaml autotest.environments 配置)。'
-              % env)
-
-    new_cases = generate_skeleton(task_dir, env, args.platform)
-    all_cases = read_cases(task_dir)
-    ok, warns = validate_cases(all_cases)
-
-    print('已生成 %d 条用例骨架 → %s' % (len(new_cases), _cases_path(task_dir)))
-    print('任务: %s  环境: %s  平台: %s' % (
-        task.get('title', Path(task_dir).name), env, args.platform))
-    print()
-    print('⚠️ 这些是骨架占位。请按任务 PRD「验收标准」补充每条的:')
-    print('   - title: 用例标题')
-    print('   - steps: 操作步骤 (goto/click/fill/assert_visible ...)')
-    print('   - expected: 预期结果')
-    print('   (用 /wl-test 触发 AI 自动据 PRD 填充)')
-    if warns:
-        print()
-        print('校验提醒:')
-        for w in warns:
-            print('  - ' + w)
-    print()
-    print('下一步: /wl-test run %s --env %s  (生成+执行)'
-          % (Path(task_dir).name, env))
-    return 0
-
-
-# ---------------------------------------------------------------------------
-# 子命令: run
-# ---------------------------------------------------------------------------
-
-def _detect_qoderwork():
-    """探测当前是否在 QoderWork 环境 (有浏览器连接器)。
-
-    QoderWork 会暴露运行时工具/环境标记。探测而非假设: 看不到就回退。
-    返回 (is_qoderwork: bool, hint: str)
-    """
-    # 1. 显式环境变量标记 (QoderWork 桌面端/CLI 会设置)
-    for key in ('QODERWORK_SESSION', 'QODER_WORK', 'QW_CONNECTOR'):
-        if os.environ.get(key):
-            return True, 'env:' + key
-    # 2. QoderWork 配置目录存在 (~/.qoderwork/)
-    home = os.path.expanduser('~')
-    if os.path.isdir(os.path.join(home, '.qoderwork')):
-        return True, '~/.qoderwork'
-    return False, ''
-
-
-def _iter_injectable_strings(s):
-    """遍历一个 step 里所有可做占位符替换的字符串字段, yield (setter, value)。
-
-    覆盖旧格式(target/value/desc) + 新格式(intent式 value/desc/anchor.* )。
-    setter 是个闭包, 传新值回去。anchor(dict) 递归到它的每个 str 值。
-    """
-    for field in ('target', 'value', 'desc'):
-        val = s.get(field)
-        if isinstance(val, str):
-            yield (lambda v, f=field: s.__setitem__(f, v)), val
-    # anchor (新格式): dict, 每个值都可能是占位符串
-    anc = s.get('anchor')
-    if isinstance(anc, dict):
-        for k, v in list(anc.items()):
-            if isinstance(v, str):
-                yield (lambda nv, kk=k: anc.__setitem__(kk, nv)), v
-
-
-def _inject_base_url(cases, base_url):
-    """把 steps 里的 {{base_url}} 占位替换为真实域名(覆盖 anchor.*)。"""
-    for c in cases:
-        for s in c.get('steps') or []:
-            for setter, val in _iter_injectable_strings(s):
-                if isinstance(val, str) and '{{base_url}}' in val:
-                    setter(val.replace('{{base_url}}', base_url))
-    return cases
-
-
-def collect_ask_placeholders(cases):
-    """扫出全部 {{ask:描述}} 占位, 返回去重后的描述列表(保持出现顺序)。"""
-    import re as _re
-    asks = []
-    seen = set()
-    pat = _re.compile(r'\{\{ask:([^}]+)\}\}')
-    for c in cases:
-        for s in c.get('steps') or []:
-            for setter, val in _iter_injectable_strings(s):
-                if not isinstance(val, str):
-                    continue
-                for desc in pat.findall(val):
-                    if desc.strip() not in seen:
-                        seen.add(desc.strip())
-                        asks.append(desc.strip())
-    return asks
-
-
-def inject_data(cases, data):
-    """把 {{ask:描述}} 用 data 字典注入(覆盖 anchor.*)。返回 (cases, still_missing)。"""
-    import re as _re
-    pat = _re.compile(r'\{\{ask:([^}]+)\}\}')
-    provided = {k.strip(): v for k, v in (data or {}).items()}
-    still_missing = []
-    for c in cases:
-        for s in c.get('steps') or []:
-            for setter, val in _iter_injectable_strings(s):
-                if not isinstance(val, str) or '{{ask:' not in val:
-                    continue
-                for desc in pat.findall(val):
-                    key = desc.strip()
-                    if key in provided:
-                        val = val.replace('{{ask:%s}}' % desc, str(provided[key]))
-                for desc in pat.findall(val):
-                    if desc.strip() not in provided and desc.strip() not in still_missing:
-                        still_missing.append(desc.strip())
-                setter(val)
-    return cases, still_missing
-
-
-def cmd_quick(args):
-    """快速测试: 不需要任务/PRD。AI 据描述直接生成用例并执行。
-
-    用法: autotest.py quick --cases '<JSON用例>' --env test --platform web
-    (AI 把据用户描述生成的用例, 以 JSON 字符串传入; 脚本负责注入+执行编排)
-
-    也支持 --record 回收结果 (临时用例, 不落 task 历史, 只打印汇总)。
-    """
-    # 1. 解析用例: 优先 --cases-file (文件, 不截断), 其次 --cases (内联, 短用例)
-    raw = ''
-    cases_file = getattr(args, 'cases_file', None)
-    if cases_file:
-        try:
-            raw = open(cases_file, encoding='utf-8').read().strip()
-        except (OSError, IOError) as e:
-            print('✗ 读 --cases-file 失败: %s' % e)
-            return 1
-    if not raw:
-        raw = (args.cases or '').strip()
-    if not raw:
-        print('✗ quick 模式需要用例 JSON。用文件传(推荐, 不截断):')
-        print('  --cases-file <路径>   # AI 把用例 JSON 写文件, 再传路径')
-        print('或内联传(短用例): --cases \'<JSON>\'')
-        return 1
-    try:
-        parsed = json.loads(raw)
-    except json.JSONDecodeError as e:
-        print('✗ 用例 JSON 解析失败: %s' % e)
-        if cases_file:
-            print('  (来自文件: %s)' % cases_file)
-        return 1
-    cases = parsed if isinstance(parsed, list) else [parsed]
-    # 规范化: 补默认字段
-    for i, c in enumerate(cases):
-        if not isinstance(c, dict):
-            print('✗ 第 %d 条用例不是对象' % (i + 1))
-            return 1
-        c.setdefault('case_id', 'Q-%d' % (i + 1))
-        c.setdefault('platform', args.platform)
-        c.setdefault('env', args.env)
-        c.setdefault('steps', [])
-        c.setdefault('expected', '')
-
-    # 2. 回收结果模式 (临时用例, 只打印汇总)
-    if args.record:
-        try:
-            results = json.loads(args.record)
-        except json.JSONDecodeError as e:
-            print('✗ --record 不是合法 JSON: %s' % e)
-            return 1
-        total = len(results)
-        passed = sum(1 for v in results.values()
-                     if str(v).lower() in ('pass', 'passed', 'ok', 'true', '1'))
-        failed_ids = [k for k, v in results.items()
-                      if str(v).lower() not in ('pass', 'passed', 'ok', 'true', '1')]
-        # 登录用例通过 → 自动标记该 env/platform 已登录 (QoderWork 会话保持, 后续免登录)
-        login_passed = False
-        for c in cases:
-            cid = c.get('case_id', '')
-            if str(results.get(cid, '')).lower() in ('pass', 'passed', 'ok', 'true', '1'):
-                steps_txt = json.dumps(c.get('steps', []), ensure_ascii=False)
-                if '/auth/login' in steps_txt or 'solve_captcha' in steps_txt:
-                    login_passed = True
-                    break
-        if login_passed:
-            base, _ = resolve_base_url(args.env, args.platform)
-            if base:
-                mark_logged_in(args.env, args.platform, base)
-        # 🧠 自动沉淀锚点 (测完就学会, 下次跳过LLM):
-        #   ① 若传了 --page-json (read_page 结果) → 沉淀该页元素锚点
-        #   ② 从通过的 intent 式用例里提取 goto URL + anchor → 沉淀 (用例自带锚点也存)
-        learned_pages = []
-        # ① page-json 方式: 每个 pj 是 {"url":"...", "elements":[...]} 或元素数组
-        for pj_raw in (args.page_json or []):
-            try:
-                parsed = json.loads(pj_raw)
-            except Exception:
-                continue
-            if isinstance(parsed, dict) and 'url' in parsed:
-                url_pattern = _normalize_url_pattern(parsed.get('url', ''))
-                els = parsed.get('elements', parsed.get('elements', []))
-            elif isinstance(parsed, list):
-                url_pattern = '/auto'
-                els = parsed
-            else:
-                continue
-            new_n, _ = learn_page_anchors(url_pattern, els if isinstance(els, list) else [])
-            if new_n:
-                learned_pages.append('%s (+%d)' % (url_pattern, new_n))
-        # ② 从通过的 intent 用例提取 goto URL + anchor 自动沉淀
-        for c in cases:
-            cid = c.get('case_id', '')
-            if str(results.get(cid, '')).lower() not in ('pass', 'passed', 'ok', 'true', '1'):
-                continue  # 只沉淀通过用例的锚点 (失败的锚点可能不准)
-            current_url = '/auto'
-            for s in c.get('steps') or []:
-                if not is_intent_step(s):
-                    continue
-                it = s.get('intent', '')
-                if it == 'goto' and s.get('value'):
-                    current_url = _normalize_url_pattern(s['value'])
-                elif it in ('click', 'fill') and s.get('anchor'):
-                    # 用例自带的 anchor → 直接沉淀(执行时验证过有效)
-                    desc = s.get('desc', '')
-                    im = {desc: {'intent': it, 'anchor': s['anchor']}} if desc else None
-                    new_n, _ = learn_page_anchors(current_url, [s], intent_map=im)
-                    if new_n and current_url not in [p.split(' ')[0] for p in learned_pages]:
-                        learned_pages.append('%s (+%d)' % (current_url, new_n))
-        print('=' * 60)
-        print('快速测试结果')
-        print('=' * 60)
-        print('总计 %d · 通过 %d · 失败 %d' % (total, passed, len(failed_ids)))
-        if failed_ids:
-            print('失败: %s' % ', '.join(failed_ids))
-        if login_passed:
-            print('✓ 登录用例通过 → 已标记 %s/%s 为已登录' % (args.env, args.platform))
-            print('  后续测新功能: 直接 goto 目标页, 不用重复登录(验证码慢)。')
-        if learned_pages:
-            print('🧠 自动沉淀锚点: %s' % ', '.join(learned_pages))
-            print('  下次测同页 recall 命中 → 跳过 LLM → 秒级。')
-        print('=' * 60)
-        return 0 if not failed_ids else 1
-
-    # 3. 解析环境
-    base, src = _resolve_env_platform(args)
-    if base is None:
-        return 1
-    args._base = base  # _inject_and_check_data 用
-
-    # 4. 注入数据 + 校验
-    cases, ok = _inject_and_check_data(cases, args)
-    if not ok:
-        return 1
-
-    # 5. 打印执行计划 (登录态提示)
-    logged, login_time = is_logged_in(args.env, args.platform)
-    title = args.desc or ('快速测试 (%d 条)' % len(cases))
-    record_hint = ('python .qoder/scripts/autotest.py quick '
-                   '--env %s --record \'{"%s":"pass"}\''
-                   % (args.env, cases[0].get('case_id', 'Q-1')))
-    if logged:
-        print('=' * 60)
-        print('💡 已登录 %s/%s (%s) — QoderWork 会话保持中' % (args.env, args.platform, login_time))
-        print('   浏览器 cookie 有效, 直接 goto 目标页即可, 不用重复登录!')
-        print('   (若已过期/被踢, 先 login-state clear 再重新登录)')
-        print('=' * 60)
-    _print_execution_plan(cases, base, src, args.env, args.platform, title, record_hint)
-    return 0
-
-
-def cmd_run(args):
-    task_dir = resolve_task_dir(args.task)
-    if not task_dir.is_dir():
-        print('任务不存在: %s' % args.task)
-        return 1
-    task = load_task_json(task_dir) or {}
-
-    # 1. 域名解析 (--url > --env > config > 报错)
-    base, src = resolve_base_url(args.env, args.platform, override=args.url)
-    if base is None:
-        print('✗ %s 环境未配 base_url, 无法执行测试。' % args.env)
-        print('  解决方式 (任选其一):')
-        print('    1. 命令行临时指定: --url https://你的地址')
-        print('    2. 配 config.yaml: autotest.environments.%s.%s.base_url'
-              % (args.env, args.platform))
-        return 1
-
-    # 2. 取用例 (无则自动生成骨架)
-    cases = read_cases(task_dir)
-    if not cases:
-        print('未找到用例, 自动生成骨架...')
-        cases = generate_skeleton(task_dir, args.env, args.platform)
-        cases = read_cases(task_dir)
-
-    # 3. 指定 case_id 过滤
-    if args.case:
-        want = set(args.case)
-        cases = [c for c in cases if c.get('case_id') in want]
-        if not cases:
-            print('未匹配到指定 case_id: %s' % ', '.join(args.case))
-            print('  已有用例: %s'
-                  % ', '.join(c.get('case_id', '?')
-                              for c in read_cases(task_dir)))
-            return 1
-
-    # 4. 占位符注入: 先 base_url, 再测试数据
-    cases = _inject_base_url(cases, base)
-    # 测试数据 = 个人文档(members/{dev}/autotest-data.yaml, gitignored 不共享)
-    #           + 命令行 --data(覆盖)。按 env/platform 取最精确的值。
-    # ⚠️ 绝不从 config.yaml 读测试账号 —— config 是团队共用会 push, 放账号=泄漏。
-    local_data = load_local_test_data(env=args.env, platform=args.platform)
-    try:
-        cli_data = json.loads(args.data) if args.data else {}
-    except json.JSONDecodeError as e:
-        print('✗ --data 不是合法 JSON: %s' % e)
-        print('  示例: --data \'{"登录账号":"test","登录密码":"123456"}\'')
-        return 1
-    merged_data = dict(local_data)
-    merged_data.update(cli_data)  # 命令行覆盖个人预置
-    cases, missing = inject_data(cases, merged_data)
-
-    # 测试数据完整性检查: 有未注入的 {{ask:...}} → 列清单让 AI 问用户
-    if missing:
-        print('=' * 60)
-        print('⚠️ 需要测试数据才能执行 (%d 项)' % len(missing))
-        print('=' * 60)
-        print('以下用例引用了真实测试数据(账号/密码/手机号等), 不能编造:')
-        for i, desc in enumerate(missing, 1):
-            print('  %d. %s' % (i, desc))
-        print('-' * 60)
-        print('请向用户收集后, 用 --data 传入:')
-        print('  --data \'{"%s":"<值>", "%s":"<值>"}\''
-              % (missing[0], missing[1] if len(missing) > 1 else missing[0]))
-        print()
-        print('常用账号预置到个人文档(不进 git, 团队看不到):')
-        print('  先生成: python .qoder/scripts/autotest.py init-data')
-        print('  再填:   python .qoder/scripts/autotest.py set-data 登录账号 test')
-        return 1
-
-    # 5. 校验
-    ok, warns = validate_cases(cases)
-    has_skeleton = any('待补充' in (c.get('title', '') + c.get('expected', ''))
-                       for c in cases)
-
-    # 6. 如果调用方已传入执行结果 (--record), 落历史并汇总
-    if args.record:
-        return _record_and_report(task_dir, args, base, src, args.record)
-
-    # 7. 探测 QoderWork, 输出执行指令 (核心: 增强层)
-    is_qw, qw_hint = _detect_qoderwork()
-
-    cases_path = _cases_path(task_dir)
-    print('=' * 60)
-    print('浏览器自动化测试 · 执行编排')
-    print('=' * 60)
-    print('任务: %s' % task.get('title', Path(task_dir).name))
-    print('环境: %s   平台: %s' % (args.env, args.platform))
-    print('目标: %s   (来源: %s)' % (base, src))
-    print('用例: %d 条  → %s' % (len(cases), cases_path))
-    if has_skeleton:
-        print('⚠️ 含骨架占位用例 (标题/预期标"待补充"), 建议先补全再执行。')
-    if warns:
-        print('校验提醒:')
-        for w in warns[:10]:
-            print('  - ' + w)
-    print('-' * 60)
-
-    if is_qw:
-        print()
-        print('🧩 QoderWork 浏览器执行 (已检测到: %s)' % qw_hint)
-        print('请用 Browser Use / Computer 控制连接器, 按下列要求执行:')
-        print()
-        print('1. 打开浏览器, 访问: %s' % base)
-        print('2. 逐条执行 %s 中的用例 (共 %d 条):' % (CASES_FILENAME, len(cases)))
-        for c in cases:
-            print('   ▸ %s  %s' % (c.get('case_id', '?'), c.get('title', '')))
-            for s in (c.get('steps') or [])[:6]:
-                print('       %s' % _fmt_step(s))
-            print('       预期: %s' % c.get('expected', ''))
-        print()
-        print('3. 每条用例记录 pass/fail, 全部跑完后回传结果:')
-        print('   python .qoder/scripts/autotest.py run %s \\'
-              % Path(task_dir).name)
-        print('       --env %s --record \'{"AT-...-001":"pass",'
-              '"AT-...-002":"fail"}\'' % args.env)
-        print('   (或直接把结果贴给我, 我帮你落历史 + 出报告)')
-    else:
-        print()
-        print('[非 QoderWork 或未授权浏览器连接器 → 降级为人工核对]')
-        print('用例已生成, 请人工按下方清单逐项检查 (或复制到 QoderWork 执行):')
-        print()
-        print('目标地址: %s' % base)
-        print()
-        for c in cases:
-            print('□ %s  %s' % (c.get('case_id', '?'), c.get('title', '')))
-            for s in (c.get('steps') or [])[:4]:
-                print('    %s' % _fmt_step(s))
-            print('    预期: %s' % c.get('expected', ''))
-            print()
-        print('在 QoderWork 桌面端 (Settings → Connectors 授权浏览器/Computer) ')
-        print('可让 Agent 自动执行; 结果用 --record 回传出报告。')
-    print('-' * 60)
-    return 0
-
-
-def _record_and_report(task_dir, args, base, src, record_json):
-    """把执行结果落历史 jsonl 并打印汇总。"""
-    try:
-        results = json.loads(record_json)
-    except json.JSONDecodeError as e:
-        print('✗ --record 不是合法 JSON: %s' % e)
-        return 1
-    if not isinstance(results, dict):
-        print('✗ --record 需为 {case_id: "pass"|"fail"} 形式')
-        return 1
-
-    total = len(results)
-    passed = sum(1 for v in results.values()
-                 if str(v).lower() in ('pass', 'passed', 'ok', 'true', '1'))
-    failed_ids = [k for k, v in results.items()
-                  if str(v).lower() not in ('pass', 'passed', 'ok', 'true', '1')]
-    status = 'pass' if (total > 0 and not failed_ids) else (
-        'fail' if failed_ids else 'none')
-
-    task = load_task_json(task_dir) or {}
-    record = {
-        'time': datetime.now().isoformat(),
-        'task': Path(task_dir).name,
-        'task_title': task.get('title', ''),
-        'env': args.env,
-        'platform': args.platform,
-        'base_url': base,
-        'url_source': src,
-        'total': total,
-        'passed': passed,
-        'failed': len(failed_ids),
-        'status': status,
-        'failed_cases': failed_ids,
-        'runner': 'qoderwork-browser',
-    }
-
-    try:
-        from common.atomicio import atomic_append_jsonl
-        os.makedirs(os.path.dirname(HISTORY_PATH), exist_ok=True)
-        atomic_append_jsonl(HISTORY_PATH, record, timeout=10)
-    except Exception as e:
-        print('⚠ 历史记录写入失败 (不影响本次结果): %s' % e, file=sys.stderr)
-
-    print('=' * 60)
-    print('测试结果汇总')
-    print('=' * 60)
-    print('任务: %s' % record['task_title'])
-    print('环境: %s  目标: %s' % (args.env, base))
-    print('总计 %d 条 · 通过 %d · 失败 %d · 状态: %s'
-          % (total, passed, len(failed_ids), status.upper()))
-    if failed_ids:
-        print('失败用例:')
-        for cid in failed_ids:
-            print('  ✗ %s' % cid)
-    print('-' * 60)
-    print('已记录到 %s' % HISTORY_PATH)
-    if status == 'fail':
-        print('建议: 查失败用例, 修复后重跑 /wl-test run %s --env %s'
-              % (Path(task_dir).name, args.env))
-        return 1
-    print('全部通过! 可 /wl-commit 提交, 或 /wl-report 出报告。')
-    return 0
-
-
-# ---------------------------------------------------------------------------
-# 子命令: list
-# ---------------------------------------------------------------------------
-
-def cmd_list(args):
-    task_dir = resolve_task_dir(args.task)
-    if not task_dir.is_dir():
-        print('任务不存在: %s' % args.task)
-        return 1
-    cases = read_cases(task_dir)
-    if not cases:
-        print('任务 %s 暂无用例。' % Path(task_dir).name)
-        print('生成: python .qoder/scripts/autotest.py generate %s'
-              % Path(task_dir).name)
-        return 0
-    task = load_task_json(task_dir) or {}
-    print('任务: %s' % task.get('title', Path(task_dir).name))
-    print('用例文件: %s' % _cases_path(task_dir))
-    print()
-    print('%-18s %-8s %-6s %s' % ('CASE_ID', 'ENV', 'PLAT', '标题'))
-    print('-' * 60)
-    for c in cases:
-        print('%-18s %-8s %-6s %s' % (
-            c.get('case_id', '?'),
-            c.get('env', '?'),
-            c.get('platform', '?'),
-            c.get('title', '')))
-    print('-' * 60)
-    print('共 %d 条' % len(cases))
-    return 0
-
-
-# ---------------------------------------------------------------------------
-# 子命令: set-data / list-data (个人测试数据, 本地 gitignored)
-# ---------------------------------------------------------------------------
-
-def cmd_set_data(args):
-    """预置一条个人测试数据到本地文档(不进 git)。"""
-    env = getattr(args, 'env', None)
-    platform = getattr(args, 'platform', None)
-    save_local_test_data(args.key, args.value, env=env, platform=platform)
-    loc = ('%s.%s' % (env, platform)) if (env and platform) else (
-        env or platform or '通用(顶层)')
-    print('已保存到个人文档: %s' % local_data_path())
-    print('  %s = %s   [位置: %s]' % (args.key, args.value, loc))
-    print()
-    print('🔒 此文档已被 .gitignore 覆盖 (workspace/members/*/autotest-data.yaml),')
-    print('   team_sync 不会 push, 团队/npm 包都看不到。')
-    print('   run 时自动注入用例的 {{ask:%s}} 占位。' % args.key)
-    if any(s in args.key for s in ('密码', '密', 'secret', 'token', '码')):
-        print('   (敏感数据, 存个人文档比每次对话明文输入更安全)')
-    return 0
-
-
-def cmd_list_data(args):
-    """列出本地已预置的测试数据(可按 env/platform 过滤)。"""
-    env = getattr(args, 'env', None)
-    platform = getattr(args, 'platform', None)
-    p = local_data_path()
-    if not p.is_file():
-        print('个人测试数据文档不存在: %s' % p)
-        print()
-        print('生成模板: python .qoder/scripts/autotest.py init-data')
-        print('或直接预置: python .qoder/scripts/autotest.py set-data 登录账号 test')
-        return 0
-    data = load_local_test_data(env=env, platform=platform)
-    if not data:
-        scope = ('%s/%s' % (env, platform)) if (env and platform) else (
-            env or platform or '全部')
-        print('文档 %s 在 %s 范围内无数据。' % (p, scope))
-        return 0
-    print('个人测试数据 (%d 项)' % len(data))
-    print('文档: %s' % p)
-    print('-' * 50)
-    for k, v in data.items():
-        show = v
-        if any(s in k for s in ('密码', '密', 'secret', 'token')):
-            show = '*' * min(len(str(v)), 8) if str(v) else '(空)'
-        print('  %-16s = %s' % (k, show))
-    print('-' * 50)
-    print('🔒 个人文档, 已 gitignore, 不会 push/共享。run 时自动注入 {{ask:描述}}。')
-    return 0
-
-
-def cmd_init_data(args):
-    """生成带注释的个人测试数据模板文档(若不存在)。"""
-    path, created = init_local_data_doc()
-    if created:
-        print('已生成模板: %s' % path)
-        print()
-        print('打开它, 填入你的测试账号密码(例子已给)。每人只填自己的 members/{自己}/。')
-        print('🔒 已 gitignore, 不会 push/共享给团队。')
-    else:
-        print('文档已存在(不覆盖): %s' % path)
-        print('直接编辑它, 或用 set-data 命令追加。')
-    return 0
-
-
-# ---------------------------------------------------------------------------
-# 子命令: login-state (登录态: 已登录就别重复登录, 尤其验证码慢)
-# ---------------------------------------------------------------------------
-
-def cmd_login_state(args):
-    """查看/标记/清除 登录态。
-
-    QoderWork 保持同一个浏览器会话 → 登录一次后 cookie 不丢。
-    后续测新功能直接 goto 目标页, 不用重复登录(数学题验证码很慢)。
-    """
-    action = args.action  # show / mark / clear
-    env = getattr(args, 'env', None) or _default_env()
-    platform = getattr(args, 'platform', None) or 'web'
-
-    if action == 'mark':
-        base, src = resolve_base_url(env, platform)
-        if not base:
-            print('✗ %s/%s 未配域名, 无法标记登录。' % (env, platform))
-            return 1
-        mark_logged_in(env, platform, base)
-        print('已标记 %s/%s 为已登录 (浏览器会话保持中, cookie 有效)。' % (env, platform))
-        print('🔒 存个人文档 (gitignored), 不会 push。')
-        print()
-        print('后续 quick/browser 测新功能: 直接 goto 目标页, 不用再登录。')
-        return 0
-
-    if action == 'clear':
-        clear_login_state(env if env and env != 'all' else None,
-                          platform if env != 'all' else None)
-        print('已清除登录态: %s/%s。' % (env, platform))
-        print('下次测试会重新走登录流程。')
-        return 0
-
-    # show (默认)
-    state = load_login_state()
-    if not state:
-        print('未记录任何登录态。')
-        print('登录用例通过后自动标记, 或手动: login-state mark --env %s --platform %s'
-              % (env, platform))
-        return 0
-    print('已记录登录态 (QoderWork 会话保持中, 后续测新功能可直接 goto 目标页):')
-    print('-' * 50)
-    for e, plats in state.items():
-        for pf, info in (plats or {}).items():
-            t = (info or {}).get('time', '?')[:19].replace('T', ' ')
-            url = (info or {}).get('url', '')
-            print('  %s/%s  已登录  (%s)  %s' % (e, pf, t, url))
-    print('-' * 50)
-    print('🔒 个人文档, gitignored, 不 push。清除: login-state clear --env <环境>')
-    return 0
-
-
-# ---------------------------------------------------------------------------
-# 子命令: learn / recall (页面锚点沉淀 + 查询, A方案核心)
-# ---------------------------------------------------------------------------
-
-def cmd_learn(args):
-    """把 read_page 返回的页面元素沉淀成稳定锚点 → data/index/test-pages.json。
-
-    AI 执行 observe(read_page) 后, 把元素 JSON 回传, 本命令提取稳定锚点存盘。
-    下次 recall 同页直接命中锚点, 跳过 LLM 匹配(Stagehand 式 action 缓存)。
-    """
-    url_pattern = _normalize_url_pattern(args.url, getattr(args, '_base', None))
-    # 解析 page-json (read_page 返回的元素数组, 或 {elements:[...]})
-    try:
-        parsed = json.loads(args.page_json)
-    except json.JSONDecodeError as e:
-        print('✗ --page-json 不是合法 JSON: %s' % e)
-        return 1
-    if isinstance(parsed, dict):
-        elements = parsed.get('elements') or parsed.get('elements') or []
-    elif isinstance(parsed, list):
-        elements = parsed
-    else:
-        print('✗ --page-json 应为元素数组或含 elements 的对象')
-        return 1
-    # 可选 intent-map
-    intent_map = None
-    if args.intent_map:
-        try:
-            intent_map = json.loads(args.intent_map)
-        except json.JSONDecodeError as e:
-            print('⚠ --intent-map 不是合法 JSON, 忽略: %s' % e)
-    new_n, total_n = learn_page_anchors(url_pattern, elements, intent_map=intent_map)
-    print('=' * 56)
-    print('锚点沉淀 → data/index/test-pages.json')
-    print('=' * 56)
-    print('页面: %s' % url_pattern)
-    print('本次新增 %d 个锚点, 该页累计 %d 个' % (new_n, total_n))
-    print('🔒 团队共享(随 team_sync 分发), 只存 role/name/placeholder, 不含密码/ref。')
-    print()
-    print('下次 recall %s 即可直接用锚点生成用例, 跳过 LLM 匹配。' % url_pattern)
-    return 0
-
-
-def cmd_recall(args):
-    """查某页已沉淀的锚点。AI 生成用例前查它, 有锚点就直接填进 step。"""
-    url_pattern = _normalize_url_pattern(args.url)
-    anchors = recall_page_anchors(url_pattern)
-    print('=' * 56)
-    print('已沉淀锚点: %s' % url_pattern)
-    print('=' * 56)
-    if not anchors:
-        print('该页暂无锚点。执行 observe(read_page) 后用 learn 沉淀:')
-        print('  python .qoder/scripts/autotest.py learn --url %s --page-json \'<read_page结果>\'' % url_pattern)
-        return 0
-    print('%-10s %-22s %s' % ('INTENT', 'ANCHOR', '描述'))
-    print('-' * 56)
-    for a in anchors:
-        print('%-10s %-22s %s' % (
-            a.get('intent', '?'),
-            _fmt_anchor(a.get('anchor')),
-            a.get('desc', '')[:30]))
-    print('-' * 56)
-    print('共 %d 个锚点。生成用例时可直接填入 step.anchor, 跳过 LLM 匹配。' % len(anchors))
-    return 0
-
-
-# ---------------------------------------------------------------------------
-# 子命令: page (页面按钮+接口画像, 开发→测试交接物)
-# ---------------------------------------------------------------------------
-
-def cmd_page(args):
-    """查页面按钮+接口画像。薄入口, 实际逻辑在 page_probe.py。
-    数据来自知识图谱 traces 表, 无图谱则静默提示。
-    """
-    try:
-        import page_probe
-    except ImportError:
-        # 直接当脚本跑时, 补一下 sys.path
-        sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-        import page_probe
-
-    profile = page_probe.build_page_profile(keyword=getattr(args, 'kw', None),
-                                            url=getattr(args, 'url', None))
-    label = args.kw or args.url
-    print('## 页面画像: %s' % label)
-    print()
-    print(page_probe.render_profile_md(profile))
-    if profile.get('ok'):
-        n_pages = len(profile['pages'])
-        n_btns = sum(len(pg['buttons']) for pg in profile['pages'])
-        print()
-        print('[page] %d 个页面, %d 个交互点' % (n_pages, n_btns))
-    return 0
-
-
-# ---------------------------------------------------------------------------
-# 子命令: report
-# ---------------------------------------------------------------------------
-
-def cmd_report(args):
-    task_dir = resolve_task_dir(args.task)
-    task_name = Path(task_dir).name
-    task = load_task_json(task_dir) or {}
-
-    if not os.path.isfile(HISTORY_PATH):
-        print('暂无测试执行历史 (%s)' % HISTORY_PATH)
-        print('先跑: python .qoder/scripts/autotest.py run %s --env test'
-              % task_name)
-        return 0
-
-    # 读该任务的全部历史 (倒序)
-    records = []
-    with open(HISTORY_PATH, encoding='utf-8') as f:
-        for line in f:
-            line = line.strip()
-            if not line:
-                continue
-            try:
-                r = json.loads(line)
-            except json.JSONDecodeError:
-                continue
-            if r.get('task') == task_name:
-                records.append(r)
-    if not records:
-        print('任务 %s 无执行记录。' % task_name)
-        return 0
-
-    records.sort(key=lambda r: r.get('time', ''), reverse=True)
-    print('=' * 60)
-    print('测试历史 · %s' % task.get('title', task_name))
-    print('=' * 60)
-    print('%-20s %-6s %-7s %-5s %s' % (
-        '时间', 'ENV', '状态', 'P/F', '目标'))
-    print('-' * 60)
-    for r in records[:20]:
-        t = r.get('time', '')[:19].replace('T', ' ')
-        print('%-20s %-6s %-7s %d/%d %s' % (
-            t,
-            r.get('env', '?'),
-            r.get('status', '?').upper(),
-            r.get('passed', 0),
-            r.get('total', 0),
-            r.get('base_url', '')))
-    print('-' * 60)
-    total_runs = len(records)
-    pass_runs = sum(1 for r in records if r.get('status') == 'pass')
-    print('历史 %d 次执行 · 通过率 %.0f%% (最近 %d 次)'
-          % (total_runs, 100 * pass_runs / total_runs if total_runs else 0,
-             min(total_runs, 20)))
-    last = records[0]
-    if last.get('failed_cases'):
-        print('最近一次失败用例: %s' % ', '.join(last['failed_cases']))
-    return 0
-
-
-# ---------------------------------------------------------------------------
-# argparse
-# ---------------------------------------------------------------------------
-
-def build_parser():
-    p = argparse.ArgumentParser(
-        prog='autotest.py',
-        description='浏览器自动化测试: 用例生成 + 运行编排 (QoderWork 浏览器执行, 纯 Qoder 降级人工)',
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-    )
-    sub = p.add_subparsers(dest='cmd')
-
-    def add_env_platform(sp):
-        sp.add_argument('--env', default=_default_env(),
-                        choices=SUPPORTED_ENVS,
-                        help='环境 (test/pre/prod), 默认 %(default)s')
-        sp.add_argument('--platform', default='web',
-                        choices=SUPPORTED_PLATFORMS,
-                        help='平台 (web=管理端 / app=移动端), 默认 %(default)s')
-
-    pg = sub.add_parser('generate', help='从任务生成测试用例骨架')
-    pg.add_argument('task', help='任务名/路径 (如 06-14-login)')
-    add_env_platform(pg)
-    pg.set_defaults(func=cmd_generate)
-
-    pr = sub.add_parser('run', help='生成(若无)+输出浏览器执行指令/人工清单')
-    pr.add_argument('task', help='任务名/路径')
-    add_env_platform(pr)
-    pr.add_argument('--url', default=None,
-                    help='临时覆盖目标域名 (优先于 --env 配置)')
-    pr.add_argument('--case', nargs='*', default=None,
-                    help='只执行指定 case_id (可多个)')
-    pr.add_argument('--data', default=None,
-                    help='测试数据 JSON, 注入 {{ask:描述}} 占位, '
-                         '如 \'{"登录账号":"test","登录密码":"123456"}\'')
-    pr.add_argument('--record', default=None,
-                    help='回传执行结果 JSON, 如 \'{"AT-x-001":"pass"}\'')
-    pr.set_defaults(func=cmd_run)
-
-    pq = sub.add_parser('quick', help='快速测试: 不需任务/PRD, AI 直接据描述生成并执行')
-    pq.add_argument('--cases', default=None,
-                    help='JSON 用例 (单条对象或数组), AI 据用户描述生成后传入')
-    pq.add_argument('--cases-file', dest='cases_file', default=None,
-                    help='用例 JSON 文件路径(推荐, 不截断)。AI 写文件后传路径')
-    pq.add_argument('--desc', default=None,
-                    help='本次快速测试的描述/标题 (可选)')
-    add_env_platform(pq)
-    pq.add_argument('--url', default=None, help='临时覆盖目标域名')
-    pq.add_argument('--data', default=None, help='测试数据 JSON, 注入 {{ask:描述}}')
-    pq.add_argument('--record', default=None, help='回传执行结果 JSON')
-    pq.add_argument('--page-json', nargs='*', default=None,
-                    help='read_page 返回的页面元素 JSON(多个), --record 时自动沉淀锚点')
-    pq.set_defaults(func=cmd_quick)
-
-    pl = sub.add_parser('list', help='列出任务已有用例')
-    pl.add_argument('task', help='任务名/路径')
-    pl.set_defaults(func=cmd_list)
-
-    pr2 = sub.add_parser('report', help='查看任务测试执行历史')
-    pr2.add_argument('task', help='任务名/路径')
-    pr2.set_defaults(func=cmd_report)
-
-    psd = sub.add_parser('set-data', help='预置个人测试数据到个人文档(gitignored, 不共享)')
-    psd.add_argument('key', help='数据名(对应用例 {{ask:数据名}} 占位), 如 登录账号')
-    psd.add_argument('value', help='数据值, 如 test')
-    psd.add_argument('--env', default=None, choices=SUPPORTED_ENVS,
-                     help='只对该环境生效(如 test/pre/prod)')
-    psd.add_argument('--platform', default=None, choices=SUPPORTED_PLATFORMS,
-                     help='只对该平台生效(web/app)')
-    psd.set_defaults(func=cmd_set_data)
-
-    pld = sub.add_parser('list-data', help='列出个人已预置的测试数据(可按 env/platform 过滤)')
-    pld.add_argument('--env', default=None, choices=SUPPORTED_ENVS)
-    pld.add_argument('--platform', default=None, choices=SUPPORTED_PLATFORMS)
-    pld.set_defaults(func=cmd_list_data)
-
-    pid = sub.add_parser('init-data', help='生成个人测试数据模板文档(members/{dev}/autotest-data.yaml)')
-    pid.set_defaults(func=cmd_init_data)
-
-    pls = sub.add_parser('login-state', help='登录态: 已登录就别重复登录(QoderWork 会话保持)')
-    pls.add_argument('action', nargs='?', default='show',
-                     choices=['show', 'mark', 'clear'],
-                     help='show=查看 / mark=标记已登录 / clear=清除(强制重新登录)')
-    add_env_platform(pls)
-    pls.set_defaults(func=cmd_login_state)
-
-    ple = sub.add_parser('learn', help='沉淀页面锚点到 test-pages.json(observe后调, 团队共享)')
-    ple.add_argument('--url', required=True, help='页面 URL 或路径(如 /auth/login 或完整URL)')
-    ple.add_argument('--page-json', required=True,
-                     help="read_page 返回的元素 JSON (数组 或 {elements:[...]})")
-    ple.add_argument('--intent-map', default=None,
-                     help='可选: {元素描述:{intent,anchor}} 标注意图')
-    ple.set_defaults(func=cmd_learn)
-
-    prc = sub.add_parser('recall', help='查某页已沉淀的锚点(生成用例前查, 跳过LLM匹配)')
-    prc.add_argument('--url', required=True, help='页面 URL 或路径(如 /auth/login)')
-    prc.set_defaults(func=cmd_recall)
-
-    # page: 查页面按钮+接口画像 (开发→测试交接物, 数据来自知识图谱 traces 表)
-    ppg = sub.add_parser('page', help='查页面按钮+接口画像(开发交接给测试,照着写用例)')
-    ppg_grp = ppg.add_mutually_exclusive_group(required=True)
-    ppg_grp.add_argument('--kw', help='业务关键词(如 保险 / 排班)')
-    ppg_grp.add_argument('--url', help='页面 URL 或路径关键词(如 /veh/insurance)')
-    ppg.set_defaults(func=cmd_page)
-
-    return p
-
-
-def _default_env():
-    """config.yaml autotest.default_env, 缺失回退 test。"""
-    try:
-        return load_config_section('autotest').get('default_env') or 'test'
-    except Exception:
-        return 'test'
-
-
-def main(argv=None):
-    parser = build_parser()
-    args = parser.parse_args(argv)
-    if not getattr(args, 'cmd', None):
-        parser.print_help()
-        return 1
-    try:
-        return args.func(args)
-    except RuntimeError as e:
-        # 身份缺失等 (多人共用 workspace 时的隔离保障)
-        print('✗ %s' % e)
-        return 1
-    except (ValueError, FileNotFoundError) as e:
-        print('✗ %s' % e)
-        return 1
-
-
-if __name__ == '__main__':
-    sys.exit(main())
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
+"""
+QODER Pipeline - 浏览器自动化测试 (用例生成 + 运行编排)
+
+设计原则 (遵循规则 8: QoderWork 只做可选增强, 绝不强依赖):
+    - 本脚本是"用例生成器 + 运行编排器", 不内嵌任何浏览器驱动库
+      (不 import playwright/selenium —— PM 本机装不动)。
+    - 真正"开浏览器点击"由 QoderWork 的 Browser Use / Computer 控制连接器
+      在运行时承担 (Agent 读 run 指令后调用连接器)。
+    - 纯 Qoder IDE / CLI 无连接器 → 静默降级为"人工核对清单", 不报错不阻塞。
+    - 本地 (workspace/tasks/<task>/autotest-cases.jsonl) 是唯一事实源。
+
+用例格式 (autotest-cases.jsonl, 每行一条) —— 统一用意图式(intent+anchor), 禁止 CSS selector:
+
+    intent 取值: goto / observe / click / fill / extract / assert / ask_human
+    anchor 取值: {role, name, placeholder, text} 稳定锚点(来自 a11y 树, 不随刷新变)
+    无锚点时 anchor 留空或省略, 执行时靠 snapshot 语义匹配(LLM 兜底)。
+
+    {
+      "case_id": "AT-login-001",
+      "title": "正确账号密码登录成功",
+      "platform": "web", "env": "test",
+      "preconditions": "已注册账号 test/123456",
+      "steps": [
+        {"intent":"goto","desc":"登录页","value":"{{base_url}}/auth/login"},
+        {"intent":"fill","desc":"账号输入框","value":"{{ask:登录账号}}","anchor":{"role":"textbox","name":"尊敬的管理员"}},
+        {"intent":"fill","desc":"密码输入框","value":"{{ask:登录密码}}","anchor":{"role":"textbox","name":"请输入您的密码"}},
+        {"intent":"click","desc":"登录按钮","anchor":{"role":"button","name":"登录"}},
+        {"intent":"extract","desc":"是否已离开登录页进入系统"}
+      ],
+      "expected": "登录成功进入首页"
+    }
+
+    ⚠️ URL 必须写成 {{base_url}}/auth/login (带斜杠)。base_url 已去尾斜杠。
+    ⚠️ 首次跑无锚点时, AI 应先 navigate+snapshot 拿到真实 anchor 再填, 禁止预猜 CSS selector。
+    ⚠️ 账号/密码等真实数据用 {{ask:描述}} 占位, 绝不编造; 执行时从个人文档注入。
+
+占位符 (run 时注入):
+    {{base_url}}  — 按环境(test/pre/prod)解析的目标域名(已去尾斜杠)
+    {{ask:描述}}  — 需要用户提供的测试数据(账号/密码/手机号等)。
+                    生成用例时: 凡是需要真实测试数据的, 用 {{ask:描述}} 占位, 绝不编造。
+                    执行时: 用 --data '{"登录账号":"test","登录密码":"123456"}' 传入;
+                    未提供的会列清单提示补齐后再执行。
+                    敏感数据(密码/验证码)建议走 --data 命令传, 避免明文进对话记录。
+
+    ⚠️ recall 查锚点时, --url 用相对路径(如 auth/login)避开 Git-bash 路径转换坑
+       (Windows 上 /auth/login 会被 MSYS 转成 /D:/.../Git/auth/login)。
+
+域名解析优先级: --url > --env(查 config.yaml) > 报错
+
+Usage:
+    python autotest.py generate <task> [--env test|pre|prod] [--platform web|app]
+    python autotest.py run <task>     [--env ...] [--url <url>] [--platform ...]
+                                      [--case <case_id> ...] [--data '<json>']
+                                      [--record <result>]
+    python autotest.py quick --cases '<JSON用例>' [--desc '<描述>'] [--env ...]
+                              [--url <url>] [--platform ...] [--data '<json>']
+                              [--record <result>]   # 快速测试, 不需任务/PRD
+    python autotest.py list <task>
+    python autotest.py report <task>
+
+Exit: 0 = 成功, 1 = 一般错误(含缺测试数据)
+"""
+
+import argparse
+import json
+import os
+import sys
+from datetime import datetime
+from pathlib import Path
+
+if sys.platform == 'win32':
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except (AttributeError, IOError):
+        pass
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from common.paths import get_repo_root, get_tasks_dir, get_developer, MEMBERS_DIR, index_path  # noqa: E402
+from common.task_utils import load_task_json, resolve_task_dir  # noqa: E402
+
+# ---------------------------------------------------------------------------
+
+# v3.0 f5: 数据层拆到 autotest_data.py
+from autotest_data import *  # noqa: F401,F403 (常量+数据函数)
+
+def _resolve_env_platform(args):
+    """解析域名 + 校验。返回 (base, src) 或 (None, None)。"""
+    base, src = resolve_base_url(args.env, args.platform, override=getattr(args, 'url', None))
+    if base is None:
+        print('✗ %s 环境未配 base_url, 无法执行测试。' % args.env)
+        print('  解决方式 (任选其一):')
+        print('    1. 命令行临时指定: --url https://你的地址')
+        print('    2. 配 config.yaml: autotest.environments.%s.%s.base_url'
+              % (args.env, args.platform))
+        return None, None
+    return base, src
+
+
+def _inject_and_check_data(cases, args):
+    """注入 base_url + 测试数据, 检查完整性。返回 (cases, ok)。ok=False 表示缺数据已提示。"""
+    cases = _inject_base_url(cases, getattr(args, '_base', ''))
+    local_data = load_local_test_data(env=args.env, platform=args.platform)
+    try:
+        cli_data = json.loads(args.data) if getattr(args, 'data', None) else {}
+    except json.JSONDecodeError as e:
+        print('✗ --data 不是合法 JSON: %s' % e)
+        print('  示例: --data \'{"登录账号":"test","登录密码":"123456"}\'')
+        return cases, False
+    merged = dict(local_data)
+    merged.update(cli_data)
+    cases, missing = inject_data(cases, merged)
+    if missing:
+        print('=' * 60)
+        print('⚠️ 需要测试数据才能执行 (%d 项)' % len(missing))
+        print('=' * 60)
+        print('以下用例引用了真实测试数据(账号/密码/手机号等), 不能编造:')
+        for i, desc in enumerate(missing, 1):
+            print('  %d. %s' % (i, desc))
+        print('-' * 60)
+        print('请向用户收集后, 用 --data 传入:')
+        print('  --data \'{"%s":"<值>", "%s":"<值>"}\''
+              % (missing[0], missing[1] if len(missing) > 1 else missing[0]))
+        print()
+        print('常用账号预置到个人文档(不进 git, 团队看不到):')
+        print('  python .qoder/scripts/autotest.py set-data 登录账号 test --env test')
+        return cases, False
+    return cases, True
+
+
+def _fmt_anchor(anc):
+    """格式化 anchor 为简短可读串, 如 "button '登录'" 或 "placeholder='尊敬的管理员'"。"""
+    if not isinstance(anc, dict) or not anc:
+        return ''
+    parts = []
+    for k in ('role', 'name', 'placeholder', 'text'):
+        v = anc.get(k)
+        if v:
+            parts.append("%s='%s'" % (k, v))
+    return ' '.join(parts)
+
+
+def _fmt_step(s, with_value=True):
+    """格式化单步为可读文本。支持新意图式(intent+anchor)和旧命令式(action+target)。"""
+    desc = s.get('desc', '')
+    # ── 新意图式 ──
+    if is_intent_step(s):
+        it = s.get('intent', '?')
+        anc = s.get('anchor')
+        val = s.get('value')
+        anchor_str = _fmt_anchor(anc)
+        if it == 'ask_human':
+            return '%-12s ⏸ %s' % ('人机协同', desc or '(请用户操作)')
+        if it == 'extract':
+            return '%-12s ✓ %s' % ('extract', desc or '(语义断言)')
+        if it == 'observe':
+            return '%-12s 👁 %s' % ('observe', desc or '读取页面可交互元素')
+        if it == 'goto':
+            return '%-12s → %s' % ('goto', val or desc or '')
+        # click / fill / assert
+        tag = '[锚点: %s]' % anchor_str if anchor_str else '(待匹配·LLM兜底)'
+        extra = ''
+        if val is not None:
+            extra = '  输入=%s' % val
+        return '%-12s %s %s%s' % (it, tag, desc, extra)
+    # ── 旧命令式(兼容) ──
+    act = s.get('action', '?')
+    tgt = s.get('target', '')
+    val = s.get('value')
+    if act == 'solve_captcha':
+        fill = s.get('fill_target', '')
+        detail = '截图 %s → 用视觉识别(算数学题) → 答案填入 %s' % (tgt, fill)
+        if desc:
+            detail += ' (%s)' % desc
+        return '%-16s %s' % (act, detail)
+    detail = tgt
+    if with_value and val is not None:
+        detail = '%s  输入=%s' % (tgt, val)
+    return '%-16s %s%s' % (act, detail, ('  — ' + desc) if desc else '')
+
+
+def _print_execution_plan(cases, base, src, env, platform, title, record_hint):
+    """打印执行编排指令 (QoderWork 浏览器执行 / 纯 Qoder 降级人工核对)。
+
+    record_hint: 回收结果时的命令提示文本 (run 用任务名, quick 用 --quick)。
+    """
+    is_qw, qw_hint = _detect_qoderwork()
+    print('=' * 60)
+    print('浏览器自动化测试 · 执行编排')
+    print('=' * 60)
+    print('测试: %s' % title)
+    print('环境: %s   平台: %s' % (env, platform))
+    print('目标: %s   (来源: %s)' % (base, src))
+    print('用例: %d 条' % len(cases))
+    print('-' * 60)
+
+    if is_qw:
+        print()
+        print('🧩 QoderWork 浏览器执行 (已检测到: %s)' % qw_hint)
+        print('请用 Browser Use / Computer 控制连接器, 按下列要求执行:')
+        print()
+        print('1. 打开浏览器, 访问: %s' % base)
+        print('2. 逐条执行用例 (共 %d 条):' % len(cases))
+        for c in cases:
+            print('   ▸ %s  %s' % (c.get('case_id', '?'), c.get('title', '')))
+            for s in (c.get('steps') or [])[:6]:
+                print('       %s' % _fmt_step(s))
+            print('       预期: %s' % c.get('expected', ''))
+        print()
+        print('3. 每条用例记录 pass/fail, 跑完回传结果:')
+        print('   %s' % record_hint)
+        print('   (或直接把结果贴给我, 我帮你出报告)')
+    else:
+        print()
+        print('[非 QoderWork 或未授权浏览器连接器 → 降级为人工核对]')
+        print('目标地址: %s' % base)
+        print()
+        for c in cases:
+            print('□ %s  %s' % (c.get('case_id', '?'), c.get('title', '')))
+            for s in (c.get('steps') or [])[:4]:
+                print('    %s' % _fmt_step(s))
+            print('    预期: %s' % c.get('expected', ''))
+            print()
+        print('在 QoderWork 桌面端 (Settings → Connectors 授权浏览器/Computer)')
+        print('可让 Agent 自动执行; 结果用 --record 回传出报告。')
+    print('-' * 60)
+
+
+# ---------------------------------------------------------------------------
+# 子命令: generate
+# ---------------------------------------------------------------------------
+
+def cmd_generate(args):
+    task_dir = resolve_task_dir(args.task)
+    if not task_dir.is_dir():
+        print('任务不存在: %s' % args.task)
+        print('提示: python .qoder/scripts/task.py list  查看已有任务')
+        return 1
+    task = load_task_json(task_dir) or {}
+
+    env = args.env
+    base, src = resolve_base_url(env, args.platform)
+    # generate 不强求域名 (用例用 {{base_url}} 占位), 但提示一下
+    if base is None:
+        print('提示: %s 环境未配 base_url, 用例将用 {{base_url}} 占位, '
+              'run 时再注入 (或在 config.yaml autotest.environments 配置)。'
+              % env)
+
+    new_cases = generate_skeleton(task_dir, env, args.platform)
+    all_cases = read_cases(task_dir)
+    ok, warns = validate_cases(all_cases)
+
+    print('已生成 %d 条用例骨架 → %s' % (len(new_cases), _cases_path(task_dir)))
+    print('任务: %s  环境: %s  平台: %s' % (
+        task.get('title', Path(task_dir).name), env, args.platform))
+    print()
+    print('⚠️ 这些是骨架占位。请按任务 PRD「验收标准」补充每条的:')
+    print('   - title: 用例标题')
+    print('   - steps: 操作步骤 (goto/click/fill/assert_visible ...)')
+    print('   - expected: 预期结果')
+    print('   (用 /wl-test 触发 AI 自动据 PRD 填充)')
+    if warns:
+        print()
+        print('校验提醒:')
+        for w in warns:
+            print('  - ' + w)
+    print()
+    print('下一步: /wl-test run %s --env %s  (生成+执行)'
+          % (Path(task_dir).name, env))
+    return 0
+
+
+# ---------------------------------------------------------------------------
+# 子命令: run
+# ---------------------------------------------------------------------------
+
+def _detect_qoderwork():
+    """探测当前是否在 QoderWork 环境 (有浏览器连接器)。
+
+    QoderWork 会暴露运行时工具/环境标记。探测而非假设: 看不到就回退。
+    返回 (is_qoderwork: bool, hint: str)
+    """
+    # 1. 显式环境变量标记 (QoderWork 桌面端/CLI 会设置)
+    for key in ('QODERWORK_SESSION', 'QODER_WORK', 'QW_CONNECTOR'):
+        if os.environ.get(key):
+            return True, 'env:' + key
+    # 2. QoderWork 配置目录存在 (~/.qoderwork/)
+    home = os.path.expanduser('~')
+    if os.path.isdir(os.path.join(home, '.qoderwork')):
+        return True, '~/.qoderwork'
+    return False, ''
+
+
+def _iter_injectable_strings(s):
+    """遍历一个 step 里所有可做占位符替换的字符串字段, yield (setter, value)。
+
+    覆盖旧格式(target/value/desc) + 新格式(intent式 value/desc/anchor.* )。
+    setter 是个闭包, 传新值回去。anchor(dict) 递归到它的每个 str 值。
+    """
+    for field in ('target', 'value', 'desc'):
+        val = s.get(field)
+        if isinstance(val, str):
+            yield (lambda v, f=field: s.__setitem__(f, v)), val
+    # anchor (新格式): dict, 每个值都可能是占位符串
+    anc = s.get('anchor')
+    if isinstance(anc, dict):
+        for k, v in list(anc.items()):
+            if isinstance(v, str):
+                yield (lambda nv, kk=k: anc.__setitem__(kk, nv)), v
+
+
+def _inject_base_url(cases, base_url):
+    """把 steps 里的 {{base_url}} 占位替换为真实域名(覆盖 anchor.*)。
+
+    base_url 已去尾斜杠(见 resolve_base_url), 所以用例里必须写成
+    {{base_url}}/auth/login (带斜杠)。若检测到 {{base_url}} 后紧跟非斜杠字符
+    (会拼成 https://xxxauth/login), 打印告警提醒——不阻断, 但提示 AI 修正。
+    """
+    import re as _re
+    bad_pat = _re.compile(r'\{\{base_url\}\}([^\s/&?#])')  # {{base_url}}后紧跟非分隔符 = 少斜杠
+    warned = False
+    for c in cases:
+        for s in c.get('steps') or []:
+            for setter, val in _iter_injectable_strings(s):
+                if isinstance(val, str) and '{{base_url}}' in val:
+                    if not warned and bad_pat.search(val):
+                        warned = True
+                    setter(val.replace('{{base_url}}', base_url))
+    if warned:
+        print('⚠️ 检测到 {{base_url}} 后缺少斜杠(如 {{base_url}}auth/login)。'
+              'base_url 已去尾斜杠, 正确写法是 {{base_url}}/auth/login。',
+              file=sys.stderr)
+        print('   本次已按原样拼接(可能产生 https://xxxauth/login 这样的坏地址), '
+              '请修正用例后重跑。', file=sys.stderr)
+    return cases
+
+
+def collect_ask_placeholders(cases):
+    """扫出全部 {{ask:描述}} 占位, 返回去重后的描述列表(保持出现顺序)。"""
+    import re as _re
+    asks = []
+    seen = set()
+    pat = _re.compile(r'\{\{ask:([^}]+)\}\}')
+    for c in cases:
+        for s in c.get('steps') or []:
+            for setter, val in _iter_injectable_strings(s):
+                if not isinstance(val, str):
+                    continue
+                for desc in pat.findall(val):
+                    if desc.strip() not in seen:
+                        seen.add(desc.strip())
+                        asks.append(desc.strip())
+    return asks
+
+
+def inject_data(cases, data):
+    """把 {{ask:描述}} 用 data 字典注入(覆盖 anchor.*)。返回 (cases, still_missing)。"""
+    import re as _re
+    pat = _re.compile(r'\{\{ask:([^}]+)\}\}')
+    provided = {k.strip(): v for k, v in (data or {}).items()}
+    still_missing = []
+    for c in cases:
+        for s in c.get('steps') or []:
+            for setter, val in _iter_injectable_strings(s):
+                if not isinstance(val, str) or '{{ask:' not in val:
+                    continue
+                for desc in pat.findall(val):
+                    key = desc.strip()
+                    if key in provided:
+                        val = val.replace('{{ask:%s}}' % desc, str(provided[key]))
+                for desc in pat.findall(val):
+                    if desc.strip() not in provided and desc.strip() not in still_missing:
+                        still_missing.append(desc.strip())
+                setter(val)
+    return cases, still_missing
+
+
+def cmd_quick(args):
+    """快速测试: 不需要任务/PRD。AI 据描述直接生成用例并执行。
+
+    用法: autotest.py quick --cases '<JSON用例>' --env test --platform web
+    (AI 把据用户描述生成的用例, 以 JSON 字符串传入; 脚本负责注入+执行编排)
+
+    也支持 --record 回收结果 (临时用例, 不落 task 历史, 只打印汇总)。
+    """
+    # 1. 解析用例: 优先 --cases-file (文件, 不截断), 其次 --cases (内联, 短用例)
+    raw = ''
+    cases_file = getattr(args, 'cases_file', None)
+    if cases_file:
+        try:
+            raw = open(cases_file, encoding='utf-8').read().strip()
+        except (OSError, IOError) as e:
+            print('✗ 读 --cases-file 失败: %s' % e)
+            return 1
+    if not raw:
+        raw = (args.cases or '').strip()
+    if not raw:
+        print('✗ quick 模式需要用例 JSON。用文件传(推荐, 不截断):')
+        print('  --cases-file <路径>   # AI 把用例 JSON 写文件, 再传路径')
+        print('或内联传(短用例): --cases \'<JSON>\'')
+        return 1
+    try:
+        parsed = json.loads(raw)
+    except json.JSONDecodeError as e:
+        print('✗ 用例 JSON 解析失败: %s' % e)
+        if cases_file:
+            print('  (来自文件: %s)' % cases_file)
+        return 1
+    cases = parsed if isinstance(parsed, list) else [parsed]
+    # 规范化: 补默认字段
+    for i, c in enumerate(cases):
+        if not isinstance(c, dict):
+            print('✗ 第 %d 条用例不是对象' % (i + 1))
+            return 1
+        c.setdefault('case_id', 'Q-%d' % (i + 1))
+        c.setdefault('platform', args.platform)
+        c.setdefault('env', args.env)
+        c.setdefault('steps', [])
+        c.setdefault('expected', '')
+
+    # 2. 回收结果模式 (临时用例, 只打印汇总)
+    if args.record:
+        try:
+            results = json.loads(args.record)
+        except json.JSONDecodeError as e:
+            print('✗ --record 不是合法 JSON: %s' % e)
+            return 1
+        total = len(results)
+        passed = sum(1 for v in results.values()
+                     if str(v).lower() in ('pass', 'passed', 'ok', 'true', '1'))
+        failed_ids = [k for k, v in results.items()
+                      if str(v).lower() not in ('pass', 'passed', 'ok', 'true', '1')]
+        # 登录用例通过 → 自动标记该 env/platform 已登录 (QoderWork 会话保持, 后续免登录)
+        login_passed = False
+        for c in cases:
+            cid = c.get('case_id', '')
+            if str(results.get(cid, '')).lower() in ('pass', 'passed', 'ok', 'true', '1'):
+                steps_txt = json.dumps(c.get('steps', []), ensure_ascii=False)
+                if '/auth/login' in steps_txt or 'solve_captcha' in steps_txt:
+                    login_passed = True
+                    break
+        if login_passed:
+            base, _ = resolve_base_url(args.env, args.platform)
+            if base:
+                mark_logged_in(args.env, args.platform, base)
+        # 🧠 自动沉淀锚点 (测完就学会, 下次跳过LLM):
+        #   ① 若传了 --page-json (read_page 结果) → 沉淀该页元素锚点
+        #   ② 从通过的 intent 式用例里提取 goto URL + anchor → 沉淀 (用例自带锚点也存)
+        learned_pages = []
+        # ① page-json 方式: 每个 pj 是 {"url":"...", "elements":[...]} 或元素数组
+        for pj_raw in (args.page_json or []):
+            try:
+                parsed = json.loads(pj_raw)
+            except Exception:
+                continue
+            if isinstance(parsed, dict) and 'url' in parsed:
+                url_pattern = _normalize_url_pattern(parsed.get('url', ''))
+                els = parsed.get('elements', parsed.get('elements', []))
+            elif isinstance(parsed, list):
+                url_pattern = '/auto'
+                els = parsed
+            else:
+                continue
+            new_n, _ = learn_page_anchors(url_pattern, els if isinstance(els, list) else [])
+            if new_n:
+                learned_pages.append('%s (+%d)' % (url_pattern, new_n))
+        # ② 从通过的 intent 用例提取 goto URL + anchor 自动沉淀
+        for c in cases:
+            cid = c.get('case_id', '')
+            if str(results.get(cid, '')).lower() not in ('pass', 'passed', 'ok', 'true', '1'):
+                continue  # 只沉淀通过用例的锚点 (失败的锚点可能不准)
+            current_url = '/auto'
+            for s in c.get('steps') or []:
+                if not is_intent_step(s):
+                    continue
+                it = s.get('intent', '')
+                if it == 'goto' and s.get('value'):
+                    current_url = _normalize_url_pattern(s['value'])
+                elif it in ('click', 'fill') and s.get('anchor'):
+                    # 用例自带的 anchor → 直接沉淀(执行时验证过有效)
+                    desc = s.get('desc', '')
+                    im = {desc: {'intent': it, 'anchor': s['anchor']}} if desc else None
+                    new_n, _ = learn_page_anchors(current_url, [s], intent_map=im)
+                    if new_n and current_url not in [p.split(' ')[0] for p in learned_pages]:
+                        learned_pages.append('%s (+%d)' % (current_url, new_n))
+        print('=' * 60)
+        print('快速测试结果')
+        print('=' * 60)
+        print('总计 %d · 通过 %d · 失败 %d' % (total, passed, len(failed_ids)))
+        if failed_ids:
+            print('失败: %s' % ', '.join(failed_ids))
+        if login_passed:
+            print('✓ 登录用例通过 → 已标记 %s/%s 为已登录' % (args.env, args.platform))
+            print('  后续测新功能: 直接 goto 目标页, 不用重复登录(验证码慢)。')
+        if learned_pages:
+            print('🧠 自动沉淀锚点: %s' % ', '.join(learned_pages))
+            print('  下次测同页 recall 命中 → 跳过 LLM → 秒级。')
+        print('=' * 60)
+        return 0 if not failed_ids else 1
+
+    # 3. 解析环境
+    base, src = _resolve_env_platform(args)
+    if base is None:
+        return 1
+    args._base = base  # _inject_and_check_data 用
+
+    # 4. 注入数据 + 校验
+    cases, ok = _inject_and_check_data(cases, args)
+    if not ok:
+        return 1
+
+    # 5. 打印执行计划 (登录态提示)
+    logged, login_time = is_logged_in(args.env, args.platform)
+    title = args.desc or ('快速测试 (%d 条)' % len(cases))
+    record_hint = ('python .qoder/scripts/autotest.py quick '
+                   '--env %s --record \'{"%s":"pass"}\''
+                   % (args.env, cases[0].get('case_id', 'Q-1')))
+    if logged:
+        print('=' * 60)
+        print('💡 已登录 %s/%s (%s) — QoderWork 会话保持中' % (args.env, args.platform, login_time))
+        print('   浏览器 cookie 有效, 直接 goto 目标页即可, 不用重复登录!')
+        print('   (若已过期/被踢, 先 login-state clear 再重新登录)')
+        print('=' * 60)
+    _print_execution_plan(cases, base, src, args.env, args.platform, title, record_hint)
+    return 0
+
+
+def cmd_run(args):
+    task_dir = resolve_task_dir(args.task)
+    if not task_dir.is_dir():
+        print('任务不存在: %s' % args.task)
+        return 1
+    task = load_task_json(task_dir) or {}
+
+    # 1. 域名解析 (--url > --env > config > 报错)
+    base, src = resolve_base_url(args.env, args.platform, override=args.url)
+    if base is None:
+        print('✗ %s 环境未配 base_url, 无法执行测试。' % args.env)
+        print('  解决方式 (任选其一):')
+        print('    1. 命令行临时指定: --url https://你的地址')
+        print('    2. 配 config.yaml: autotest.environments.%s.%s.base_url'
+              % (args.env, args.platform))
+        return 1
+
+    # 2. 取用例 (无则自动生成骨架)
+    cases = read_cases(task_dir)
+    if not cases:
+        print('未找到用例, 自动生成骨架...')
+        cases = generate_skeleton(task_dir, args.env, args.platform)
+        cases = read_cases(task_dir)
+
+    # 3. 指定 case_id 过滤
+    if args.case:
+        want = set(args.case)
+        cases = [c for c in cases if c.get('case_id') in want]
+        if not cases:
+            print('未匹配到指定 case_id: %s' % ', '.join(args.case))
+            print('  已有用例: %s'
+                  % ', '.join(c.get('case_id', '?')
+                              for c in read_cases(task_dir)))
+            return 1
+
+    # 4. 占位符注入: 先 base_url, 再测试数据
+    cases = _inject_base_url(cases, base)
+    # 测试数据 = 个人文档(members/{dev}/autotest-data.yaml, gitignored 不共享)
+    #           + 命令行 --data(覆盖)。按 env/platform 取最精确的值。
+    # ⚠️ 绝不从 config.yaml 读测试账号 —— config 是团队共用会 push, 放账号=泄漏。
+    local_data = load_local_test_data(env=args.env, platform=args.platform)
+    try:
+        cli_data = json.loads(args.data) if args.data else {}
+    except json.JSONDecodeError as e:
+        print('✗ --data 不是合法 JSON: %s' % e)
+        print('  示例: --data \'{"登录账号":"test","登录密码":"123456"}\'')
+        return 1
+    merged_data = dict(local_data)
+    merged_data.update(cli_data)  # 命令行覆盖个人预置
+    cases, missing = inject_data(cases, merged_data)
+
+    # 测试数据完整性检查: 有未注入的 {{ask:...}} → 列清单让 AI 问用户
+    if missing:
+        print('=' * 60)
+        print('⚠️ 需要测试数据才能执行 (%d 项)' % len(missing))
+        print('=' * 60)
+        print('以下用例引用了真实测试数据(账号/密码/手机号等), 不能编造:')
+        for i, desc in enumerate(missing, 1):
+            print('  %d. %s' % (i, desc))
+        print('-' * 60)
+        print('请向用户收集后, 用 --data 传入:')
+        print('  --data \'{"%s":"<值>", "%s":"<值>"}\''
+              % (missing[0], missing[1] if len(missing) > 1 else missing[0]))
+        print()
+        print('常用账号预置到个人文档(不进 git, 团队看不到):')
+        print('  先生成: python .qoder/scripts/autotest.py init-data')
+        print('  再填:   python .qoder/scripts/autotest.py set-data 登录账号 test')
+        return 1
+
+    # 5. 校验
+    ok, warns = validate_cases(cases)
+    has_skeleton = any('待补充' in (c.get('title', '') + c.get('expected', ''))
+                       for c in cases)
+
+    # 6. 如果调用方已传入执行结果 (--record), 落历史并汇总
+    if args.record:
+        return _record_and_report(task_dir, args, base, src, args.record)
+
+    # 7. 探测 QoderWork, 输出执行指令 (核心: 增强层)
+    is_qw, qw_hint = _detect_qoderwork()
+
+    cases_path = _cases_path(task_dir)
+    print('=' * 60)
+    print('浏览器自动化测试 · 执行编排')
+    print('=' * 60)
+    print('任务: %s' % task.get('title', Path(task_dir).name))
+    print('环境: %s   平台: %s' % (args.env, args.platform))
+    print('目标: %s   (来源: %s)' % (base, src))
+    print('用例: %d 条  → %s' % (len(cases), cases_path))
+    if has_skeleton:
+        print('⚠️ 含骨架占位用例 (标题/预期标"待补充"), 建议先补全再执行。')
+    if warns:
+        print('校验提醒:')
+        for w in warns[:10]:
+            print('  - ' + w)
+    print('-' * 60)
+
+    if is_qw:
+        print()
+        print('🧩 QoderWork 浏览器执行 (已检测到: %s)' % qw_hint)
+        print('请用 Browser Use / Computer 控制连接器, 按下列要求执行:')
+        print()
+        print('1. 打开浏览器, 访问: %s' % base)
+        print('2. 逐条执行 %s 中的用例 (共 %d 条):' % (CASES_FILENAME, len(cases)))
+        for c in cases:
+            print('   ▸ %s  %s' % (c.get('case_id', '?'), c.get('title', '')))
+            for s in (c.get('steps') or [])[:6]:
+                print('       %s' % _fmt_step(s))
+            print('       预期: %s' % c.get('expected', ''))
+        print()
+        print('3. 每条用例记录 pass/fail, 全部跑完后回传结果:')
+        print('   python .qoder/scripts/autotest.py run %s \\'
+              % Path(task_dir).name)
+        print('       --env %s --record \'{"AT-...-001":"pass",'
+              '"AT-...-002":"fail"}\'' % args.env)
+        print('   (或直接把结果贴给我, 我帮你落历史 + 出报告)')
+    else:
+        print()
+        print('[非 QoderWork 或未授权浏览器连接器 → 降级为人工核对]')
+        print('用例已生成, 请人工按下方清单逐项检查 (或复制到 QoderWork 执行):')
+        print()
+        print('目标地址: %s' % base)
+        print()
+        for c in cases:
+            print('□ %s  %s' % (c.get('case_id', '?'), c.get('title', '')))
+            for s in (c.get('steps') or [])[:4]:
+                print('    %s' % _fmt_step(s))
+            print('    预期: %s' % c.get('expected', ''))
+            print()
+        print('在 QoderWork 桌面端 (Settings → Connectors 授权浏览器/Computer) ')
+        print('可让 Agent 自动执行; 结果用 --record 回传出报告。')
+    print('-' * 60)
+    return 0
+
+
+def _record_and_report(task_dir, args, base, src, record_json):
+    """把执行结果落历史 jsonl 并打印汇总。"""
+    try:
+        results = json.loads(record_json)
+    except json.JSONDecodeError as e:
+        print('✗ --record 不是合法 JSON: %s' % e)
+        return 1
+    if not isinstance(results, dict):
+        print('✗ --record 需为 {case_id: "pass"|"fail"} 形式')
+        return 1
+
+    total = len(results)
+    passed = sum(1 for v in results.values()
+                 if str(v).lower() in ('pass', 'passed', 'ok', 'true', '1'))
+    failed_ids = [k for k, v in results.items()
+                  if str(v).lower() not in ('pass', 'passed', 'ok', 'true', '1')]
+    status = 'pass' if (total > 0 and not failed_ids) else (
+        'fail' if failed_ids else 'none')
+
+    task = load_task_json(task_dir) or {}
+    record = {
+        'time': datetime.now().isoformat(),
+        'task': Path(task_dir).name,
+        'task_title': task.get('title', ''),
+        'env': args.env,
+        'platform': args.platform,
+        'base_url': base,
+        'url_source': src,
+        'total': total,
+        'passed': passed,
+        'failed': len(failed_ids),
+        'status': status,
+        'failed_cases': failed_ids,
+        'runner': 'qoderwork-browser',
+    }
+
+    try:
+        from common.atomicio import atomic_append_jsonl
+        os.makedirs(os.path.dirname(HISTORY_PATH), exist_ok=True)
+        atomic_append_jsonl(HISTORY_PATH, record, timeout=10)
+    except Exception as e:
+        print('⚠ 历史记录写入失败 (不影响本次结果): %s' % e, file=sys.stderr)
+
+    print('=' * 60)
+    print('测试结果汇总')
+    print('=' * 60)
+    print('任务: %s' % record['task_title'])
+    print('环境: %s  目标: %s' % (args.env, base))
+    print('总计 %d 条 · 通过 %d · 失败 %d · 状态: %s'
+          % (total, passed, len(failed_ids), status.upper()))
+    if failed_ids:
+        print('失败用例:')
+        for cid in failed_ids:
+            print('  ✗ %s' % cid)
+    print('-' * 60)
+    print('已记录到 %s' % HISTORY_PATH)
+    if status == 'fail':
+        print('建议: 查失败用例, 修复后重跑 /wl-test run %s --env %s'
+              % (Path(task_dir).name, args.env))
+        return 1
+    print('全部通过! 可 /wl-commit 提交, 或 /wl-report 出报告。')
+    return 0
+
+
+# ---------------------------------------------------------------------------
+# 子命令: list
+# ---------------------------------------------------------------------------
+
+def cmd_list(args):
+    task_dir = resolve_task_dir(args.task)
+    if not task_dir.is_dir():
+        print('任务不存在: %s' % args.task)
+        return 1
+    cases = read_cases(task_dir)
+    if not cases:
+        print('任务 %s 暂无用例。' % Path(task_dir).name)
+        print('生成: python .qoder/scripts/autotest.py generate %s'
+              % Path(task_dir).name)
+        return 0
+    task = load_task_json(task_dir) or {}
+    print('任务: %s' % task.get('title', Path(task_dir).name))
+    print('用例文件: %s' % _cases_path(task_dir))
+    print()
+    print('%-18s %-8s %-6s %s' % ('CASE_ID', 'ENV', 'PLAT', '标题'))
+    print('-' * 60)
+    for c in cases:
+        print('%-18s %-8s %-6s %s' % (
+            c.get('case_id', '?'),
+            c.get('env', '?'),
+            c.get('platform', '?'),
+            c.get('title', '')))
+    print('-' * 60)
+    print('共 %d 条' % len(cases))
+    return 0
+
+
+# ---------------------------------------------------------------------------
+# 子命令: set-data / list-data (个人测试数据, 本地 gitignored)
+# ---------------------------------------------------------------------------
+
+def cmd_set_data(args):
+    """预置一条个人测试数据到本地文档(不进 git)。"""
+    env = getattr(args, 'env', None)
+    platform = getattr(args, 'platform', None)
+    save_local_test_data(args.key, args.value, env=env, platform=platform)
+    loc = ('%s.%s' % (env, platform)) if (env and platform) else (
+        env or platform or '通用(顶层)')
+    print('已保存到个人文档: %s' % local_data_path())
+    print('  %s = %s   [位置: %s]' % (args.key, args.value, loc))
+    print()
+    print('🔒 此文档已被 .gitignore 覆盖 (workspace/members/*/autotest-data.yaml),')
+    print('   team_sync 不会 push, 团队/npm 包都看不到。')
+    print('   run 时自动注入用例的 {{ask:%s}} 占位。' % args.key)
+    if any(s in args.key for s in ('密码', '密', 'secret', 'token', '码')):
+        print('   (敏感数据, 存个人文档比每次对话明文输入更安全)')
+    return 0
+
+
+def cmd_list_data(args):
+    """列出本地已预置的测试数据(可按 env/platform 过滤)。"""
+    env = getattr(args, 'env', None)
+    platform = getattr(args, 'platform', None)
+    p = local_data_path()
+    if not p.is_file():
+        print('个人测试数据文档不存在: %s' % p)
+        print()
+        print('生成模板: python .qoder/scripts/autotest.py init-data')
+        print('或直接预置: python .qoder/scripts/autotest.py set-data 登录账号 test')
+        return 0
+    data = load_local_test_data(env=env, platform=platform)
+    if not data:
+        scope = ('%s/%s' % (env, platform)) if (env and platform) else (
+            env or platform or '全部')
+        print('文档 %s 在 %s 范围内无数据。' % (p, scope))
+        return 0
+    print('个人测试数据 (%d 项)' % len(data))
+    print('文档: %s' % p)
+    print('-' * 50)
+    for k, v in data.items():
+        show = v
+        if any(s in k for s in ('密码', '密', 'secret', 'token')):
+            show = '*' * min(len(str(v)), 8) if str(v) else '(空)'
+        print('  %-16s = %s' % (k, show))
+    print('-' * 50)
+    print('🔒 个人文档, 已 gitignore, 不会 push/共享。run 时自动注入 {{ask:描述}}。')
+    return 0
+
+
+def cmd_init_data(args):
+    """生成带注释的个人测试数据模板文档(若不存在)。"""
+    path, created = init_local_data_doc()
+    if created:
+        print('已生成模板: %s' % path)
+        print()
+        print('打开它, 填入你的测试账号密码(例子已给)。每人只填自己的 members/{自己}/。')
+        print('🔒 已 gitignore, 不会 push/共享给团队。')
+    else:
+        print('文档已存在(不覆盖): %s' % path)
+        print('直接编辑它, 或用 set-data 命令追加。')
+    return 0
+
+
+# ---------------------------------------------------------------------------
+# 子命令: login-state (登录态: 已登录就别重复登录, 尤其验证码慢)
+# ---------------------------------------------------------------------------
+
+def cmd_login_state(args):
+    """查看/标记/清除 登录态。
+
+    QoderWork 保持同一个浏览器会话 → 登录一次后 cookie 不丢。
+    后续测新功能直接 goto 目标页, 不用重复登录(数学题验证码很慢)。
+    """
+    action = args.action  # show / mark / clear
+    env = getattr(args, 'env', None) or _default_env()
+    platform = getattr(args, 'platform', None) or 'web'
+
+    if action == 'mark':
+        base, src = resolve_base_url(env, platform)
+        if not base:
+            print('✗ %s/%s 未配域名, 无法标记登录。' % (env, platform))
+            return 1
+        mark_logged_in(env, platform, base)
+        print('已标记 %s/%s 为已登录 (浏览器会话保持中, cookie 有效)。' % (env, platform))
+        print('🔒 存个人文档 (gitignored), 不会 push。')
+        print()
+        print('后续 quick/browser 测新功能: 直接 goto 目标页, 不用再登录。')
+        return 0
+
+    if action == 'clear':
+        clear_login_state(env if env and env != 'all' else None,
+                          platform if env != 'all' else None)
+        print('已清除登录态: %s/%s。' % (env, platform))
+        print('下次测试会重新走登录流程。')
+        return 0
+
+    # show (默认)
+    state = load_login_state()
+    if not state:
+        print('未记录任何登录态。')
+        print('登录用例通过后自动标记, 或手动: login-state mark --env %s --platform %s'
+              % (env, platform))
+        return 0
+    print('已记录登录态 (QoderWork 会话保持中, 后续测新功能可直接 goto 目标页):')
+    print('-' * 50)
+    for e, plats in state.items():
+        for pf, info in (plats or {}).items():
+            t = (info or {}).get('time', '?')[:19].replace('T', ' ')
+            url = (info or {}).get('url', '')
+            print('  %s/%s  已登录  (%s)  %s' % (e, pf, t, url))
+    print('-' * 50)
+    print('🔒 个人文档, gitignored, 不 push。清除: login-state clear --env <环境>')
+    return 0
+
+
+# ---------------------------------------------------------------------------
+# 子命令: learn / recall (页面锚点沉淀 + 查询, A方案核心)
+# ---------------------------------------------------------------------------
+
+def cmd_learn(args):
+    """把 read_page 返回的页面元素沉淀成稳定锚点 → data/index/test-pages.json。
+
+    AI 执行 observe(read_page) 后, 把元素 JSON 回传, 本命令提取稳定锚点存盘。
+    下次 recall 同页直接命中锚点, 跳过 LLM 匹配(Stagehand 式 action 缓存)。
+    """
+    url_pattern = _normalize_url_pattern(args.url, getattr(args, '_base', None))
+    # 解析 page-json (read_page 返回的元素数组, 或 {elements:[...]})
+    try:
+        parsed = json.loads(args.page_json)
+    except json.JSONDecodeError as e:
+        print('✗ --page-json 不是合法 JSON: %s' % e)
+        return 1
+    if isinstance(parsed, dict):
+        elements = parsed.get('elements') or parsed.get('elements') or []
+    elif isinstance(parsed, list):
+        elements = parsed
+    else:
+        print('✗ --page-json 应为元素数组或含 elements 的对象')
+        return 1
+    # 可选 intent-map
+    intent_map = None
+    if args.intent_map:
+        try:
+            intent_map = json.loads(args.intent_map)
+        except json.JSONDecodeError as e:
+            print('⚠ --intent-map 不是合法 JSON, 忽略: %s' % e)
+    new_n, total_n = learn_page_anchors(url_pattern, elements, intent_map=intent_map)
+    print('=' * 56)
+    print('锚点沉淀 → data/index/test-pages.json')
+    print('=' * 56)
+    print('页面: %s' % url_pattern)
+    print('本次新增 %d 个锚点, 该页累计 %d 个' % (new_n, total_n))
+    print('🔒 团队共享(随 team_sync 分发), 只存 role/name/placeholder, 不含密码/ref。')
+    print()
+    print('下次 recall %s 即可直接用锚点生成用例, 跳过 LLM 匹配。' % url_pattern)
+    return 0
+
+
+def cmd_recall(args):
+    """查某页已沉淀的锚点。AI 生成用例前查它, 有锚点就直接填进 step。"""
+    url_pattern = _normalize_url_pattern(args.url)
+    anchors = recall_page_anchors(url_pattern)
+    print('=' * 56)
+    print('已沉淀锚点: %s' % url_pattern)
+    print('=' * 56)
+    if not anchors:
+        print('该页暂无锚点。执行 observe(read_page) 后用 learn 沉淀:')
+        print('  python .qoder/scripts/autotest.py learn --url %s --page-json \'<read_page结果>\'' % url_pattern)
+        return 0
+    print('%-10s %-22s %s' % ('INTENT', 'ANCHOR', '描述'))
+    print('-' * 56)
+    for a in anchors:
+        print('%-10s %-22s %s' % (
+            a.get('intent', '?'),
+            _fmt_anchor(a.get('anchor')),
+            a.get('desc', '')[:30]))
+    print('-' * 56)
+    print('共 %d 个锚点。生成用例时可直接填入 step.anchor, 跳过 LLM 匹配。' % len(anchors))
+    return 0
+
+
+# ---------------------------------------------------------------------------
+# 子命令: page (页面按钮+接口画像, 开发→测试交接物)
+# ---------------------------------------------------------------------------
+
+def cmd_page(args):
+    """查页面按钮+接口画像。薄入口, 实际逻辑在 page_probe.py。
+    数据来自知识图谱 traces 表, 无图谱则静默提示。
+    """
+    try:
+        import page_probe
+    except ImportError:
+        # 直接当脚本跑时, 补一下 sys.path
+        sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+        import page_probe
+
+    profile = page_probe.build_page_profile(keyword=getattr(args, 'kw', None),
+                                            url=getattr(args, 'url', None))
+    label = args.kw or args.url
+    print('## 页面画像: %s' % label)
+    print()
+    print(page_probe.render_profile_md(profile))
+    if profile.get('ok'):
+        n_pages = len(profile['pages'])
+        n_btns = sum(len(pg['buttons']) for pg in profile['pages'])
+        print()
+        print('[page] %d 个页面, %d 个交互点' % (n_pages, n_btns))
+    return 0
+
+
+# ---------------------------------------------------------------------------
+# 子命令: report
+# ---------------------------------------------------------------------------
+
+def cmd_report(args):
+    task_dir = resolve_task_dir(args.task)
+    task_name = Path(task_dir).name
+    task = load_task_json(task_dir) or {}
+
+    if not os.path.isfile(HISTORY_PATH):
+        print('暂无测试执行历史 (%s)' % HISTORY_PATH)
+        print('先跑: python .qoder/scripts/autotest.py run %s --env test'
+              % task_name)
+        return 0
+
+    # 读该任务的全部历史 (倒序)
+    records = []
+    with open(HISTORY_PATH, encoding='utf-8') as f:
+        for line in f:
+            line = line.strip()
+            if not line:
+                continue
+            try:
+                r = json.loads(line)
+            except json.JSONDecodeError:
+                continue
+            if r.get('task') == task_name:
+                records.append(r)
+    if not records:
+        print('任务 %s 无执行记录。' % task_name)
+        return 0
+
+    records.sort(key=lambda r: r.get('time', ''), reverse=True)
+    print('=' * 60)
+    print('测试历史 · %s' % task.get('title', task_name))
+    print('=' * 60)
+    print('%-20s %-6s %-7s %-5s %s' % (
+        '时间', 'ENV', '状态', 'P/F', '目标'))
+    print('-' * 60)
+    for r in records[:20]:
+        t = r.get('time', '')[:19].replace('T', ' ')
+        print('%-20s %-6s %-7s %d/%d %s' % (
+            t,
+            r.get('env', '?'),
+            r.get('status', '?').upper(),
+            r.get('passed', 0),
+            r.get('total', 0),
+            r.get('base_url', '')))
+    print('-' * 60)
+    total_runs = len(records)
+    pass_runs = sum(1 for r in records if r.get('status') == 'pass')
+    print('历史 %d 次执行 · 通过率 %.0f%% (最近 %d 次)'
+          % (total_runs, 100 * pass_runs / total_runs if total_runs else 0,
+             min(total_runs, 20)))
+    last = records[0]
+    if last.get('failed_cases'):
+        print('最近一次失败用例: %s' % ', '.join(last['failed_cases']))
+    return 0
+
+
+# ---------------------------------------------------------------------------
+# argparse
+# ---------------------------------------------------------------------------
+
+def build_parser():
+    p = argparse.ArgumentParser(
+        prog='autotest.py',
+        description='浏览器自动化测试: 用例生成 + 运行编排 (QoderWork 浏览器执行, 纯 Qoder 降级人工)',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    sub = p.add_subparsers(dest='cmd')
+
+    def add_env_platform(sp):
+        sp.add_argument('--env', default=_default_env(),
+                        choices=SUPPORTED_ENVS,
+                        help='环境 (test/pre/prod), 默认 %(default)s')
+        sp.add_argument('--platform', default='web',
+                        choices=SUPPORTED_PLATFORMS,
+                        help='平台 (web=管理端 / app=移动端), 默认 %(default)s')
+
+    pg = sub.add_parser('generate', help='从任务生成测试用例骨架')
+    pg.add_argument('task', help='任务名/路径 (如 06-14-login)')
+    add_env_platform(pg)
+    pg.set_defaults(func=cmd_generate)
+
+    pr = sub.add_parser('run', help='生成(若无)+输出浏览器执行指令/人工清单')
+    pr.add_argument('task', help='任务名/路径')
+    add_env_platform(pr)
+    pr.add_argument('--url', default=None,
+                    help='临时覆盖目标域名 (优先于 --env 配置)')
+    pr.add_argument('--case', nargs='*', default=None,
+                    help='只执行指定 case_id (可多个)')
+    pr.add_argument('--data', default=None,
+                    help='测试数据 JSON, 注入 {{ask:描述}} 占位, '
+                         '如 \'{"登录账号":"test","登录密码":"123456"}\'')
+    pr.add_argument('--record', default=None,
+                    help='回传执行结果 JSON, 如 \'{"AT-x-001":"pass"}\'')
+    pr.set_defaults(func=cmd_run)
+
+    pq = sub.add_parser('quick', help='快速测试: 不需任务/PRD, AI 直接据描述生成并执行')
+    pq.add_argument('--cases', default=None,
+                    help='JSON 用例 (单条对象或数组), AI 据用户描述生成后传入')
+    pq.add_argument('--cases-file', dest='cases_file', default=None,
+                    help='用例 JSON 文件路径(推荐, 不截断)。AI 写文件后传路径')
+    pq.add_argument('--desc', default=None,
+                    help='本次快速测试的描述/标题 (可选)')
+    add_env_platform(pq)
+    pq.add_argument('--url', default=None, help='临时覆盖目标域名')
+    pq.add_argument('--data', default=None, help='测试数据 JSON, 注入 {{ask:描述}}')
+    pq.add_argument('--record', default=None, help='回传执行结果 JSON')
+    pq.add_argument('--page-json', nargs='*', default=None,
+                    help='read_page 返回的页面元素 JSON(多个), --record 时自动沉淀锚点')
+    pq.set_defaults(func=cmd_quick)
+
+    pl = sub.add_parser('list', help='列出任务已有用例')
+    pl.add_argument('task', help='任务名/路径')
+    pl.set_defaults(func=cmd_list)
+
+    pr2 = sub.add_parser('report', help='查看任务测试执行历史')
+    pr2.add_argument('task', help='任务名/路径')
+    pr2.set_defaults(func=cmd_report)
+
+    psd = sub.add_parser('set-data', help='预置个人测试数据到个人文档(gitignored, 不共享)')
+    psd.add_argument('key', help='数据名(对应用例 {{ask:数据名}} 占位), 如 登录账号')
+    psd.add_argument('value', help='数据值, 如 test')
+    psd.add_argument('--env', default=None, choices=SUPPORTED_ENVS,
+                     help='只对该环境生效(如 test/pre/prod)')
+    psd.add_argument('--platform', default=None, choices=SUPPORTED_PLATFORMS,
+                     help='只对该平台生效(web/app)')
+    psd.set_defaults(func=cmd_set_data)
+
+    pld = sub.add_parser('list-data', help='列出个人已预置的测试数据(可按 env/platform 过滤)')
+    pld.add_argument('--env', default=None, choices=SUPPORTED_ENVS)
+    pld.add_argument('--platform', default=None, choices=SUPPORTED_PLATFORMS)
+    pld.set_defaults(func=cmd_list_data)
+
+    pid = sub.add_parser('init-data', help='生成个人测试数据模板文档(members/{dev}/autotest-data.yaml)')
+    pid.set_defaults(func=cmd_init_data)
+
+    pls = sub.add_parser('login-state', help='登录态: 已登录就别重复登录(QoderWork 会话保持)')
+    pls.add_argument('action', nargs='?', default='show',
+                     choices=['show', 'mark', 'clear'],
+                     help='show=查看 / mark=标记已登录 / clear=清除(强制重新登录)')
+    add_env_platform(pls)
+    pls.set_defaults(func=cmd_login_state)
+
+    ple = sub.add_parser('learn', help='沉淀页面锚点到 test-pages.json(observe后调, 团队共享)')
+    ple.add_argument('--url', required=True, help='页面 URL 或路径(如 /auth/login 或完整URL)')
+    ple.add_argument('--page-json', required=True,
+                     help="read_page 返回的元素 JSON (数组 或 {elements:[...]})")
+    ple.add_argument('--intent-map', default=None,
+                     help='可选: {元素描述:{intent,anchor}} 标注意图')
+    ple.set_defaults(func=cmd_learn)
+
+    prc = sub.add_parser('recall', help='查某页已沉淀的锚点(生成用例前查, 跳过LLM匹配)')
+    prc.add_argument('--url', required=True, help='页面 URL 或路径(如 /auth/login)')
+    prc.set_defaults(func=cmd_recall)
+
+    # page: 查页面按钮+接口画像 (开发→测试交接物, 数据来自知识图谱 traces 表)
+    ppg = sub.add_parser('page', help='查页面按钮+接口画像(开发交接给测试,照着写用例)')
+    ppg_grp = ppg.add_mutually_exclusive_group(required=True)
+    ppg_grp.add_argument('--kw', help='业务关键词(如 保险 / 排班)')
+    ppg_grp.add_argument('--url', help='页面 URL 或路径关键词(如 /veh/insurance)')
+    ppg.set_defaults(func=cmd_page)
+
+    return p
+
+
+def _default_env():
+    """config.yaml autotest.default_env, 缺失回退 test。"""
+    try:
+        return load_config_section('autotest').get('default_env') or 'test'
+    except Exception:
+        return 'test'
+
+
+def main(argv=None):
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    if not getattr(args, 'cmd', None):
+        parser.print_help()
+        return 1
+    try:
+        return args.func(args)
+    except RuntimeError as e:
+        # 身份缺失等 (多人共用 workspace 时的隔离保障)
+        print('✗ %s' % e)
+        return 1
+    except (ValueError, FileNotFoundError) as e:
+        print('✗ %s' % e)
+        return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())