@szc-ft/mcp-szcd-client 0.30.0 → 0.31.0

package/qwen-extension/skills/local-browser-test/lib/cdp-browser-config.js

@@ -0,0 +1,115 @@
+/**
+ * CDP 方式获取浏览器运行配置
+ * 通过 Chrome DevTools Protocol 获取浏览器命令行参数，解析 user-data-dir 等配置
+ */
+import { execSync } from 'child_process';
+import { join } from 'path';
+
+/**
+ * 通过 wmic 获取 msedge.exe 的完整命令行，解析关键参数
+ * @param {"msedge"|"chrome"} browserName
+ * @returns {{ userDataDir: string, remoteDebuggingPort: string, args: string[] }}
+ */
+export function getBrowserConfigFromProcess(browserName = 'msedge') {
+  const exeName = browserName === 'chrome' ? 'chrome.exe' : 'msedge.exe';
+  // 方案1：wmic /format:list 获取命令行
+  let output = '';
+  try {
+    const raw = execSync(
+      `wmic process where "name='${exeName}'" get commandline /format:list`,
+      { encoding: 'utf8', timeout: 5000, windowsHide: true }
+    );
+    // 解析 key=value 格式（每行 CommandLine=...，空格行分隔进程）
+    const blocks = raw.split(/\r\n\r\n/);
+    output = blocks
+      .map(b => {
+        const m = b.match(/CommandLine=(.+)/s);
+        return m ? m[1].trim() : '';
+      })
+      .filter(Boolean)
+      .join('\n');
+  } catch {
+    // 方案2：PowerShell Get-CimInstance
+    try {
+      const psScript = `Get-CimInstance Win32_Process -Filter 'Name="${exeName}"' | Where-Object { $_.CommandLine -like '*--remote-debugging-port*' } | ForEach-Object { $_.CommandLine }`;
+      output = execSync(
+        `powershell -NoProfile -Command "${psScript.replace(/"/g, '\\"')}"`,
+        { encoding: 'utf8', timeout: 8000, windowsHide: true }
+      );
+    } catch {
+      return null;
+    }
+  }
+
+  // 解析命令行参数
+  const lines = output.split('\n').filter(l => l.includes('--remote-debugging-port') && l.trim());
+  if (lines.length === 0) return null;
+
+  const cmdLine = lines[0].trim();
+
+  // 提取关键参数
+  const config = {
+    userDataDir: null,
+    remoteDebuggingPort: null,
+    args: [],
+  };
+
+  // 解析 --user-data-dir="path" 或 --user-data-dir=path 或 --user-data-dir path
+  const uddMatch = cmdLine.match(/--user-data-dir[= ]"?([^ "]+)"?/i);
+  if (uddMatch) {
+    config.userDataDir = uddMatch[1].replace(/\\/g, '/');
+  }
+
+  // 解析 --remote-debugging-port
+  const rdpMatch = cmdLine.match(/--remote-debugging-port[= ](\d+)/i);
+  if (rdpMatch) {
+    config.remoteDebuggingPort = rdpMatch[1];
+  }
+
+  // 返回所有参数
+  const argMatches = cmdLine.match(/--[\w-]+(?:[= ][^ "]+)?/g);
+  if (argMatches) {
+    config.args = argMatches.map(a => a.trim());
+  }
+
+  return config;
+}
+
+/**
+ * 通过 CDP 连接获取浏览器版本信息
+ * @param {string} cdpUrl - CDP 地址，默认 http://localhost:9222
+ */
+export async function getBrowserInfoFromCDP(cdpUrl = 'http://localhost:9222') {
+  try {
+    const resp = await fetch(`${cdpUrl}/json/version`);
+    const data = await resp.json();
+    return {
+      browser: data.Browser || data.browser,
+      userAgent: data['User-Agent'],
+      protocolVersion: data['Protocol-Version'],
+      webSocketDebuggerUrl: data.webSocketDebuggerUrl,
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 综合获取浏览器完整配置
+ * 先通过进程命令行获取 user-data-dir，再通过 CDP 获取版本信息
+ */
+export async function getFullBrowserConfig(cdpUrl = 'http://localhost:9222') {
+  const procConfig = getBrowserConfigFromProcess();
+  const browserInfo = await getBrowserInfoFromCDP(cdpUrl);
+
+  return {
+    ...procConfig,
+    browserInfo,
+    loginDataPath: procConfig?.userDataDir
+      ? join(procConfig.userDataDir, 'Default', 'Login Data')
+      : null,
+    localStatePath: procConfig?.userDataDir
+      ? join(procConfig.userDataDir, 'Local State')
+      : null,
+  };
+}

package/qwen-extension/skills/local-browser-test/lib/decrypt-passwords.js

@@ -0,0 +1,210 @@
+/**
+ * 从 Edge/Chrome 的 Login Data 数据库中解密保存的密码
+ *
+ * 支持 v10 格式（使用 AES-256-GCM + DPAPI 加密密钥）
+ * 不支持 v20 格式（App-Bound Encryption，需在浏览器进程内解密）
+ *
+ * 依赖：
+ *   - sql.js（纯 JS SQLite，npm install sql.js）
+ *   - Node.js 内置 crypto
+ *   - Windows DPAPI（通过 PowerShell 子进程）
+ */
+import { readFileSync, writeFileSync, unlinkSync, existsSync } from 'fs';
+import { createDecipheriv } from 'crypto';
+import { execSync } from 'child_process';
+import { join, dirname } from 'path';
+import { createRequire } from 'module';
+
+// sql.js 在共享缓存 ~/.szcd-mcp/deps/node_modules/ 中
+// ESM 的 NODE_PATH 不支持，用 createRequire 兼容
+const require = createRequire(import.meta.url);
+const initSqlJs = require('sql.js');
+
+// ============ DPAPI 解密（通过 PowerShell） ============
+
+/**
+ * 使用 Windows DPAPI 解密数据
+ * 通过 PowerShell 调用 System.Security.Cryptography.ProtectedData
+ */
+export function dpapiDecrypt(encryptedBuffer) {
+  const tmpDir = process.env.TEMP || process.env.TMP || '/tmp';
+  const tmpIn = join(tmpDir, '_dpapi_in.bin');
+  const tmpOut = join(tmpDir, '_dpapi_out.bin');
+
+  writeFileSync(tmpIn, encryptedBuffer);
+
+  // PowerShell 脚本：读文件 → DPAPI 解密 → 写文件
+  const psScript = [
+    'Add-Type -AssemblyName System.Security',
+    `$in=[System.IO.File]::ReadAllBytes('${tmpIn.replace(/\\/g, '\\\\')}')`,
+    `$out=[System.Security.Cryptography.ProtectedData]::Unprotect($in,$null,'CurrentUser')`,
+    `[System.IO.File]::WriteAllBytes('${tmpOut.replace(/\\/g, '\\\\')}',$out)`,
+  ].join(';');
+
+  try {
+    execSync(`powershell -NoProfile -Command "${psScript}"`, {
+      encoding: 'utf8',
+      windowsHide: true,
+      timeout: 10000,
+    });
+    return readFileSync(tmpOut);
+  } finally {
+    try { unlinkSync(tmpIn); } catch {}
+    try { unlinkSync(tmpOut); } catch {}
+  }
+}
+
+
+// ============ 浏览器配置检测 ============
+
+/**
+ * 获取 Edge/Chrome 的 user-data-dir 配置
+ * 通过解析进程命令行参数
+ */
+export function detectUserDataDir(browserName = 'msedge') {
+  const exeName = browserName === 'chrome' ? 'chrome.exe' : 'msedge.exe';
+
+  let output = '';
+  try {
+    output = execSync(
+      `wmic process where "name='${exeName}'" get commandline /format:csv`,
+      { encoding: 'utf8', timeout: 5000, windowsHide: true }
+    );
+  } catch {
+    try {
+      output = execSync(
+        `powershell -NoProfile -Command "Get-CimInstance Win32_Process -Filter \\"Name='${exeName}'\\" | Where-Object {\\$_.CommandLine -like '*--remote-debugging-port*'} | Select-Object -ExpandProperty CommandLine"`,
+        { encoding: 'utf8', timeout: 5000, windowsHide: true }
+      );
+    } catch {
+      return null;
+    }
+  }
+
+  const lines = output.split('\n').filter(l => l.includes('--remote-debugging-port'));
+  if (lines.length === 0) return null;
+
+  const match = lines[0].match(/--user-data-dir[= ]"?([^ "]+)"?/i);
+  return match ? match[1].replace(/\\/g, '/') : null;
+}
+
+
+// ============ AES-256-GCM 解密（v10 格式） ============
+
+/**
+ * 解密 v10 格式的密码
+ * 格式: "v10" (3 bytes) + nonce (12 bytes) + ciphertext + tag (16 bytes)
+ */
+function decryptV10Password(aesKey, encryptedBlob) {
+  const raw = Buffer.from(encryptedBlob);
+  if (raw.length < 31) throw new Error('v10 blob too short');
+
+  const nonce = raw.subarray(3, 15);           // 12 bytes after v10
+  const tag = raw.subarray(raw.length - 16);    // last 16 bytes
+  const ciphertext = raw.subarray(15, raw.length - 16);
+
+  const decipher = createDecipheriv('aes-256-gcm', aesKey, nonce);
+  decipher.setAuthTag(tag);
+  return Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+}
+
+
+// ============ 主入口 ============
+
+/**
+ * 从浏览器配置目录解密所有保存的密码
+ * @param {object} options
+ * @param {string} [options.userDataDir] - Edge/Chrome 的 user-data-dir 路径，不传则自动检测
+ * @param {string} [options.filter] - 过滤 URL 的关键词，默认 '%'（全部）
+ * @param {boolean} [options.verbose] - 是否输出详细信息
+ * @returns {Array<{url: string, username: string, password: string}>}
+ */
+export async function decryptAllPasswords(options = {}) {
+  const {
+    userDataDir = detectUserDataDir(),
+    filter = '%',
+    verbose = false,
+  } = options;
+
+  if (!userDataDir) {
+    throw new Error(
+      '未检测到浏览器 user-data-dir。请确保 Edge/Chrome 以 --remote-debugging-port 和 --user-data-dir 参数启动'
+    );
+  }
+
+  const localStatePath = join(userDataDir, 'Local State');
+  const loginDataPath = join(userDataDir, 'Default', 'Login Data');
+
+  if (!existsSync(localStatePath)) {
+    throw new Error(`Local State 文件不存在: ${localStatePath}`);
+  }
+  if (!existsSync(loginDataPath)) {
+    throw new Error(`Login Data 文件不存在: ${loginDataPath}`);
+  }
+
+  if (verbose) {
+    console.log(`[decrypt] userDataDir: ${userDataDir}`);
+    console.log(`[decrypt] Login Data: ${loginDataPath}`);
+    console.log(`[decrypt] Local State: ${localStatePath}`);
+  }
+
+  // 1. 读取 Local State 获取加密密钥
+  const localState = JSON.parse(readFileSync(localStatePath, 'utf8'));
+  if (!localState.os_crypt?.encrypted_key) {
+    throw new Error('Local State 中未找到 os_crypt.encrypted_key');
+  }
+
+  const encKeyBuf = Buffer.from(localState.os_crypt.encrypted_key, 'base64');
+  if (encKeyBuf.length < 5) throw new Error('加密密钥格式异常');
+
+  // 去除 "DPAPI" 前缀（5 字节）
+  const aesKey = dpapiDecrypt(encKeyBuf.subarray(5));
+  if (verbose) console.log(`[decrypt] AES key: ${aesKey.length} bytes`);
+
+  // 2. 读取 SQLite 数据库
+  const SQL = await initSqlJs();
+  const db = new SQL.Database(readFileSync(loginDataPath));
+  const rows = db.exec(
+    `SELECT origin_url, username_value, password_value FROM logins WHERE origin_url LIKE '${filter}'`
+  );
+
+  const credentials = [];
+  const values = rows[0]?.values || [];
+
+  for (const [url, username, pwdBlob] of values) {
+    if (!pwdBlob || pwdBlob.length < 3) continue;
+
+    const raw = Buffer.from(pwdBlob);
+    const prefix = raw.subarray(0, 3).toString();
+
+    if (prefix === 'v10') {
+      try {
+        const password = decryptV10Password(aesKey, pwdBlob).toString('utf8');
+        credentials.push({ url, username, password });
+        if (verbose) console.log(`[decrypt] ✓ ${username} @ ${url}`);
+      } catch (e) {
+        if (verbose) console.log(`[decrypt] ✗ ${username}: ${e.message}`);
+      }
+    } else if (verbose) {
+      console.log(`[decrypt] ⊘ ${username}: unsupported format (${prefix})`);
+    }
+  }
+
+  db.close();
+  return credentials;
+}
+
+/**
+ * 获取指定 URL 的凭据（便捷方法）
+ * @param {string} urlPattern - URL 匹配模式
+ * @param {object} [options]
+ * @returns {Promise<{username: string, password: string}|null>}
+ */
+export async function getCredential(urlPattern, options = {}) {
+  const creds = await decryptAllPasswords({
+    ...options,
+    filter: `%${urlPattern}%`,
+    verbose: false,
+  });
+  return creds.length > 0 ? creds[0] : null;
+}

package/qwen-extension/skills/local-browser-test/lib/shared-deps.js

@@ -13,8 +13,8 @@ import fs from "node:fs";
 /** 共享缓存目录 */
 const SHARED_DEPS_DIR = path.join(homedir(), ".szcd-mcp", "deps");
 
-/** 核心浏览器自动化依赖 */
-const CORE_PACKAGES = ["puppeteer-core"];
+/** 核心浏览器自动化依赖（主链路 observe/act/assert + 凭据解密） */
+const CORE_PACKAGES = ["puppeteer-core", "sql.js"];
 
 /** 视觉对比依赖 */
 const VISUAL_COMPARE_PACKAGES = ["pixelmatch", "pngjs", "sharp"];

package/standard-skill/local-browser-test/SKILL.md

@@ -25,6 +25,9 @@ compatibility:
 **视觉对比（用 --action compare）：**
 - "对比设计稿" / "还原度" / "像素对比"
 
+**凭据管理（用 decrypt-creds.mjs）：**
+- "获取密码" / "解密密码" / "自动登录" / "读取浏览器保存的密码" / "接管浏览器，帮我登录"
+
 ## ⚡ 路径解析（必读，避免 ad-hoc 脚本）
 
 **执行器内置在 skill 目录中（自包含），会话开始时先解析 skill 路径：**
@@ -149,15 +152,22 @@ Agent / SKILL.md
   → $SKILL_DIR/lib/expect.js          (validation/locator/url/api + poll)
   → puppeteer-core + CDP
   → 用户真实 Chrome / Edge
+
+  ── 凭据分支 ──
+  → $SKILL_DIR/decrypt-creds.mjs          (CLI 入口)
+  → $SKILL_DIR/lib/cdp-browser-config.js  (检测 user-data-dir)
+  → $SKILL_DIR/lib/decrypt-passwords.js   (DPAPI + AES-GCM 解密)
+  → 输出 { username, password, url }
 ```
 
-执行器 + lib 内置在 skill 目录中（自包含），`postinstall` 会把整个 skill 目录复制到各 IDE。
+执行器 + lib + 凭据解密模块内置在 skill 目录中（自包含），`postinstall` 会把整个 skill 目录复制到各 IDE。
 **禁止 AI 在用户机器上写 ad-hoc puppeteer 脚本**——会丢失：
 - 微前端 frame 探活 + 自动召回
 - `closeAllDropdowns` 跨 frame 清理
 - Ant Select VERIFY 回写
 - testCase recovery 重试
 - API 按 frame scope 过滤
+- 浏览器凭据自动解密（使用内置 `decrypt-creds.mjs`）
 
 `local-browser-executor.cjs`（同目录）是 CommonJS 过渡版，仅支持基础诊断。**Ant 适配层 / testCase DSL / expect 断言仅 `local-browser-executor.js`（ES Module 版）支持。**
 
@@ -168,6 +178,9 @@ Agent / SKILL.md
 ### connect 模式（推荐）
 连接用户已启动的调试 Chrome，天然继承登录态/微前端环境。
 
+**connect 时自动解密凭据**：连接浏览器后，engine 自动检测 `--user-data-dir` 并解密所有保存的密码，
+结果缓存到 `~/.szcd-mcp/deps/decrypted-creds.json`。后续可直接用 `engine._credentials` 获取。
+
 用户一次性配置：
 ```bash
 # macOS
@@ -632,12 +645,12 @@ NODE_PATH=~/.szcd-mcp/deps/node_modules node "$SKILL_DIR/local-browser-executor.
 ## 依赖管理
 
 浏览器测试依赖采用**共享缓存 + 按需安装**方案：
-- `observe/act/assert/diagnose/screenshot` 主链路只安装 `puppeteer-core` 到 `~/.szcd-mcp/deps/`
+- 主链路（`observe/act/assert/diagnose/screenshot` + 凭据解密）安装 `puppeteer-core` + `sql.js` 到 `~/.szcd-mcp/deps/`
 - 只有执行设计稿像素对比 `compare` 时才安装 `pixelmatch/pngjs/sharp`
 - 后续所有项目共享复用，无需重复安装
 - 如果核心依赖自动安装失败，引导用户手动执行：
 ```bash
-cd ~/.szcd-mcp/deps && npm install --registry=https://registry.npmmirror.com puppeteer-core
+cd ~/.szcd-mcp/deps && npm install --registry=https://registry.npmmirror.com puppeteer-core sql.js
 ```
 - 如果视觉对比依赖自动安装失败，引导用户手动执行：
 ```bash
@@ -720,6 +733,133 @@ cd ~/.szcd-mcp/deps && npm install --registry=https://registry.npmmirror.com --@
    ```
    `runTask` 会自动从 `context.lastApiCapture` 拿菜单树，不需要再传文件。
 
+## 🔑 凭据解密（自动获取浏览器保存的密码）
+
+当测试需要登录但浏览器已保存密码时，使用内置的 `decrypt-creds.mjs` 自动从 Edge/Chrome 的密码管理器中解密凭据，**无需人工输入密码**。
+
+### 工作原理
+
+```
+Agent / SKILL.md
+  → $SKILL_DIR/lib/cdp-browser-config.js  自动检测浏览器 user-data-dir
+  → $SKILL_DIR/lib/decrypt-passwords.js    DPAPI + AES-GCM 解密 v10 密码
+  → $SKILL_DIR/decrypt-creds.mjs           CLI 入口（一键调用）
+  → 返回 { username, password, url }
+```
+
+### 前置条件
+
+- 浏览器以 `--remote-debugging-port=9222` 启动（CDP 已连接）
+- 浏览器以 `--user-data-dir=<path>` 指定了自定义数据目录（开发/测试环境常见）
+- 密码以 **v10 格式**存储（开发环境默认；生产环境 v20 需 Python 方案）
+- skill 目录下已安装 `sql.js`：`cd $SKILL_DIR && npm install sql.js`
+- 首次解密后结果自动缓存到 `~/.szcd-mcp/deps/decrypted-creds.json`，后续秒级返回
+
+### 使用方式
+
+```bash
+# 自动检测浏览器配置 + 解密所有凭据（使用共享缓存依赖）
+NODE_PATH=~/.szcd-mcp/deps/node_modules node "$SKILL_DIR/decrypt-creds.mjs" --url aicityos
+
+# 首次运行：全量解密 + 写入缓存（~/.szcd-mcp/deps/decrypted-creds.json）
+# 后续运行：秒级返回（自动检测 Login Data 修改时间判断缓存是否过期）
+
+# 强制刷新缓存（如手动修改了密码）
+NODE_PATH=~/.szcd-mcp/deps/node_modules node "$SKILL_DIR/decrypt-creds.mjs" --url aicityos --refresh
+
+# JSON 格式输出（供脚本解析）
+NODE_PATH=~/.szcd-mcp/deps/node_modules node "$SKILL_DIR/decrypt-creds.mjs" --url aicityos --json
+
+# 手动指定 user-data-dir（跳过自动检测）
+NODE_PATH=~/.szcd-mcp/deps/node_modules node "$SKILL_DIR/decrypt-creds.mjs" --user-data-dir "C:/EdgeDevSession" --url aicityos
+
+# 查看帮助
+NODE_PATH=~/.szcd-mcp/deps/node_modules node "$SKILL_DIR/decrypt-creds.mjs" --help
+```
+
+### 典型场景：SSO 登录自动化
+
+**⚠️ 强制流程：解密后必须先向用户澄清使用哪一个账号登录，禁止自动选择！**
+
+```bash
+# 1. 解密凭据（使用共享缓存依赖）
+CREDS=$(NODE_PATH=~/.szcd-mcp/deps/node_modules node "$SKILL_DIR/decrypt-creds.mjs" --url aicityos --json)
+
+# ❌ 错误：拿到第一个凭据就直接登录
+# USER=$(echo "$CREDS" | node -p "JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'))[0].username")
+
+# ✅ 正确：先把去重后的用户列表展示给用户，让用户选择
+# LLM 根据解密结果，用 AskUserQuestion 列出所有可用账号供用户选择：
+#   "解密到以下 X 个账号，请选择使用哪一个登录："
+#   - admin (密码: Jx***01#)
+#   - 18718576547 (密码: Jx***01#)
+#   - zengzhijie (密码: zen***123)
+#   ...
+# 用户选择后，再继续后续步骤
+
+# 2. 用户确认后，用选定的凭据构造登录 testCase
+cat > /tmp/login.json <<EOF
+{
+  "title": "自动登录",
+  "options": { "timeout": 30000 },
+  "steps": [
+    { "type": "antInput", "placeholder": "请输入账户", "value": "$USER" },
+    { "type": "antInput", "placeholder": "请输入密码", "value": "$PASS" },
+    { "type": "antInput", "placeholder": "请输入图形验证码", "value": "6" },
+    { "type": "act", "click": "text==登 录" }
+  ]
+}
+EOF
+
+# 3. 执行登录
+node "$EXECUTOR" --action plan --plan-file /tmp/login.json --url-contains "platform.aicityos.com" --wait 8000
+```
+
+**LLM 处理流程：**
+1. 调用 `decrypt-creds.mjs --json` 获取用户列表（首次慢，后续秒级缓存命中）
+2. 对凭据去重（同一用户名取首次出现的密码）
+3. **用 `AskUserQuestion` 列出所有可用账号（只展示完整用户名，不展示密码），让用户选择**
+4. 用户选择后，从解密结果中查找对应密码，构造登录 testCase
+5. 执行登录
+
+**⚠️ 强制约束：**
+- 只展示账号列表，**不展示密码**（含脱敏也不展示）
+- **展示完整账号**，不截断
+- **每次登录都向用户询问**，不自动选择
+
+**多账号切换场景（如测试不同角色权限）：**
+- 首次登录时一次性询问："本次测试需要用到哪些账号？"，用户可多选
+- 后续切换直接用缓存的选择，不再重复询问
+- 构造 testCase 时，用 `dataset` 数组参数化不同账号：
+```json
+{
+  "title": "多账号权限测试",
+  "dataset": [
+    { "user": "admin", "pwd": "Jx@shSmt01#" },
+    { "user": "18718576547", "pwd": "Jx@shSmt01#" }
+  ],
+  "steps": [
+    { "type": "cdpScript", "script": "logout" },
+    { "type": "cdpScript", "script": "login", "params": { "username": "{{user}}", "password": "{{pwd}}" } },
+    { "type": "act", "click": "text=提交", "waitAfterEach": 3000 }
+  ]
+}
+```
+
+### 技术栈（纯 Node.js，零原生编译）
+
+| 模块 | 功能 | 依赖 |
+|------|------|------|
+| `lib/cdp-browser-config.js` | 通过 wmic + CDP 自动获取 `--user-data-dir` | Node.js 内置 |
+| `lib/decrypt-passwords.js` | DPAPI 解密 AES 密钥 + AES-256-GCM 解密密码 | `sql.js`（共享缓存）+ `crypto` + PowerShell |
+| `decrypt-creds.mjs` | CLI 入口：检测配置 → 解密 → 输出 | 以上两者 |
+
+### 兼容性说明
+
+- ✅ **v10 格式**（开发/测试环境 Edge/Chrome）：完全支持
+- ❌ **v20 格式**（生产环境，App-Bound Encryption）：需 Python `pywin32` + `cryptography` 方案
+- ⚠️ Windows 专属（DPAPI），macOS/Linux 需 Keychain/KWallet 方案
+
 ## 反模式备忘（来自 6/17 + 6/18 实战反馈）
 
 | 错误做法 | 正确做法 | 原因 |
@@ -734,6 +874,76 @@ cd ~/.szcd-mcp/deps && npm install --registry=https://registry.npmmirror.com --@
 | 每个 Select 后忘记 `closeAllDropdowns` | `act` 自动检测上一次 antSelect/antTreeSelect 并预清理 | 下拉浮层残留会污染下一次 Select 操作，选项串选 |
 | 硬编码 `sleep(15*200)` 等选项渲染 | `antSelect` 内置 `pollEval` 15×200ms 轮询，`expect(poll)` 可自定义条件 | 选项渲染时间受网络/数据量影响，固定 sleep 时机不可靠 |
 | 表单校验用 ad-hoc evaluate 检查 | 用 `expect validation.toPass` 或 `formFill` 的 `validateAfter` | 语义断言自带 poll + 结构化错误信息（field + message），可直接进报告 |
+| 登录/登出写多步 antInput + act | 用 `cdpScript` 一次搞定：`{ "type": "cdpScript", "script": "login", "params": {...} }` | 已封装为内置脚本，自动处理 appId/viewId 参数保留和 cookie 清理 |
+| 登出后硬编码裸 URL 导航 | 从主 frame 提取 `appId`/`viewId` 构建完整登录 URL | 裸 URL 不会自动补充 SSO 参数，导致后续登录失败 |
+| CDP captureApi 请求数为 0 | 关闭 DevTools 后再用 `Network.enable` 监听 | DevTools 的 Network 面板会抢占 CDP Network 域，导致 captureApi 捕获不到请求 |
+
+## 🛡️ 测试健壮性三层架构（L1/L2/L3）
+
+每次 testCase 执行都会自动运行三层监控与恢复，无需额外配置：
+
+```
+testCase 执行
+  ├── L1 自动监控（每步内置）
+  │   ├── Runtime.exceptionThrown → browserErrors[]
+  │   ├── console.error → consoleErrors[]
+  │   └── Network.response ≥400 → failedRequests[]
+  │
+  ├── L2 智能诊断（失败时自动生成）
+  │   ├── 失败步骤定位（哪个 step/dataRow 失败）
+  │   ├── 网络错误归类（401/403/5xx 统计）
+  │   └── 推断建议（session 过期/验证码/服务器异常）
+  │
+  └── L3 自动修复（条件触发）
+      ├── 登录失败 → 刷新页面 + 重新登录（maxRetries 次）
+      ├── 元素未找到 → 等待渲染 + 重试
+      └── 网络错误 → 页面重载 + 重试
+```
+
+### testCase 新增选项
+
+```json
+{
+  "title": "测试",
+  "options": {
+    "autoRecover": true,        // 开启自动恢复（默认 true）
+    "autoRecoverRetries": 2     // 最大恢复重试次数（默认 2）
+  },
+  "steps": [...]
+}
+```
+
+### testCase 返回增强
+
+```json
+{
+  "passedSteps": 8,           // 最终通过数
+  "failedSteps": 0,           // 最终失败数
+  "browserErrors": [...],     // L1: JS 异常详情
+  "failedRequests": [...],    // L1: 4xx/5xx 请求列表
+  "consoleErrors": [...],     // L1: console.error 消息
+  "diagnosticHint": {         // L2: 诊断结果（仅失败时）
+    "failedAt": [...],
+    "suggestions": ["建议刷新登录页重试..."],
+    "summary": "1 个步骤失败, 0 个请求异常"
+  },
+  "autoRecovery": {           // L3: 恢复结果（仅触发时）
+    "strategies": [{"type": "login", "result": "success"}],
+    "recovered": true,
+    "retries": 2
+  }
+}
+```
+
+### cdpScript login 增强
+
+- `params.username` 必填，`params.password` 可选（自动从 `engine._credentials` 查找）
+- 内置验证码过期重试：失败时自动刷新页面重新填表（`params.maxRetries` 默认 3）
+- 自动处理 appId/viewId URL 参数
+
+```json
+{ "type": "cdpScript", "script": "login", "params": { "username": "admin" } }
+```
 
 ## Ant Design 适配层（6/22 反馈落地）
 
@@ -799,18 +1009,20 @@ node local-browser-executor.js --action test-case --test-case-file /tmp/case.jso
 |------|---------|---------|------|---------|
 | 1 | evaluate | 浏览器端 | DOM 查询/操作 | 简单检查、点击元素 |
 | 2 | rawScript | Node.js 端 | 完整 puppeteer API | 跨 frame、等待、多标签页 |
-| 3 | cdpScript | Node.js 端 | 调用已注册脚本 | 复用通用交互模式 |
-| 4 | 内置 cdpScript | Node.js 端 | 预定义通用 UI 交互 | Drawer/Modal/表格等 |
+| 3 | cdpScript | Node.js 端 | 调用内置或用户注册脚本 | 登录/登出/切换账号/抽屉/弹窗等通用交互 |
+| 4 | 内置 cdpScript | Node.js 端 | 预定义通用 UI 交互 + 凭据管理 | login/logout/getCredentials/drawer-action/modal-action/switch-tab/wait-api/get-table-data |
 
 **evaluate**：浏览器端执行 JS，只能操作 DOM，不能等待/跨 frame/调用 puppeteer
 **rawScript**：Node.js 端执行 async 函数，接收 `(page, frame, params, browser)`，可调用所有 puppeteer API
 **registerCdpScript**：注册可复用脚本，后续通过 cdpScript 步骤按 name 调用
-**cdpScript**：调用 registerCdpScript 注册的脚本或内置脚本
+**cdpScript**：调用内置脚本或用户注册脚本。内置脚本包括登录（支持自动查凭据+验证码重试）、登出（自动保留 appId/viewId）、凭据列表获取等
 
 ### 内置 cdpScript（通用 UI 交互模式）
 
 | script | 功能 | params |
 |--------|------|--------|
+| `login` | **自动登录**（填表+提交） | `username`, `password`, `captcha?`(默认6), `loginUrl?` |
+| `logout` | **登出**（清 cookie+跳转登录页） | `appUrl?`(默认/szc-ai-data/) |
 | `drawer-action` | Drawer 操作 | `action: 'search'\|'select'\|'confirm'\|'cancel'`, `radioIndex?`, `searchText?`, `searchPlaceholder?` |
 | `modal-action` | Modal/Popconfirm 操作 | `action: 'confirm'\|'cancel'`, `buttonText?` |
 | `switch-tab` | 多标签页切换 | `urlContains?`, `titleIncludes?`, `pageIndex?` |