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

package/opencode-extension/skills/local-browser-test/SKILL.md

@@ -182,13 +182,21 @@ Agent / SKILL.md
 结果缓存到 `~/.szcd-mcp/deps/decrypted-creds.json`。后续可直接用 `engine._credentials` 获取。
 
 用户一次性配置：
+
+> 💡 **快捷方式自动创建**：`npm install @szc-ft/mcp-szcd-client` 时，postinstall 会自动检测本机
+> Chrome / Edge 并在系统应用启动器里创建一个 **"DevSession"** 快捷方式（不动主图标、独立 profile、
+> 默认 9222 端口）。双击该图标即可启动，下面命令仅作 fallback / 自定义参考。
+>
+> 落点：Windows 桌面 `.lnk`、macOS `~/Applications/<Name> DevSession.app`、
+> Linux `~/.local/share/applications/szcd-<id>-devsession.desktop`。
+
 ```bash
 # macOS
-open -a "Google Chrome" --args --remote-debugging-port=9222
+open -a "Google Chrome" --args --disable-features=RendererCodeIntegrity --disable-web-security --user-data-dir="$HOME/ChromeDevSession" --remote-debugging-port=9222
 # Linux
-google-chrome --remote-debugging-port=9222
+google-chrome --disable-features=RendererCodeIntegrity --disable-web-security --user-data-dir="$HOME/ChromeDevSession" --remote-debugging-port=9222
 # Windows
-"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222
+"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --disable-features=RendererCodeIntegrity --disable-web-security --user-data-dir="C:/EdgeDevSession" --remote-debugging-port=9222
 ```
 
 ### launch 模式（回退）

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@szc-ft/mcp-szcd-client",
-    "version": "0.31.0",
+    "version": "0.32.1",
     "description": "MCP client for szcd component library - auto-configures AI coding tools with MCP server, skills, agents and commands",
     "keywords": [
         "mcp",

package/qwen-extension/qwen-extension.json

@@ -1,6 +1,6 @@
 {
     "name": "szcd-component-helper",
-    "version": "0.31.0",
+    "version": "0.32.1",
     "description": "szcd 组件库 MCP 助手 — 查询组件信息、匹配需求、生成代码",
     "mcpServers": {
         "szcd-component-helper": {

package/qwen-extension/skills/local-browser-test/SKILL.md

@@ -182,13 +182,21 @@ Agent / SKILL.md
 结果缓存到 `~/.szcd-mcp/deps/decrypted-creds.json`。后续可直接用 `engine._credentials` 获取。
 
 用户一次性配置：
+
+> 💡 **快捷方式自动创建**：`npm install @szc-ft/mcp-szcd-client` 时，postinstall 会自动检测本机
+> Chrome / Edge 并在系统应用启动器里创建一个 **"DevSession"** 快捷方式（不动主图标、独立 profile、
+> 默认 9222 端口）。双击该图标即可启动，下面命令仅作 fallback / 自定义参考。
+>
+> 落点：Windows 桌面 `.lnk`、macOS `~/Applications/<Name> DevSession.app`、
+> Linux `~/.local/share/applications/szcd-<id>-devsession.desktop`。
+
 ```bash
 # macOS
-open -a "Google Chrome" --args --remote-debugging-port=9222
+open -a "Google Chrome" --args --disable-features=RendererCodeIntegrity --disable-web-security --user-data-dir="$HOME/ChromeDevSession" --remote-debugging-port=9222
 # Linux
-google-chrome --remote-debugging-port=9222
+google-chrome --disable-features=RendererCodeIntegrity --disable-web-security --user-data-dir="$HOME/ChromeDevSession" --remote-debugging-port=9222
 # Windows
-"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222
+"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --disable-features=RendererCodeIntegrity --disable-web-security --user-data-dir="C:/EdgeDevSession" --remote-debugging-port=9222
 ```
 
 ### launch 模式（回退）

package/scripts/lib/dev-browser-shortcut.js

@@ -0,0 +1,239 @@
+/**
+ * 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
+    // 注意：Arguments 字符串里含 "C:/..." 这种裸双引号；为彻底避开 shell 引号嵌套，
+    // 用 PowerShell -EncodedCommand：脚本块以 UTF-16LE 序列化后 base64 传入，
+    // 不再依赖 cmd / bash 的引号转义规则。
+    const psScript = [
+        `$s = (New-Object -ComObject WScript.Shell).CreateShortcut([System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String('${b64utf8(lnkPath)}')))`,
+        `$s.TargetPath = [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String('${b64utf8(browser.exe)}'))`,
+        `$s.Arguments = [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String('${b64utf8(args)}'))`,
+        `$s.WorkingDirectory = [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String('${b64utf8(path.dirname(browser.exe))}'))`,
+        `$s.IconLocation = [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String('${b64utf8(browser.exe + ",0")}'))`,
+        `$s.Description = [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String('${b64utf8(browser.name + " CDP dev mode (port " + CDP_PORT + ") — used by szcd local-browser-test")}'))`,
+        `$s.Save()`,
+    ].join("; ");
+    // -EncodedCommand 要求脚本块本身是 UTF-16LE base64
+    const encoded = Buffer.from(psScript, "utf16le").toString("base64");
+    try {
+        execSync(`powershell -NoProfile -ExecutionPolicy Bypass -EncodedCommand ${encoded}`, { stdio: "ignore" });
+        return { ok: true, path: lnkPath };
+    } catch (e) {
+        return { ok: false, error: e.message };
+    }
+}
+
+// 字符串 → UTF-8 bytes → base64，给 PowerShell 内联反序列化用
+function b64utf8(s) {
+    return Buffer.from(String(s), "utf8").toString("base64");
+}
+
+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);

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

@@ -182,13 +182,21 @@ Agent / SKILL.md
 结果缓存到 `~/.szcd-mcp/deps/decrypted-creds.json`。后续可直接用 `engine._credentials` 获取。
 
 用户一次性配置：
+
+> 💡 **快捷方式自动创建**：`npm install @szc-ft/mcp-szcd-client` 时，postinstall 会自动检测本机
+> Chrome / Edge 并在系统应用启动器里创建一个 **"DevSession"** 快捷方式（不动主图标、独立 profile、
+> 默认 9222 端口）。双击该图标即可启动，下面命令仅作 fallback / 自定义参考。
+>
+> 落点：Windows 桌面 `.lnk`、macOS `~/Applications/<Name> DevSession.app`、
+> Linux `~/.local/share/applications/szcd-<id>-devsession.desktop`。
+
 ```bash
 # macOS
-open -a "Google Chrome" --args --remote-debugging-port=9222
+open -a "Google Chrome" --args --disable-features=RendererCodeIntegrity --disable-web-security --user-data-dir="$HOME/ChromeDevSession" --remote-debugging-port=9222
 # Linux
-google-chrome --remote-debugging-port=9222
+google-chrome --disable-features=RendererCodeIntegrity --disable-web-security --user-data-dir="$HOME/ChromeDevSession" --remote-debugging-port=9222
 # Windows
-"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222
+"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --disable-features=RendererCodeIntegrity --disable-web-security --user-data-dir="C:/EdgeDevSession" --remote-debugging-port=9222
 ```
 
 ### launch 模式（回退）