@szc-ft/mcp-szcd-client 0.12.2 → 0.13.0

package/agents/build.js

@@ -333,7 +333,7 @@ function build() {
             mcpServers: {
                 [platformsConfig.mcpServerName]: {
                     type: qwenConfig.mcp.type,
-                    url: qwenConfig.mcp.url,
+                    httpUrl: qwenConfig.mcp.httpUrl,
                 },
             },
             contextFileName: "QWEN.md",
@@ -352,7 +352,7 @@ function build() {
         };
 
         fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 4) + "\n");
-        console.log(`    ✓ Generated qwen-extension.json (type: ${qwenConfig.mcp.type}, url: ${qwenConfig.mcp.url})`);
+        console.log(`    ✓ Generated qwen-extension.json (type: ${qwenConfig.mcp.type}, httpUrl: ${qwenConfig.mcp.httpUrl})`);
     }
 
     console.log("\n✅ Agent build complete!");

package/agents/platforms.json

@@ -44,7 +44,7 @@
             "toolPrefix": "",
             "mcp": {
                 "type": "http",
-                "url": "http://localhost:3456/mcp"
+                "httpUrl": "http://localhost:3456/mcp"
             }
         }
     }

package/agents/qwen-extension/agents/szcd-component-expert.md

@@ -78,27 +78,15 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 
 **这一步是核心，必须实际调用 MCP 工具查询，禁止凭记忆猜测 API。**
 
-使用 MCP 工具获取组件信息和 API：
-
-- `get_component_library_overview` — 获取全部组件概览（含功能描述和适用场景）
-- `search_all_components` — 按关键词搜索组件
-- `get_other_component` / `get_cover_component` — 获取组件详情和 Props
-- `get_accurate_component_doc` — 获取复合组件的透传机制
-- `search_component_examples` — 搜索组件使用示例
-- `read_file` — 读取组件源码（必要时）
-
-**映射规则**:
-- 页面布局 → `TemplateMode`
-- 查询表单 → `Query`（通过 config 配置字段）
-- 数据表格 → `TableOrList`
-- 左侧树 → `LeftTree`
-- 弹窗/抽屉 → `ModelOrDrawer`
-- 返回标题 → `TitleAndBack`
-- 按钮 → Cover 层 `Button`
-- 输入框 → Cover 层 `Input` 或 Query 的 valueType: 'input'
-- 下拉选择 → Cover 层 `Select` 或 Query 的 valueType: 'select'
-- 日期选择 → Cover 层 `DatePicker` 或 Query 的 valueType: 'datePicker'
-- 树选择 → Query 的 valueType: 'treeSelect'
+使用 MCP 工具获取组件信息和 API，**优先使用 Repowiki 语义搜索工具**：
+
+- `search_components_semantic` — 基于 Repowiki 知识库的语义搜索，用自然语言描述匹配最适合的组件（**优先使用**）
+- `get_component_full_profile` — 一站式获取组件全景画像。`name` 支持逗号分隔批量查询（如 `"Query,TableOrList"`），`depth="deep"` 获取 Props 链 + 源码摘要 + 样式注入，**返回值是紧凑 Markdown 格式**（**推荐首选，一次调用替代多次查询**）
+- `get_component_dependencies` — 查询组件依赖关系图，确认 hooks 和插槽关系
+- `get_best_practices` — 获取组件使用最佳实践，指定 scenario 可获取组合最佳实践（如"左树右表页面"）
+- `get_style_injection_guide` — 查询组件样式注入方法，获取 CSS 覆盖路径和分配策略
+- `read_file` — 读取组件源码（deep 模式信息不足时）
+- `api_tool` — 拉取 API 文档（自动识别 YApi/Swagger）或联调测试接口
 
 
 ### 步骤5：匹配组件并确认方案（必做）
@@ -126,6 +114,44 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 - "是否需要补充表单校验规则？"
 - "是否需要添加批量操作功能？"
 
+### 步骤7：收集用户反馈（必做，质量闭环）
+
+代码生成完成后，**必须**向用户收集反馈，用于优化 MCP 工具行为：
+
+1. **询问准确率评分**："请对本次生成的代码准确性评分（1-5 分，5 分最准确）？"
+2. **询问是否采纳**："您是否计划采纳本次生成的代码？"
+3. **如拒绝，询问原因**："未采纳的原因是什么？（如：组件不匹配、API 错误、缺少功能、不符合设计稿等）"
+4. **调用 `submit_feedback` 提交反馈**：
+
+```
+参数示例：
+{
+  "sessionId": "<当前会话ID或时间戳>",
+  "toolsUsed": ["search_components_semantic", "get_component_full_profile", ...],
+  "userQuery": "<用户的原始需求描述>",
+  "generatedCodeSummary": "<生成代码的摘要或关键组件列表>",
+  "accuracyRating": <1-5>,
+  "adopted": <true/false>,
+  "rejectionReason": "<拒绝原因，如采纳则为空>",
+  "contextSnapshot": {
+    "matchedComponents": ["Query", "TableOrList", "TemplateMode"],
+    "layoutType": "LeftRight",
+    "queryFields": ["name", "status", "date"]
+  },
+  "toolType": "<trae|claude|qwen|qoder|cursor|vscode>"
+}
+```
+
+**toolType 映射规则**：
+- Trae CLI / Trae IDE → `"trae"`
+- Claude Code / Claude Desktop → `"claude"`
+- Qwen Code / 通义灵码 → `"qwen"`
+- Qoder CLI → `"qoder"`
+- Cursor → `"cursor"`
+- VS Code + Cline / Continue → `"vscode"`
+- 其他 → `"generic"`
+
+
 ## 典型页面模式
 
 ### 模式1: 左右布局 + 查询 + 表格（最常见）

package/agents/src/szcd-component-expert.md

@@ -75,8 +75,8 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 
 | 任务类型 | 判断条件 | 流程 |
 |---------|---------|------|
-| **简单查询** | 只查组件信息/API/示例，不涉及代码生成 | 快速流程（步骤1→4→6） |
-| **页面生成** | 需要根据需求/设计稿生成页面代码 | 完整流程（步骤1→2→3→4→5→6） |
+| **简单查询** | 只查组件信息/API/示例，不涉及代码生成 | 快速流程（步骤1→4→6→7） |
+| **页面生成** | 需要根据需求/设计稿生成页面代码 | 完整流程（步骤1→2→3→4→5→6→7） |
 
 ---
 <!-- /INCLUDE:enhanced -->
@@ -159,44 +159,41 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 **这一步是核心，必须实际调用 MCP 工具查询，禁止凭记忆猜测 API。**
 
 <!-- EXCLUDE:enhanced -->
-使用 MCP 工具获取组件信息和 API：
-
-- `{{TOOL:get_component_library_overview}}` — 获取全部组件概览（含功能描述和适用场景）
-- `{{TOOL:search_all_components}}` — 按关键词搜索组件
-- `{{TOOL:get_other_component}}` / `{{TOOL:get_cover_component}}` — 获取组件详情和 Props
-- `{{TOOL:get_accurate_component_doc}}` — 获取复合组件的透传机制
-- `{{TOOL:search_component_examples}}` — 搜索组件使用示例
-- `{{TOOL:read_file}}` — 读取组件源码（必要时）
-
-**映射规则**:
-- 页面布局 → `TemplateMode`
-- 查询表单 → `Query`（通过 config 配置字段）
-- 数据表格 → `TableOrList`
-- 左侧树 → `LeftTree`
-- 弹窗/抽屉 → `ModelOrDrawer`
-- 返回标题 → `TitleAndBack`
-- 按钮 → Cover 层 `Button`
-- 输入框 → Cover 层 `Input` 或 Query 的 valueType: 'input'
-- 下拉选择 → Cover 层 `Select` 或 Query 的 valueType: 'select'
-- 日期选择 → Cover 层 `DatePicker` 或 Query 的 valueType: 'datePicker'
-- 树选择 → Query 的 valueType: 'treeSelect'
+使用 MCP 工具获取组件信息和 API，**优先使用 Repowiki 语义搜索工具**：
+
+- `{{TOOL:search_components_semantic}}` — 基于 Repowiki 知识库的语义搜索，用自然语言描述匹配最适合的组件（**优先使用**）
+- `{{TOOL:get_component_full_profile}}` — 一站式获取组件全景画像。`name` 支持逗号分隔批量查询（如 `"Query,TableOrList"`），`depth="deep"` 获取 Props 链 + 源码摘要 + 样式注入，**返回值是紧凑 Markdown 格式**（**推荐首选，一次调用替代多次查询**）
+- `{{TOOL:get_component_dependencies}}` — 查询组件依赖关系图，确认 hooks 和插槽关系
+- `{{TOOL:get_best_practices}}` — 获取组件使用最佳实践，指定 scenario 可获取组合最佳实践（如"左树右表页面"）
+- `{{TOOL:get_style_injection_guide}}` — 查询组件样式注入方法，获取 CSS 覆盖路径和分配策略
+- `{{TOOL:read_file}}` — 读取组件源码（deep 模式信息不足时）
+- `{{TOOL:api_tool}}` — 拉取 API 文档（自动识别 YApi/Swagger）或联调测试接口
+
 <!-- /EXCLUDE:enhanced -->
 
 <!-- INCLUDE:enhanced -->
 按以下顺序查询：
 
-1. **确认组合关系**：调用 `{{TOOL:get_component_dependencies}}` 获取核心组件的依赖图，确认：
+1. **语义搜索匹配**：调用 `{{TOOL:search_components_semantic}}` 用自然语言描述搜索最匹配的组件（**优先使用**）
+
+2. **批量获取全景画像**：调用 `{{TOOL:get_component_full_profile}}` 获取组件全景画像。关键用法：
+   - `name` 支持逗号分隔批量查询（如 `"Query,TableOrList,LeftTree"`），一次调用替代多次查询
+   - `depth="deep"` 获取 Props 链 + 源码摘要 + 样式注入信息
+   - `depth="standard"` 获取完整 Props 表格 + 依赖 + 示例
+   - **返回值是紧凑 Markdown 格式**，直接阅读即可
+
+3. **确认组合关系**：调用 `{{TOOL:get_component_dependencies}}` 获取核心组件的依赖图，确认：
    - 必选组件和 hooks（如 TreeQueryTable 需要 LeftTree + Query + TableOrList + useLeftTree + useTable）
    - 插槽组件（如 CustomOption 是 LeftTree 的插槽）
    - 检查 `llmMappingHints` 是否有针对当前组件的常见错误修正
 
-2. **获取组件详情**：对每个目标组件调用：
-   - `{{TOOL:get_other_component}}` / `{{TOOL:get_cover_component}}`
-   - `{{TOOL:get_accurate_component_doc}}`
+4. **组合最佳实践**（可选）：调用 `{{TOOL:get_best_practices}}`（scenario="页面场景描述"）获取页面级组件组合最佳实践
+
+5. **样式注入**（可选）：调用 `{{TOOL:get_style_injection_guide}}` 获取样式覆盖方式和 CSS 穿透路径
 
-3. **搜索使用示例**：调用 `{{TOOL:search_component_examples}}`
+6. **读取源码**（仅在 deep 模式信息不足时）：调用 `{{TOOL:read_file}}` 读取具体源码文件确认行为
 
-4. **如有疑问**：用 `{{TOOL:read_file}}` 读取组件源码确认
+7. **API 联调**（如需要后端接口）：调用 `{{TOOL:api_tool}}`（action="fetch" 拉取文档，action="test" 联调测试）
 <!-- /INCLUDE:enhanced -->
 
 <!-- INCLUDE:full -->
@@ -238,7 +235,7 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 <!-- /INCLUDE:enhanced -->
 
 <!-- INCLUDE:full -->
-**交互节点**：通过 AskUserQuestion 工具向用户确认：
+**交互节点**：向用户确认：
 - "以上组件方案是否合适？是否需要调整？"
 - 提供选项：同意方案 / 需要调整 / 换一个方案
 <!-- /INCLUDE:full -->
@@ -270,7 +267,50 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 - "代码已生成，是否需要调整样式或交互细节？"
 - "是否需要补充表单校验规则？"
 - "是否需要添加批量操作功能？"
+<!-- /EXCLUDE:enhanced -->
+
+### 步骤7：收集用户反馈（必做，质量闭环）
+
+代码生成完成后，**必须**向用户收集反馈，用于优化 MCP 工具行为：
+
+1. **询问准确率评分**："请对本次生成的代码准确性评分（1-5 分，5 分最准确）？"
+2. **询问是否采纳**："您是否计划采纳本次生成的代码？"
+3. **如拒绝，询问原因**："未采纳的原因是什么？（如：组件不匹配、API 错误、缺少功能、不符合设计稿等）"
+4. **调用 `{{TOOL:submit_feedback}}` 提交反馈**：
 
+```
+参数示例：
+{
+  "sessionId": "<当前会话ID或时间戳>",
+  "toolsUsed": ["search_components_semantic", "get_component_full_profile", ...],
+  "userQuery": "<用户的原始需求描述>",
+  "generatedCodeSummary": "<生成代码的摘要或关键组件列表>",
+  "accuracyRating": <1-5>,
+  "adopted": <true/false>,
+  "rejectionReason": "<拒绝原因，如采纳则为空>",
+  "contextSnapshot": {
+    "matchedComponents": ["Query", "TableOrList", "TemplateMode"],
+    "layoutType": "LeftRight",
+    "queryFields": ["name", "status", "date"]
+  },
+  "toolType": "<trae|claude|qwen|qoder|cursor|vscode>"
+}
+```
+
+**toolType 映射规则**：
+- Trae CLI / Trae IDE → `"trae"`
+- Claude Code / Claude Desktop → `"claude"`
+- Qwen Code / 通义灵码 → `"qwen"`
+- Qoder CLI → `"qoder"`
+- Cursor → `"cursor"`
+- VS Code + Cline / Continue → `"vscode"`
+- 其他 → `"generic"`
+
+<!-- INCLUDE:enhanced -->
+**注意**：此步骤不阻塞用户后续操作，即使反馈提交失败也不影响已生成的代码。
+<!-- /INCLUDE:enhanced -->
+
+<!-- EXCLUDE:enhanced -->
 ## 典型页面模式
 
 ### 模式1: 左右布局 + 查询 + 表格（最常见）
@@ -318,10 +358,11 @@ ProForm / ProFormWrapper
 
 ## 快速流程（简单查询类任务）
 
-仅执行步骤1→4→6，跳过需求分析和方案确认：
+仅执行步骤1→4→6→7，跳过需求分析和方案确认：
 1. **架构认知 + 自检** — 同步骤1
 2. **查询组件** — 按需查询目标组件（含依赖验证）
 3. **输出结果** — 直接返回组件信息/API/示例
+4. **收集反馈** — 同步骤7（如生成了代码则收集反馈）
 
 ---
 

package/agents/src/tools.json

@@ -5,108 +5,68 @@
         "whenToUse": "步骤1：架构认知"
     },
     {
-        "name": "get_component_dependencies",
-        "description": "查询组件依赖关系图（依赖谁/被谁依赖）",
-        "whenToUse": "步骤4：确认组合关系"
-    },
-    {
-        "name": "get_other_component",
-        "description": "获取复合组件详情（路径、Props、透传目标、示例）",
-        "whenToUse": "步骤4：获取组件详情"
+        "name": "search_components_semantic",
+        "description": "基于Repowiki知识库的语义搜索，用自然语言描述匹配最适合的组件",
+        "whenToUse": "步骤4：语义搜索匹配"
     },
     {
-        "name": "get_cover_component",
-        "description": "获取 Cover 层组件详情（Props、透传目标、准确文档）",
-        "whenToUse": "步骤4：获取 Cover 组件"
+        "name": "get_component_full_profile",
+        "description": "一站式获取组件全景画像。name支持逗号分隔批量查询，depth=deep获取Props链+源码摘要+样式注入，返回值是紧凑Markdown格式",
+        "whenToUse": "步骤4：批量获取全景画像"
     },
     {
-        "name": "get_accurate_component_doc",
-        "description": "获取组件准确Props文档（含透传机制）",
-        "whenToUse": "步骤4：确认透传机制"
-    },
-    {
-        "name": "search_component_examples",
-        "description": "搜索组件使用示例",
-        "whenToUse": "步骤4：查找示例"
+        "name": "get_component_dependencies",
+        "description": "查询组件依赖关系图（依赖谁/被谁依赖/hooks依赖）",
+        "whenToUse": "步骤4：确认组合关系"
     },
     {
-        "name": "search_all_components",
-        "description": "全局搜索组件（支持按类型筛选）",
-        "whenToUse": "查找组件时"
+        "name": "get_best_practices",
+        "description": "获取组件使用最佳实践和常见错误修正，指定scenario可获取组合最佳实践",
+        "whenToUse": "步骤4：组合最佳实践"
     },
     {
-        "name": "resolve_props_chain",
-        "description": "递归解析组件完整 Props 链",
-        "whenToUse": "需要完整 Props 时"
+        "name": "get_style_injection_guide",
+        "description": "查询组件样式注入方法、CSS穿透路径、优先级和反模式",
+        "whenToUse": "步骤5：样式注入"
     },
     {
         "name": "read_file",
-        "description": "读取仓库内文件",
-        "whenToUse": "需要查看源码时"
+        "description": "读取仓库内文件（组件源码/文档），组件源码无长度限制",
+        "whenToUse": "步骤6：读取源码确认"
     },
     {
         "name": "analyze_design_image",
-        "description": "分析设计稿图片（三通道提取）",
+        "description": "分析UI设计稿，提取Token配置、CSS覆盖样式、视觉细节，支持pixel_perfect模式",
         "whenToUse": "步骤3：分析设计稿"
     },
     {
-        "name": "get_style_injection_guide",
-        "description": "查询组件样式注入方法",
-        "whenToUse": "生成代码时需要注入样式"
+        "name": "api_tool",
+        "description": "统一API工具：自动识别YApi/Swagger拉取API文档、联调测试、配置管理",
+        "whenToUse": "API联调"
     },
     {
-        "name": "list_antd_components",
-        "description": "列出 Ant Design 组件分类概览",
-        "whenToUse": "需要了解 antd 组件分类时"
+        "name": "coding_fetch_issue",
+        "description": "获取CODING Issue（缺陷/需求）详情，支持URL自动解析",
+        "whenToUse": "获取需求详情"
     },
     {
-        "name": "list_antd_components_by_category",
-        "description": "按分类列出 Ant Design 组件",
-        "whenToUse": "按分类查找 antd 组件时"
+        "name": "coding_config",
+        "description": "查看或设置CODING默认配置（baseUrl/projectId/账号/Cookie）",
+        "whenToUse": "配置CODING连接"
     },
     {
         "name": "get_antd_component",
-        "description": "获取 Ant Design 组件详细信息",
-        "whenToUse": "需要底层 antd 组件时"
-    },
-    {
-        "name": "list_pro_components",
-        "description": "列出 ProComponents 组件分类概览",
-        "whenToUse": "需要了解 Pro 组件分类时"
-    },
-    {
-        "name": "list_pro_components_by_category",
-        "description": "按分类列出 ProComponents 组件",
-        "whenToUse": "按分类查找 Pro 组件时"
+        "description": "获取Ant Design组件详细信息（中文名、描述、API文档、Props列表）",
+        "whenToUse": "需要底层antd组件时"
     },
     {
         "name": "get_pro_component",
-        "description": "获取 ProComponents 组件详细信息",
-        "whenToUse": "需要 Pro 组件详情时"
-    },
-    {
-        "name": "swagger_fetch_apis",
-        "description": "获取 Swagger API 列表",
-        "whenToUse": "需要 API 联调时"
-    },
-    {
-        "name": "swagger_test_api",
-        "description": "测试 Swagger API 接口",
-        "whenToUse": "需要测试 API 接口时"
-    },
-    {
-        "name": "coding_fetch_issue",
-        "description": "获取 CODING Issue（缺陷/需求）详情",
-        "whenToUse": "需要获取需求详情时"
-    },
-    {
-        "name": "coding_config",
-        "description": "查看或设置 CODING 默认配置",
-        "whenToUse": "配置 CODING 连接时"
+        "description": "获取ProComponents组件详细信息（特性说明、API文档、Props列表）",
+        "whenToUse": "需要Pro组件详情时"
     },
     {
-        "name": "refresh_component_docs",
-        "description": "刷新组件文档缓存",
-        "whenToUse": "缓存过期时"
+        "name": "submit_feedback",
+        "description": "提交用户对AI生成结果的反馈（准确率评分、是否采纳、拒绝原因、上下文快照）",
+        "whenToUse": "步骤7：收集用户反馈"
     }
 ]

package/agents/szcd-component-expert.md

@@ -82,27 +82,15 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 
 **这一步是核心，必须实际调用 MCP 工具查询，禁止凭记忆猜测 API。**
 
-使用 MCP 工具获取组件信息和 API：
-
-- `get_component_library_overview` — 获取全部组件概览（含功能描述和适用场景）
-- `search_all_components` — 按关键词搜索组件
-- `get_other_component` / `get_cover_component` — 获取组件详情和 Props
-- `get_accurate_component_doc` — 获取复合组件的透传机制
-- `search_component_examples` — 搜索组件使用示例
-- `read_file` — 读取组件源码（必要时）
-
-**映射规则**:
-- 页面布局 → `TemplateMode`
-- 查询表单 → `Query`（通过 config 配置字段）
-- 数据表格 → `TableOrList`
-- 左侧树 → `LeftTree`
-- 弹窗/抽屉 → `ModelOrDrawer`
-- 返回标题 → `TitleAndBack`
-- 按钮 → Cover 层 `Button`
-- 输入框 → Cover 层 `Input` 或 Query 的 valueType: 'input'
-- 下拉选择 → Cover 层 `Select` 或 Query 的 valueType: 'select'
-- 日期选择 → Cover 层 `DatePicker` 或 Query 的 valueType: 'datePicker'
-- 树选择 → Query 的 valueType: 'treeSelect'
+使用 MCP 工具获取组件信息和 API，**优先使用 Repowiki 语义搜索工具**：
+
+- `search_components_semantic` — 基于 Repowiki 知识库的语义搜索，用自然语言描述匹配最适合的组件（**优先使用**）
+- `get_component_full_profile` — 一站式获取组件全景画像。`name` 支持逗号分隔批量查询（如 `"Query,TableOrList"`），`depth="deep"` 获取 Props 链 + 源码摘要 + 样式注入，**返回值是紧凑 Markdown 格式**（**推荐首选，一次调用替代多次查询**）
+- `get_component_dependencies` — 查询组件依赖关系图，确认 hooks 和插槽关系
+- `get_best_practices` — 获取组件使用最佳实践，指定 scenario 可获取组合最佳实践（如"左树右表页面"）
+- `get_style_injection_guide` — 查询组件样式注入方法，获取 CSS 覆盖路径和分配策略
+- `read_file` — 读取组件源码（deep 模式信息不足时）
+- `api_tool` — 拉取 API 文档（自动识别 YApi/Swagger）或联调测试接口
 
 
 ### 步骤5：匹配组件并确认方案（必做）
@@ -130,6 +118,44 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 - "是否需要补充表单校验规则？"
 - "是否需要添加批量操作功能？"
 
+### 步骤7：收集用户反馈（必做，质量闭环）
+
+代码生成完成后，**必须**向用户收集反馈，用于优化 MCP 工具行为：
+
+1. **询问准确率评分**："请对本次生成的代码准确性评分（1-5 分，5 分最准确）？"
+2. **询问是否采纳**："您是否计划采纳本次生成的代码？"
+3. **如拒绝，询问原因**："未采纳的原因是什么？（如：组件不匹配、API 错误、缺少功能、不符合设计稿等）"
+4. **调用 `submit_feedback` 提交反馈**：
+
+```
+参数示例：
+{
+  "sessionId": "<当前会话ID或时间戳>",
+  "toolsUsed": ["search_components_semantic", "get_component_full_profile", ...],
+  "userQuery": "<用户的原始需求描述>",
+  "generatedCodeSummary": "<生成代码的摘要或关键组件列表>",
+  "accuracyRating": <1-5>,
+  "adopted": <true/false>,
+  "rejectionReason": "<拒绝原因，如采纳则为空>",
+  "contextSnapshot": {
+    "matchedComponents": ["Query", "TableOrList", "TemplateMode"],
+    "layoutType": "LeftRight",
+    "queryFields": ["name", "status", "date"]
+  },
+  "toolType": "<trae|claude|qwen|qoder|cursor|vscode>"
+}
+```
+
+**toolType 映射规则**：
+- Trae CLI / Trae IDE → `"trae"`
+- Claude Code / Claude Desktop → `"claude"`
+- Qwen Code / 通义灵码 → `"qwen"`
+- Qoder CLI → `"qoder"`
+- Cursor → `"cursor"`
+- VS Code + Cline / Continue → `"vscode"`
+- 其他 → `"generic"`
+
+
 ## 典型页面模式
 
 ### 模式1: 左右布局 + 查询 + 表格（最常见）

package/agents/szcd-component-expert.qoder.md

@@ -45,27 +45,19 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 | 工具名 | 功能 | 何时使用 |
 |--------|------|---------|
 | `get_architecture_overview` | 获取7层架构图、模板组合模式、LLM映射错误提示 | 步骤1：架构认知 |
-| `get_component_dependencies` | 查询组件依赖关系图（依赖谁/被谁依赖） | 步骤4：确认组合关系 |
-| `get_other_component` | 获取复合组件详情（路径、Props、透传目标、示例） | 步骤4：获取组件详情 |
-| `get_cover_component` | 获取 Cover 层组件详情（Props、透传目标、准确文档） | 步骤4：获取 Cover 组件 |
-| `get_accurate_component_doc` | 获取组件准确Props文档（含透传机制） | 步骤4：确认透传机制 |
-| `search_component_examples` | 搜索组件使用示例 | 步骤4：查找示例 |
-| `search_all_components` | 全局搜索组件（支持按类型筛选） | 查找组件时 |
-| `resolve_props_chain` | 递归解析组件完整 Props 链 | 需要完整 Props 时 |
-| `read_file` | 读取仓库内文件 | 需要查看源码时 |
-| `analyze_design_image` | 分析设计稿图片（三通道提取） | 步骤3：分析设计稿 |
-| `get_style_injection_guide` | 查询组件样式注入方法 | 生成代码时需要注入样式 |
-| `list_antd_components` | 列出 Ant Design 组件分类概览 | 需要了解 antd 组件分类时 |
-| `list_antd_components_by_category` | 按分类列出 Ant Design 组件 | 按分类查找 antd 组件时 |
-| `get_antd_component` | 获取 Ant Design 组件详细信息 | 需要底层 antd 组件时 |
-| `list_pro_components` | 列出 ProComponents 组件分类概览 | 需要了解 Pro 组件分类时 |
-| `list_pro_components_by_category` | 按分类列出 ProComponents 组件 | 按分类查找 Pro 组件时 |
-| `get_pro_component` | 获取 ProComponents 组件详细信息 | 需要 Pro 组件详情时 |
-| `swagger_fetch_apis` | 获取 Swagger API 列表 | 需要 API 联调时 |
-| `swagger_test_api` | 测试 Swagger API 接口 | 需要测试 API 接口时 |
-| `coding_fetch_issue` | 获取 CODING Issue（缺陷/需求）详情 | 需要获取需求详情时 |
-| `coding_config` | 查看或设置 CODING 默认配置 | 配置 CODING 连接时 |
-| `refresh_component_docs` | 刷新组件文档缓存 | 缓存过期时 |
+| `search_components_semantic` | 基于Repowiki知识库的语义搜索，用自然语言描述匹配最适合的组件 | 步骤4：语义搜索匹配 |
+| `get_component_full_profile` | 一站式获取组件全景画像。name支持逗号分隔批量查询，depth=deep获取Props链+源码摘要+样式注入，返回值是紧凑Markdown格式 | 步骤4：批量获取全景画像 |
+| `get_component_dependencies` | 查询组件依赖关系图（依赖谁/被谁依赖/hooks依赖） | 步骤4：确认组合关系 |
+| `get_best_practices` | 获取组件使用最佳实践和常见错误修正，指定scenario可获取组合最佳实践 | 步骤4：组合最佳实践 |
+| `get_style_injection_guide` | 查询组件样式注入方法、CSS穿透路径、优先级和反模式 | 步骤5：样式注入 |
+| `read_file` | 读取仓库内文件（组件源码/文档），组件源码无长度限制 | 步骤6：读取源码确认 |
+| `analyze_design_image` | 分析UI设计稿，提取Token配置、CSS覆盖样式、视觉细节，支持pixel_perfect模式 | 步骤3：分析设计稿 |
+| `api_tool` | 统一API工具：自动识别YApi/Swagger拉取API文档、联调测试、配置管理 | API联调 |
+| `coding_fetch_issue` | 获取CODING Issue（缺陷/需求）详情，支持URL自动解析 | 获取需求详情 |
+| `coding_config` | 查看或设置CODING默认配置（baseUrl/projectId/账号/Cookie） | 配置CODING连接 |
+| `get_antd_component` | 获取Ant Design组件详细信息（中文名、描述、API文档、Props列表） | 需要底层antd组件时 |
+| `get_pro_component` | 获取ProComponents组件详细信息（特性说明、API文档、Props列表） | 需要Pro组件详情时 |
+| `submit_feedback` | 提交用户对AI生成结果的反馈（准确率评分、是否采纳、拒绝原因、上下文快照） | 步骤7：收集用户反馈 |
 
 ## 流程分支：先判断任务类型
 
@@ -73,8 +65,8 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 
 | 任务类型 | 判断条件 | 流程 |
 |---------|---------|------|
-| **简单查询** | 只查组件信息/API/示例，不涉及代码生成 | 快速流程（步骤1→4→6） |
-| **页面生成** | 需要根据需求/设计稿生成页面代码 | 完整流程（步骤1→2→3→4→5→6） |
+| **简单查询** | 只查组件信息/API/示例，不涉及代码生成 | 快速流程（步骤1→4→6→7） |
+| **页面生成** | 需要根据需求/设计稿生成页面代码 | 完整流程（步骤1→2→3→4→5→6→7） |
 
 ---
 
@@ -134,18 +126,26 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 
 按以下顺序查询：
 
-1. **确认组合关系**：调用 `get_component_dependencies` 获取核心组件的依赖图，确认：
+1. **语义搜索匹配**：调用 `search_components_semantic` 用自然语言描述搜索最匹配的组件（**优先使用**）
+
+2. **批量获取全景画像**：调用 `get_component_full_profile` 获取组件全景画像。关键用法：
+   - `name` 支持逗号分隔批量查询（如 `"Query,TableOrList,LeftTree"`），一次调用替代多次查询
+   - `depth="deep"` 获取 Props 链 + 源码摘要 + 样式注入信息
+   - `depth="standard"` 获取完整 Props 表格 + 依赖 + 示例
+   - **返回值是紧凑 Markdown 格式**，直接阅读即可
+
+3. **确认组合关系**：调用 `get_component_dependencies` 获取核心组件的依赖图，确认：
    - 必选组件和 hooks（如 TreeQueryTable 需要 LeftTree + Query + TableOrList + useLeftTree + useTable）
    - 插槽组件（如 CustomOption 是 LeftTree 的插槽）
    - 检查 `llmMappingHints` 是否有针对当前组件的常见错误修正
 
-2. **获取组件详情**：对每个目标组件调用：
-   - `get_other_component` / `get_cover_component`
-   - `get_accurate_component_doc`
+4. **组合最佳实践**（可选）：调用 `get_best_practices`（scenario="页面场景描述"）获取页面级组件组合最佳实践
+
+5. **样式注入**（可选）：调用 `get_style_injection_guide` 获取样式覆盖方式和 CSS 穿透路径
 
-3. **搜索使用示例**：调用 `search_component_examples`
+6. **读取源码**（仅在 deep 模式信息不足时）：调用 `read_file` 读取具体源码文件确认行为
 
-4. **如有疑问**：用 `read_file` 读取组件源码确认
+7. **API 联调**（如需要后端接口）：调用 `api_tool`（action="fetch" 拉取文档，action="test" 联调测试）
 
 **输出**：每个选用组件的 API 详情、Props 列表、依赖关系、使用示例
 
@@ -174,7 +174,7 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 [说明]
 ```
 
-**交互节点**：通过 AskUserQuestion 工具向用户确认：
+**交互节点**：向用户确认：
 - "以上组件方案是否合适？是否需要调整？"
 - 提供选项：同意方案 / 需要调整 / 换一个方案
 
@@ -195,16 +195,57 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 - Hooks 按依赖关系正确引入（如 useLeftTree、useTable）
 
 
+### 步骤7：收集用户反馈（必做，质量闭环）
+
+代码生成完成后，**必须**向用户收集反馈，用于优化 MCP 工具行为：
+
+1. **询问准确率评分**："请对本次生成的代码准确性评分（1-5 分，5 分最准确）？"
+2. **询问是否采纳**："您是否计划采纳本次生成的代码？"
+3. **如拒绝，询问原因**："未采纳的原因是什么？（如：组件不匹配、API 错误、缺少功能、不符合设计稿等）"
+4. **调用 `submit_feedback` 提交反馈**：
+
+```
+参数示例：
+{
+  "sessionId": "<当前会话ID或时间戳>",
+  "toolsUsed": ["search_components_semantic", "get_component_full_profile", ...],
+  "userQuery": "<用户的原始需求描述>",
+  "generatedCodeSummary": "<生成代码的摘要或关键组件列表>",
+  "accuracyRating": <1-5>,
+  "adopted": <true/false>,
+  "rejectionReason": "<拒绝原因，如采纳则为空>",
+  "contextSnapshot": {
+    "matchedComponents": ["Query", "TableOrList", "TemplateMode"],
+    "layoutType": "LeftRight",
+    "queryFields": ["name", "status", "date"]
+  },
+  "toolType": "<trae|claude|qwen|qoder|cursor|vscode>"
+}
+```
+
+**toolType 映射规则**：
+- Trae CLI / Trae IDE → `"trae"`
+- Claude Code / Claude Desktop → `"claude"`
+- Qwen Code / 通义灵码 → `"qwen"`
+- Qoder CLI → `"qoder"`
+- Cursor → `"cursor"`
+- VS Code + Cline / Continue → `"vscode"`
+- 其他 → `"generic"`
+
+**注意**：此步骤不阻塞用户后续操作，即使反馈提交失败也不影响已生成的代码。
+
+
 **输出**：完整代码文件 + 组件映射说明表 + 关键实现要点
 
 ---
 
 ## 快速流程（简单查询类任务）
 
-仅执行步骤1→4→6，跳过需求分析和方案确认：
+仅执行步骤1→4→6→7，跳过需求分析和方案确认：
 1. **架构认知 + 自检** — 同步骤1
 2. **查询组件** — 按需查询目标组件（含依赖验证）
 3. **输出结果** — 直接返回组件信息/API/示例
+4. **收集反馈** — 同步骤7（如生成了代码则收集反馈）
 
 ---