mcp-probe-kit 1.13.0 → 1.15.1

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.
Files changed (46) hide show
  1. package/README.md +54 -3
  2. package/build/index.js +14 -1
  3. package/build/schemas/index.d.ts +108 -0
  4. package/build/schemas/index.js +2 -0
  5. package/build/schemas/ui-ux-schemas.d.ts +248 -0
  6. package/build/schemas/ui-ux-schemas.js +147 -0
  7. package/build/tools/__tests__/start_ui.integration.test.d.ts +6 -0
  8. package/build/tools/__tests__/start_ui.integration.test.js +179 -0
  9. package/build/tools/__tests__/start_ui.property.test.d.ts +6 -0
  10. package/build/tools/__tests__/start_ui.property.test.js +263 -0
  11. package/build/tools/__tests__/start_ui.unit.test.d.ts +6 -0
  12. package/build/tools/__tests__/start_ui.unit.test.js +109 -0
  13. package/build/tools/index.d.ts +4 -0
  14. package/build/tools/index.js +5 -0
  15. package/build/tools/init_component_catalog.d.ts +22 -0
  16. package/build/tools/init_component_catalog.js +809 -0
  17. package/build/tools/render_ui.d.ts +22 -0
  18. package/build/tools/render_ui.js +384 -0
  19. package/build/tools/start_ui.d.ts +25 -0
  20. package/build/tools/start_ui.js +299 -0
  21. package/build/tools/ui-ux-tools.d.ts +116 -0
  22. package/build/tools/ui-ux-tools.js +756 -0
  23. package/build/tools/ui-ux-tools.test.d.ts +6 -0
  24. package/build/tools/ui-ux-tools.test.js +132 -0
  25. package/build/utils/ascii-box-formatter.d.ts +29 -0
  26. package/build/utils/ascii-box-formatter.js +195 -0
  27. package/build/utils/bm25.d.ts +60 -0
  28. package/build/utils/bm25.js +139 -0
  29. package/build/utils/cache-manager.d.ts +65 -0
  30. package/build/utils/cache-manager.js +156 -0
  31. package/build/utils/design-reasoning-engine.d.ts +158 -0
  32. package/build/utils/design-reasoning-engine.js +363 -0
  33. package/build/utils/design-system-json-formatter.d.ts +41 -0
  34. package/build/utils/design-system-json-formatter.js +165 -0
  35. package/build/utils/ui-data-loader.d.ts +56 -0
  36. package/build/utils/ui-data-loader.js +164 -0
  37. package/build/utils/ui-search-engine.d.ts +57 -0
  38. package/build/utils/ui-search-engine.js +123 -0
  39. package/build/utils/ui-sync.d.ts +13 -0
  40. package/build/utils/ui-sync.js +241 -0
  41. package/docs/BEST_PRACTICES.md +257 -1
  42. package/docs/HOW_TO_TRIGGER.md +71 -1
  43. package/docs/MCP-Probe-Kit-/344/275/277/347/224/250/346/211/213/345/206/214.html +89 -29
  44. package/docs/MCP-Probe-Kit-/344/275/277/347/224/250/346/211/213/345/206/214.md +582 -1
  45. package/package.json +19 -6
  46. package/docs/HOW_TO_TRIGGER.html +0 -255
@@ -3,7 +3,7 @@
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>MCP Probe Kit 工具速查手册</title>
6
+ <title>MCP Probe Kit 工具速查手册 v1.15.0</title>
7
7
  <style>
8
8
  * {
9
9
  margin: 0;
@@ -119,27 +119,62 @@
119
119
  font-size: 7.5pt;
120
120
  color: #c7254e;
121
121
  }
122
+
123
+ .new-badge {
124
+ background: #28a745;
125
+ color: white;
126
+ padding: 1px 4px;
127
+ border-radius: 2px;
128
+ font-size: 7pt;
129
+ margin-left: 4px;
130
+ }
122
131
  </style>
123
132
  </head>
124
133
  <body>
125
- <h1>🛠️ MCP Probe Kit 工具速查手册 (43个工具)</h1>
134
+ <h1>🛠️ MCP Probe Kit 工具速查手册 v1.15.0 (49个工具)</h1>
126
135
 
127
- <h2>🎯 需求访谈工具(2个)🆕</h2>
136
+ <h2>🎨 UI/UX Pro Max 工具(3个)<span class="new-badge">新增</span></h2>
137
+ <div class="grid">
138
+ <div class="tool-card single-col">
139
+ <div class="tool-name">1. ui_design_system - 设计系统生成器</div>
140
+ <div class="tool-desc">基于 100 条行业规则的智能推荐,生成设计系统推荐和创作指导</div>
141
+ <div class="tool-example">💬 "帮我生成一个 React 设计系统" / "生成蓝色主题设计系统"</div>
142
+ <div class="tool-params">product_type: SaaS/E-commerce/Healthcare, stack: react/vue/nextjs, primary_color</div>
143
+ </div>
144
+
145
+ <div class="tool-card">
146
+ <div class="tool-name">2. ui_search - UI/UX 智能搜索</div>
147
+ <div class="tool-desc">搜索 UI 组件、颜色方案、图标、设计模式、最佳实践</div>
148
+ <div class="tool-example">💬 "我需要一个 React 的主按钮组件"</div>
149
+ <div class="tool-params">query(必填), category, stack, mode: search/catalog/template</div>
150
+ </div>
151
+
152
+ <div class="tool-card">
153
+ <div class="tool-name">3. sync_ui_data - 数据同步工具</div>
154
+ <div class="tool-desc">同步最新的 UI/UX 数据到本地缓存</div>
155
+ <div class="tool-example">💬 "检查 UI 数据更新" / "强制同步 UI 数据"</div>
156
+ <div class="tool-params">force: true/false, verbose: true/false</div>
157
+ </div>
158
+ </div>
159
+
160
+
161
+ <h2>🎯 需求访谈工具(2个)<span class="new-badge">新增</span></h2>
128
162
  <div class="grid">
129
163
  <div class="tool-card">
130
164
  <div class="tool-name">1. interview - 需求访谈模式</div>
131
165
  <div class="tool-desc">在开发前通过结构化访谈澄清需求,避免理解偏差</div>
132
- <div class="tool-example">示例: "interview 用户登录功能"</div>
133
- <div class="tool-params">参数: description(必填), context(可选)</div>
166
+ <div class="tool-example">💬 "interview 用户登录功能"</div>
167
+ <div class="tool-params">description(必填), context(可选)</div>
134
168
  </div>
135
169
 
136
170
  <div class="tool-card">
137
171
  <div class="tool-name">2. ask_user - AI 主动提问</div>
138
172
  <div class="tool-desc">AI 可在任何时候向用户提问,澄清不确定的信息</div>
139
- <div class="tool-example">示例: AI自动调用或"有什么需要确认的吗?"</div>
140
- <div class="tool-params">参数: question(必填), options(可选)</div>
173
+ <div class="tool-example">💬 AI自动调用或"有什么需要确认的吗?"</div>
174
+ <div class="tool-params">question(必填), options(可选)</div>
141
175
  </div>
142
176
  </div>
177
+
143
178
 
144
179
  <h2>📋 代码生成工具(12个)</h2>
145
180
  <div class="grid">
@@ -227,6 +262,7 @@
227
262
  <div class="tool-params">input: 图片URL/描述, framework</div>
228
263
  </div>
229
264
  </div>
265
+
230
266
 
231
267
  <h2>🔍 分析诊断工具(7个)</h2>
232
268
  <div class="grid">
@@ -279,6 +315,7 @@
279
315
  <div class="tool-params">project_path, max_depth, include_content</div>
280
316
  </div>
281
317
  </div>
318
+
282
319
 
283
320
  <h2>🔧 重构优化工具(6个)</h2>
284
321
  <div class="grid">
@@ -318,12 +355,13 @@
318
355
  </div>
319
356
 
320
357
  <div class="tool-card">
321
- <div class="tool-name">6. design2code</div>
322
- <div class="tool-desc">设计稿转前端代码</div>
323
- <div class="tool-example">💬 "根据这个设计稿生成代码"</div>
324
- <div class="tool-params">input: 图片URL/描述, framework, style_solution</div>
358
+ <div class="tool-name">6. css_order</div>
359
+ <div class="tool-desc">重排 CSS 属性顺序</div>
360
+ <div class="tool-example">💬 "整理这段 CSS 的属性顺序"</div>
361
+ <div class="tool-params">直接粘贴 CSS 代码</div>
325
362
  </div>
326
363
  </div>
364
+
327
365
 
328
366
  <h2>🎯 工作流编排工具(9个)- 自动化多步骤流程</h2>
329
367
  <div class="grid">
@@ -384,13 +422,38 @@
384
422
  </div>
385
423
 
386
424
  <div class="tool-card">
387
- <div class="tool-name">9. start_ralph 🆕</div>
425
+ <div class="tool-name">9. start_ralph <span class="new-badge">新增</span></div>
388
426
  <div class="tool-desc">Ralph Loop 循环开发 - 生成安全模式脚本 → 多轮迭代 → 自动保护</div>
389
427
  <div class="tool-example">💬 "start_ralph 实现用户登录功能"</div>
390
428
  <div class="tool-params">goal(必填), mode: safe/normal, max_iterations: 8, max_minutes: 25</div>
391
429
  </div>
392
430
  </div>
393
431
 
432
+ <h2>🎨 UI 开发编排工具(3个)<span class="new-badge">新增</span></h2>
433
+ <div class="grid">
434
+ <div class="tool-card single-col">
435
+ <div class="tool-name">1. start_ui - 统一 UI 开发编排 <span class="new-badge">优化</span></div>
436
+ <div class="tool-desc">智能文件检查 → 简洁指导输出 → 双模式支持(manual/auto)→ 安全字符串处理</div>
437
+ <div class="tool-example">💬 "生成一个登录页面" / "start_ui '电商商品列表' --mode=auto"</div>
438
+ <div class="tool-params">description(必填), framework: react/vue/html, mode: manual/auto</div>
439
+ </div>
440
+
441
+ <div class="tool-card">
442
+ <div class="tool-name">2. init_component_catalog</div>
443
+ <div class="tool-desc">生成组件目录,定义可用的 UI 组件</div>
444
+ <div class="tool-example">💬 "生成组件目录"</div>
445
+ <div class="tool-params">无需参数(自动读取设计系统)</div>
446
+ </div>
447
+
448
+ <div class="tool-card">
449
+ <div class="tool-name">3. render_ui</div>
450
+ <div class="tool-desc">将 JSON 模板渲染为最终代码</div>
451
+ <div class="tool-example">💬 "渲染 login-form.json"</div>
452
+ <div class="tool-params">template(必填), framework: react/vue/html</div>
453
+ </div>
454
+ </div>
455
+
456
+
394
457
  <h2>🏗️ 项目管理工具(5个)</h2>
395
458
  <div class="grid">
396
459
  <div class="tool-card">
@@ -429,7 +492,7 @@
429
492
  </div>
430
493
  </div>
431
494
 
432
- <h2>🛠️ 其他工具(4个)</h2>
495
+ <h2>🛠️ 其他工具(2个)</h2>
433
496
  <div class="grid">
434
497
  <div class="tool-card">
435
498
  <div class="tool-name">1. detect_shell</div>
@@ -444,25 +507,13 @@
444
507
  <div class="tool-example">💬 "初始化 Cursor 配置"</div>
445
508
  <div class="tool-params">project_path: 项目路径</div>
446
509
  </div>
447
-
448
- <div class="tool-card">
449
- <div class="tool-name">3. css_order</div>
450
- <div class="tool-desc">重排 CSS 属性顺序</div>
451
- <div class="tool-example">💬 "整理这段 CSS 的属性顺序"</div>
452
- <div class="tool-params">直接粘贴 CSS 代码</div>
453
- </div>
454
-
455
- <div class="tool-card">
456
- <div class="tool-name">4. gen_skill</div>
457
- <div class="tool-desc">生成 Agent Skills 文档</div>
458
- <div class="tool-example">💬 "生成技能文档" / "生成所有工具的文档"</div>
459
- <div class="tool-params">scope: all/basic/generation, tool_name, lang</div>
460
- </div>
461
510
  </div>
511
+
462
512
 
463
513
  <div class="tips">
464
514
  <strong>💡 使用技巧:</strong><br>
465
515
  • <strong>Interview 模式:</strong>需求不明确时先用 interview 访谈,再用 start_feature 开发<br>
516
+ • <strong>UI 开发:</strong>start_ui 提供 manual(步骤指导)和 auto(智能推理)两种模式<br>
466
517
  • <strong>组合使用:</strong>debug 定位 → fix 修复 | analyze_project 了解 → add_feature 添加<br>
467
518
  • <strong>工作流优先:</strong>复杂任务用 start_* 系列(自动编排),简单任务用单个工具(更快)<br>
468
519
  • <strong>提供完整信息:</strong>粘贴完整错误堆栈、提供代码上下文、描述清楚期望结果<br>
@@ -474,11 +525,20 @@
474
525
  • <strong>修 Bug:</strong>"修复这个 Bug:[错误信息]" → 自动分析定位修复测试<br>
475
526
  • <strong>新功能:</strong>"开发用户登录功能" → 自动生成规格估算工作量<br>
476
527
  • <strong>代码审查:</strong>"全面审查这段代码" → 质量+安全+性能综合分析<br>
477
- • <strong>发版准备:</strong>"准备发布 v1.2.0" → 自动生成 Changelog 和 PR 描述
528
+ • <strong>发版准备:</strong>"准备发布 v1.2.0" → 自动生成 Changelog 和 PR 描述<br>
529
+ • <strong>UI 开发:</strong>"start_ui '登录页面'" → 检查设计系统 → 生成组件 → 渲染代码
530
+ </div>
531
+
532
+ <div class="workflow" style="background: #e7f3ff; border-left-color: #2196f3;">
533
+ <strong>🎨 UI 开发完整流程(v1.15.0 优化):</strong><br>
534
+ 1. <strong>生成设计系统:</strong>ui_design_system --product_type="SaaS" --stack="react"<br>
535
+ 2. <strong>一键生成页面:</strong>start_ui "登录页面" (自动检查文件、提供步骤指导)<br>
536
+ 3. <strong>智能模式:</strong>start_ui "电商商品列表" --mode=auto (AI 自动推理参数)<br>
537
+ 4. <strong>批量生成:</strong>所有页面自动使用相同设计规范,样式完全统一 ✨
478
538
  </div>
479
539
 
480
540
  <div style="text-align: center; margin-top: 8px; font-size: 7.5pt; color: #999;">
481
- MCP Probe Kit 工具速查手册 | MCP工具: 42个 | 打印日期: <script>document.write(new Date().toLocaleDateString('zh-CN'))</script>
541
+ MCP Probe Kit 工具速查手册 v1.15.0 | 49个工具 (37基础 + 9编排 + 3 UI/UX) | 打印日期: 2026-01-25
482
542
  </div>
483
543
  </body>
484
544
  </html>