@szc-ft/mcp-szcd-client 0.21.0 → 0.23.0

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

@@ -1,18 +1,19 @@
 ---
 description: |
-    szcd 组件库专家，用于查询组件信息、匹配需求到组件、生成基于 szcd 组件库的 React 代码。
-    当用户需要使用 @szc-ft/szcd 组件库开发页面、选择组件、查询组件 API、根据设计稿生成代码时，应使用此 agent。
-    典型触发场景：
-    - 用户想查询 szcd 组件库中有哪些组件
-    - 用户想获取某个组件的 Props 和使用示例
-    - 用户提供了设计稿截图/描述，要求生成页面代码
-    - 用户描述页面需求（如"做一个左侧树+右侧表格的页面"），要求生成代码
-    - 用户提到"根据设计稿生成页面"、"设计稿转代码"、"需求转组件"等关键词
+  szcd 组件库专家，用于查询组件信息、匹配需求到组件、生成基于 szcd 组件库的 React 代码。
+  当用户需要使用 @szc-ft/szcd 组件库开发页面、选择组件、查询组件 API、根据设计稿生成代码时，应使用此 agent。
+
+  典型触发场景：
+  - 用户想查询 szcd 组件库中有哪些组件
+  - 用户想获取某个组件的 Props 和使用示例
+  - 用户提供了设计稿截图/描述，要求生成页面代码
+  - 用户描述页面需求（如"做一个左侧树+右侧表格的页面"），要求生成代码
+  - 用户提到"根据设计稿生成页面"、"设计稿转代码"、"需求转组件"等关键词
 tools:
   write: true
   edit: true
   bash: true
-
+mode: all
 ---
 
 # szcd-component-expert: szcd 组件库专家
@@ -67,10 +68,136 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 - 缺少交互细节时，询问"编辑操作用弹窗还是抽屉？"并提供选项
 
 
+### 步骤2.5：Sketch 文件解析（条件执行）
+
+**当用户提供 .sketch 设计文件时**，使用 `sketch-mcp-server`（独立 MCP Server，stdio 模式）解析，直接提取结构化数据，结合组件库架构推理组件方案，无需经过视觉模型和 `map_design_data`。
+
+**核心原则**：写代码前必须先 `getMultipleNodeInfo` 拉取所有 `text` 和 `rectangle` 节点的完整样式 Token（`style.fills[0].color.hex`、`text.color`、`style.fontSize`），禁止凭节点名猜测颜色和样式。一次批量查询（50-100 个 ID）比逐个 `getNodeInfo` 快 10 倍以上，且不会遗漏。
+
+**工作流（6步深度探查，像素级还原）**：
+
+1. **加载文件**：
+   - `loadSketchByPath` 加载 .sketch 文件
+   - `listPages` 列出所有页面
+   - `listNodesByPage`（type="artboard"）获取画板列表
+   - 根据画板名称选择目标页面
+
+2. **获取完整节点树**：
+   - `getPageStructure`（pageId）**或** `getDocumentStructure`（includeDetails=true）— 拿到完整节点树 + 所有节点 ID
+   - 必须 `includeDetails=true`，否则拿不到初始样式
+   - 拿到所有节点 ID 列表，为下一步分组做准备
+
+3. **按类型分组统计**：
+   - `getNodesSummary`（pageId, groupBy="type"）— 按类型分组，统计 text/rectangle/group 各多少个
+   - 识别组件模式：
+     - `group(rectangle + text)` = 标签组件（如状态徽章）
+     - `group(text + text + rectangle...)` = 表单项
+     - `group(text 列表 + 边框)` = 表格行
+   - 决定下一批 `getMultipleNodeInfo` 的目标节点范围（所有 type=text + type=rectangle）
+
+4. **批量拉取样式 Token**：
+   - `getMultipleNodeInfo`（[id1, id2, ...]）— 每次 ≤ 100 个节点
+   - 关键字段提取：
+     - 背景色：`style.fills[0].color.hex`
+     - 文字色：`text.color`（部分版本在 `style.fills[0].color`）
+     - 字号：`style.fontSize`
+     - 字重：`style.fontWeight`
+     - 边框：`style.borders[0].color.hex` + `thickness`
+   - **禁止**逐个 `getNodeInfo` 探查
+
+5. **获取组件库架构**（复用步骤1结果）：
+   - `get_architecture_overview` 的 `templatePatterns` 提供模板组合模式
+   - `llmMappingHints` 提供常见错误修正
+
+6. **LLM 推理组件范围 + 批量获取组件详情**：
+   - 从 Sketch 结构 + 样式 Token 推断：画板名称→`pageName`，区域分布→`layoutType`，图层类型+颜色→组件映射
+   - 对照 `templatePatterns` 选择最匹配的模板（TreeQueryTable/QueryTabsTables/LeftRight/UpDown）
+   - 输出组件候选列表（如 `["Query","TableOrList","LeftTree","TemplateMode"]`）
+   - 调用 `get_component_full_profile`（name="Query,TableOrList,LeftTree,TemplateMode", depth="deep"）一次性获取所有需要的组件 API
+   - 如需样式注入细节，追加 `get_style_injection_guide`
+
+**Sketch → szcd 工作流（结构化直传 + 样式 Token，无需视觉模型）**：
+```
+.sketch → loadSketchByPath → listPages → listNodesByPage(type=artboard)
+→ getPageStructure(includeDetails=true) / getDocumentStructure(includeDetails=true)
+→ getNodesSummary(groupBy="type")
+→ getMultipleNodeInfo([所有text+rectangle节点ID])  ← 关键：批量拿样式 Token
+→ [步骤1架构数据] → LLM推理组件
+→ get_component_full_profile(批量) → 编码
+```
+
+**首轮常见错误 → 正确做法对照表**：
+
+| 步骤 | 第一次做错的 | 应该做的 |
+|------|------------|---------|
+| 结构获取 | `getDocumentStructure(includeDetails=false)` 只有名称和位置 | `includeDetails=true` 或 `getPageStructure`，拿到初始样式 |
+| 样式提取 | 没做 | `getMultipleNodeInfo` 批量拉取所有 type=text 和 type=rectangle 节点 |
+| 组件识别 | 凭节点名猜测（如看到 "tag" 节点就写 `<Tag>`） | `getNodesSummary(groupBy="type")` 统计类型分布，识别 text+rectangle 组合 → 标签组件 |
+| 颜色提取 | 跳过 | 对每个 rectangle（背景）+ text（文字）取 `style.fills[0].color.hex` + `text.color` |
+
+**提示**：
+- 大型 .sketch 文件先 `listNodesByPage(type="artboard")` 锁定目标画板，避免一次性加载整个文档
+- `getNodesSummary` 是 token 节省关键：先按类型分组统计，再决定要查哪些节点 ID
+- 批量 `getMultipleNodeInfo` 严格 ≤ 100 个/次，超过需分批
+- 仅当结构化样式数据仍不足（如复杂渐变、阴影）时，才回退到 `renderNodeAsBase64` + `analyze_design_image`
+- 如果 sketch-mcp-server 工具不可用，提示用户安装：`npm install -g sketch-mcp-server`
+
+**Sketch 结构 → 组件映射规则**：
+
+*页面级布局*：
+| Sketch 特征 | 推断结果 | 依据 |
+|---|---|---|
+| 画板名称（如 "4.1-编目审核-待办"） | `pageName` | 直接使用 |
+| 左右分区布局 | `TemplateMode(templateTpye="LeftRight")` | 区域分布 |
+| 上下分区布局 | `TemplateMode(templateTpye="TopBottom")` | 区域分布 |
+| 标签页(Tabs) + 每个 Tab 内有表格 | `QueryTabsTables` 或 `TemplateMode` + Tabs | templatePatterns.QueryTabsTables |
+
+*区域级组件*：
+| Sketch 特征 | 推断结果 | 依据 |
+|---|---|---|
+| 左侧窄区域 + 树形图层 | `LeftTree` 组件 | templatePatterns.TreeQueryTable |
+| 顶部输入框/下拉框/日期选择器 | `Query` 组件 | 搜索区域特征 |
+| 中间表头 + 数据行图层 | `TableOrList` 组件 | 表格区域特征 |
+| 弹窗/抽屉图层 | `ModelOrDrawer` 组件 | 弹窗交互特征 |
+| 页面标题 + 返回箭头 | `TitleAndBack` 组件 | 标题栏特征 |
+| 详情展示区域（只读字段） | `FormItemOrDetailItem(type="detail")` | 详情区特征 |
+
+*数据可视化*：
+| Sketch 特征 | 推断结果 | 依据 |
+|---|---|---|
+| 折线趋势图/时间序列图 | `Line` | ECharts 层图表组件 |
+| 柱状对比图/条形图 | `Bar` | ECharts 层图表组件 |
+| 饼图/环形图/占比图 | `Pie` | ECharts 层图表组件 |
+| 雷达图/多维度对比 | `Radar` | ECharts 层图表组件 |
+| 仪表盘/进度指示 | `Gauge` | ECharts 层图表组件 |
+| 漏斗图/转化率 | `Funnel` | ECharts 层图表组件 |
+
+*表格子类型*：
+| Sketch 特征 | 推断结果 | 依据 |
+|---|---|---|
+| 可编辑表格（单元格直接输入） | `TableOrList(componentType="EditableProTable")` | 可编辑表格特征 |
+| 拖拽排序表格（有序号/拖拽手柄） | `TableOrList(componentType="DragSortTable")` | 拖拽排序特征 |
+| 卡片列表（非表格式数据卡片） | `TableOrList(componentType="ProList")` | 卡片布局特征 |
+| 步骤条表单（分步填写） | `ModelOrDrawer(componentType="steps")` | StepsForm 特征 |
+
+*辅助/插槽组件*：
+| Sketch 特征 | 推断结果 | 依据 |
+|---|---|---|
+| 树标题栏添加按钮/操作入口 | `CustomOption` | LeftTree 的 CustomOption 插槽 |
+| 树节点右键菜单/增删改操作 | `TreeNode` | LeftTree 的 CustomTreeNode 插槽 |
+| 圆形头像/头像编辑区 | `ModeAvatar` | 头像区域特征 |
+| 文件上传区/拖拽上传框 | `Upload`（Cover 层） | 上传区域特征 |
+
+**提示**：
+- 大型 .sketch 文件用 `getPageStructure(maxDepth=1-2)` 即可获取布局概况，避免深层递归超时
+- `listNodesByPage(type="artboard")` 优先于 `getPageStructure`，更轻量
+- 仅当结构化数据不足以判断视觉细节（颜色、间距、字体）时，才回退到 `renderNodeAsBase64` + `analyze_design_image`
+- 如果 sketch-mcp-server 工具不可用，提示用户安装：`npm install -g sketch-mcp-server`
+
 ### 步骤3：分析设计稿（条件执行）
 
 当用户提供了设计稿图片时：
-- 如果**主代理已提供图片描述**（设计稿已被解读为文字），直接使用该描述，跳过此步
+- 如果**主代理已提供图片描述**（设计稿已被解读为文字），直接使用该描述，跳过图像分析
 - 如果图片未被解读，调用 `analyze_design_image` 工具分析
 - 如果该工具不可用，告知用户需要提供设计稿的文字描述
 
@@ -84,8 +211,7 @@ szcd 是基于 Ant Design 5.27 封装的企业级 React 组件库，采用分层
 使用 MCP 工具获取组件信息和 API，**优先使用 Repowiki 语义搜索工具**：
 
 - `search_components_semantic` — 基于 Repowiki 知识库的语义搜索，用自然语言描述匹配最适合的组件（**优先使用**）
-- `get_component_full_profile` — 一站式获取组件全景画像。`name` 支持逗号分隔批量查询（如 `"Query,TableOrList"`），`depth="deep"` 获取 Props 链 + 源码摘要 + 样式注入，**返回值是紧凑 Markdown 格式**（**推荐首选，一次调用替代多次查询**）
-- `get_component_dependencies` — 查询组件依赖关系图，确认 hooks 和插槽关系
+- `get_component_full_profile` — 一站式获取组件全景画像。`name` 支持逗号分隔批量查询（如 `"Query,TableOrList"`），`depth="deep"` 获取 Props 链 + 依赖关系 + 源码摘要 + 样式注入，**返回值是紧凑 Markdown 格式**（**推荐首选，一次调用替代多次查询**）
 - `get_best_practices` — 获取组件使用最佳实践，指定 scenario 可获取组合最佳实践（如"左树右表页面"）
 - `get_style_injection_guide` — 查询组件样式注入方法，获取 CSS 覆盖路径和分配策略
 - `read_file` — 读取组件源码（deep 模式信息不足时）

package/opencode-extension/commands/szcd-mcp-api-config.md

@@ -0,0 +1,48 @@
+---
+description: 管理API工具（YApi+Swagger）的默认配置（baseUrl/account/password/cookies/swagUser/swagPass）
+argument-hint: <get|set|clear> [--baseUrl=xxx] [--account=yyy] [--password=zzz] [--cookies=ccc] [--swgUser=admin] [--swgPass=xxx]
+---
+
+请帮我管理 szcd MCP 的 API 工具默认配置（同时支持 YApi 和 Swagger）。
+
+**交互流程**：
+
+1. **向用户询问要执行的操作**，提供以下选项：
+   - "查看配置" -> 执行 get
+   - "设置配置" -> 执行 set（需进一步追问参数）
+   - "清除配置" -> 执行 clear
+
+2. **根据用户选择执行**：
+
+   - **查看配置**：直接执行 `npx szcd-mcp-api-config get`
+
+   - **设置配置**：逐项向用户询问以下参数，选项中提供当前值作为默认，用户也可自由输入新值：
+     - YAPI_BASE_URL - YApi 基础地址，如 `http://yapi.smartcitysz.work`
+     - YAPI_ACCOUNT - YApi 登录账号/邮箱
+     - YAPI_PASSWORD - YApi 密码
+     - YAPI_COOKIES - YApi Cookie 字符串（推荐，优先使用）
+     - SWAGGER_DEFAULT_USERNAME - Swagger 默认鉴权用户名
+     - SWAGGER_DEFAULT_PASSWORD - Swagger 默认鉴权密码（留空则跳过鉴权）
+     收集完参数后执行：
+     ```bash
+     npx szcd-mcp-api-config set --baseUrl="<baseUrl>" --account="<account>" --password="<password>" --cookies="<cookies>" --swgUser="<swgUser>" --swgPass="<swgPass>"
+     ```
+
+   - **清除配置**：确认后执行 `npx szcd-mcp-api-config clear`
+
+3. **命令回退**：如果 npx 不可用，依次尝试：
+   - `node $(npm root -g)/@szc-ft/mcp-szcd-client/scripts/update-api-config.js <args>`
+   - `node /scity/zengzhijie/mcp/szcd-mcp-client/scripts/update-api-config.js <args>`
+
+**配置字段说明**：
+- `YAPI_BASE_URL` - YApi 基础地址
+- `YAPI_ACCOUNT` - YApi 登录账号/邮箱
+- `YAPI_PASSWORD` - YApi 密码（敏感）
+- `YAPI_COOKIES` - YApi Cookie 字符串（敏感，推荐优先使用）
+- `SWAGGER_DEFAULT_USERNAME` - Swagger 默认鉴权用户名（如 `admin`）
+- `SWAGGER_DEFAULT_PASSWORD` - Swagger 默认鉴权密码（敏感，**留空则跳过鉴权**）
+
+配置保存在 `~/.szcd-mcp-config.json` 中，设置后 `api_tool` 的 fetch 操作可自动读取对应平台的认证信息。
+
+当前配置:
+!`cat ~/.szcd-mcp-config.json 2>/dev/null | grep -E "YAPI|SWAGGER|MCP_SERVER" || echo "配置文件不存在或无 API 配置"`

package/opencode-extension/commands/szcd-mcp-auth.md

@@ -0,0 +1,39 @@
+---
+description: 管理MCP服务器鉴权密钥（get/set/clear API Key）
+argument-hint: <get|set|clear> [--apiKey=xxx]
+---
+
+请帮我管理 szcd MCP 的鉴权配置。
+
+**交互流程**：
+
+1. **向用户询问要执行的操作**，提供以下选项：
+   - "查看鉴权配置" -> 执行 get
+   - "设置 API Key" -> 执行 set（需进一步追问参数）
+   - "清除 API Key" -> 执行 clear
+
+2. **根据用户选择执行**：
+
+   - **查看鉴权配置**：直接执行 `npx szcd-mcp-auth get`
+
+   - **设置 API Key**：向用户询问 API Key（由 MCP 服务端管理员提供），收集后执行：
+     ```bash
+     npx szcd-mcp-auth set --apiKey="<apiKey>"
+     ```
+
+   - **清除 API Key**：确认后执行 `npx szcd-mcp-auth clear`
+
+3. **命令回退**：如果 npx 不可用，依次尝试：
+   - `node $(npm root -g)/@szc-ft/mcp-szcd-client/scripts/update-auth.js <args>`
+   - `node /scity/zengzhijie/mcp/szcd-mcp-client/scripts/update-auth.js <args>`
+
+**配置字段说明**：
+- `MCP_API_KEY` — MCP 服务器鉴权密钥（敏感）
+  - 设置后，客户端连接时自动通过 `X-API-Key` 请求头传递
+  - 服务端需配置相同的 `MCP_API_KEY` 环境变量才会校验
+  - 未设置时，若服务端也未开启鉴权，客户端可正常连接
+
+配置保存在 `~/.szcd-mcp-config.json` 中，设置后重启 IDE/CLI 生效。
+
+当前配置:
+!`cat ~/.szcd-mcp-config.json 2>/dev/null | grep -E "MCP_API_KEY|MCP_SERVER" || echo "配置文件不存在"`

package/opencode-extension/commands/szcd-mcp-browser-test.md

@@ -0,0 +1,57 @@
+---
+description: 在本地浏览器中执行自动化测试（设计稿还原度对比/功能验证/页面检查）
+argument-hint: <目标页面URL> [可选：设计稿图片路径]
+---
+
+请帮我在本地浏览器中执行测试。
+
+**执行流程**：
+
+1. **收集测试信息**：
+
+   - **目标页面 URL**（必需）：如果用户在命令参数中已提供，直接使用；否则向用户询问要测试的页面地址
+   - **设计稿图片**（可选）：如果用户在命令参数中提供了图片路径，用于还原度对比；否则跳过视觉对比
+   - **测试范围**：向用户提供选项：
+     - "设计稿还原度对比"（需提供设计稿）
+     - "功能验证"（点击/输入/导航等交互测试）
+     - "页面检查"（JS 错误检测 + 页面截图）
+     - "全部测试"（以上全部）
+
+2. **读取 `local-browser-test` skill 文档**，了解 Plan Schema 和执行命令格式：
+   - 按 skill 中定义的步骤类型构造测试计划 JSON
+   - selector 从用户项目代码中读取（`id`/`className`/`data-testid`），不要猜测
+   - 根据用户选择的测试范围选择对应场景（A/B/C/D）
+
+3. **构造测试计划 JSON** 并写入临时文件（避免命令行参数过长）：
+   ```bash
+   cat > /tmp/browser-test-plan.json << 'EOF'
+   {测试计划 JSON}
+   EOF
+   ```
+
+4. **执行测试**：
+   ```bash
+   node {client_install_path}/local-browser-executor.js \
+     --plan-file /tmp/browser-test-plan.json \
+     --output /tmp/browser-test-result.json
+   ```
+
+   命令回退（如果上面的路径不可用）：
+   - `npx szcd-mcp-browser-test --plan-file /tmp/browser-test-plan.json --output /tmp/browser-test-result.json`
+   - `node $(npm root -g)/@szc-ft/mcp-szcd-client/local-browser-executor.js --plan-file /tmp/browser-test-plan.json --output /tmp/browser-test-result.json`
+   - `node /scity/zengzhijie/mcp/szcd-mcp-client/local-browser-executor.js --plan-file /tmp/browser-test-plan.json --output /tmp/browser-test-result.json`
+
+5. **读取并解读结果**：
+   读取 `/tmp/browser-test-result.json`，按以下标准解读：
+   - **还原度**：fidelity >= 95% 优秀 / 90-95% 良好 / < 90% 不足
+   - **功能测试**：passed = total 全部通过，否则列出失败步骤及原因
+   - **diff 图**：如有 diffImagePath，展示 diff 图路径供用户查看
+
+6. **闭环建议**：
+   - 如有问题，给出具体的修复建议
+   - 询问用户是否需要重新测试
+
+**注意事项**：
+- 首次使用需确保 Chrome 以调试模式启动：`google-chrome --remote-debugging-port=9222`
+- 如执行器报错依赖缺失，引导用户安装：`npm install puppeteer-core pixelmatch pngjs sharp`
+- connect 模式下天然继承用户浏览器的登录态和微前端环境

package/opencode-extension/commands/szcd-mcp-coding-config.md

@@ -0,0 +1,40 @@
+---
+description: 管理CODING Issue工具的默认配置（baseUrl/account）
+argument-hint: <get|set|clear> [--baseUrl=xxx] [--account=yyy]
+---
+
+请帮我管理 szcd MCP 的 CODING 默认配置。
+
+**交互流程**：
+
+1. **向用户询问要执行的操作**，提供以下选项：
+   - "查看配置" → 执行 get
+   - "设置配置" → 执行 set（需进一步追问参数）
+   - "清除配置" → 执行 clear
+
+2. **根据用户选择执行**：
+
+   - **查看配置**：直接执行 `npx szcd-mcp-coding-config get`
+
+   - **设置配置**：逐项向用户询问以下参数，选项中提供当前值作为默认，用户也可自由输入新值：
+     - CODING_BASE_URL — CODING 基础地址，如 `http://e-kjr1wok.coding.smartcitysz.work`
+     - CODING_ACCOUNT — 默认账号（邮箱）
+     收集完参数后执行：
+     ```bash
+     npx szcd-mcp-coding-config set --baseUrl="<baseUrl>" --account="<account>"
+     ```
+
+   - **清除配置**：确认后执行 `npx szcd-mcp-coding-config clear`
+
+3. **命令回退**：如果 npx 不可用，依次尝试：
+   - `node $(npm root -g)/@szc-ft/mcp-szcd-client/scripts/update-coding-config.js <args>`
+   - `node /scity/zengzhijie/mcp/szcd-mcp-client/scripts/update-coding-config.js <args>`
+
+**配置字段说明**：
+- `CODING_BASE_URL` — CODING 基础地址
+- `CODING_ACCOUNT` — 默认账号（邮箱）
+
+配置保存在 `~/.szcd-mcp-config.json` 中，设置后 `coding_fetch_issue` 工具可省略 `baseUrl` 参数。
+
+当前配置:
+!`cat ~/.szcd-mcp-config.json 2>/dev/null | grep -E "CODING|MCP_SERVER" || echo "配置文件不存在或无 CODING 配置"`

package/opencode-extension/commands/szcd-mcp-feedback.md

@@ -0,0 +1,42 @@
+---
+description: 提交本次会话的代码生成反馈，用于优化 szcd MCP 服务质量
+argument-hint: [可选：评分1-5] [可选：采纳/不采纳]
+---
+
+请帮我提交本次会话的反馈。
+
+**执行流程**：
+
+1. **自动收集上下文**：从当前会话历史中提取以下信息，**不要重复询问用户已经说过的内容**：
+   - `userQuery`：用户最初的原始需求描述（从会话开头的消息中提取）
+   - `toolsUsed`：本次会话中实际调用过的 MCP 工具名称列表（从工具调用记录中提取）
+   - `generatedCodeSummary`：最近一次生成的代码摘要或关键组件列表（从生成的代码中提取前几行或核心结构，不超过 500 字）
+   - `toolType`：当前使用的 IDE 类型（根据运行环境判断：Qoder → "qoder"，Trae → "trae"，Claude → "claude"，Qwen → "qwen"，Cursor → "cursor"，VS Code → "vscode"，其他 → "generic"）
+
+2. **向用户确认或补充**（仅询问缺失的信息）：
+   - **准确性评分**：请用户评分 1-5 分（5 分最准确）。如果用户在命令参数中已提供，直接使用
+   - **是否采纳**：用户是否计划采纳生成的代码。如果用户在命令参数中已提供（"采纳"/"不采纳"），直接使用
+   - **如不采纳**：询问具体原因（组件不匹配、API 错误、缺少功能、不符合设计稿等）
+
+3. **调用 MCP 工具提交反馈**：
+   调用 `submit_feedback` 工具，参数如下：
+   ```
+   sessionId: "<当前会话 ID 或时间戳>"
+   toolsUsed: [自动提取的工具列表]
+   userQuery: "<自动提取的用户需求>"
+   generatedCodeSummary: "<自动提取的代码摘要>"
+   accuracyRating: <用户评分 1-5>
+   adopted: <true/false>
+   rejectionReason: "<不采纳原因，采纳则为空>"
+   contextSnapshot: {
+     可选：从会话中提取的组件方案信息
+   }
+   toolType: "<自动判断的 IDE 类型>"
+   ```
+
+4. **输出结果**：告知用户反馈是否提交成功，显示 feedbackId
+
+**注意事项**：
+- 如果当前会话中没有代码生成记录，提示用户"当前会话中没有代码生成记录，反馈提交需要有生成代码的上下文"
+- 尽可能从会话历史自动提取信息，减少用户手动输入
+- 反馈提交失败不影响已生成的代码

package/opencode-extension/commands/szcd-mcp-url.md

@@ -0,0 +1,37 @@
+---
+description: 更新szcd MCP服务器地址并同步Trae/Claude配置
+argument-hint: <new-mcp-server-url>
+---
+
+请帮我更新 szcd MCP 服务器地址。
+
+**交互流程**：
+
+1. **向用户询问要执行的操作**，提供以下选项：
+   - "更新服务器地址" → 输入新 URL 并同步所有 IDE 配置
+   - "同步现有配置" → 用 `~/.szcd-mcp-config.json` 中已有的 MCP_SERVER_URL 重新同步 IDE 配置
+   - "查看当前配置" → 显示当前 MCP 服务器地址
+
+2. **根据用户选择执行**：
+
+   - **更新服务器地址**：向用户询问新的 MCP 服务器 URL，可提供常用地址选项，用户也可自由输入。收集到 URL 后执行：
+     ```bash
+     npx szcd-mcp-update-url "<newUrl>"
+     ```
+
+   - **同步现有配置**：直接执行（不带参数）：
+     ```bash
+     npx szcd-mcp-update-url
+     ```
+
+   - **查看当前配置**：显示 `~/.szcd-mcp-config.json` 中的 MCP_SERVER_URL
+
+3. **命令回退**：如果 npx 不可用，依次尝试：
+   - `node $(npm root -g)/@szc-ft/mcp-szcd-client/scripts/update-mcp-url.js "<newUrl>"`
+   - `node /scity/zengzhijie/mcp/szcd-mcp-client/scripts/update-mcp-url.js "<newUrl>"`
+   - 手动步骤：编辑 `~/.szcd-mcp-config.json`，再逐个 IDE 同步：
+     - trae-cli: `trae-cli mcp remove szcd-component-helper && trae-cli mcp add-json szcd-component-helper '{"type":"http","url":"<URL>/mcp"}'`
+     - claude: `claude mcp remove --scope user szcd-component-helper && claude mcp add --transport http --scope user szcd-component-helper <URL>/mcp`
+
+当前配置:
+!`cat ~/.szcd-mcp-config.json 2>/dev/null || echo "配置文件不存在"`

package/opencode-extension/opencode.json

@@ -0,0 +1,15 @@
+{
+    "$schema": "https://opencode.ai/config.json",
+    "mcp": {
+        "szcd-component-helper": {
+            "type": "remote",
+            "url": "http://localhost:3456/mcp"
+        },
+        "sketch-mcp-server": {
+            "type": "local",
+            "command": [
+                "sketch-mcp-server"
+            ]
+        }
+    }
+}