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

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.2",
+    "version": "0.13.0",
     "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,11 +1,11 @@
 {
     "name": "szcd-component-helper",
-    "version": "0.12.2",
+    "version": "0.13.0",
     "description": "szcd 组件库 MCP 助手 — 查询组件信息、匹配需求、生成代码",
     "mcpServers": {
         "szcd-component-helper": {
             "type": "http",
-            "url": "http://localhost:3456/mcp"
+            "httpUrl": "http://localhost:3456/mcp"
         }
     },
     "contextFileName": "QWEN.md",

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));
@@ -194,38 +197,48 @@ function copyAgentToClaudeCode(deps, isProjectLevel = false) {
 // ==================== Slash Command 安装 ====================
 
 function installClaudeCodeSlashCommand(deps) {
-    const commandSource = path.join(deps.PACKAGE_ROOT, "commands", "szcd-mcp-url.md");
-    if (!fs.existsSync(commandSource)) {
-        console.log("⚠️  Slash command source not found, skipping Claude Code");
+    const commandsSourceDir = path.join(deps.PACKAGE_ROOT, "commands");
+    if (!fs.existsSync(commandsSourceDir)) {
+        console.log("⚠️  Commands source directory not found, skipping Claude Code");
+        return;
+    }
+
+    const commandFiles = fs.readdirSync(commandsSourceDir).filter(f => f.endsWith(".md"));
+    if (commandFiles.length === 0) {
+        console.log("⚠️  No command files found, skipping Claude Code");
         return;
     }
 
     // Claude Code：项目级 .claude/commands/
     const claudeDir = path.join(deps.PROJECT_ROOT, ".claude");
     const claudeCommandsDir = path.join(claudeDir, "commands");
-    const commandDest = path.join(claudeCommandsDir, "szcd-mcp-url.md");
 
     if (fs.existsSync(claudeDir) && !fs.statSync(claudeDir).isDirectory()) {
-        console.log(`⚠️  Skipping Claude Code slash command: ${claudeDir} exists but is not a directory`);
+        console.log(`⚠️  Skipping Claude Code slash commands: ${claudeDir} exists but is not a directory`);
         return;
     }
 
     try {
         deps.ensureDirectory(claudeCommandsDir);
 
-        if (fs.existsSync(commandDest)) {
-            const existingContent = fs.readFileSync(commandDest, "utf8").trim();
-            const sourceContent = fs.readFileSync(commandSource, "utf8").trim();
-            if (existingContent !== sourceContent) {
-                console.log(`⏭️  Skipping Claude Code slash command: ${commandDest} already exists (user modified)`);
-                return;
+        for (const file of commandFiles) {
+            const commandSource = path.join(commandsSourceDir, file);
+            const commandDest = path.join(claudeCommandsDir, file);
+
+            if (fs.existsSync(commandDest)) {
+                const existingContent = fs.readFileSync(commandDest, "utf8").trim();
+                const sourceContent = fs.readFileSync(commandSource, "utf8").trim();
+                if (existingContent !== sourceContent) {
+                    console.log(`⏭️  Skipping Claude Code command ${file}: already exists (user modified)`);
+                    continue;
+                }
             }
-        }
 
-        deps.copyFile(commandSource, commandDest);
-        console.log(`✓ Installed Claude Code project slash command: /szcd-mcp-url`);
+            deps.copyFile(commandSource, commandDest);
+            console.log(`✓ Installed Claude Code slash command: /${file.replace(".md", "")}`);
+        }
     } catch (error) {
-        console.log(`⚠️  Failed to install Claude Code slash command: ${error.message}`);
+        console.log(`⚠️  Failed to install Claude Code slash commands: ${error.message}`);
     }
 }
 
@@ -304,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,14 +342,26 @@ function syncExtensionConfig(targetUrl, serverName) {
     }
 
     const mcpUrl = `${targetUrl}/mcp`;
+    const clientConfigHeader = getClientConfigHeaderDirect();
     const entry = manifest.mcpServers[serverName];
-    if (entry.type === "http" && entry.url === 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;
     }
 
     entry.type = "http";
-    entry.url = mcpUrl;
+    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}`);
 }
@@ -360,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

@@ -73,6 +73,12 @@ function parseYamlMcpServers(content) {
     return { servers, lines };
 }
 
+// ==================== 客户端 CODING 配置（使用 common.js 公共函数）====================
+
+// loadClientCodingConfig / encodeClientConfig 已在 common.js 中定义，
+// 通过 deps 参数传入（deps.getClientConfigHeader()）
+// 此处仅保留兼容旧代码的本地引用
+
 // ==================== YAML 文件同步 ====================
 
 export function syncTraeCliYaml(deps) {
@@ -80,10 +86,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;
@@ -93,7 +105,7 @@ export function syncTraeCliYaml(deps) {
     const { servers } = parseYamlMcpServers(content);
 
     const existing = servers.find(s => s.name === serverName);
-    if (existing && existing.url === mcpUrl) {
+    if (existing && existing.url === mcpUrl && existing.type === "http") {
         console.log(`✓ Trae CLI YAML already up-to-date: ${mcpUrl}`);
         return;
     }
@@ -101,13 +113,14 @@ export function syncTraeCliYaml(deps) {
     if (existing) {
         const newRaw = existing.raw.map(l =>
             l.replace(/^(\s+url\s*:\s*).*/, `$1${mcpUrl}`)
+             .replace(/^(\s+type\s*:\s*).*/, `$1http`)
         );
         const oldBlock = existing.raw.join("\n");
         const newBlock = newRaw.join("\n");
         content = content.replace(oldBlock, newBlock);
-        console.log(`✓ Updated Trae CLI YAML: ${existing.url} → ${mcpUrl}`);
+        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)) {
@@ -129,7 +142,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") {
@@ -176,17 +198,25 @@ export function getTraeCliCommandsDirectory() {
 }
 
 export function installTraeCliSlashCommand(deps) {
-    const commandSource = path.join(deps.PACKAGE_ROOT, "commands", "szcd-mcp-url.md");
-    if (!fs.existsSync(commandSource)) {
-        console.log("⚠️  Slash command source not found, skipping");
+    const commandsSourceDir = path.join(deps.PACKAGE_ROOT, "commands");
+    if (!fs.existsSync(commandsSourceDir)) {
+        console.log("⚠️  Commands source directory not found, skipping");
+        return;
+    }
+
+    const commandFiles = fs.readdirSync(commandsSourceDir).filter(f => f.endsWith(".md"));
+    if (commandFiles.length === 0) {
+        console.log("⚠️  No command files found, skipping");
         return;
     }
 
     const traeCliCommandsDir = getTraeCliCommandsDirectory();
     try {
         deps.ensureDirectory(traeCliCommandsDir);
-        deps.copyFile(commandSource, path.join(traeCliCommandsDir, "szcd-mcp-url.md"));
-        console.log(`✓ Installed Trae CLI slash command: /szcd-mcp-url`);
+        for (const file of commandFiles) {
+            deps.copyFile(path.join(commandsSourceDir, file), path.join(traeCliCommandsDir, file));
+            console.log(`✓ Installed Trae CLI slash command: /${file.replace(".md", "")}`);
+        }
     } catch (error) {
         console.log(`⚠️  Failed to install Trae CLI slash command: ${error.message}`);
     }
@@ -266,7 +296,7 @@ function syncTraeCliYamlDirect(targetUrl, serverName) {
     const { servers } = parseYamlMcpServers(content);
 
     const existing = servers.find(s => s.name === serverName);
-    if (existing && existing.url === mcpUrl) {
+    if (existing && existing.url === mcpUrl && existing.type === "http") {
         console.log(`⏭️  Trae CLI YAML already up-to-date: ${mcpUrl}`);
         return;
     }
@@ -274,11 +304,12 @@ function syncTraeCliYamlDirect(targetUrl, serverName) {
     if (existing) {
         const newRaw = existing.raw.map(l =>
             l.replace(/^(\s+url\s*:\s*).*/, `$1${mcpUrl}`)
+             .replace(/^(\s+type\s*:\s*).*/, `$1http`)
         );
         const oldBlock = existing.raw.join("\n");
         const newBlock = newRaw.join("\n");
         content = content.replace(oldBlock, newBlock);
-        console.log(`✓ Updated Trae CLI YAML: ${existing.url} → ${mcpUrl}`);
+        console.log(`✓ Updated Trae CLI YAML: ${existing.url} → ${mcpUrl}, type → http`);
     } else {
         const entry = `    - name: ${serverName}\n      url: ${mcpUrl}\n      type: http\n`;
         if (/^mcp_servers\s*:\s*\[\]\s*$/m.test(content)) {