m8-mcp-server 1.0.0 → 1.1.0

package/package.json

@@ -1,43 +1,56 @@
 {
   "name": "m8-mcp-server",
-  "version": "1.0.0",
-  "description": "MCP server for M8 framework and EJS API documentation",
+  "version": "1.1.0",
+  "description": "M8 移动前端跨端框架 MCP 智能开发辅助工具",
   "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
   "bin": {
-    "m8-mcp": "./bin/m8-mcp.js"
+    "m8-mcp-server": "./dist/index.js"
   },
   "files": [
     "dist",
-    "bin",
+    "docs",
+    "prompts",
     "README.md"
   ],
   "scripts": {
-    "build": "tsc && npm run copy-data && npm run obfuscate",
-    "copy-data": "node -e \"const fs=require('fs'); const path=require('path'); const src=path.join('src','data'); const dest=path.join('dist','data'); fs.cpSync(src, dest, {recursive: true});\"",
-    "obfuscate": "javascript-obfuscator ./dist --output ./dist --compact true --self-defending true",
-    "start": "node dist/index.js",
-    "dev": "ts-node src/index.ts",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "mcp",
+    "model-context-protocol",
     "m8",
     "ejs",
-    "documentation"
+    "mobile",
+    "development",
+    "ai-assistant",
+    "vue",
+    "cross-platform"
   ],
   "author": "",
-  "license": "ISC",
+  "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.6.0",
-    "fast-glob": "^3.3.2",
-    "fuse.js": "^7.0.0",
-    "gray-matter": "^4.0.3",
-    "zod": "^3.23.8"
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "minisearch": "^7.1.0",
+    "zod": "^3.23.0"
   },
   "devDependencies": {
-    "@types/node": "^20.12.7",
-    "javascript-obfuscator": "^4.1.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.4.5"
+    "@types/node": "^20.10.0",
+    "fast-check": "^3.15.0",
+    "terser": "^5.27.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0",
+    "@vitest/coverage-v8": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
   }
 }

package/prompts/PROMPTS.md

@@ -0,0 +1,476 @@
+# M8 MCP Server 提示词规范
+
+## 🎯 MCP Prompts 使用说明
+
+M8 MCP Server 提供了内置的 MCP Prompts，可以自动应用编码规范生成代码。使用 Prompts 时，您只需描述需求，系统会自动注入完整的编码规范和代码模板。
+
+### 可用的 Prompts
+
+| Prompt 名称 | 描述 | 参数 |
+|------------|------|------|
+| `generate_page` | 生成符合 M8 框架规范的页面代码 | `requirement`(必需), `vueVersion`(可选) |
+| `generate_component` | 生成符合 M8 框架规范的 Vue 组件 | `requirement`(必需), `vueVersion`(可选) |
+| `generate_form` | 生成表单页面，包含验证和提交逻辑 | `requirement`(必需), `vueVersion`(可选) |
+| `generate_list` | 生成列表页面，包含下拉刷新和加载更多 | `requirement`(必需), `vueVersion`(可选) |
+| `review_code` | 根据编码规范审查代码 | `code`(必需), `type`(可选) |
+
+### 参数说明
+
+- **requirement**: 需求描述，例如 "用户登录表单" 或 "商品列表页面"
+- **vueVersion**: Vue 版本，`2` 表示 M8.3/Vue2，`3` 表示 M8.4/Vue3（默认为 3）
+- **code**: 需要审查的代码
+- **type**: 代码类型，可选值：`vue`、`javascript`、`scss`
+
+### 使用示例
+
+```
+// 生成 Vue3 页面
+使用 generate_page prompt，参数：
+- requirement: "用户个人中心页面，显示头像、昵称、手机号"
+- vueVersion: "3"
+
+// 生成 Vue2 表单
+使用 generate_form prompt，参数：
+- requirement: "用户注册表单，包含姓名、手机号、验证码"
+- vueVersion: "2"
+
+// 审查代码
+使用 review_code prompt，参数：
+- code: "<你的代码>"
+- type: "vue"
+```
+
+### Prompts 自动注入的内容
+
+使用 Prompts 时，系统会自动注入：
+- ✅ Vue/JavaScript/SCSS 编码规范
+- ✅ 版本对应的代码模板
+- ✅ EJS API vs M8 组件选择指南
+- ✅ 全局变量使用提醒（Util、Config）
+- ✅ 根据需求关键词注入的上下文内容
+
+---
+
+## 🚨 重要：自动化代码生成流程
+
+当用户请求生成页面代码、组件代码或任何 M8 框架相关代码时，**必须自动执行以下流程**，无需用户额外提示：
+
+### 第一步：检测 Vue 版本（必须）
+
+在生成任何代码前，**必须先确定项目的 Vue 版本**：
+
+1. 检查项目的 `package.json` 文件中的 `vue` 依赖版本
+2. 根据版本判断框架类型：
+   - `"vue": "^2.x.x"` → **M8.3 (Vue2)**
+   - `"vue": "^3.x.x"` → **M8.4 (Vue3)**
+3. 如果无法自动检测，**必须询问用户**：
+   ```
+   请确认您的项目版本：
+   1. M8.3 (Vue2)
+   2. M8.4 (Vue3)
+   ```
+
+### 第二步：自动获取编码规范（必须）
+
+确定版本后，**自动调用以下 MCP 工具获取规范**：
+
+```javascript
+// 1. 获取 Vue 组件规范
+get_coding_standard({ type: 'vue' })
+
+// 2. 获取 JavaScript 规范
+get_coding_standard({ type: 'javascript' })
+
+// 3. 获取 CSS/SCSS 规范
+get_coding_standard({ type: 'css' })
+
+// 4. 如果涉及项目结构，获取项目结构规范
+get_coding_standard({ type: 'project-structure' })
+```
+
+### 第三步：查询相关组件/API（按需）
+
+根据用户需求，**自动查询相关组件和 API**：
+
+```javascript
+// 如果需要 UI 组件
+recommend_solution({ requirement: '用户需求描述', type: 'ui' })
+
+// 如果需要原生功能
+get_api_info({ module: 'ui' })  // 或 page, storage, device 等
+
+// 如果需要工具方法
+get_util_info({ category: 'ajax' })  // 或 string, date 等
+```
+
+### 第四步：生成符合规范的代码
+
+根据获取的规范和组件信息，生成代码。
+
+---
+
+## 版本差异速查表
+
+| 特性 | M8.3 (Vue2) | M8.4 (Vue3) |
+|------|-------------|-------------|
+| 组件语法 | Options API | Composition API + `<script setup>` |
+| 响应式 | `data()` 返回对象 | `ref()`, `reactive()` |
+| 生命周期 | `created`, `mounted` | `onMounted`, `onUnmounted` |
+| 状态管理 | Vuex | Pinia |
+| 样式穿透 | `::v-deep` | `:deep()` |
+| 获取页面参数 | `Util.getExtraDataByKey()` | `onLoad((options) => {})` |
+
+---
+
+## 核心编码规范（内置）
+
+以下规范已内置，生成代码时**必须遵守**：
+
+### Vue 组件规范
+
+```vue
+<!--
+ * @作者: [作者名]
+ * @创建时间: YYYY-MM-DD HH:mm:ss
+ * @修改时间: YYYY-MM-DD HH:mm:ss
+ * @版本: [1.0]
+ * @版权: 国泰新点软件股份有限公司
+ * @描述: [组件功能描述]
+-->
+<template>
+  <div class="page_container">
+    <!-- 重构页面不添加导航栏 em-header -->
+    <!-- 内容区域 -->
+  </div>
+</template>
+
+<script setup>
+// Vue3 使用 script setup
+import { ref, computed, onMounted } from 'vue';
+</script>
+
+<style lang="scss" scoped>
+@import "./css/page-name.scss";
+</style>
+```
+
+**必须遵守：**
+- ✅ 文件头部必须有完整注释块
+- ✅ 样式必须剥离到外部 `.scss` 文件
+- ✅ `<style>` 必须使用 `scoped`
+- ❌ 重构页面禁止添加 `em-header` 导航栏
+- ❌ 禁止在 `.vue` 文件中写大量样式代码
+
+### JavaScript 规范
+
+```javascript
+// ✅ 变量/函数: camelCase
+const userName = 'John';
+function getUserInfo() {}
+
+// ✅ 常量: UPPER_SNAKE_CASE
+const MAX_COUNT = 100;
+
+// ✅ 必须使用 Util.ajax，禁止 fetch/axios
+async function loadData() {
+  try {
+    const result = await Util.ajax({
+      url: Config.serverUrl + '/api/data',
+      type: 'POST',
+      data: { params: JSON.stringify(params) }
+    });
+    if (result.status?.code === 1) {
+      return result.data;
+    }
+  } catch (error) {
+    console.error('请求失败:', error);
+    ejs.ui.toast({ message: '网络错误' });
+  }
+}
+
+// ❌ 禁止 import Util 和 Config（它们是全局变量）
+// import { Util } from '@shared';  // 错误！
+// import { Config } from '@config'; // 错误！
+```
+
+**必须遵守：**
+- ✅ 使用 `Util.ajax` 发送请求
+- ✅ 使用 `Config.serverUrl` 拼接 API 地址
+- ✅ `Util` 和 `Config` 是全局变量，禁止 import
+- ✅ 日志必须包含描述：`console.log('描述:', data)`
+- ✅ 使用 `async/await` 处理异步
+
+### SCSS 规范
+
+```scss
+// ✅ 使用 SASS 变量，禁止硬编码颜色
+$color-primary: #1890ff;
+$color-text-primary: #333;
+$spacing-md: 16px;
+
+// ✅ 类名: 小写英文 + 下划线
+.page_container {
+  background: $color-bg-gray;
+  
+  .page_header {
+    padding: $spacing-md;
+    
+    .header_title {
+      color: $color-text-primary;
+    }
+  }
+}
+
+// ❌ 禁止硬编码颜色值
+// ❌ 禁止超过 3 层嵌套
+// ❌ 禁止使用 ID 选择器
+// ❌ 禁止使用 !important
+```
+
+**必须遵守：**
+- ✅ 使用 SASS 变量管理颜色
+- ✅ 类名使用小写英文 + 下划线
+- ✅ 选择器嵌套不超过 3 层
+- ✅ `position` 定位必须加 `z-index`
+
+---
+
+## 代码模板
+
+### Vue3 页面模板 (M8.4)
+
+```vue
+<!--
+ * @作者: [作者名]
+ * @创建时间: YYYY-MM-DD HH:mm:ss
+ * @修改时间: YYYY-MM-DD HH:mm:ss
+ * @版本: [1.0]
+ * @版权: 国泰新点软件股份有限公司
+ * @描述: [页面功能描述]
+-->
+<template>
+  <div class="page_container">
+    <div class="page_content">
+      <!-- 页面内容 -->
+    </div>
+  </div>
+</template>
+
+<script setup>
+import { ref, computed, onMounted } from 'vue';
+
+// 响应式数据
+const loading = ref(false);
+const dataList = ref([]);
+
+// 计算属性
+const isEmpty = computed(() => dataList.value.length === 0);
+
+// 生命周期
+onMounted(() => {
+  loadData();
+});
+
+/**
+ * 加载数据
+ */
+async function loadData() {
+  loading.value = true;
+  try {
+    const result = await Util.ajax({
+      url: Config.serverUrl + '/api/list',
+      type: 'POST',
+      data: { params: JSON.stringify({}) }
+    });
+    if (result.status?.code === 1) {
+      dataList.value = result.data || [];
+    } else {
+      ejs.ui.toast({ message: result.status?.text || '加载失败' });
+    }
+  } catch (error) {
+    console.error('加载数据失败:', error);
+    ejs.ui.toast({ message: '网络错误，请重试' });
+  } finally {
+    loading.value = false;
+  }
+}
+</script>
+
+<style lang="scss" scoped>
+@import "./css/page-name.scss";
+</style>
+```
+
+### Vue2 页面模板 (M8.3)
+
+```vue
+<!--
+ * @作者: [作者名]
+ * @创建时间: YYYY-MM-DD HH:mm:ss
+ * @修改时间: YYYY-MM-DD HH:mm:ss
+ * @版本: [1.0]
+ * @版权: 国泰新点软件股份有限公司
+ * @描述: [页面功能描述]
+-->
+<template>
+  <div class="page_container">
+    <div class="page_content">
+      <!-- 页面内容 -->
+    </div>
+  </div>
+</template>
+
+<script>
+export default {
+  name: 'PageName',
+  data() {
+    return {
+      loading: false,
+      dataList: []
+    };
+  },
+  computed: {
+    isEmpty() {
+      return this.dataList.length === 0;
+    }
+  },
+  created() {
+    this.loadData();
+  },
+  methods: {
+    /**
+     * 加载数据
+     */
+    async loadData() {
+      this.loading = true;
+      try {
+        const result = await Util.ajax({
+          url: Config.serverUrl + '/api/list',
+          type: 'POST',
+          data: { params: JSON.stringify({}) }
+        });
+        if (result.status?.code === 1) {
+          this.dataList = result.data || [];
+        } else {
+          ejs.ui.toast({ message: result.status?.text || '加载失败' });
+        }
+      } catch (error) {
+        console.error('加载数据失败:', error);
+        ejs.ui.toast({ message: '网络错误，请重试' });
+      } finally {
+        this.loading = false;
+      }
+    }
+  }
+};
+</script>
+
+<style lang="scss" scoped>
+@import "./css/page-name.scss";
+</style>
+```
+
+### SCSS 文件模板
+
+```scss
+// page-name.scss
+
+.page_container {
+  min-height: 100vh;
+  background: $color-bg-gray;
+  
+  .page_content {
+    padding: $spacing-md;
+  }
+  
+  .page_header {
+    padding: $spacing-md;
+    background: $color-bg-base;
+    
+    .header_title {
+      font-size: $font-size-lg;
+      font-weight: 500;
+      color: $color-text-primary;
+    }
+  }
+  
+  .page_list {
+    margin-top: $spacing-sm;
+    
+    .list_item {
+      padding: $spacing-md;
+      background: $color-bg-base;
+      border-bottom: 1px solid $color-border;
+      
+      &:last-child {
+        border-bottom: none;
+      }
+    }
+  }
+}
+```
+
+---
+
+## EJS API vs M8 组件选择指南
+
+| 功能 | 优先使用 | 说明 |
+|------|----------|------|
+| Toast 提示 | `ejs.ui.toast()` | 原生 API |
+| 确认弹窗 | `ejs.ui.confirm()` | 原生 API |
+| 日期选择 | `ejs.ui.pickDate()` | 原生 API |
+| 时间选择 | `ejs.ui.pickTime()` | 原生 API |
+| Loading | `ejs.ui.showWaiting()` | 原生 API |
+| 页面跳转 | `ejs.page.open()` | 原生 API |
+| 按钮 | `em-button` | M8 组件 |
+| 输入框 | `em-field` | M8 组件 |
+| 列表项 | `em-cell` | M8 组件 |
+| 上传 | `em-uploader` | M8 组件 |
+| 下拉刷新 | `em-minirefresh` | M8 组件 |
+
+**原则：交互类优先 EJS API，UI 展示类使用 M8 组件**
+
+---
+
+## MCP 工具参考
+
+### search_docs - 文档搜索
+```
+参数：query(必需), category(可选), limit(可选)
+```
+
+### get_component_info - 组件信息
+```
+参数：componentName(必需)
+示例：em-button, em-field, em-cell
+```
+
+### get_api_info - EJS API 信息
+```
+参数：module(必需), method(可选)
+模块：ui, page, storage, device, auth, io
+```
+
+### get_util_info - Util 工具信息
+```
+参数：category(必需), method(可选)
+分类：string, date, base64, ajax
+```
+
+### get_coding_standard - 编码规范
+```
+参数：type(必需), keyword(可选)
+类型：css, javascript, vue, project-structure, all
+```
+
+### generate_code - 代码生成
+```
+参数：type(必需), requirement(必需), vueVersion(可选)
+类型：vue-component, javascript, scss, api-call
+```
+
+### recommend_solution - 智能推荐
+```
+参数：requirement(必需), type(可选)
+类型：ui, data, native, general
+```

package/bin/m8-mcp.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-require('../dist/index.js');

package/dist/constants.js

@@ -1 +0,0 @@
-const a0_0x4db045=a0_0x33ed;(function(_0x57558c,_0x5ac6a1){const _0x495b27=a0_0x33ed,_0x49eb16=_0x57558c();while(!![]){try{const _0x1de8c1=-parseInt(_0x495b27(0x1c4))/0x1+parseInt(_0x495b27(0x1b9))/0x2*(-parseInt(_0x495b27(0x1cc))/0x3)+-parseInt(_0x495b27(0x1c0))/0x4*(parseInt(_0x495b27(0x1c9))/0x5)+parseInt(_0x495b27(0x1b7))/0x6+-parseInt(_0x495b27(0x1c5))/0x7+-parseInt(_0x495b27(0x1d0))/0x8+parseInt(_0x495b27(0x1c1))/0x9;if(_0x1de8c1===_0x5ac6a1)break;else _0x49eb16['push'](_0x49eb16['shift']());}catch(_0x22f907){_0x49eb16['push'](_0x49eb16['shift']());}}}(a0_0x2dc6,0x5d4f8));const a0_0x41522a=(function(){let _0x493f54=!![];return function(_0x2da0b3,_0x1ec6b9){const _0x3baa30=_0x493f54?function(){if(_0x1ec6b9){const _0x4704be=_0x1ec6b9['apply'](_0x2da0b3,arguments);return _0x1ec6b9=null,_0x4704be;}}:function(){};return _0x493f54=![],_0x3baa30;};}()),a0_0x3e463f=a0_0x41522a(this,function(){const _0x58149a=a0_0x33ed;return a0_0x3e463f['toString']()[_0x58149a(0x1bf)](_0x58149a(0x1d6))[_0x58149a(0x1c3)]()[_0x58149a(0x1ce)](a0_0x3e463f)[_0x58149a(0x1bf)](_0x58149a(0x1d6));});function a0_0x2dc6(){const _0x1cffff=['2708360Iqrwoe','__esModule','data','standards','defineProperty','__importDefault','(((.+)+)+)+$','DATA_DIR','4437930PphuVN','STANDARDS_DIR','638882yFPNwr','getDataDir','m8mpdoc-develop','src/data','default','PROJECT_ROOT','search','107996YbyRrV','6664860LevGdZ','resolve','toString','151828htOxLA','505323XSvZct','extname','.ts','M8_DOCS_DIR','40olYobA','join','EJS_DOCS_DIR','3nxKjXS','../src/data','constructor','PROD_DOCS_DIR'];a0_0x2dc6=function(){return _0x1cffff;};return a0_0x2dc6();}function a0_0x33ed(_0x17e400,_0x42e155){_0x17e400=_0x17e400-0x1b6;const _0x345b33=a0_0x2dc6();let _0x3e463f=_0x345b33[_0x17e400];return _0x3e463f;}a0_0x3e463f();'use strict';var __importDefault=this&&this[a0_0x4db045(0x1d5)]||function(_0x1578df){const _0x10c994=a0_0x4db045;return _0x1578df&&_0x1578df[_0x10c994(0x1d1)]?_0x1578df:{'default':_0x1578df};};Object[a0_0x4db045(0x1d4)](exports,a0_0x4db045(0x1d1),{'value':!![]}),exports['STANDARDS_DIR']=exports[a0_0x4db045(0x1cb)]=exports['M8_DOCS_DIR']=exports[a0_0x4db045(0x1cf)]=exports['DOCS_DIR']=exports[a0_0x4db045(0x1be)]=exports[a0_0x4db045(0x1b6)]=void 0x0,exports[a0_0x4db045(0x1ba)]=getDataDir;const path_1=__importDefault(require('path'));exports[a0_0x4db045(0x1b6)]=path_1['default'][a0_0x4db045(0x1ca)](__dirname,a0_0x4db045(0x1cd));const IS_TS_NODE=path_1[a0_0x4db045(0x1bd)][a0_0x4db045(0x1c6)](__filename)===a0_0x4db045(0x1c7);exports['PROJECT_ROOT']=path_1[a0_0x4db045(0x1bd)][a0_0x4db045(0x1c2)](__dirname,IS_TS_NODE?'..':'..'),exports['DOCS_DIR']=path_1[a0_0x4db045(0x1bd)]['join'](exports['PROJECT_ROOT'],a0_0x4db045(0x1bc)),exports[a0_0x4db045(0x1cf)]=path_1['default'][a0_0x4db045(0x1ca)](exports[a0_0x4db045(0x1be)],a0_0x4db045(0x1d2));function getDataDir(){const _0x31528e=a0_0x4db045;return path_1[_0x31528e(0x1bd)][_0x31528e(0x1ca)](__dirname,_0x31528e(0x1d2));}exports[a0_0x4db045(0x1c8)]=a0_0x4db045(0x1bb),exports[a0_0x4db045(0x1cb)]='ejs-doc',exports[a0_0x4db045(0x1b8)]=a0_0x4db045(0x1d3);