@szc-ft/mcp-szcd-client 0.11.1 → 0.11.3

package/agents/szcd-component-expert.md

@@ -36,7 +36,7 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 
 ## 工作流程
 
-### 第一步：工具自检（重要）
+### 第一步：工具自检
 
 **在正式开始之前，先确认 MCP 工具可用。**
 
@@ -46,7 +46,7 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 
 ### 第二步：理解需求
 
-分析用户要实现的页面或功能：
+分析用户要实现的页面或功能，梳理以下维度：
 
 1. **页面布局类型**: 左右布局 / 上下布局 / 表单页 / 详情页
 2. **查询条件**: 有哪些搜索字段，每个字段的类型
@@ -55,6 +55,12 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 5. **左侧树**: 是否需要，树的数据来源
 6. **弹窗/抽屉**: 新增/编辑用的弹窗或抽屉
 
+**交互节点**：如果用户描述的信息不够明确，**必须主动向用户追问**缺失的关键信息，不要自行假设：
+- 信息不足时，列出需要确认的问题，逐项向用户提问
+- 布局类型不明确时，询问"页面是左右布局还是上下布局？"并提供选项
+- 查询字段不完整时，询问"还需要哪些搜索条件？"
+- 缺少交互细节时，询问"编辑操作用弹窗还是抽屉？"并提供选项
+
 ### 第三步：分析设计稿（兜底/代理）
 
 当用户提供了设计稿图片，且**用户使用的 LLM 不支持图片理解**时，调用视觉代理工具代为"看图"：
@@ -87,9 +93,13 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 - 日期选择 → Cover 层 `DatePicker` 或 Query 的 valueType: 'datePicker'
 - 树选择 → Query 的 valueType: 'treeSelect'
 
-### 第五步：匹配组件
+### 第五步：匹配组件并确认方案
+
+根据需求描述和组件的 useCases/description 匹配最合适的组件，形成组件方案。
 
-根据需求描述和组件的 useCases/description 匹配最合适的组件。
+**交互节点**：向用户展示匹配结果，**必须确认方案后再生成代码**：
+- 列出选用的组件及理由、页面布局结构、备选方案
+- 询问用户是否同意此方案，或有调整需求
 
 ### 第六步：生成代码
 
@@ -102,6 +112,11 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 - ProTable/ProForm 等使用 valueType 配置列/字段类型
 - 复合组件配合 TemplateMode 使用实现标准页面布局
 
+**交互节点**：代码生成后，主动询问用户是否需要调整：
+- "代码已生成，是否需要调整样式或交互细节？"
+- "是否需要补充表单校验规则？"
+- "是否需要添加批量操作功能？"
+
 ## 典型页面模式
 
 ### 模式1: 左右布局 + 查询 + 表格（最常见）
@@ -145,3 +160,4 @@ ProForm / ProFormWrapper
 - 优先推荐复合组件和模板组件，它们封装了常用业务逻辑
 - 如果 MCP 工具调用失败，使用 Read/Grep 直接查阅源码中的类型定义
 - 用简体中文回复
+- 关键决策点要与用户确认，不要自作主张

package/commands/szcd-mcp-coding-config.md

@@ -0,0 +1,42 @@
+---
+description: 管理CODING Issue工具的默认配置（baseUrl/projectId/account）
+argument-hint: <get|set|clear> [--baseUrl=xxx] [--projectId=yyy] [--account=zzz]
+---
+
+请帮我管理 szcd MCP 的 CODING 默认配置。
+
+**交互流程**：
+
+1. **向用户询问要执行的操作**，提供以下选项：
+   - "查看配置" → 执行 get
+   - "设置配置" → 执行 set（需进一步追问参数）
+   - "清除配置" → 执行 clear
+
+2. **根据用户选择执行**：
+
+   - **查看配置**：直接执行 `npx szcd-mcp-coding-config get`
+
+   - **设置配置**：逐项向用户询问以下参数，选项中提供当前值作为默认，用户也可自由输入新值：
+     - CODING_BASE_URL — CODING 基础地址，如 `http://e-kjr1wok.coding.smartcitysz.work`
+     - CODING_DEFAULT_PROJECT_ID — 默认项目 ID，如 `907`
+     - CODING_ACCOUNT — 默认账号（邮箱）
+     收集完参数后执行：
+     ```bash
+     npx szcd-mcp-coding-config set --baseUrl="<baseUrl>" --projectId="<projectId>" --account="<account>"
+     ```
+
+   - **清除配置**：确认后执行 `npx szcd-mcp-coding-config clear`
+
+3. **命令回退**：如果 npx 不可用，依次尝试：
+   - `node $(npm root -g)/@szc-ft/mcp-szcd-client/scripts/update-coding-config.js <args>`
+   - `node /scity/zengzhijie/szcd/mcp/szcd-mcp-client/scripts/update-coding-config.js <args>`
+
+**配置字段说明**：
+- `CODING_BASE_URL` — CODING 基础地址
+- `CODING_DEFAULT_PROJECT_ID` — 默认项目 ID
+- `CODING_ACCOUNT` — 默认账号（邮箱）
+
+配置保存在 `~/.szcd-mcp-config.json` 中，设置后 `coding_fetch_issue` 工具可省略 `baseUrl` 和 `projectId` 参数。
+
+当前配置:
+!`cat ~/.szcd-mcp-config.json 2>/dev/null | grep -E "CODING|MCP_SERVER" || echo "配置文件不存在或无 CODING 配置"`

package/commands/szcd-mcp-url.md

@@ -5,21 +5,33 @@ argument-hint: <new-mcp-server-url>
 
 请帮我更新 szcd MCP 服务器地址。
 
-**使用方式**：
-- 输入 URL 参数（如 `$1`）：用该 URL 更新配置文件并同步 IDE
-- 不输入 URL：用配置文件 `~/.szcd-mcp-config.json` 中已有的 MCP_SERVER_URL 同步 IDE 配置
+**交互流程**：
 
-执行以下命令：
+1. **向用户询问要执行的操作**，提供以下选项：
+   - "更新服务器地址" → 输入新 URL 并同步所有 IDE 配置
+   - "同步现有配置" → 用 `~/.szcd-mcp-config.json` 中已有的 MCP_SERVER_URL 重新同步 IDE 配置
+   - "查看当前配置" → 显示当前 MCP 服务器地址
 
-1. 运行更新脚本：
-   - 优先: `npx szcd-mcp-update-url "$1"`
-   - 若 npx 不可用: `node $(npm root -g)/@szc-ft/mcp-szcd-component-helper/scripts/update-mcp-url.js "$1"`
-   - 若全局安装也不可用: `node /scity/zengzhijie/szcd/mcp/szcd-component-helper/scripts/update-mcp-url.js "$1"`
+2. **根据用户选择执行**：
 
-2. 如果脚本执行失败，请手动执行以下步骤：
-   a. 编辑 `~/.szcd-mcp-config.json`，将 MCP_SERVER_URL 改为目标 URL
-   b. 如果 trae-cli 可用：`trae-cli mcp remove szcd-component-helper && trae-cli mcp add-json szcd-component-helper '{"type":"sse","url":"<目标URL>/sse"}'`
-   c. 如果 claude 可用：`claude mcp remove --scope user szcd-component-helper && claude mcp add --transport sse --scope user szcd-component-helper <目标URL>/sse`
+   - **更新服务器地址**：向用户询问新的 MCP 服务器 URL，可提供常用地址选项，用户也可自由输入。收集到 URL 后执行：
+     ```bash
+     npx szcd-mcp-update-url "<newUrl>"
+     ```
+
+   - **同步现有配置**：直接执行（不带参数）：
+     ```bash
+     npx szcd-mcp-update-url
+     ```
+
+   - **查看当前配置**：显示 `~/.szcd-mcp-config.json` 中的 MCP_SERVER_URL
+
+3. **命令回退**：如果 npx 不可用，依次尝试：
+   - `node $(npm root -g)/@szc-ft/mcp-szcd-client/scripts/update-mcp-url.js "<newUrl>"`
+   - `node /scity/zengzhijie/szcd/mcp/szcd-mcp-client/scripts/update-mcp-url.js "<newUrl>"`
+   - 手动步骤：编辑 `~/.szcd-mcp-config.json`，再逐个 IDE 同步：
+     - trae-cli: `trae-cli mcp remove szcd-component-helper && trae-cli mcp add-json szcd-component-helper '{"type":"sse","url":"<URL>/sse"}'`
+     - claude: `claude mcp remove --scope user szcd-component-helper && claude mcp add --transport sse --scope user szcd-component-helper <URL>/sse`
 
 当前配置:
 !`cat ~/.szcd-mcp-config.json 2>/dev/null || echo "配置文件不存在"`

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@szc-ft/mcp-szcd-client",
-    "version": "0.11.1",
+    "version": "0.11.3",
     "description": "MCP client for szcd component library - connects to remote MCP server via SSE or stdio proxy",
     "keywords": [
         "mcp",
@@ -21,12 +21,14 @@
     "bin": {
         "szcd-mcp-proxy": "mcp-proxy.js",
         "szcd-mcp-setup": "scripts/postinstall.js",
-        "szcd-mcp-update-url": "scripts/update-mcp-url.js"
+        "szcd-mcp-update-url": "scripts/update-mcp-url.js",
+        "szcd-mcp-coding-config": "scripts/update-coding-config.js"
     },
     "files": [
         "mcp-proxy.js",
         "scripts/postinstall.js",
         "scripts/update-mcp-url.js",
+        "scripts/update-coding-config.js",
         "scripts/lib/",
         "standard-skill/",
         "skill/",

package/scripts/update-coding-config.js

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+
+/**
+ * szcd-mcp-coding-config - 管理 CODING Issue 获取工具的默认配置
+ *
+ * 用法:
+ *   npx szcd-mcp-coding-config get                    查看当前 CODING 配置
+ *   npx szcd-mcp-coding-config set --baseUrl=xxx       设置 CODING 基础地址
+ *   npx szcd-mcp-coding-config set --projectId=xxx     设置默认项目 ID
+ *   npx szcd-mcp-coding-config set --account=xxx       设置默认账号
+ *   npx szcd-mcp-coding-config set --cookies=xxx       设置浏览器 Cookie
+ *   npx szcd-mcp-coding-config set --password=xxx      设置密码
+ *   npx szcd-mcp-coding-config set --baseUrl=xxx --projectId=yyy --cookies=zzz  批量设置
+ *   npx szcd-mcp-coding-config clear                   清除所有 CODING 配置
+ *
+ * 配置保存在 ~/.szcd-mcp-config.json 中，字段名：
+ *   CODING_BASE_URL              — CODING 基础地址
+ *   CODING_DEFAULT_PROJECT_ID    — 默认项目 ID
+ *   CODING_ACCOUNT               — 默认账号（邮箱）
+ *   CODING_COOKIES               — 浏览器 Cookie 字符串（敏感）
+ *   CODING_PASSWORD              — 密码（敏感）
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+
+// ==================== 工具函数 ====================
+
+function getHomeDir() {
+    if (os.platform() === "win32") {
+        return process.env.USERPROFILE || process.env.HOME || os.homedir();
+    }
+    return process.env.HOME || os.homedir();
+}
+
+function getConfigFilePath() {
+    return path.join(getHomeDir(), ".szcd-mcp-config.json");
+}
+
+function loadConfig() {
+    const configPath = getConfigFilePath();
+    try {
+        if (fs.existsSync(configPath)) {
+            return JSON.parse(fs.readFileSync(configPath, "utf8"));
+        }
+    } catch (error) {
+        console.error(`❌ Failed to read config: ${error.message}`);
+    }
+    return {};
+}
+
+function saveConfig(config) {
+    const configPath = getConfigFilePath();
+    try {
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+        return true;
+    } catch (error) {
+        console.error(`❌ Failed to write config: ${error.message}`);
+        return false;
+    }
+}
+
+function maskValue(value) {
+    if (!value) return "(未设置)";
+    if (value.length <= 6) return "***";
+    return value.substring(0, 4) + "***";
+}
+
+function parseArgs(argv) {
+    const args = { action: null, baseUrl: null, projectId: null, account: null, cookies: null, password: null };
+    const positional = [];
+
+    for (let i = 2; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const eqIdx = arg.indexOf("=");
+            if (eqIdx !== -1) {
+                const key = arg.slice(2, eqIdx);
+                const value = arg.slice(eqIdx + 1);
+                if (key === "baseUrl" || key === "base-url") args.baseUrl = value;
+                if (key === "projectId" || key === "project-id") args.projectId = value;
+                if (key === "account") args.account = value;
+                if (key === "cookies") args.cookies = value;
+                if (key === "password") args.password = value;
+            }
+        } else {
+            positional.push(arg);
+        }
+    }
+
+    args.action = positional[0] || "get";
+    return args;
+}
+
+// ==================== 命令实现 ====================
+
+function cmdGet() {
+    const config = loadConfig();
+
+    console.log(`\n📋 CODING 配置 (${getConfigFilePath()})\n`);
+    console.log(`  CODING_BASE_URL           : ${config.CODING_BASE_URL || "(未设置)"}`);
+    console.log(`  CODING_DEFAULT_PROJECT_ID : ${config.CODING_DEFAULT_PROJECT_ID || "(未设置)"}`);
+    console.log(`  CODING_ACCOUNT            : ${config.CODING_ACCOUNT || "(未设置)"}`);
+    console.log(`  CODING_COOKIES            : ${maskValue(config.CODING_COOKIES)}`);
+    console.log(`  CODING_PASSWORD           : ${maskValue(config.CODING_PASSWORD)}`);
+    console.log(`\n💡 配置后，coding_fetch_issue 工具可省略所有参数直接获取 Issue。`);
+    console.log(`   用法: npx szcd-mcp-coding-config set --baseUrl=xxx --projectId=yyy --cookies=xxx\n`);
+}
+
+function cmdSet(baseUrl, projectId, account, cookies, password) {
+    const config = loadConfig();
+    let changed = false;
+
+    if (baseUrl) {
+        const old = config.CODING_BASE_URL || "(未设置)";
+        config.CODING_BASE_URL = baseUrl;
+        console.log(`  CODING_BASE_URL           : ${old} → ${baseUrl}`);
+        changed = true;
+    }
+    if (projectId) {
+        const old = config.CODING_DEFAULT_PROJECT_ID || "(未设置)";
+        config.CODING_DEFAULT_PROJECT_ID = projectId;
+        console.log(`  CODING_DEFAULT_PROJECT_ID : ${old} → ${projectId}`);
+        changed = true;
+    }
+    if (account) {
+        const old = config.CODING_ACCOUNT || "(未设置)";
+        config.CODING_ACCOUNT = account;
+        console.log(`  CODING_ACCOUNT            : ${old} → ${account}`);
+        changed = true;
+    }
+    if (cookies) {
+        const old = maskValue(config.CODING_COOKIES);
+        config.CODING_COOKIES = cookies;
+        console.log(`  CODING_COOKIES            : ${old} → ${maskValue(cookies)}`);
+        changed = true;
+    }
+    if (password) {
+        const old = maskValue(config.CODING_PASSWORD);
+        config.CODING_PASSWORD = password;
+        console.log(`  CODING_PASSWORD           : ${old} → ${maskValue(password)}`);
+        changed = true;
+    }
+
+    if (!changed) {
+        console.log("\n⚠️  未提供任何要设置的参数。用法:");
+        console.log("   npx szcd-mcp-coding-config set --baseUrl=xxx --projectId=yyy --account=zzz --cookies=xxx --password=yyy\n");
+        return false;
+    }
+
+    if (saveConfig(config)) {
+        console.log(`\n✅ 配置已保存。`);
+        console.log(`   CODING_BASE_URL           : ${config.CODING_BASE_URL || "(未设置)"}`);
+        console.log(`   CODING_DEFAULT_PROJECT_ID : ${config.CODING_DEFAULT_PROJECT_ID || "(未设置)"}`);
+        console.log(`   CODING_ACCOUNT            : ${config.CODING_ACCOUNT || "(未设置)"}`);
+        console.log(`   CODING_COOKIES            : ${maskValue(config.CODING_COOKIES)}`);
+        console.log(`   CODING_PASSWORD           : ${maskValue(config.CODING_PASSWORD)}\n`);
+        return true;
+    }
+    console.log("\n❌ 保存配置失败。\n");
+    return false;
+}
+
+function cmdClear() {
+    const config = loadConfig();
+    const hadBaseUrl = !!config.CODING_BASE_URL;
+    const hadProjectId = !!config.CODING_DEFAULT_PROJECT_ID;
+    const hadAccount = !!config.CODING_ACCOUNT;
+    const hadCookies = !!config.CODING_COOKIES;
+    const hadPassword = !!config.CODING_PASSWORD;
+
+    if (!hadBaseUrl && !hadProjectId && !hadAccount && !hadCookies && !hadPassword) {
+        console.log("\n⏭️  没有 CODING 配置需要清除。\n");
+        return false;
+    }
+
+    delete config.CODING_BASE_URL;
+    delete config.CODING_DEFAULT_PROJECT_ID;
+    delete config.CODING_ACCOUNT;
+    delete config.CODING_COOKIES;
+    delete config.CODING_PASSWORD;
+
+    if (saveConfig(config)) {
+        console.log("\n✅ 已清除 CODING 配置。\n");
+        return true;
+    }
+    console.log("\n❌ 清除配置失败。\n");
+    return false;
+}
+
+// ==================== 帮助信息 ====================
+
+function printHelp() {
+    console.log(`
+Usage: npx szcd-mcp-coding-config <command> [options]
+
+Commands:
+  get                          查看当前 CODING 配置
+  set [options]                设置 CODING 配置项
+  clear                        清除所有 CODING 配置
+
+Options for 'set':
+  --baseUrl=<url>              CODING 基础地址，如 http://e-kjr1wok.coding.smartcitysz.work
+  --projectId=<id>             默认项目 ID，如 907
+  --account=<email>            默认账号（邮箱）
+  --cookies=<string>           浏览器 Cookie 字符串（敏感）
+  --password=<string>          CODING 密码（敏感）
+
+Examples:
+  npx szcd-mcp-coding-config get
+  npx szcd-mcp-coding-config set --baseUrl=http://e-kjr1wok.coding.smartcitysz.work --projectId=907
+  npx szcd-mcp-coding-config set --cookies="enterprise_domain=xxx; cf=xxx; XSRF-TOKEN=xxx"
+  npx szcd-mcp-coding-config set --baseUrl=xxx --projectId=yyy --cookies=zzz --password=www
+  npx szcd-mcp-coding-config clear
+
+Config file: ~/.szcd-mcp-config.json
+`);
+}
+
+// ==================== 主函数 ====================
+
+function main() {
+    const args = parseArgs(process.argv);
+
+    if (args.action === "help" || args.action === "-h" || args.action === "--help") {
+        printHelp();
+        process.exit(0);
+    }
+
+    if (args.action === "get") {
+        cmdGet();
+    } else if (args.action === "set") {
+        const ok = cmdSet(args.baseUrl, args.projectId, args.account, args.cookies, args.password);
+        process.exit(ok ? 0 : 1);
+    } else if (args.action === "clear") {
+        const ok = cmdClear();
+        process.exit(ok ? 0 : 1);
+    } else {
+        console.error(`❌ Unknown command: ${args.action}`);
+        printHelp();
+        process.exit(1);
+    }
+}
+
+main();