@szc-ft/mcp-szcd-client 0.34.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.34.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",

package/qwen-extension/qwen-extension.json

@@ -1,6 +1,6 @@
 {
     "name": "szcd-component-helper",
-    "version": "0.34.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/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/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;
                 }