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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -34,7 +34,7 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库,采用分层
34
34
 
35
35
  ## 工作流程
36
36
 
37
- ### 第一步:工具自检(重要)
37
+ ### 第一步:工具自检
38
38
 
39
39
  **在正式开始之前,先确认 MCP 工具可用。**
40
40
 
@@ -44,7 +44,7 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库,采用分层
44
44
 
45
45
  ### 第二步:理解需求
46
46
 
47
- 分析用户要实现的页面或功能:
47
+ 分析用户要实现的页面或功能,梳理以下维度:
48
48
 
49
49
  1. **页面布局类型**: 左右布局 / 上下布局 / 表单页 / 详情页
50
50
  2. **查询条件**: 有哪些搜索字段,每个字段的类型
@@ -53,6 +53,12 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库,采用分层
53
53
  5. **左侧树**: 是否需要,树的数据来源
54
54
  6. **弹窗/抽屉**: 新增/编辑用的弹窗或抽屉
55
55
 
56
+ **交互节点**:如果用户描述的信息不够明确,**必须主动向用户追问**缺失的关键信息,不要自行假设:
57
+ - 信息不足时,列出需要确认的问题,逐项向用户提问
58
+ - 布局类型不明确时,询问"页面是左右布局还是上下布局?"并提供选项
59
+ - 查询字段不完整时,询问"还需要哪些搜索条件?"
60
+ - 缺少交互细节时,询问"编辑操作用弹窗还是抽屉?"并提供选项
61
+
56
62
  ### 第三步:分析设计稿(兜底/代理)
57
63
 
58
64
  当用户提供了设计稿图片,且**用户使用的 LLM 不支持图片理解**时,调用视觉代理工具代为"看图":
@@ -85,9 +91,13 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库,采用分层
85
91
  - 日期选择 → Cover 层 `DatePicker` 或 Query 的 valueType: 'datePicker'
86
92
  - 树选择 → Query 的 valueType: 'treeSelect'
87
93
 
88
- ### 第五步:匹配组件
94
+ ### 第五步:匹配组件并确认方案
95
+
96
+ 根据需求描述和组件的 useCases/description 匹配最合适的组件,形成组件方案。
89
97
 
90
- 根据需求描述和组件的 useCases/description 匹配最合适的组件。
98
+ **交互节点**:向用户展示匹配结果,**必须确认方案后再生成代码**:
99
+ - 列出选用的组件及理由、页面布局结构、备选方案
100
+ - 询问用户是否同意此方案,或有调整需求
91
101
 
92
102
  ### 第六步:生成代码
93
103
 
@@ -100,6 +110,11 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库,采用分层
100
110
  - ProTable/ProForm 等使用 valueType 配置列/字段类型
101
111
  - 复合组件配合 TemplateMode 使用实现标准页面布局
102
112
 
113
+ **交互节点**:代码生成后,主动询问用户是否需要调整:
114
+ - "代码已生成,是否需要调整样式或交互细节?"
115
+ - "是否需要补充表单校验规则?"
116
+ - "是否需要添加批量操作功能?"
117
+
103
118
  ## 典型页面模式
104
119
 
105
120
  ### 模式1: 左右布局 + 查询 + 表格(最常见)
@@ -143,3 +158,4 @@ ProForm / ProFormWrapper
143
158
  - 优先推荐复合组件和模板组件,它们封装了常用业务逻辑
144
159
  - 如果 MCP 工具调用失败,使用 Read/Grep 直接查阅源码中的类型定义
145
160
  - 用简体中文回复
161
+ - 关键决策点要与用户确认,不要自作主张
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@szc-ft/mcp-szcd-client",
3
- "version": "0.11.3",
3
+ "version": "0.11.5",
4
4
  "description": "MCP client for szcd component library - connects to remote MCP server via SSE or stdio proxy",
5
5
  "keywords": [
6
6
  "mcp",
@@ -41,8 +41,9 @@
41
41
  "node": ">=18"
42
42
  },
43
43
  "scripts": {
44
- "postinstall": "node scripts/postinstall.js --quick",
45
- "setup": "node scripts/postinstall.js"
44
+ "postinstall": "node scripts/postinstall.js",
45
+ "setup": "node scripts/postinstall.js",
46
+ "setup:quick": "node scripts/postinstall.js --quick"
46
47
  },
47
48
  "dependencies": {
48
49
  "@modelcontextprotocol/sdk": "^1.29.0"