@fjyueke/bify-mcp 1.0.2 → 1.0.5

package/README.md

@@ -9,26 +9,89 @@
 
 Bify 是基于 Taroify 的移动端组件库，基于 Vant 视觉规范，提供一致的 API 接口，助力开发者快速搭建小程序应用。
 
-Bify MCP 是一项独立的 MCP（模型上下文协议）服务，旨在将 Bify 与大模型连接起来。它使大模型能够直接从文档中检索组件、API数据。
+Bify MCP 是一项独立的 MCP（模型上下文协议）服务，旨在将 Bify 与大模型连接起来。它使大模型能够直接从文档中检索组件、API 数据，并支持 Arco Mobile → Bify 代码转换。
 
 - 直接使用 npx 运行
 - 无需外部依赖，只需要 Node 环境
+- 支持 68+ 个组件文档查询
+- 支持 Arco Mobile 代码转换
 
-## Cursor 用法
+## 配置方式
 
-Cursor Mcp 使用指南参考：<https://docs.cursor.com/context/model-context-protocol#using-mcp-tools-in-agent>
+### Cursor
 
-``` json
+```json
 {
   "mcpServers": {
     "@fjyueke/bify-mcp": {
       "command": "npx",
       "args": [
         "-y",
-        "@fjyueke/bify-mcp",
+        "@fjyueke/bify-mcp"
       ],
       "env": {}
     }
   }
 }
 ```
+
+### Trae
+
+在 `.trae/skills/` 目录下创建配置文件，或在 Trae 设置中添加 MCP 服务。
+
+### 其他支持 MCP 的 IDE
+
+参考对应 IDE 的 MCP 配置文档，使用上述配置格式。
+
+## 可用工具
+
+| 工具名 | 功能 |
+|--------|------|
+| `list-components` | 列出所有可用的 Bify 组件 |
+| `get-component-docs` | 获取指定组件的详细文档 |
+| `get-component-props` | 获取指定组件的属性和 API 文档 |
+| `list-component-example` | 获取指定组件的所有示例代码 |
+| `convert-arco-to-bify` | 将 Arco Mobile React 代码转换为 Bify 代码 |
+| `get-arco-conversion-help` | 获取 Arco Mobile → Bify 转换帮助信息 |
+
+## 使用示例
+
+### 查询组件文档
+
+```bash
+# 列出所有组件
+list-components
+
+# 获取 Cell 组件文档
+get-component-docs Cell
+
+# 获取 Cell 组件属性
+get-component-props Cell
+
+# 获取 Cell 组件示例
+list-component-example Cell
+```
+
+### Arco Mobile 代码转换
+
+```bash
+# 获取转换帮助
+get-arco-conversion-help
+
+# 转换代码
+convert-arco-to-bify "<Cell label='标题' desc='描述' showArrow>内容</Cell>"
+```
+
+## 版本历史
+
+| 版本 | 日期 | 说明 |
+|------|------|------|
+| 1.0.3 | 2026-07-13 | 优化代码转换工具，增加 40+ 组件映射、值映射、布尔属性转换 |
+| 1.0.2 | 2026-07-13 | 添加 Arco Mobile → Bify 代码转换功能 |
+| 1.0.1 | 2026-07-13 | 更正包名为 bify-mcp |
+| 1.0.0 | 2026-07-13 | 初始版本，支持 68+ 组件文档查询 |
+
+## 相关链接
+
+- npm 包地址：https://www.npmjs.com/package/@fjyueke/bify-mcp
+- Bify 组件库：https://github.com/fjyueke/bify

package/dist/index.js

@@ -172,9 +172,11 @@ var componentMappings = [
       { arcoProp: "label", bifyProp: "title" },
       { arcoProp: "desc", bifyProp: "brief" },
       { arcoProp: "text", bifyProp: "children" },
-      { arcoProp: "showArrow", bifyProp: "clickable" },
+      { arcoProp: "showArrow", bifyProp: "clickable", transform: () => "true" },
+      { arcoProp: "arrow", bifyProp: "rightIcon" },
       { arcoProp: "bordered", bifyProp: "bordered" },
-      { arcoProp: "icon", bifyProp: "icon" }
+      { arcoProp: "icon", bifyProp: "icon" },
+      { arcoProp: "onClick", bifyProp: "onClick" }
     ]
   },
   {
@@ -182,7 +184,10 @@ var componentMappings = [
     bifyName: "CellGroup",
     arcoImport: "@arco-design/mobile-react",
     bifyImport: "@fjyueke/bify-core",
-    propMappings: []
+    propMappings: [
+      { arcoProp: "bordered", bifyProp: "bordered" },
+      { arcoProp: "onClick", bifyProp: "onClick" }
+    ]
   },
   {
     arcoName: "Button",
@@ -194,16 +199,25 @@ var componentMappings = [
       { arcoProp: "size", bifyProp: "size" },
       { arcoProp: "disabled", bifyProp: "disabled" },
       { arcoProp: "loading", bifyProp: "loading" },
-      { arcoProp: "block", bifyProp: "block" },
-      { arcoProp: "ghost", bifyProp: "plain" }
-    ]
-  },
-  {
-    arcoName: "Icon",
-    bifyName: "",
-    arcoImport: "@arco-design/mobile-react",
-    bifyImport: "@fjyueke/bify-icons",
-    propMappings: []
+      { arcoProp: "icon", bifyProp: "icon" },
+      { arcoProp: "onClick", bifyProp: "onClick" },
+      { arcoProp: "className", bifyProp: "className" },
+      { arcoProp: "style", bifyProp: "style" }
+    ],
+    valueMappings: {
+      type: {
+        ghost: "outlined",
+        default: "default",
+        primary: "primary"
+      },
+      size: {
+        mini: "mini",
+        small: "small",
+        medium: "medium",
+        large: "large",
+        huge: "large"
+      }
+    }
   },
   {
     arcoName: "Avatar",
@@ -235,8 +249,18 @@ var componentMappings = [
     propMappings: [
       { arcoProp: "type", bifyProp: "type" },
       { arcoProp: "size", bifyProp: "size" },
-      { arcoProp: "closable", bifyProp: "closable" }
-    ]
+      { arcoProp: "closable", bifyProp: "closable" },
+      { arcoProp: "onClose", bifyProp: "onClose" }
+    ],
+    valueMappings: {
+      type: {
+        default: "default",
+        primary: "primary",
+        success: "success",
+        warning: "warning",
+        danger: "danger"
+      }
+    }
   },
   {
     arcoName: "Switch",
@@ -257,6 +281,17 @@ var componentMappings = [
     propMappings: [
       { arcoProp: "checked", bifyProp: "checked" },
       { arcoProp: "disabled", bifyProp: "disabled" },
+      { arcoProp: "onChange", bifyProp: "onChange" },
+      { arcoProp: "label", bifyProp: "children" }
+    ]
+  },
+  {
+    arcoName: "CheckboxGroup",
+    bifyName: "Checkbox.Group",
+    arcoImport: "@arco-design/mobile-react",
+    bifyImport: "@fjyueke/bify-core",
+    propMappings: [
+      { arcoProp: "value", bifyProp: "modelValue" },
       { arcoProp: "onChange", bifyProp: "onChange" }
     ]
   },
@@ -268,6 +303,17 @@ var componentMappings = [
     propMappings: [
       { arcoProp: "checked", bifyProp: "checked" },
       { arcoProp: "disabled", bifyProp: "disabled" },
+      { arcoProp: "onChange", bifyProp: "onChange" },
+      { arcoProp: "label", bifyProp: "children" }
+    ]
+  },
+  {
+    arcoName: "RadioGroup",
+    bifyName: "Radio.Group",
+    arcoImport: "@arco-design/mobile-react",
+    bifyImport: "@fjyueke/bify-core",
+    propMappings: [
+      { arcoProp: "value", bifyProp: "modelValue" },
       { arcoProp: "onChange", bifyProp: "onChange" }
     ]
   },
@@ -332,13 +378,6 @@ var componentMappings = [
       { arcoProp: "onClose", bifyProp: "onClose" }
     ]
   },
-  {
-    arcoName: "PickerView",
-    bifyName: "Picker",
-    arcoImport: "@arco-design/mobile-react",
-    bifyImport: "@fjyueke/bify-core",
-    propMappings: []
-  },
   {
     arcoName: "DatePicker",
     bifyName: "DatePicker",
@@ -505,6 +544,16 @@ var componentMappings = [
       { arcoProp: "activeKey", bifyProp: "activeNames" }
     ]
   },
+  {
+    arcoName: "CollapseItem",
+    bifyName: "Collapse.Item",
+    arcoImport: "@arco-design/mobile-react",
+    bifyImport: "@fjyueke/bify-core",
+    propMappings: [
+      { arcoProp: "title", bifyProp: "title" },
+      { arcoProp: "name", bifyProp: "name" }
+    ]
+  },
   {
     arcoName: "PullRefresh",
     bifyName: "PullRefresh",
@@ -533,6 +582,29 @@ var componentMappings = [
     propMappings: [
       { arcoProp: "endTime", bifyProp: "endTime" }
     ]
+  },
+  {
+    arcoName: "List",
+    bifyName: "List",
+    arcoImport: "@arco-design/mobile-react",
+    bifyImport: "@fjyueke/bify-core",
+    propMappings: []
+  },
+  {
+    arcoName: "RefreshControl",
+    bifyName: "PullRefresh",
+    arcoImport: "@arco-design/mobile-react",
+    bifyImport: "@fjyueke/bify-core",
+    propMappings: [
+      { arcoProp: "onRefresh", bifyProp: "onRefresh" }
+    ]
+  },
+  {
+    arcoName: "PickerView",
+    bifyName: "PickerView",
+    arcoImport: "@arco-design/mobile-react",
+    bifyImport: "@fjyueke/bify-core",
+    propMappings: []
   }
 ];
 function findMappingByArcoName(arcoName) {
@@ -544,19 +616,36 @@ function findAllArcoComponents() {
 
 // src/services/arco-converter.ts
 async function convertArcoToBify(arcoCode) {
+  const warnings = [];
+  const suggestions = [];
+  const usedMappings = [];
   let result = arcoCode;
-  result = convertImports(result);
-  result = convertComponents(result);
+  const importsResult = convertImports(result, warnings);
+  result = importsResult.code;
+  usedMappings.push(...importsResult.mappings);
+  const componentsResult = convertComponents(result, warnings, suggestions);
+  result = componentsResult.code;
+  usedMappings.push(...componentsResult.mappings);
   result = convertIconImports(result);
-  return result;
+  result = fixCodeFormat(result);
+  const uniqueMappings = usedMappings.filter(
+    (m, index, self) => self.findIndex((t) => t.arcoName === m.arcoName) === index
+  );
+  return {
+    code: result,
+    mappings: uniqueMappings,
+    warnings,
+    suggestions
+  };
 }
-function convertImports(code) {
+function convertImports(code, warnings) {
   let result = code;
+  const usedMappings = [];
   const arcoImportRegex = /import\s+([\s\S]*?)\s+from\s+['"]@arco-design\/mobile-react['"]/g;
   const matches = [...code.matchAll(arcoImportRegex)];
   const bifyCoreComponents = [];
   const bifyIconComponents = [];
-  const remainingComponents = [];
+  const unsupportedComponents = [];
   for (const match of matches) {
     const importContent = match[1].trim();
     const namedImportRegex = /\{([\s\S]*?)\}/;
@@ -566,62 +655,56 @@ function convertImports(code) {
       for (const component of components) {
         const mapping = findMappingByArcoName(component);
         if (mapping) {
+          usedMappings.push(mapping);
           if (mapping.bifyImport === "@fjyueke/bify-icons") {
             bifyIconComponents.push(component);
           } else {
             bifyCoreComponents.push(mapping.bifyName || component);
           }
         } else {
-          remainingComponents.push(component);
+          unsupportedComponents.push(component);
         }
       }
-    } else {
-      remainingComponents.push(importContent);
     }
     result = result.replace(match[0], "");
   }
   result = result.trim();
   if (bifyCoreComponents.length > 0) {
-    const coreImport = `import { ${bifyCoreComponents.join(", ")} } from "@fjyueke/bify-core"
+    const uniqueCoreComponents = [...new Set(bifyCoreComponents)];
+    const coreImport = `import { ${uniqueCoreComponents.join(", ")} } from "@fjyueke/bify-core"
 `;
     result = coreImport + result;
   }
   if (bifyIconComponents.length > 0) {
-    const iconImport = `import { ${bifyIconComponents.join(", ")} } from "@fjyueke/bify-icons"
+    const uniqueIconComponents = [...new Set(bifyIconComponents)];
+    const iconImport = `import { ${uniqueIconComponents.join(", ")} } from "@fjyueke/bify-icons"
 `;
     result = iconImport + result;
   }
-  return result;
+  if (unsupportedComponents.length > 0) {
+    warnings.push(`\u4EE5\u4E0B\u7EC4\u4EF6\u6682\u4E0D\u652F\u6301\u81EA\u52A8\u8F6C\u6362\uFF1A${unsupportedComponents.join(", ")}`);
+  }
+  return { code: result, mappings: usedMappings };
 }
-function convertComponents(code) {
+function convertComponents(code, warnings, suggestions) {
   let result = code;
+  const usedMappings = [];
   const arcoComponents = findAllArcoComponents();
   for (const arcoComponent of arcoComponents) {
     const mapping = findMappingByArcoName(arcoComponent);
     if (!mapping || !mapping.bifyName) continue;
+    const componentPattern = new RegExp(`<${arcoComponent}`, "g");
+    if (!componentPattern.test(code)) continue;
+    usedMappings.push(mapping);
     const bifyComponent = mapping.bifyName;
-    const componentRegex = new RegExp(
+    const selfClosingRegex = new RegExp(
       `<${arcoComponent}([^>]*)\\/?>`,
       "g"
     );
-    result = result.replace(componentRegex, (match, props) => {
+    result = result.replace(selfClosingRegex, (match, props) => {
       let newProps = props;
-      for (const propMapping of mapping.propMappings) {
-        const propRegex = new RegExp(
-          `${propMapping.arcoProp}=(["'])(.*?)\\1`,
-          "g"
-        );
-        newProps = newProps.replace(propRegex, `${propMapping.bifyProp}=$1$2$1`);
-      }
-      if (arcoComponent === "Dialog" || arcoComponent === "Popup") {
-        newProps = newProps.replace(/visible=/g, "open=");
-      }
-      if (arcoComponent === "SearchBar" || arcoComponent === "Field" || arcoComponent === "Textarea") {
-        newProps = newProps.replace(/value=/g, "modelValue=");
-      }
-      if (arcoComponent === "Cell") {
-        newProps = newProps.replace(/showArrow/g, "clickable");
-      }
+      newProps = applyPropMappings(newProps, mapping, warnings);
+      newProps = applyValueMappings(newProps, mapping);
       return `<${bifyComponent}${newProps}/>`;
     });
     const closingComponentRegex = new RegExp(
@@ -630,23 +713,58 @@ function convertComponents(code) {
     );
     result = result.replace(closingComponentRegex, (match, props, children) => {
       let newProps = props;
-      for (const propMapping of mapping.propMappings) {
-        const propRegex = new RegExp(
-          `${propMapping.arcoProp}=(["'])(.*?)\\1`,
-          "g"
-        );
-        newProps = newProps.replace(propRegex, `${propMapping.bifyProp}=$1$2$1`);
-      }
-      if (arcoComponent === "Dialog" || arcoComponent === "Popup") {
-        newProps = newProps.replace(/visible=/g, "open=");
-      }
-      if (arcoComponent === "SearchBar" || arcoComponent === "Field" || arcoComponent === "Textarea") {
-        newProps = newProps.replace(/value=/g, "modelValue=");
+      newProps = applyPropMappings(newProps, mapping, warnings);
+      newProps = applyValueMappings(newProps, mapping);
+      return `<${bifyComponent}${newProps}>${children}</${bifyComponent}>`;
+    });
+    addSuggestions(mapping, suggestions);
+  }
+  return { code: result, mappings: usedMappings };
+}
+function applyPropMappings(props, mapping, warnings) {
+  let result = props;
+  const arcoProps = props.match(/\b(\w+)=/g)?.map((p) => p.slice(0, -1)) || [];
+  const mappedProps = mapping.propMappings.map((m) => m.arcoProp);
+  for (const arcoProp of arcoProps) {
+    if (!mappedProps.includes(arcoProp) && !["className", "style", "children"].includes(arcoProp)) {
+      warnings.push(`\u7EC4\u4EF6 ${mapping.arcoName} \u7684\u5C5E\u6027 ${arcoProp} \u672A\u627E\u5230\u6620\u5C04\uFF0C\u5DF2\u4FDD\u7559\u539F\u6837`);
+    }
+  }
+  for (const propMapping of mapping.propMappings) {
+    const propRegex = new RegExp(
+      `${propMapping.arcoProp}=(["'])(.*?)\\1`,
+      "g"
+    );
+    result = result.replace(propRegex, (match, quote, value) => {
+      if (propMapping.transform) {
+        const transformedValue = propMapping.transform(value);
+        return `${propMapping.bifyProp}=${quote}${transformedValue}${quote}`;
       }
-      if (arcoComponent === "Cell") {
-        newProps = newProps.replace(/showArrow/g, "clickable");
+      return `${propMapping.bifyProp}=${quote}${value}${quote}`;
+    });
+    const booleanPropRegex = new RegExp(`\\b${propMapping.arcoProp}\\b`, "g");
+    if (propMapping.transform) {
+      result = result.replace(booleanPropRegex, `${propMapping.bifyProp}=${propMapping.transform("")}`);
+    } else {
+      result = result.replace(booleanPropRegex, propMapping.bifyProp);
+    }
+  }
+  return result;
+}
+function applyValueMappings(props, mapping) {
+  if (!mapping.valueMappings) return props;
+  let result = props;
+  for (const [propName, valueMap] of Object.entries(mapping.valueMappings)) {
+    const propRegex = new RegExp(
+      `${propName}=(["'])(.*?)\\1`,
+      "g"
+    );
+    result = result.replace(propRegex, (match, quote, value) => {
+      const mappedValue = valueMap[value] || value;
+      if (mappedValue !== value) {
+        return `${propName}=${quote}${mappedValue}${quote}`;
       }
-      return `<${bifyComponent}${newProps}>${children}</${bifyComponent}>`;
+      return match;
     });
   }
   return result;
@@ -655,16 +773,51 @@ function convertIconImports(code) {
   let result = code;
   const arcoIconRegex = /import\s+Icon(\w+)\s+from\s+['"]@arco-design\/mobile-react\/es\/icon\/Icon(\w+)['"]/g;
   result = result.replace(arcoIconRegex, 'import { Icon$1 } from "@fjyueke/bify-icons"');
+  const arcoIconsImportRegex = /import\s+\{([^}]+)\}\s+from\s+['"]@arco-design\/mobile-react\/es\/icon['"]/g;
+  result = result.replace(arcoIconsImportRegex, 'import { $1 } from "@fjyueke/bify-icons"');
   return result;
 }
+function fixCodeFormat(code) {
+  let result = code;
+  result = result.replace(/\n{3,}/g, "\n\n");
+  result = result.replace(/import\s+\{\s*\}\s+from/g, "");
+  const lines = result.split("\n");
+  const nonEmptyLines = lines.filter((line) => line.trim() !== "");
+  result = nonEmptyLines.join("\n");
+  return result.trim();
+}
+function addSuggestions(mapping, suggestions) {
+  const suggestionMap = {
+    Cell: "Bify \u7684 Cell \u7EC4\u4EF6\u652F\u6301\u66F4\u591A\u5E03\u5C40\u5C5E\u6027\uFF0C\u5EFA\u8BAE\u67E5\u770B\u6587\u6863\u4E86\u89E3 align\u3001size \u7B49\u5C5E\u6027",
+    Button: "Bify \u7684 Button \u7EC4\u4EF6\u652F\u6301\u66F4\u591A\u6837\u5F0F\u53D8\u4F53\uFF0C\u5EFA\u8BAE\u67E5\u770B variant \u5C5E\u6027",
+    Dialog: "Bify \u7684 Dialog \u7EC4\u4EF6\u652F\u6301\u66F4\u591A\u4EA4\u4E92\u9009\u9879\uFF0C\u5EFA\u8BAE\u67E5\u770B closeOnClickOverlay \u7B49\u5C5E\u6027",
+    Tabs: "Bify \u7684 Tabs \u7EC4\u4EF6\u652F\u6301\u6ED1\u52A8\u5207\u6362\uFF0C\u5EFA\u8BAE\u67E5\u770B swipeable \u5C5E\u6027",
+    Field: "Bify \u7684 Field \u7EC4\u4EF6\u652F\u6301\u66F4\u591A\u9A8C\u8BC1\u5C5E\u6027\uFF0C\u5EFA\u8BAE\u67E5\u770B rules \u5C5E\u6027"
+  };
+  if (suggestionMap[mapping.arcoName]) {
+    suggestions.push(suggestionMap[mapping.arcoName]);
+  }
+}
 async function getArcoConversionHelp() {
   const availableComponents = componentMappings.filter((m) => m.bifyName).map((m) => `- ${m.arcoName} \u2192 ${m.bifyName}`).join("\n");
+  const valueMappingExamples = componentMappings.filter((m) => m.valueMappings).map((m) => {
+    const mappings = Object.entries(m.valueMappings).map(([prop, values]) => {
+      const valuePairs = Object.entries(values).map(([from, to]) => `${from} \u2192 ${to}`).join(", ");
+      return `  - ${prop}: ${valuePairs}`;
+    }).join("\n");
+    return `**${m.arcoName}**
+${mappings}`;
+  }).join("\n\n");
   return `## Arco Mobile \u2192 Bify \u4EE3\u7801\u8F6C\u6362
 
-### \u652F\u6301\u7684\u7EC4\u4EF6
+### \u652F\u6301\u7684\u7EC4\u4EF6 (${componentMappings.length} \u4E2A)
 
 ${availableComponents}
 
+### \u503C\u6620\u5C04\u793A\u4F8B
+
+${valueMappingExamples || "\u6682\u65E0"}
+
 ### \u4F7F\u7528\u65B9\u5F0F
 
 \`\`\`tsx
@@ -674,7 +827,7 @@ import { Cell, CellGroup, Button } from '@arco-design/mobile-react';
 <CellGroup>
   <Cell label="\u6807\u9898" desc="\u63CF\u8FF0" showArrow>\u5185\u5BB9</Cell>
 </CellGroup>
-<Button type="primary">\u6309\u94AE</Button>
+<Button type="primary" ghost>\u6309\u94AE</Button>
 
 // \u8F6C\u6362\u4E3A Bify \u4EE3\u7801
 import { Cell, CellGroup, Button } from '@fjyueke/bify-core';
@@ -682,23 +835,31 @@ import { Cell, CellGroup, Button } from '@fjyueke/bify-core';
 <CellGroup>
   <Cell title="\u6807\u9898" brief="\u63CF\u8FF0" clickable>\u5185\u5BB9</Cell>
 </CellGroup>
-<Button type="primary">\u6309\u94AE</Button>
+<Button type="primary" outlined>\u6309\u94AE</Button>
 \`\`\`
 
 ### \u5C5E\u6027\u6620\u5C04\u793A\u4F8B
 
-| Arco \u5C5E\u6027 | Bify \u5C5E\u6027 |
-|-----------|-----------|
-| \`label\` | \`title\` |
-| \`desc\` | \`brief\` |
-| \`showArrow\` | \`clickable\` |
-| \`visible\` | \`open\` |
-| \`value\` | \`modelValue\` |
-| \`ghost\` | \`plain\` |
+| Arco \u5C5E\u6027 | Bify \u5C5E\u6027 | \u8BF4\u660E |
+|-----------|-----------|------|
+| \`label\` | \`title\` | \u5355\u5143\u683C\u6807\u9898 |
+| \`desc\` | \`brief\` | \u5355\u5143\u683C\u63CF\u8FF0 |
+| \`showArrow\` | \`clickable\` | \u662F\u5426\u663E\u793A\u7BAD\u5934 |
+| \`visible\` | \`open\` | \u5F39\u7A97\u663E\u793A\u72B6\u6001 |
+| \`value\` | \`modelValue\` | \u8868\u5355\u503C\u7ED1\u5B9A |
+| \`ghost\` | \`outlined\` | \u9542\u7A7A\u6309\u94AE\u6837\u5F0F |
+| \`max\` | \`count\` | Rate \u6700\u5927\u6570\u91CF |
+| \`percent\` | \`percentage\` | Progress \u767E\u5206\u6BD4 |
+
+### \u6700\u4F73\u5B9E\u8DF5
+
+1. **\u4F7F\u7528 AI \u8F85\u52A9\u8F6C\u6362**\uFF1A\u540C\u65F6\u914D\u7F6E Arco Mobile MCP \u548C Bify MCP\uFF0C\u8BA9 AI \u67E5\u8BE2\u53CC\u65B9\u6587\u6863\u540E\u518D\u8FDB\u884C\u8F6C\u6362
+2. **\u624B\u52A8\u68C0\u67E5**\uFF1A\u8F6C\u6362\u540E\u8BF7\u68C0\u67E5\u8B66\u544A\u4FE1\u606F\uFF0C\u5904\u7406\u672A\u6620\u5C04\u7684\u5C5E\u6027
+3. **\u53C2\u8003\u6587\u6863**\uFF1A\u4F7F\u7528 \`get-component-docs\` \u548C \`get-component-props\` \u67E5\u770B Bify \u7EC4\u4EF6\u7684\u8BE6\u7EC6\u7528\u6CD5
 
 ### \u8C03\u7528\u65B9\u5F0F
 
-\u4F7F\u7528 \`convert-arco-to-bify\` \u5DE5\u5177\uFF0C\u4F20\u5165 Arco Mobile \u4EE3\u7801\u5373\u53EF\u83B7\u5F97\u8F6C\u6362\u540E\u7684 Bify \u4EE3\u7801\u3002`;
+\u4F7F\u7528 \`convert-arco-to-bify\` \u5DE5\u5177\uFF0C\u4F20\u5165 Arco Mobile \u4EE3\u7801\u5373\u53EF\u83B7\u5F97\u8F6C\u6362\u540E\u7684 Bify \u4EE3\u7801\u53CA\u8BE6\u7EC6\u62A5\u544A\u3002`;
 }
 
 // src/tools/components.ts
@@ -770,19 +931,50 @@ function registerTifyTools(server) {
   );
   server.tool(
     "convert-arco-to-bify",
-    "Converts Arco Mobile React code to Bify code",
+    "Converts Arco Mobile React code to Bify code with detailed report including warnings and suggestions",
     { arcoCode: z.string() },
     async (args) => {
-      const convertedCode = await convertArcoToBify(args.arcoCode);
+      const result = await convertArcoToBify(args.arcoCode);
+      let report = `## \u8F6C\u6362\u7ED3\u679C
+
+### \u8F6C\u6362\u540E\u7684\u4EE3\u7801
+
+\`\`\`tsx
+${result.code}
+\`\`\``;
+      if (result.mappings.length > 0) {
+        report += `
+
+### \u4F7F\u7528\u7684\u6620\u5C04
+
+| Arco \u7EC4\u4EF6 | Bify \u7EC4\u4EF6 |
+|-----------|-----------|
+${result.mappings.map((m) => `| ${m.arcoName} | ${m.bifyName} |`).join("\n")}`;
+      }
+      if (result.warnings.length > 0) {
+        report += `
+
+### \u26A0\uFE0F \u8B66\u544A
+
+- ${result.warnings.join("\n- ")}`;
+      }
+      if (result.suggestions.length > 0) {
+        report += `
+
+### \u{1F4A1} \u5EFA\u8BAE
+
+- ${result.suggestions.join("\n- ")}`;
+      }
+      report += `
+
+### \u8F6C\u6362\u8BF4\u660E
+
+\u5982\u9700\u66F4\u7CBE\u786E\u7684\u8F6C\u6362\uFF0C\u5EFA\u8BAE\u540C\u65F6\u4F7F\u7528 Arco Mobile MCP \u548C Bify MCP \u67E5\u8BE2\u53CC\u65B9\u7EC4\u4EF6\u6587\u6863\u540E\u8FDB\u884C\u624B\u52A8\u8C03\u6574\u3002`;
       return {
         content: [
           {
             type: "text",
-            text: `## \u8F6C\u6362\u7ED3\u679C
-
-\`\`\`tsx
-${convertedCode}
-\`\`\``
+            text: report
           }
         ]
       };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fjyueke/bify-mcp",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "type": "module",
   "description": "MCP UI builder by Bify",
   "license": "MIT",