@szc-ft/mcp-szcd-client 0.30.0 → 0.32.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/scripts/lib/dev-browser-shortcut.js

@@ -0,0 +1,230 @@
+/**
+ * dev-browser-shortcut.js — 为本地浏览器自动化创建"开发模式"快捷方式
+ *
+ * 目标：用户装包后无需手动敲 --remote-debugging-port=9222 等一长串参数，
+ * 双击快捷方式即可启动一个开 CDP + 独立 profile 的浏览器，配合 local-browser-test skill。
+ *
+ * 设计原则：
+ *   1. 不动用户主浏览器快捷方式 / Dock 图标 / 默认 profile
+ *   2. 同时检测 Chrome 和 Edge，找到几个就装几个（每个一个独立 profile）
+ *   3. 已存在的快捷方式覆盖（保持参数与 SKILL.md 同步），新版本能自动升级参数
+ *   4. 任何子步骤失败都只 warn，绝不让整个 postinstall 退出
+ *
+ * 三平台落点：
+ *   Windows: 用户桌面 .lnk（PowerShell + WScript.Shell COM）
+ *   Linux:   ~/.local/share/applications/<id>.desktop  + chmod +x（更新 desktop database 可选）
+ *   macOS:   ~/Applications/<Name> DevSession.app    （wrapper .app，bash 启动器）
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { execSync } from "node:child_process";
+
+// 与 SKILL.md 第 186-191 行保持一致
+const CDP_PORT = 9222;
+const COMMON_FLAGS = [
+    "--disable-features=RendererCodeIntegrity",
+    "--disable-web-security",
+    `--remote-debugging-port=${CDP_PORT}`,
+];
+
+// user-data-dir 与 SKILL.md 固定路径一致
+function getUserDataDir(browser, platform) {
+    if (platform === "win32") {
+        return browser === "edge" ? "C:/EdgeDevSession" : "C:/ChromeDevSession";
+    }
+    return path.join(os.homedir(), browser === "edge" ? "EdgeDevSession" : "ChromeDevSession");
+}
+
+// ============ 浏览器检测 ============
+
+function detectBrowsers(platform) {
+    const found = [];
+    if (platform === "win32") {
+        const candidates = [
+            { id: "edge", name: "Microsoft Edge", paths: [
+                "C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe",
+                "C:/Program Files/Microsoft/Edge/Application/msedge.exe",
+            ]},
+            { id: "chrome", name: "Google Chrome", paths: [
+                "C:/Program Files/Google/Chrome/Application/chrome.exe",
+                "C:/Program Files (x86)/Google/Chrome/Application/chrome.exe",
+                path.join(os.homedir(), "AppData/Local/Google/Chrome/Application/chrome.exe"),
+            ]},
+        ];
+        for (const c of candidates) {
+            const hit = c.paths.find(p => safeExists(p));
+            if (hit) found.push({ ...c, exe: hit });
+        }
+    } else if (platform === "darwin") {
+        const candidates = [
+            { id: "chrome", name: "Google Chrome",
+              app: "/Applications/Google Chrome.app",
+              exe: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" },
+            { id: "edge", name: "Microsoft Edge",
+              app: "/Applications/Microsoft Edge.app",
+              exe: "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge" },
+        ];
+        for (const c of candidates) {
+            if (safeExists(c.app)) found.push(c);
+        }
+    } else {
+        // linux
+        const candidates = [
+            { id: "chrome", name: "Google Chrome", cmds: ["google-chrome", "google-chrome-stable", "chromium", "chromium-browser"] },
+            { id: "edge", name: "Microsoft Edge", cmds: ["microsoft-edge", "microsoft-edge-stable"] },
+        ];
+        for (const c of candidates) {
+            const exe = c.cmds.map(which).find(Boolean);
+            if (exe) found.push({ id: c.id, name: c.name, exe });
+        }
+    }
+    return found;
+}
+
+function safeExists(p) {
+    try { return fs.existsSync(p); } catch { return false; }
+}
+
+function which(cmd) {
+    try {
+        const out = execSync(`command -v ${cmd}`, { stdio: ["ignore", "pipe", "ignore"] }).toString().trim();
+        return out || null;
+    } catch { return null; }
+}
+
+// ============ 平台实现 ============
+
+function installWindows(browser) {
+    const dataDir = getUserDataDir(browser.id, "win32");
+    const args = [`--user-data-dir="${dataDir}"`, ...COMMON_FLAGS].join(" ");
+    const desktop = path.join(os.homedir(), "Desktop");
+    const lnkPath = path.join(desktop, `${browser.name} DevSession.lnk`);
+
+    // PowerShell 创建 .lnk
+    // 注意：PowerShell -Command 参数里的双引号、反斜杠都得转义
+    const ps = [
+        `$s = (New-Object -ComObject WScript.Shell).CreateShortcut('${lnkPath.replace(/'/g, "''")}')`,
+        `$s.TargetPath = '${browser.exe.replace(/'/g, "''")}'`,
+        `$s.Arguments = '${args.replace(/'/g, "''")}'`,
+        `$s.WorkingDirectory = '${path.dirname(browser.exe).replace(/'/g, "''")}'`,
+        `$s.IconLocation = '${browser.exe.replace(/'/g, "''")},0'`,
+        `$s.Description = '${browser.name} CDP dev mode (port ${CDP_PORT}) — used by szcd local-browser-test'`,
+        `$s.Save()`,
+    ].join("; ");
+    try {
+        execSync(`powershell -NoProfile -ExecutionPolicy Bypass -Command "${ps}"`, { stdio: "ignore" });
+        return { ok: true, path: lnkPath };
+    } catch (e) {
+        return { ok: false, error: e.message };
+    }
+}
+
+function installMac(browser) {
+    const dataDir = getUserDataDir(browser.id, "darwin");
+    const appDir = path.join(os.homedir(), "Applications");
+    const wrapperApp = path.join(appDir, `${browser.name} DevSession.app`);
+    const macosDir = path.join(wrapperApp, "Contents", "MacOS");
+    const resourcesDir = path.join(wrapperApp, "Contents", "Resources");
+    const plistPath = path.join(wrapperApp, "Contents", "Info.plist");
+    const execName = "launch";
+    const execPath = path.join(macosDir, execName);
+
+    try {
+        fs.mkdirSync(macosDir, { recursive: true });
+        fs.mkdirSync(resourcesDir, { recursive: true });
+        const script = [
+            "#!/bin/bash",
+            `exec "${browser.exe}" --user-data-dir="${dataDir}" ${COMMON_FLAGS.join(" ")} "$@"`,
+            "",
+        ].join("\n");
+        fs.writeFileSync(execPath, script, { mode: 0o755 });
+        const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleExecutable</key><string>${execName}</string>
+  <key>CFBundleName</key><string>${browser.name} DevSession</string>
+  <key>CFBundleIdentifier</key><string>com.szc-ft.${browser.id}-devsession</string>
+  <key>CFBundlePackageType</key><string>APPL</string>
+  <key>CFBundleVersion</key><string>1</string>
+  <key>LSUIElement</key><false/>
+</dict>
+</plist>
+`;
+        fs.writeFileSync(plistPath, plist);
+        return { ok: true, path: wrapperApp };
+    } catch (e) {
+        return { ok: false, error: e.message };
+    }
+}
+
+function installLinux(browser) {
+    const dataDir = getUserDataDir(browser.id, "linux");
+    const dir = path.join(os.homedir(), ".local", "share", "applications");
+    const file = path.join(dir, `szcd-${browser.id}-devsession.desktop`);
+    const content = [
+        "[Desktop Entry]",
+        "Version=1.0",
+        "Type=Application",
+        `Name=${browser.name} DevSession`,
+        `Comment=${browser.name} with CDP port ${CDP_PORT} and isolated profile — used by szcd local-browser-test`,
+        `Exec=${browser.exe} --user-data-dir=${dataDir} ${COMMON_FLAGS.join(" ")} %U`,
+        "Terminal=false",
+        "Categories=Development;WebBrowser;",
+        `Icon=${browser.id === "edge" ? "microsoft-edge" : "google-chrome"}`,
+        "StartupNotify=true",
+        "",
+    ].join("\n");
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(file, content, { mode: 0o644 });
+        fs.chmodSync(file, 0o755);
+        // 更新 desktop database（非必须，失败不影响）
+        try { execSync(`update-desktop-database "${dir}"`, { stdio: "ignore" }); } catch {}
+        return { ok: true, path: file };
+    } catch (e) {
+        return { ok: false, error: e.message };
+    }
+}
+
+// ============ 主入口 ============
+
+export function setupDevBrowserShortcut(deps = {}) {
+    const platform = process.platform;
+    const results = [];
+
+    try {
+        const browsers = detectBrowsers(platform);
+        if (browsers.length === 0) {
+            console.log("⚠️  No Chrome/Edge detected — skipping dev-browser shortcut.");
+            return { ok: false, results, skipped: true };
+        }
+        const install =
+            platform === "win32" ? installWindows :
+            platform === "darwin" ? installMac :
+            installLinux;
+        for (const b of browsers) {
+            const r = install(b);
+            results.push({ browser: b.id, ...r });
+            if (r.ok) {
+                console.log(`✓ Created ${b.name} DevSession shortcut: ${r.path}`);
+            } else {
+                console.warn(`⚠️  Failed to create ${b.name} DevSession shortcut: ${r.error}`);
+            }
+        }
+        const okCount = results.filter(r => r.ok).length;
+        if (okCount > 0) {
+            const dirHint = platform === "win32" ? "桌面 (Desktop)"
+                : platform === "darwin" ? "~/Applications/ (Launchpad / Spotlight)"
+                : "应用菜单 (Activities)";
+            console.log(`\n💡 Double-click the "DevSession" shortcut in ${dirHint} to start a CDP-enabled browser`);
+            console.log(`   on port ${CDP_PORT} with an isolated profile, then re-run your local-browser-test plan.`);
+        }
+        return { ok: okCount > 0, results };
+    } catch (e) {
+        console.warn(`⚠️  setupDevBrowserShortcut error: ${e.message}`);
+        return { ok: false, results, error: e.message };
+    }
+}

package/scripts/postinstall.js

@@ -24,6 +24,7 @@ import { setupClaudeCode } from "./lib/claude-code.js";
 import { setupOpenCode } from "./lib/opencode.js";
 import { setupQwenCode } from "./lib/qwen-code.js";
 import { setupQoder } from "./lib/qoder.js";
+import { setupDevBrowserShortcut } from "./lib/dev-browser-shortcut.js";
 
 // 递归守卫在 common.js 加载时已执行
 // 超时保护在 common.js 中已初始化
@@ -227,6 +228,10 @@ function main() {
         console.log("\n🔧 Setting up Qoder CLI compatibility...\n");
         const qoderResult = setupQoder(deps);
 
+        // ---- Dev Browser Shortcut（local-browser-test 一键启动） ----
+        console.log("\n🔧 Setting up dev-browser shortcut for local-browser-test...\n");
+        setupDevBrowserShortcut(deps);
+
         showSuccessMessage(traeResult, claudeResult, qwenResult, qoderResult, openCodeResult);
     } catch (error) {
         console.error("\n❌ Error during installation:", error.message);