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

package/README.md

@@ -4,8 +4,20 @@ szcd 组件库 MCP 客户端 — 自动配置 AI 编码工具的 MCP 服务器
 
 ## 安装
 
+### Windows 用户（推荐）
+
+不需要手动安装 Node.js / npm，下载并双击安装器：
+
+```text
+https://mcp.szcd-mcp.top/download?path=/scity/zengzhijie/mcp/downloads/SZCD-MCP-Setup.exe&key=3f4ec52f5137dbf2b458d87a28a3948ea88149b1d506e106
+```
+
+安装器会自动检查/安装 Node.js LTS，然后执行客户端安装与 IDE 配置。安装完成后请重启已打开的 IDE。
+
+### 开发者 / 已安装 Node.js 的用户
+
 ```bash
-npm install @szc-ft/mcp-szcd-client
+npm install -g @szc-ft/mcp-szcd-client
 ```
 
 安装后自动执行配置，支持以下 AI 编码工具：

package/opencode-extension/skills/local-browser-test/lib/browser-engine.js

@@ -2497,14 +2497,22 @@ export class BrowserEngine {
                         for (var k = 0; k < page.frames().length; k++) {
                             try {
                                 var fu = page.frames()[k].url();
-                                var am = fu.match(/appId=(\\d+)/);
-                                var vm = fu.match(/viewId=(\\d+)/);
+                                var am = fu.match(/appId=(\d+)/);
+                                var vm = fu.match(/viewId=(\d+)/);
                                 if (am) { appId = am[1]; if (vm) viewId = vm[1]; break; }
                             } catch (e) { /* skip */ }
                         }
                     } catch (e) { /* ignore */ }
                 }
-                var loginUrl = params.loginUrl || 'http://platform.aicityos.com:32222/ucenter/login/';
+                // 默认登录地址从当前页面 origin 推导，避免硬编码到其它环境
+                var loginUrl = params.loginUrl;
+                if (!loginUrl) {
+                    try {
+                        var curOrigin = new URL(page.url()).origin;
+                        if (curOrigin && curOrigin.indexOf('http') === 0) loginUrl = curOrigin + '/ucenter/login/';
+                    } catch (e) { /* ignore */ }
+                    if (!loginUrl) loginUrl = 'http://platform.aicityos.com:32222/ucenter/login/';
+                }
                 if (appId && viewId) loginUrl += '#/user/login?appId=' + appId + '&viewId=' + viewId;
 
                 // 尝试登录，验证码过期自动重试
@@ -2615,7 +2623,14 @@ export class BrowserEngine {
                 });
 
                 // 4. 构建带参数的登录 URL（保留 appId/viewId）
-                var loginUrl = 'http://platform.aicityos.com:32222/ucenter/login/';
+                var loginUrl = params.loginUrl;
+                if (!loginUrl) {
+                    try {
+                        var curOrigin = new URL(page.url()).origin;
+                        if (curOrigin && curOrigin.indexOf('http') === 0) loginUrl = curOrigin + '/ucenter/login/';
+                    } catch (e) { /* ignore */ }
+                    if (!loginUrl) loginUrl = 'http://platform.aicityos.com:32222/ucenter/login/';
+                }
                 if (appId && viewId) {
                     loginUrl += '#/user/login?appId=' + appId + '&viewId=' + viewId;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@szc-ft/mcp-szcd-client",
-    "version": "0.33.0",
+    "version": "0.34.1",
     "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.1",
     "description": "szcd 组件库 MCP 助手 — 查询组件信息、匹配需求、生成代码",
     "mcpServers": {
         "szcd-component-helper": {

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

@@ -2497,14 +2497,22 @@ export class BrowserEngine {
                         for (var k = 0; k < page.frames().length; k++) {
                             try {
                                 var fu = page.frames()[k].url();
-                                var am = fu.match(/appId=(\\d+)/);
-                                var vm = fu.match(/viewId=(\\d+)/);
+                                var am = fu.match(/appId=(\d+)/);
+                                var vm = fu.match(/viewId=(\d+)/);
                                 if (am) { appId = am[1]; if (vm) viewId = vm[1]; break; }
                             } catch (e) { /* skip */ }
                         }
                     } catch (e) { /* ignore */ }
                 }
-                var loginUrl = params.loginUrl || 'http://platform.aicityos.com:32222/ucenter/login/';
+                // 默认登录地址从当前页面 origin 推导，避免硬编码到其它环境
+                var loginUrl = params.loginUrl;
+                if (!loginUrl) {
+                    try {
+                        var curOrigin = new URL(page.url()).origin;
+                        if (curOrigin && curOrigin.indexOf('http') === 0) loginUrl = curOrigin + '/ucenter/login/';
+                    } catch (e) { /* ignore */ }
+                    if (!loginUrl) loginUrl = 'http://platform.aicityos.com:32222/ucenter/login/';
+                }
                 if (appId && viewId) loginUrl += '#/user/login?appId=' + appId + '&viewId=' + viewId;
 
                 // 尝试登录，验证码过期自动重试
@@ -2615,7 +2623,14 @@ export class BrowserEngine {
                 });
 
                 // 4. 构建带参数的登录 URL（保留 appId/viewId）
-                var loginUrl = 'http://platform.aicityos.com:32222/ucenter/login/';
+                var loginUrl = params.loginUrl;
+                if (!loginUrl) {
+                    try {
+                        var curOrigin = new URL(page.url()).origin;
+                        if (curOrigin && curOrigin.indexOf('http') === 0) loginUrl = curOrigin + '/ucenter/login/';
+                    } catch (e) { /* ignore */ }
+                    if (!loginUrl) loginUrl = 'http://platform.aicityos.com:32222/ucenter/login/';
+                }
                 if (appId && viewId) {
                     loginUrl += '#/user/login?appId=' + appId + '&viewId=' + viewId;
                 }

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/codex.js

@@ -23,6 +23,8 @@
  *   1. MCP：优先 spawn `codex mcp remove` 再 `codex mcp add`（CLI 自己做 TOML 合并 + 幂等）
  *   2. MCP fallback：找不到 `codex` 时直接写 config.toml（扁平 TOML，与 CLI 序列化一致）
  *   3. Skill：调用 deps.copySkill(...) 把 standard-skill/* 整目录拷到 ~/.agents/skills/
+ *   4. Command：Codex 无自定义命令目录，把 commands/*.md 转换为 Open Agent Skills：
+ *      ~/.agents/skills/<command-name>/SKILL.md
  */
 
 import fs from "node:fs";
@@ -201,6 +203,105 @@ function copySkillsToCodex(deps) {
     return { ok: results.every(r => r.ok), results, skillsRoot };
 }
 
+// ==================== Command → Skill 转换 ====================
+
+function getCommandsSourceDirectory(deps) {
+    return path.join(deps.PACKAGE_ROOT, "commands");
+}
+
+function copyCommandsAsSkillsToCodex(deps) {
+    const commandsSourceDir = getCommandsSourceDirectory(deps);
+    if (!fs.existsSync(commandsSourceDir)) {
+        console.log("⏭️  Skipping Codex command-to-skill install: commands source directory not found");
+        return { ok: true, skipped: true, results: [] };
+    }
+
+    const skillsRoot = getCodexSkillsDirectory();
+    const commandFiles = fs.readdirSync(commandsSourceDir).filter((f) => f.endsWith(".md"));
+    const results = [];
+
+    for (const commandFile of commandFiles) {
+        const sourcePath = path.join(commandsSourceDir, commandFile);
+        const commandName = path.basename(commandFile, ".md");
+        const skillDir = path.join(skillsRoot, commandName);
+        const destPath = path.join(skillDir, "SKILL.md");
+
+        try {
+            const sourceContent = fs.readFileSync(sourcePath, "utf8");
+            const skillContent = renderCommandAsSkill(commandName, sourceContent);
+            deps.ensureDirectory?.(skillDir) ?? fs.mkdirSync(skillDir, { recursive: true });
+
+            if (fs.existsSync(destPath)) {
+                const existingContent = fs.readFileSync(destPath, "utf8").trim();
+                if (existingContent !== skillContent.trim()) {
+                    console.log(`⏭️  Skipping Codex command skill "${commandName}": already exists with custom content`);
+                    results.push({ name: commandName, ok: false, skipped: true, path: skillDir });
+                    continue;
+                }
+            }
+
+            fs.writeFileSync(destPath, skillContent);
+            console.log(`✓ Converted command "${commandName}" to Codex skill (${skillDir})`);
+            results.push({ name: commandName, ok: true, path: skillDir });
+        } catch (e) {
+            console.warn(`⚠️  Failed to convert command "${commandName}" to Codex skill: ${e.message}`);
+            results.push({ name: commandName, ok: false, error: e.message });
+        }
+    }
+
+    return { ok: results.every(r => r.ok || r.skipped), results, skillsRoot };
+}
+
+function renderCommandAsSkill(commandName, sourceContent) {
+    const { metadata, body } = splitFrontmatter(sourceContent);
+    const description = metadata.description || `Codex skill converted from /${commandName}`;
+    const argumentHint = metadata["argument-hint"];
+    const lines = [
+        "---",
+        `name: ${yamlScalar(commandName)}`,
+        `description: ${yamlScalar(description)}`,
+        "---",
+        "",
+        `# /${commandName}`,
+        "",
+    ];
+
+    if (argumentHint) {
+        lines.push(`参数提示：\`${argumentHint}\``, "");
+    }
+
+    lines.push(body.trimStart());
+    return lines.join("\n").replace(/\n*$/, "\n");
+}
+
+function splitFrontmatter(content) {
+    const match = String(content).match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match) return { metadata: {}, body: String(content) };
+    return { metadata: parseSimpleYaml(match[1]), body: match[2] };
+}
+
+function parseSimpleYaml(yaml) {
+    const metadata = {};
+    for (const line of yaml.split(/\r?\n/)) {
+        const match = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+        if (!match) continue;
+        metadata[match[1]] = stripYamlScalar(match[2]);
+    }
+    return metadata;
+}
+
+function stripYamlScalar(value) {
+    const trimmed = String(value).trim();
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+
+function yamlScalar(value) {
+    return JSON.stringify(String(value));
+}
+
 // ==================== 主入口 ====================
 
 export function setupCodex(deps) {
@@ -223,7 +324,10 @@ export function setupCodex(deps) {
     // 3) Skill 复制（独立于 MCP 注册成败，文件操作本身基本不会失败）
     const skillResult = copySkillsToCodex(deps);
 
-    return { mcp: mcpResult, skill: skillResult };
+    // 4) Command 转 Skill（Codex 无自定义命令目录，使用 Open Agent Skills 承载入口）
+    const commandSkillResult = copyCommandsAsSkillsToCodex(deps);
+
+    return { mcp: mcpResult, skill: skillResult, commandSkill: commandSkillResult };
 }
 
 function registerMcpServers(ourServers) {

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 };

package/standard-skill/local-browser-test/lib/browser-engine.js

@@ -2497,14 +2497,22 @@ export class BrowserEngine {
                         for (var k = 0; k < page.frames().length; k++) {
                             try {
                                 var fu = page.frames()[k].url();
-                                var am = fu.match(/appId=(\\d+)/);
-                                var vm = fu.match(/viewId=(\\d+)/);
+                                var am = fu.match(/appId=(\d+)/);
+                                var vm = fu.match(/viewId=(\d+)/);
                                 if (am) { appId = am[1]; if (vm) viewId = vm[1]; break; }
                             } catch (e) { /* skip */ }
                         }
                     } catch (e) { /* ignore */ }
                 }
-                var loginUrl = params.loginUrl || 'http://platform.aicityos.com:32222/ucenter/login/';
+                // 默认登录地址从当前页面 origin 推导，避免硬编码到其它环境
+                var loginUrl = params.loginUrl;
+                if (!loginUrl) {
+                    try {
+                        var curOrigin = new URL(page.url()).origin;
+                        if (curOrigin && curOrigin.indexOf('http') === 0) loginUrl = curOrigin + '/ucenter/login/';
+                    } catch (e) { /* ignore */ }
+                    if (!loginUrl) loginUrl = 'http://platform.aicityos.com:32222/ucenter/login/';
+                }
                 if (appId && viewId) loginUrl += '#/user/login?appId=' + appId + '&viewId=' + viewId;
 
                 // 尝试登录，验证码过期自动重试
@@ -2615,7 +2623,14 @@ export class BrowserEngine {
                 });
 
                 // 4. 构建带参数的登录 URL（保留 appId/viewId）
-                var loginUrl = 'http://platform.aicityos.com:32222/ucenter/login/';
+                var loginUrl = params.loginUrl;
+                if (!loginUrl) {
+                    try {
+                        var curOrigin = new URL(page.url()).origin;
+                        if (curOrigin && curOrigin.indexOf('http') === 0) loginUrl = curOrigin + '/ucenter/login/';
+                    } catch (e) { /* ignore */ }
+                    if (!loginUrl) loginUrl = 'http://platform.aicityos.com:32222/ucenter/login/';
+                }
                 if (appId && viewId) {
                     loginUrl += '#/user/login?appId=' + appId + '&viewId=' + viewId;
                 }