@szc-ft/mcp-szcd-client 0.12.4 → 0.13.1

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（如生成了代码则收集反馈）
 
 ---
 

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

@@ -45,8 +45,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） |
 
 ---
 
@@ -98,18 +98,26 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 
 按以下顺序查询：
 
-1. **确认组合关系**：调用 `mcp__szcd-component-helper__get_component_dependencies` 获取核心组件的依赖图，确认：
+1. **语义搜索匹配**：调用 `mcp__szcd-component-helper__search_components_semantic` 用自然语言描述搜索最匹配的组件（**优先使用**）
+
+2. **批量获取全景画像**：调用 `mcp__szcd-component-helper__get_component_full_profile` 获取组件全景画像。关键用法：
+   - `name` 支持逗号分隔批量查询（如 `"Query,TableOrList,LeftTree"`），一次调用替代多次查询
+   - `depth="deep"` 获取 Props 链 + 源码摘要 + 样式注入信息
+   - `depth="standard"` 获取完整 Props 表格 + 依赖 + 示例
+   - **返回值是紧凑 Markdown 格式**，直接阅读即可
+
+3. **确认组合关系**：调用 `mcp__szcd-component-helper__get_component_dependencies` 获取核心组件的依赖图，确认：
    - 必选组件和 hooks（如 TreeQueryTable 需要 LeftTree + Query + TableOrList + useLeftTree + useTable）
    - 插槽组件（如 CustomOption 是 LeftTree 的插槽）
    - 检查 `llmMappingHints` 是否有针对当前组件的常见错误修正
 
-2. **获取组件详情**：对每个目标组件调用：
-   - `mcp__szcd-component-helper__get_other_component` / `mcp__szcd-component-helper__get_cover_component`
-   - `mcp__szcd-component-helper__get_accurate_component_doc`
+4. **组合最佳实践**（可选）：调用 `mcp__szcd-component-helper__get_best_practices`（scenario="页面场景描述"）获取页面级组件组合最佳实践
+
+5. **样式注入**（可选）：调用 `mcp__szcd-component-helper__get_style_injection_guide` 获取样式覆盖方式和 CSS 穿透路径
 
-3. **搜索使用示例**：调用 `mcp__szcd-component-helper__search_component_examples`
+6. **读取源码**（仅在 deep 模式信息不足时）：调用 `mcp__szcd-component-helper__read_file` 读取具体源码文件确认行为
 
-4. **如有疑问**：用 `mcp__szcd-component-helper__read_file` 读取组件源码确认
+7. **API 联调**（如需要后端接口）：调用 `mcp__szcd-component-helper__api_tool`（action="fetch" 拉取文档，action="test" 联调测试）
 
 
 ### 步骤5：匹配组件并确认方案（必做）
@@ -154,14 +162,55 @@ Ant Design → ProComponents → Cover 层 → Wrapper 层 → ProPackages →
 - Hooks 按依赖关系正确引入（如 useLeftTree、useTable）
 
 
+### 步骤7：收集用户反馈（必做，质量闭环）
+
+代码生成完成后，**必须**向用户收集反馈，用于优化 MCP 工具行为：
+
+1. **询问准确率评分**："请对本次生成的代码准确性评分（1-5 分，5 分最准确）？"
+2. **询问是否采纳**："您是否计划采纳本次生成的代码？"
+3. **如拒绝，询问原因**："未采纳的原因是什么？（如：组件不匹配、API 错误、缺少功能、不符合设计稿等）"
+4. **调用 `mcp__szcd-component-helper__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（如生成了代码则收集反馈）
 
 ---
 

package/mcp-proxy.js

@@ -54,6 +54,14 @@ const SERVER_URL = process.env.MCP_SERVER_URL || fileConfig.MCP_SERVER_URL || "h
 const SERVER_TIMEOUT = parseInt(process.env.MCP_TIMEOUT || fileConfig.MCP_TIMEOUT || "120000", 10);
 const SERVER_API_KEY = process.env.MCP_API_KEY || fileConfig.MCP_API_KEY || "";
 
+// 提取用户本地 CODING 配置，通过 Header 透传给服务器（服务器优先使用客户端配置）
+const CLIENT_CODING_CONFIG = {};
+if (fileConfig.CODING_BASE_URL) CLIENT_CODING_CONFIG.CODING_BASE_URL = fileConfig.CODING_BASE_URL;
+if (fileConfig.CODING_DEFAULT_PROJECT_ID) CLIENT_CODING_CONFIG.CODING_DEFAULT_PROJECT_ID = fileConfig.CODING_DEFAULT_PROJECT_ID;
+if (fileConfig.CODING_ACCOUNT) CLIENT_CODING_CONFIG.CODING_ACCOUNT = fileConfig.CODING_ACCOUNT;
+if (fileConfig.CODING_COOKIES) CLIENT_CODING_CONFIG.CODING_COOKIES = fileConfig.CODING_COOKIES;
+if (fileConfig.CODING_PASSWORD) CLIENT_CODING_CONFIG.CODING_PASSWORD = fileConfig.CODING_PASSWORD;
+
 // ==================== 日志 ====================
 
 function log(msg) {
@@ -138,6 +146,10 @@ function forwardToStreamableHttp(msg) {
         if (httpSessionId) {
             headers["Mcp-Session-Id"] = httpSessionId;
         }
+        // 透传用户本地 CODING 配置给服务器
+        if (Object.keys(CLIENT_CODING_CONFIG).length > 0) {
+            headers["X-Client-Config"] = Buffer.from(JSON.stringify(CLIENT_CODING_CONFIG)).toString("base64");
+        }
 
         const postData = JSON.stringify(msg);
 
@@ -262,6 +274,10 @@ function connectSSE() {
             headers["X-API-Key"] = SERVER_API_KEY;
             headers["Authorization"] = `Bearer ${SERVER_API_KEY}`;
         }
+        // 透传用户本地 CODING 配置给服务器
+        if (Object.keys(CLIENT_CODING_CONFIG).length > 0) {
+            headers["X-Client-Config"] = Buffer.from(JSON.stringify(CLIENT_CODING_CONFIG)).toString("base64");
+        }
 
         log(`Connecting to SSE endpoint: ${url.toString()}, headers: ${JSON.stringify(headers)}`);
 
@@ -334,6 +350,10 @@ function forwardToSSEMessageEndpoint(msg) {
             headers["X-API-Key"] = SERVER_API_KEY;
             headers["Authorization"] = `Bearer ${SERVER_API_KEY}`;
         }
+        // 透传用户本地 CODING 配置给服务器
+        if (Object.keys(CLIENT_CODING_CONFIG).length > 0) {
+            headers["X-Client-Config"] = Buffer.from(JSON.stringify(CLIENT_CODING_CONFIG)).toString("base64");
+        }
 
         const postData = JSON.stringify(msg);
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@szc-ft/mcp-szcd-client",
-    "version": "0.12.4",
+    "version": "0.13.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/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/qwen-extension/qwen-extension.json

@@ -1,6 +1,6 @@
 {
     "name": "szcd-component-helper",
-    "version": "0.12.4",
+    "version": "0.13.1",
     "description": "szcd 组件库 MCP 助手 — 查询组件信息、匹配需求、生成代码",
     "mcpServers": {
         "szcd-component-helper": {

package/scripts/lib/claude-code.js

@@ -9,6 +9,7 @@ import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
 import { execSync } from "node:child_process";
+import { getClientConfigHeader as getClientConfigHeaderDirect } from "./common.js";
 
 // ==================== 路径工具 ====================
 
@@ -59,9 +60,11 @@ function syncClaudeCodeConfig(deps) {
         return;
     }
 
+    const clientConfigHeader = deps.getClientConfigHeader ? deps.getClientConfigHeader() : null;
     config.mcpServers[serverName] = {
         type: "http",
         url: mcpUrl,
+        ...(clientConfigHeader ? { headers: { "X-Client-Config": clientConfigHeader } } : {}),
     };
 
     fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
@@ -314,9 +317,11 @@ function syncClaudeCodeConfigDirect(targetUrl, serverName) {
         return;
     }
 
+    const clientConfigHeader = getClientConfigHeaderDirect();
     config.mcpServers[serverName] = {
         type: "http",
         url: mcpUrl,
+        ...(clientConfigHeader ? { headers: { "X-Client-Config": clientConfigHeader } } : {}),
     };
 
     fs.writeFileSync(configPath, JSON.stringify(config, null, 2));

package/scripts/lib/common.js

@@ -159,3 +159,36 @@ export function getMcpServerName() {
     const config = loadExistingConfig();
     return config.MCP_SERVER_NAME || DEFAULT_MCP_SERVER_NAME;
 }
+
+// ==================== 客户端 CODING 配置透传 ====================
+
+/**
+ * 读取用户本地 ~/.szcd-mcp-config.json 中的 CODING 配置
+ * 用于通过 HTTP Header (X-Client-Config) 透传给 MCP 服务器
+ */
+export function loadClientCodingConfig() {
+    const config = loadExistingConfig();
+    const codingConfig = {};
+    if (config.CODING_BASE_URL) codingConfig.CODING_BASE_URL = config.CODING_BASE_URL;
+    if (config.CODING_DEFAULT_PROJECT_ID) codingConfig.CODING_DEFAULT_PROJECT_ID = config.CODING_DEFAULT_PROJECT_ID;
+    if (config.CODING_ACCOUNT) codingConfig.CODING_ACCOUNT = config.CODING_ACCOUNT;
+    if (config.CODING_COOKIES) codingConfig.CODING_COOKIES = config.CODING_COOKIES;
+    if (config.CODING_PASSWORD) codingConfig.CODING_PASSWORD = config.CODING_PASSWORD;
+    return Object.keys(codingConfig).length > 0 ? codingConfig : null;
+}
+
+/**
+ * 将 CODING 配置编码为 Base64，用于 X-Client-Config Header
+ */
+export function encodeClientConfig(config) {
+    if (!config) return null;
+    return Buffer.from(JSON.stringify(config)).toString("base64");
+}
+
+/**
+ * 获取 X-Client-Config Header 值（便捷函数）
+ * 返回 Base64 编码的字符串，或 null（无 CODING 配置时）
+ */
+export function getClientConfigHeader() {
+    return encodeClientConfig(loadClientCodingConfig());
+}

package/scripts/lib/qoder.js

@@ -29,6 +29,7 @@ import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
 import { execSync } from "node:child_process";
+import { getClientConfigHeader as _getClientConfigHeader } from "./common.js";
 
 // ==================== 路径工具 ====================
 
@@ -148,9 +149,11 @@ function syncQoderSettings(deps) {
 
     if (!settings.mcpServers) settings.mcpServers = {};
 
+    const clientConfigHeader = deps.getClientConfigHeader ? deps.getClientConfigHeader() : null;
     const desiredConfig = {
         type: "http",
         url: mcpUrl,
+        ...(clientConfigHeader ? { headers: { "X-Client-Config": clientConfigHeader } } : {}),
     };
 
     const current = settings.mcpServers[serverName];
@@ -358,9 +361,11 @@ function setupQoderProjectConfig(deps) {
     let settings = readJsonFile(projectSettingsPath);
     if (!settings.mcpServers) settings.mcpServers = {};
 
+    const clientConfigHeader = deps.getClientConfigHeader ? deps.getClientConfigHeader() : null;
     settings.mcpServers[serverName] = {
         type: "http",
         url: mcpUrl,
+        ...(clientConfigHeader ? { headers: { "X-Client-Config": clientConfigHeader } } : {}),
     };
 
     writeJsonFile(projectSettingsPath, settings);
@@ -440,9 +445,11 @@ function syncQoderSettingsDirect(targetUrl, serverName) {
         return;
     }
 
+    const clientConfigHeader = _getClientConfigHeader();
     settings.mcpServers[serverName] = {
         type: "http",
         url: mcpUrl,
+        ...(clientConfigHeader ? { headers: { "X-Client-Config": clientConfigHeader } } : {}),
     };
 
     writeJsonFile(settingsPath, settings);

package/scripts/lib/qwen-code.js

@@ -23,6 +23,7 @@ import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
 import { execSync } from "node:child_process";
+import { getClientConfigHeader as getClientConfigHeaderDirect } from "./common.js";
 
 // ==================== 路径工具 ====================
 
@@ -299,6 +300,29 @@ function cleanupSettingsMcpEntry(serverName) {
     console.log(`✓ Cleaned up mcpServers in ~/.qwen/settings.json (extension mode)`);
 }
 
+/**
+ * 向已安装扩展的 qwen-extension.json 注入 X-Client-Config Header
+ * 仅在 postinstall 时调用（setupQwenCode），syncMcpUrl 路径由 syncExtensionConfig 处理
+ */
+function injectClientConfigHeader(serverName, clientConfigHeader) {
+    const extDir = path.join(getQwenCodeExtensionsDirectory(), serverName);
+    const manifestPath = path.join(extDir, "qwen-extension.json");
+
+    if (!fs.existsSync(manifestPath)) return;
+
+    const manifest = readJsonFile(manifestPath);
+    if (!manifest.mcpServers || !manifest.mcpServers[serverName]) return;
+
+    const entry = manifest.mcpServers[serverName];
+    if (entry.headers && entry.headers["X-Client-Config"] === clientConfigHeader) {
+        return; // 已是最新
+    }
+
+    entry.headers = { "X-Client-Config": clientConfigHeader };
+    writeJsonFile(manifestPath, manifest);
+    console.log(`✓ Injected X-Client-Config header into extension qwen-extension.json`);
+}
+
 /**
  * 更新已安装扩展目录中的 qwen-extension.json
  */
@@ -318,8 +342,12 @@ function syncExtensionConfig(targetUrl, serverName) {
     }
 
     const mcpUrl = `${targetUrl}/mcp`;
+    const clientConfigHeader = getClientConfigHeaderDirect();
     const entry = manifest.mcpServers[serverName];
-    if (entry.type === "http" && entry.httpUrl === mcpUrl) {
+    const headersUnchanged = clientConfigHeader
+        ? entry.headers && entry.headers["X-Client-Config"] === clientConfigHeader
+        : !entry.headers;
+    if (entry.type === "http" && entry.httpUrl === mcpUrl && headersUnchanged) {
         console.log(`⏭️  Extension qwen-extension.json already up-to-date: ${mcpUrl}`);
         return;
     }
@@ -328,6 +356,12 @@ function syncExtensionConfig(targetUrl, serverName) {
     entry.httpUrl = mcpUrl;
     // 清理旧字段，避免冲突
     delete entry.url;
+    // 透传用户本地 CODING 配置
+    if (clientConfigHeader) {
+        entry.headers = { "X-Client-Config": clientConfigHeader };
+    } else {
+        delete entry.headers;
+    }
     writeJsonFile(manifestPath, manifest);
     console.log(`✓ Updated extension qwen-extension.json: ${mcpUrl}`);
 }
@@ -362,6 +396,14 @@ export function setupQwenCode(deps) {
         extensionInstalled = installExtensionViaCopy(deps);
     }
 
+    // ---- 注入 X-Client-Config Header ----
+    if (extensionInstalled) {
+        const clientConfigHeader = deps.getClientConfigHeader ? deps.getClientConfigHeader() : null;
+        if (clientConfigHeader) {
+            injectClientConfigHeader(deps.getMcpServerName(), clientConfigHeader);
+        }
+    }
+
     // ---- 结果 ----
     if (extensionInstalled) {
         console.log(`\n✅ Qwen Code extension installed successfully!`);

package/scripts/lib/trae-cli.js

@@ -14,6 +14,7 @@ import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
 import { execSync } from "node:child_process";
+import { loadClientCodingConfig, encodeClientConfig } from "./common.js";
 
 // ==================== 路径工具 ====================
 
@@ -73,6 +74,12 @@ function parseYamlMcpServers(content) {
     return { servers, lines };
 }
 
+// ==================== 客户端 CODING 配置（使用 common.js 公共函数）====================
+
+// loadClientCodingConfig / encodeClientConfig 已在 common.js 中定义，
+// 通过 deps 参数传入（deps.getClientConfigHeader()）
+// 此处仅保留兼容旧代码的本地引用
+
 // ==================== YAML 文件同步 ====================
 
 export function syncTraeCliYaml(deps) {
@@ -80,10 +87,16 @@ export function syncTraeCliYaml(deps) {
     const mcpUrl = `${deps.getMcpServerUrl()}/mcp`;
     const serverName = deps.getMcpServerName();
 
+    // 读取用户本地 CODING 配置，生成 X-Client-Config Header
+    const clientConfigHeader = deps.getClientConfigHeader ? deps.getClientConfigHeader() : null;
+    const headersBlock = clientConfigHeader
+        ? `\n      headers:\n          X-Client-Config: ${clientConfigHeader}`
+        : "";
+
     if (!fs.existsSync(yamlPath)) {
         const dir = path.dirname(yamlPath);
         if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-        const content = `mcp_servers:\n    - name: ${serverName}\n      url: ${mcpUrl}\n      type: http\n`;
+        const content = `mcp_servers:\n    - name: ${serverName}\n      url: ${mcpUrl}\n      type: http${headersBlock}\n`;
         fs.writeFileSync(yamlPath, content);
         console.log(`✓ Created Trae CLI YAML: ${yamlPath}`);
         return;
@@ -108,7 +121,7 @@ export function syncTraeCliYaml(deps) {
         content = content.replace(oldBlock, newBlock);
         console.log(`✓ Updated Trae CLI YAML: ${existing.url} → ${mcpUrl}, type → http`);
     } else {
-        const entry = `    - name: ${serverName}\n      url: ${mcpUrl}\n      type: http\n`;
+        const entry = `    - name: ${serverName}\n      url: ${mcpUrl}\n      type: http${headersBlock}\n`;
         if (/^mcp_servers\s*:\s*\[\]\s*$/m.test(content)) {
             content = content.replace(/^mcp_servers\s*:\s*\[\]\s*$/m, `mcp_servers:\n${entry}`);
         } else if (/^mcp_servers\s*:\s*$/m.test(content)) {
@@ -130,7 +143,16 @@ export function createTraeCliConfig(deps) {
     if (deps.isCommandAvailable("trae-cli")) {
         const mcpUrl = `${deps.getMcpServerUrl()}/mcp`;
         const serverName = deps.getMcpServerName();
-        const jsonConfig = `{"type":"http","url":"${mcpUrl}"}`;
+
+        // 读取用户本地 CODING 配置，生成 X-Client-Config Header
+        const codingConfig = loadClientCodingConfig();
+        const clientConfigHeader = encodeClientConfig(codingConfig);
+        const jsonConfigObj = { type: "http", url: mcpUrl };
+        if (clientConfigHeader) {
+            jsonConfigObj.headers = { "X-Client-Config": clientConfigHeader };
+        }
+        const jsonConfig = JSON.stringify(jsonConfigObj);
+
         deps.safeExecSync(`trae-cli mcp remove ${serverName} 2>/dev/null`);
         const result = deps.safeExecSync(`trae-cli mcp add-json ${serverName} '${jsonConfig}'`);
         if (result === true || result === "already_exists") {

package/scripts/lib/trae-ide.js

@@ -13,6 +13,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
+import { getClientConfigHeader } from "./common.js";
 
 // ==================== 路径工具 ====================
 
@@ -78,10 +79,16 @@ export function syncTraeCnMcpJson(deps) {
         return;
     }
 
-    config.mcpServers[serverName] = {
+    const clientConfigHeader = deps.getClientConfigHeader ? deps.getClientConfigHeader() : null;
+    const serverConfig = {
         type: "http",
         url: mcpUrl,
     };
+    if (clientConfigHeader) {
+        serverConfig.headers = { "X-Client-Config": clientConfigHeader };
+    }
+
+    config.mcpServers[serverName] = serverConfig;
 
     const dir = path.dirname(mcpJsonPath);
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
@@ -119,10 +126,16 @@ export function syncMcpUrl(targetUrl, serverName) {
         return;
     }
 
-    config.mcpServers[serverName] = {
+    const clientConfigHeader = getClientConfigHeader();
+    const serverConfig = {
         type: "http",
         url: mcpUrl,
     };
+    if (clientConfigHeader) {
+        serverConfig.headers = { "X-Client-Config": clientConfigHeader };
+    }
+
+    config.mcpServers[serverName] = serverConfig;
 
     const dir = path.dirname(mcpJsonPath);
     if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });

package/scripts/postinstall.js

@@ -33,6 +33,7 @@ const IS_QUICK = process.argv.includes("--quick");
 const deps = {
     getMcpServerUrl: common.getMcpServerUrl,
     getMcpServerName: common.getMcpServerName,
+    getClientConfigHeader: common.getClientConfigHeader,
     safeExecSync: common.safeExecSync,
     isCommandAvailable: common.isCommandAvailable,
     ensureDirectory: common.ensureDirectory,