m8-mcp-server 1.0.4 → 1.0.6

package/resources/standards/vue.json

@@ -1,122 +0,0 @@
-{
-  "id": "vue-style",
-  "category": "vue",
-  "title": "Vue 组件编码规范",
-  "version": "1.2.0",
-  "lastUpdated": "2024-12-22",
-  "description": "M8 框架 Vue 组件的编码标准，适用于 M8.3 (Vue2) 和 M8.4 (Vue3) 项目",
-  "rules": [
-    {
-      "id": "vue-file-header",
-      "title": ".vue 文件必须包含头部注释",
-      "description": "每个 .vue 文件必须在顶部添加标准化的注释块，包含作者、时间、版本、版权和描述信息。",
-      "correctExample": "<!--\n * @作者: 张三\n * @创建时间: 2024-11-11 14:20:03\n * @修改时间: 2024-11-11 14:20:03\n * @版本: [1.0]\n * @版权: 国泰新点软件股份有限公司\n * @描述: 用户信息展示组件\n-->\n<template>\n  <!-- 组件内容 -->\n</template>",
-      "incorrectExample": "<template>\n  <!-- 缺少头部注释 -->\n</template>"
-    },
-    {
-      "id": "vue-component-naming",
-      "title": "组件文件命名使用 PascalCase",
-      "description": "组件文件名应使用 PascalCase 命名法。",
-      "correctExample": "UserProfile.vue\nTodoList.vue\nSearchInput.vue",
-      "incorrectExample": "userProfile.vue\nuser-profile.vue\ntodolist.vue"
-    },
-    {
-      "id": "vue-base-component-prefix",
-      "title": "基础组件使用特定前缀",
-      "description": "应用特定样式和约定的基础组件应该全部以一个特定的前缀开头，比如 Base、App 或 Ne。",
-      "correctExample": "BaseButton.vue\nBaseTable.vue\nNeInput.vue",
-      "incorrectExample": "MyButton.vue\nVueTable.vue"
-    },
-    {
-      "id": "vue-props-type",
-      "title": "Props 必须指定类型",
-      "description": "Props 定义应该尽量详细，至少需要指定其类型。",
-      "correctExample": "// Vue2\nexport default {\n  props: {\n    status: {\n      type: String,\n      required: true\n    },\n    count: {\n      type: Number,\n      default: 0\n    }\n  }\n}\n\n// Vue3\nconst props = defineProps<{\n  status: 'success' | 'warning' | 'error';\n  count?: number;\n}>();",
-      "incorrectExample": "props: ['status', 'count']"
-    },
-    {
-      "id": "vue-props-camelcase",
-      "title": "Props 命名使用 camelCase",
-      "description": "在声明 props 时，其命名应该始终使用 camelCase。",
-      "correctExample": "props: {\n  greetingText: String\n}",
-      "incorrectExample": "props: {\n  'greeting-text': String\n}"
-    },
-    {
-      "id": "vue-event-kebabcase",
-      "title": "事件名使用 kebab-case",
-      "description": "事件名应该使用 kebab-case 命名。",
-      "correctExample": "this.$emit('item-click', item);\nemit('update-value', newValue);",
-      "incorrectExample": "this.$emit('itemClick', item);\nemit('updateValue', newValue);"
-    },
-    {
-      "id": "vue-self-closing",
-      "title": "组件标签自闭合",
-      "description": "没有内容的组件应该自闭合。",
-      "correctExample": "<MyComponent />\n<ne-button type=\"primary\" />",
-      "incorrectExample": "<MyComponent></MyComponent>\n<ne-button type=\"primary\"></ne-button>"
-    },
-    {
-      "id": "vue-multi-attribute",
-      "title": "多属性换行",
-      "description": "当组件有多个属性时，应该每个属性占一行。",
-      "correctExample": "<ne-field\n  v-model=\"formData.name\"\n  label=\"姓名\"\n  placeholder=\"请输入姓名\"\n  required\n  :rules=\"nameRules\"\n/>",
-      "incorrectExample": "<ne-field v-model=\"formData.name\" label=\"姓名\" placeholder=\"请输入姓名\" required :rules=\"nameRules\" />"
-    },
-    {
-      "id": "vue-script-setup",
-      "title": "使用 script setup (Vue3)",
-      "description": "Vue3 项目推荐使用 <script setup> 语法。",
-      "correctExample": "<script setup>\nimport { ref, computed } from 'vue';\n\nconst count = ref(0);\nconst double = computed(() => count.value * 2);\n</script>",
-      "incorrectExample": "<script>\nimport { ref, computed, defineComponent } from 'vue';\n\nexport default defineComponent({\n  setup() {\n    const count = ref(0);\n    return { count };\n  }\n});\n</script>"
-    },
-    {
-      "id": "vue-code-order",
-      "title": "响应式数据声明顺序",
-      "description": "按照以下顺序组织代码：props/emits → refs → computed → watch → 生命周期 → methods",
-      "correctExample": "<script setup>\n// 1. Props 和 Emits\nconst props = defineProps<{ title: string }>();\nconst emit = defineEmits<{ (e: 'update', value: string): void }>();\n\n// 2. 响应式数据\nconst count = ref(0);\n\n// 3. 计算属性\nconst total = computed(() => count.value);\n\n// 4. 侦听器\nwatch(count, (newVal) => { });\n\n// 5. 生命周期\nonMounted(() => { });\n\n// 6. 方法\nfunction loadData() { }\n</script>",
-      "incorrectExample": "// 代码顺序混乱"
-    },
-    {
-      "id": "vue-style-external",
-      "title": "样式必须剥离到外部文件",
-      "description": "Vue 组件的样式必须剥离到独立的 SCSS 文件中，通过 @import 方式引入。",
-      "correctExample": "<style lang=\"scss\" scoped>\n@import './css/login.scss';\n</style>",
-      "incorrectExample": "<style lang=\"scss\" scoped>\n.login_page {\n  // 大量样式代码直接写在 .vue 文件中\n}\n</style>"
-    },
-    {
-      "id": "vue-style-scoped",
-      "title": "style 标签必须使用 scoped",
-      "description": "为避免样式污染，<style> 标签必须添加 scoped 属性。",
-      "correctExample": "<style lang=\"scss\" scoped>\n@import './css/user-profile.scss';\n</style>",
-      "incorrectExample": "<style lang=\"scss\">\n@import './css/user-profile.scss';\n</style>"
-    },
-    {
-      "id": "vue-no-header-refactor",
-      "title": "重构页面时不添加导航栏",
-      "description": "重构现有页面时，不需要添加 em-header 或 nav-bar 导航栏组件。导航栏由框架或原生容器统一管理。",
-      "correctExample": "<template>\n  <div class=\"page-container\">\n    <div class=\"content\">\n      <em-cell title=\"用户信息\" />\n    </div>\n  </div>\n</template>",
-      "incorrectExample": "<template>\n  <div class=\"page-container\">\n    <em-header title=\"页面标题\" />\n    <div class=\"content\">\n      <em-cell title=\"用户信息\" />\n    </div>\n  </div>\n</template>"
-    },
-    {
-      "id": "vue-no-complex-template",
-      "title": "避免在模板中使用复杂表达式",
-      "description": "复杂的逻辑应该使用计算属性，而不是直接写在模板中。",
-      "correctExample": "<template>\n  <div>{{ activeItemNames }}</div>\n</template>\n\n<script setup>\nconst activeItemNames = computed(() =>\n  items.value.filter(i => i.active).map(i => i.name).join(', ')\n);\n</script>",
-      "incorrectExample": "<template>\n  <div>{{ items.filter(i => i.active).map(i => i.name).join(', ') }}</div>\n</template>"
-    },
-    {
-      "id": "vue-no-mutate-props",
-      "title": "避免直接修改 Props",
-      "description": "不要直接修改 props，应该使用 emit 通知父组件。",
-      "correctExample": "emit('update:value', newValue);",
-      "incorrectExample": "props.value = newValue;"
-    },
-    {
-      "id": "vue-field-clickable",
-      "title": "输入框交互规范",
-      "description": "当输入框为 readonly 但需要点击触发操作时，必须同时添加 is-link 和 clickable 属性。",
-      "correctExample": "<em-field\n  v-model=\"date\"\n  readonly\n  clickable\n  is-link\n  label=\"选择日期\"\n  @click=\"showDatePicker\"\n/>",
-      "incorrectExample": "<em-field\n  v-model=\"date\"\n  readonly\n  label=\"选择日期\"\n  @click=\"showDatePicker\"\n/>"
-    }
-  ]
-}

package/resources/utils/ajax.json

@@ -1,76 +0,0 @@
-{
-  "category": "ajax",
-  "title": "Ajax 与文件上传",
-  "description": "核心工具集中内置的 Ajax 与 Upload，用于接口请求和文件上传",
-  "methods": [
-    {
-      "name": "ajax",
-      "description": "进行 ajax 请求，支持普通版本和 Promise 版本",
-      "parameters": [
-        { "name": "url", "type": "String", "required": true, "description": "请求的 url" },
-        { "name": "data", "type": "String/JSON", "required": true, "description": "请求的数据" },
-        { "name": "type", "type": "String", "required": false, "description": "请求类别，GET 或 POST，默认为 POST" },
-        { "name": "isAutoProxy", "type": "Boolean", "required": false, "description": "默认为 true，是否在请求头中携带用户 token" },
-        { "name": "isAutoErrToast", "type": "Boolean", "required": false, "description": "默认为 false，是否开启错误状态码自动弹窗提示" },
-        { "name": "success", "type": "Function", "required": false, "description": "成功回调" },
-        { "name": "error", "type": "Function", "required": false, "description": "失败回调" },
-        { "name": "complete", "type": "Function", "required": false, "description": "请求完成后的回调" },
-        { "name": "dataPath", "type": "String/Array", "required": false, "description": "需要获取的路径指令，例如 custom.infolist" },
-        { "name": "headers", "type": "Object", "required": false, "description": "设置请求的 header" },
-        { "name": "timeout", "type": "Number", "required": false, "description": "请求超时的毫秒数" },
-        { "name": "cancelKey", "type": "String", "required": false, "description": "中断请求的自定义 key 值" }
-      ],
-      "returnValue": { "type": "Promise", "description": "返回 Promise 对象，支持链式调用" },
-      "examples": [
-        {
-          "title": "Promise 版本",
-          "code": "Util.ajax({\n  url: Config.serverUrl + '/api/list',\n  type: 'POST',\n  data: {\n    params: JSON.stringify({ keyword: 'test' })\n  },\n  dataPath: 'custom.infolist'\n}).then((res) => {\n  if (res.code === 1) {\n    console.log(res.data);\n  }\n}).catch((err) => {\n  console.error(err);\n});",
-          "description": "使用 Promise 方式进行 ajax 请求"
-        },
-        {
-          "title": "回调版本",
-          "code": "Util.ajax({\n  url: Config.serverUrl + '/api/detail',\n  data: {\n    params: JSON.stringify({ guid: '12345' })\n  },\n  dataPath: 'custom',\n  success: (result) => {\n    if (result.code === 1) {\n      // 处理数据\n    }\n  },\n  error: (err) => {\n    console.error(err);\n  }\n});",
-          "description": "使用回调方式进行 ajax 请求"
-        }
-      ]
-    },
-    {
-      "name": "ajaxAll",
-      "description": "控制多个 Ajax 请求并发执行",
-      "parameters": [
-        { "name": "...requests", "type": "Promise[]", "required": true, "description": "多个 ajax 请求的 Promise 对象" }
-      ],
-      "returnValue": { "type": "Promise<Array>", "description": "返回所有请求结果的数组" },
-      "examples": [
-        {
-          "title": "并发请求",
-          "code": "const ajax1 = Util.ajax({ url: Config.serverUrl + '/api/users' });\nconst ajax2 = Util.ajax({ url: Config.serverUrl + '/api/products' });\n\nUtil.ajaxAll(ajax1, ajax2).then((response) => {\n  const users = response[0];\n  const products = response[1];\n});",
-          "description": "同时发起多个请求并等待所有请求完成"
-        }
-      ]
-    },
-    {
-      "name": "upload",
-      "description": "将本地资源上传到开发者服务器",
-      "parameters": [
-        { "name": "url", "type": "String", "required": true, "description": "开发者服务器 url" },
-        { "name": "filePath", "type": "String", "required": true, "description": "要上传文件资源的路径（推荐使用）" },
-        { "name": "name", "type": "String", "required": true, "description": "文件对应的 key" },
-        { "name": "files", "type": "Array", "required": false, "description": "需要上传的文件列表（仅 H5 支持）" },
-        { "name": "headers", "type": "Object", "required": false, "description": "设置请求的 header" },
-        { "name": "formData", "type": "Object", "required": false, "description": "HTTP 请求中其他额外的 form data" },
-        { "name": "success", "type": "Function", "required": false, "description": "接口调用成功的回调函数" },
-        { "name": "error", "type": "Function", "required": false, "description": "接口调用失败的回调函数" },
-        { "name": "uploading", "type": "Function", "required": false, "description": "文件上传时，进度回调" }
-      ],
-      "returnValue": { "type": "Promise", "description": "返回 Promise 对象" },
-      "examples": [
-        {
-          "title": "文件上传",
-          "code": "Util.upload({\n  url: Config.serverUrl + '/api/upload',\n  filePath: file.path,\n  name: file.name,\n  formData: {\n    user: 'test'\n  },\n  success: (res) => {\n    console.log(res);\n  }\n});",
-          "description": "上传文件到服务器"
-        }
-      ]
-    }
-  ]
-}

package/resources/utils/common.json

@@ -1,129 +0,0 @@
-{
-  "category": "common",
-  "title": "通用工具方法",
-  "description": "Util 提供的通用工具方法，包括 uuid 生成、对象合并、数据处理等",
-  "methods": [
-    {
-      "name": "uuid",
-      "description": "生成一个随机 uuid",
-      "parameters": [
-        { "name": "len", "type": "Number", "required": false, "description": "长度，默认为 32 位，最大不能超过 36，最小不能小于 4" },
-        { "name": "radix", "type": "Number", "required": false, "description": "随机的基数，如果小于等于 10 代表只用纯数字，最大为 62，默认为 62" },
-        { "name": "type", "type": "String", "required": false, "description": "类别，默认为 default 代表 a-c-c-d-e 的连线模式，如果为 noline 代表不会有连线" }
-      ],
-      "returnValue": { "type": "String", "description": "生成的 uuid 字符串" },
-      "examples": [
-        {
-          "title": "生成默认 uuid",
-          "code": "const uuid = Util.uuid();\n// 例如: yczYoFSp-ooru-ANjl-Hrgg-XgXmMxSN",
-          "description": "生成一个 8-4-4-4-12 格式的 32 位 uuid"
-        },
-        {
-          "title": "生成纯数字 uuid",
-          "code": "const uuid = Util.uuid({ len: 36, radix: 10 });\n// 例如: 52616056-5161-7170-8460-802618729824",
-          "description": "生成一个只有数字的 36 位 uuid"
-        }
-      ]
-    },
-    {
-      "name": "getExtraDataByKey",
-      "description": "通过传入 key 值，得到页面 key 的初始化传值",
-      "parameters": [
-        { "name": "key", "type": "String", "required": true, "description": "对应的 key 值" }
-      ],
-      "returnValue": { "type": "String", "description": "返回 href 中对应的 key 的 value" },
-      "examples": [
-        {
-          "title": "获取页面参数",
-          "code": "const value = Util.getExtraDataByKey('id');\nconsole.log(value);",
-          "description": "获取 URL 中的参数值"
-        }
-      ]
-    },
-    {
-      "name": "getFullUrlByParams",
-      "description": "将 json 参数拼接到 url 中",
-      "parameters": [
-        { "name": "url", "type": "String", "required": true, "description": "需要拼接的 url" },
-        { "name": "data", "type": "JSON", "required": true, "description": "对应需要拼接的 JSON 参数" },
-        { "name": "isType", "type": "Boolean", "required": false, "description": "是否相对路径，默认 false" }
-      ],
-      "returnValue": { "type": "String", "description": "拼接后的完整 URL" },
-      "examples": [
-        {
-          "title": "拼接 URL 参数",
-          "code": "const url = 'http://app.epoint.com.cn/api';\nconst data = { key1: 'value1' };\nconst finalUrl = Util.getFullUrlByParams(url, data);\n// 返回: http://app.epoint.com.cn/api?key1=value1",
-          "description": "将 JSON 参数拼接到 URL 中"
-        }
-      ]
-    },
-    {
-      "name": "extend",
-      "description": "合并多个对象",
-      "parameters": [
-        { "name": "deep", "type": "Boolean", "required": false, "description": "为 true 时会进行递归合并" },
-        { "name": "target", "type": "Object", "required": true, "description": "需要合并的目标对象" },
-        { "name": "source1", "type": "Object", "required": true, "description": "需要合并的源对象" },
-        { "name": "sourceN", "type": "Object", "required": false, "description": "更多需要合并的源对象" }
-      ],
-      "returnValue": { "type": "Object", "description": "合并后的对象" },
-      "examples": [
-        {
-          "title": "浅合并",
-          "code": "const target = { a: 1 };\nconst source = { b: 2 };\nconst result = Util.extend({}, target, source);\n// { a: 1, b: 2 }",
-          "description": "浅合并多个对象"
-        },
-        {
-          "title": "深合并",
-          "code": "const target = { product: { ejs: 'ejs' } };\nconst source = { product: { m7: 'm7' } };\nconst result = Util.extend(true, {}, target, source);\n// { product: { ejs: 'ejs', m7: 'm7' } }",
-          "description": "递归合并多个对象"
-        }
-      ]
-    },
-    {
-      "name": "each",
-      "description": "遍历对象或数组",
-      "parameters": [
-        { "name": "object", "type": "Object/Array", "required": true, "description": "需要遍历的对象或数组" },
-        { "name": "handler", "type": "Function", "required": true, "description": "每个元素执行的回调函数" }
-      ],
-      "returnValue": { "type": "void", "description": "无返回值" },
-      "examples": [
-        {
-          "title": "遍历数组",
-          "code": "const array = [1, 2, 3];\nUtil.each(array, function(index, item) {\n  console.log(item * item);\n});",
-          "description": "遍历数组并处理每个元素"
-        }
-      ]
-    },
-    {
-      "name": "dataProcess",
-      "description": "处理返回数据，返回按指令处理过后的最终数据",
-      "parameters": [
-        { "name": "response", "type": "JSON", "required": true, "description": "需要处理的数据" },
-        { "name": "options.dataPath", "type": "String/Array", "required": false, "description": "需要获取的路径指令" }
-      ],
-      "returnValue": { "type": "Object", "description": "包含 code、message、data 的处理结果" },
-      "examples": [
-        {
-          "title": "处理接口返回数据",
-          "code": "const response = {\n  custom: { infolist: [{ title: '测试' }] },\n  status: { code: 1, text: '成功' }\n};\nconst result = Util.dataProcess(response, {\n  dataPath: 'custom.infolist'\n});\nconsole.log(result.data);",
-          "description": "从接口返回数据中提取指定路径的数据"
-        }
-      ]
-    },
-    {
-      "name": "os",
-      "description": "判断当前的运行环境",
-      "parameters": [],
-      "returnValue": { "type": "Object", "description": "包含 android、ios、ejs、h5、wechat 等环境判断属性" },
-      "examples": [
-        {
-          "title": "判断运行环境",
-          "code": "if (Util.os.android) {\n  console.log('Android 环境');\n}\nif (Util.os.ios) {\n  console.log('iOS 环境');\n}\nif (Util.os.h5) {\n  console.log('H5 环境');\n}",
-          "description": "判断当前代码运行的平台环境"
-        }
-      ]
-    }
-  ]
-}

package/resources/utils/index.json

@@ -1,7 +0,0 @@
-{
-  "categories": [
-    { "id": "ajax", "title": "Ajax 与文件上传", "file": "ajax.json" },
-    { "id": "string", "title": "字符串校验工具", "file": "string.json" },
-    { "id": "common", "title": "通用工具方法", "file": "common.json" }
-  ]
-}

package/resources/utils/string.json

@@ -1,112 +0,0 @@
-{
-  "category": "string",
-  "title": "字符串校验工具",
-  "description": "Util.string 提供的字符串校验方法，用于验证手机号、邮箱、身份证等",
-  "methods": [
-    {
-      "name": "isMobile",
-      "description": "验证是否为手机号",
-      "parameters": [
-        { "name": "str", "type": "String", "required": true, "description": "需要验证的字符串" }
-      ],
-      "returnValue": { "type": "Boolean", "description": "是否为有效手机号" },
-      "examples": [
-        {
-          "title": "验证手机号",
-          "code": "const isValid = Util.string.isMobile('13800138000');\nconsole.log(isValid); // true",
-          "description": "验证字符串是否为有效的手机号"
-        }
-      ]
-    },
-    {
-      "name": "isTel",
-      "description": "验证是否为固定电话",
-      "parameters": [
-        { "name": "str", "type": "String", "required": true, "description": "需要验证的字符串" }
-      ],
-      "returnValue": { "type": "Boolean", "description": "是否为有效固定电话" },
-      "examples": [
-        {
-          "title": "验证固定电话",
-          "code": "const isValid = Util.string.isTel('0512-12345678');\nconsole.log(isValid); // true",
-          "description": "验证字符串是否为有效的固定电话"
-        }
-      ]
-    },
-    {
-      "name": "isPhone",
-      "description": "验证是否为电话（手机或固话）",
-      "parameters": [
-        { "name": "str", "type": "String", "required": true, "description": "需要验证的字符串" }
-      ],
-      "returnValue": { "type": "Boolean", "description": "是否为有效电话" },
-      "examples": [
-        {
-          "title": "验证电话",
-          "code": "const isValid = Util.string.isPhone('13800138000');\nconsole.log(isValid); // true",
-          "description": "验证字符串是否为有效的电话号码"
-        }
-      ]
-    },
-    {
-      "name": "isEmail",
-      "description": "验证是否为邮箱",
-      "parameters": [
-        { "name": "str", "type": "String", "required": true, "description": "需要验证的字符串" }
-      ],
-      "returnValue": { "type": "Boolean", "description": "是否为有效邮箱" },
-      "examples": [
-        {
-          "title": "验证邮箱",
-          "code": "const isValid = Util.string.isEmail('test@example.com');\nconsole.log(isValid); // true",
-          "description": "验证字符串是否为有效的邮箱地址"
-        }
-      ]
-    },
-    {
-      "name": "isIdCard",
-      "description": "验证是否为身份证号",
-      "parameters": [
-        { "name": "str", "type": "String", "required": true, "description": "需要验证的字符串" }
-      ],
-      "returnValue": { "type": "Boolean", "description": "是否为有效身份证号" },
-      "examples": [
-        {
-          "title": "验证身份证",
-          "code": "const isValid = Util.string.isIdCard('110101199001011234');\nconsole.log(isValid); // true",
-          "description": "验证字符串是否为有效的身份证号"
-        }
-      ]
-    },
-    {
-      "name": "isPostCode",
-      "description": "验证是否为邮政编码",
-      "parameters": [
-        { "name": "str", "type": "String", "required": true, "description": "需要验证的字符串" }
-      ],
-      "returnValue": { "type": "Boolean", "description": "是否为有效邮政编码" },
-      "examples": [
-        {
-          "title": "验证邮政编码",
-          "code": "const isValid = Util.string.isPostCode('215000');\nconsole.log(isValid); // true",
-          "description": "验证字符串是否为有效的邮政编码"
-        }
-      ]
-    },
-    {
-      "name": "isOrgCode",
-      "description": "验证是否为组织机构代码",
-      "parameters": [
-        { "name": "str", "type": "String", "required": true, "description": "需要验证的字符串" }
-      ],
-      "returnValue": { "type": "Boolean", "description": "是否为有效组织机构代码" },
-      "examples": [
-        {
-          "title": "验证组织机构代码",
-          "code": "const isValid = Util.string.isOrgCode('12345678-9');\nconsole.log(isValid);",
-          "description": "验证字符串是否为有效的组织机构代码"
-        }
-      ]
-    }
-  ]
-}