@szc-ft/mcp-szcd-client 0.33.0 → 0.34.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@szc-ft/mcp-szcd-client",
-    "version": "0.33.0",
+    "version": "0.34.0",
     "description": "MCP client for szcd component library - auto-configures AI coding tools with MCP server, skills, agents and commands",
     "keywords": [
         "mcp",
@@ -22,6 +22,7 @@
     "bin": {
         "szcd-mcp-proxy": "mcp-proxy.js",
         "szcd-mcp-setup": "scripts/postinstall.js",
+        "szcd-mcp-install-shortcuts": "scripts/install-dev-shortcuts.js",
         "szcd-mcp-update-url": "scripts/update-mcp-url.js",
         "szcd-mcp-coding-config": "scripts/update-coding-config.js",
         "szcd-mcp-api-config": "scripts/update-api-config.js",
@@ -32,6 +33,7 @@
         "local-browser-executor.js",
         "lib/",
         "scripts/postinstall.js",
+        "scripts/install-dev-shortcuts.js",
         "scripts/update-mcp-url.js",
         "scripts/update-coding-config.js",
         "scripts/update-api-config.js",

package/qwen-extension/qwen-extension.json

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

package/scripts/install-dev-shortcuts.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * install-dev-shortcuts.js — 手动重跑 dev-browser 快捷方式安装的 CLI
+ *
+ * 用途：postinstall 静默失败时（特别是 Windows 中文系统、AV 拦截、ExecutionPolicy 等）
+ * 用户跑 `npx szcd-mcp-install-shortcuts` 单独重试并看到完整错误信息。
+ *
+ * 与 postinstall 调用同一个 setupDevBrowserShortcut；本 CLI 区别在于：
+ *   1. 进程退出码：失败时 exit 1（postinstall 是 exit 0 不阻塞 npm install）
+ *   2. 输出更详细：直接传入 process 的 stdout / stderr，不被 npm install 折叠
+ *   3. 文末汇总：成功/失败计数 + 每条失败的完整错误，便于贴回 issue
+ */
+
+import { setupDevBrowserShortcut } from "./lib/dev-browser-shortcut.js";
+
+console.log("============================================================");
+console.log("  szcd-mcp dev-browser DevSession shortcut installer");
+console.log("============================================================");
+console.log(`Platform: ${process.platform}`);
+console.log(`Node:     ${process.version}`);
+console.log("");
+
+const result = setupDevBrowserShortcut({});
+
+console.log("");
+console.log("============================================================");
+console.log("  Summary");
+console.log("============================================================");
+if (result.skipped) {
+    console.log("⚠️  No Chrome/Edge detected on this machine.");
+    console.log("    Install Google Chrome or Microsoft Edge, then re-run this command.");
+    process.exit(1);
+}
+
+const okCount = result.results.filter(r => r.ok).length;
+const total = result.results.length;
+console.log(`Installed: ${okCount}/${total}`);
+for (const r of result.results) {
+    if (r.ok) {
+        console.log(`  ✓ ${r.name}: ${r.path}`);
+    } else {
+        console.log(`  ✗ ${r.name}:`);
+        for (const line of String(r.error || "(unknown error)").split("\n")) {
+            console.log(`      ${line}`);
+        }
+    }
+}
+console.log("");
+
+process.exit(result.ok ? 0 : 1);

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

@@ -19,7 +19,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
-import { execSync } from "node:child_process";
+import { execSync, spawnSync } from "node:child_process";
 
 // 与 SKILL.md 第 186-191 行保持一致
 const CDP_PORT = 9222;
@@ -117,12 +117,40 @@ function installWindows(browser) {
     ].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 };
+
+    // 反馈 #18（2026-06-24, accuracy=1）：原先用
+    //   execSync('powershell ... -EncodedCommand ...', { stdio: 'ignore' })
+    // 在中文 Windows + 全局 npm install 场景下静默失败：execSync 经 cmd.exe /d /s /c
+    // 调用 PowerShell，中文 Windows 下 PowerShell 启动期向 stderr 写 CLIXML
+    // (progress/information record)，stdio:'ignore' 导致 stderr 写入失败，
+    // PowerShell 以 exit code 1 终止，CreateShortcut COM 调用未执行；
+    // 外层 try/catch 仅 console.warn，postinstall 整体仍成功，用户无法察觉。
+    //
+    // 修复：用 spawnSync 直接调 powershell.exe，绕开 cmd.exe；stderr/stdout 用 pipe
+    // 而不是 ignore，捕获真实失败信息以便排查。
+    const result = spawnSync(
+        "powershell.exe",
+        ["-NoProfile", "-ExecutionPolicy", "Bypass", "-EncodedCommand", encoded],
+        { stdio: ["ignore", "pipe", "pipe"], windowsHide: true }
+    );
+    if (result.error) {
+        return { ok: false, error: `spawn failed: ${result.error.message}` };
     }
+    if (result.status !== 0) {
+        const stderr = (result.stderr?.toString() || "").trim();
+        const stdout = (result.stdout?.toString() || "").trim();
+        return {
+            ok: false,
+            error: `powershell exit code ${result.status}` +
+                   (stderr ? `\n  stderr: ${stderr.slice(0, 400)}` : "") +
+                   (stdout ? `\n  stdout: ${stdout.slice(0, 200)}` : ""),
+        };
+    }
+    // 二次校验：文件实际存在再算成功
+    if (!fs.existsSync(lnkPath)) {
+        return { ok: false, error: `powershell exit 0 but ${lnkPath} not created` };
+    }
+    return { ok: true, path: lnkPath };
 }
 
 // 字符串 → UTF-8 bytes → base64，给 PowerShell 内联反序列化用
@@ -216,14 +244,15 @@ export function setupDevBrowserShortcut(deps = {}) {
             installLinux;
         for (const b of browsers) {
             const r = install(b);
-            results.push({ browser: b.id, ...r });
+            results.push({ browser: b.id, name: b.name, ...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}`);
+                console.warn(`⚠️  Failed to create ${b.name} DevSession shortcut:\n  ${r.error}`);
             }
         }
         const okCount = results.filter(r => r.ok).length;
+        const failCount = results.length - okCount;
         if (okCount > 0) {
             const dirHint = platform === "win32" ? "桌面 (Desktop)"
                 : platform === "darwin" ? "~/Applications/ (Launchpad / Spotlight)"
@@ -231,7 +260,16 @@ export function setupDevBrowserShortcut(deps = {}) {
             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 };
+        if (failCount > 0) {
+            // 醒目告警 + 手动重跑命令（反馈 #18 要求）
+            console.warn("");
+            console.warn("⚠️  ============================================================");
+            console.warn(`⚠️   ${failCount}/${results.length} dev-browser shortcut(s) failed to install.`);
+            console.warn("⚠️   Re-run the dedicated CLI to retry with full diagnostics:");
+            console.warn("⚠️     npx szcd-mcp-install-shortcuts");
+            console.warn("⚠️  ============================================================");
+        }
+        return { ok: okCount > 0 && failCount === 0, results, platform };
     } catch (e) {
         console.warn(`⚠️  setupDevBrowserShortcut error: ${e.message}`);
         return { ok: false, results, error: e.message };