m8-codex-mcp 1.0.4 → 1.0.6

package/data/standards/07-router/index.md

@@ -1,141 +0,0 @@
-# 路由规范
-
-> 定义 M8 项目的路由配置规范。
-
-## 📁 文件位置
-
-```
-src/pages/[module_name]/
-├── [module_name].vue
-└── router.js          # 路由配置
-```
-
-构建时会自动将模块下的路由配置合并到 `pages.json`。
-
-## 📝 路由配置格式
-
-```javascript
-/**
- * router.js 无需 import 组件
- * path 路径与 vue 组件名称保持匹配
- * 有效参数只有 path 与 style
- */
-const routes = [
-  {
-    path: "pages/user_center/index",
-    style: {
-      navigationBarTitleText: "用户中心",
-      navigationStyle: "custom",
-      navigationBarTextStyle: "white",
-    },
-  },
-  {
-    path: "pages/user_center/profile",
-    style: {
-      navigationBarTitleText: "个人资料",
-    },
-  },
-];
-
-const options = {
-  // 是否自动分包
-  autoSubPackages: true,
-  // 是否为首页模块（autoSubPackages 为 true 时无效）
-  isFirstModule: false,
-};
-
-export default { routes, options };
-```
-
-## 📋 style 配置项
-
-| 属性                           | 类型    | 说明                           |
-| ------------------------------ | ------- | ------------------------------ |
-| `navigationBarTitleText`       | string  | 导航栏标题                     |
-| `navigationStyle`              | string  | 导航栏样式：`default`/`custom` |
-| `navigationBarTextStyle`       | string  | 标题颜色：`black`/`white`      |
-| `navigationBarBackgroundColor` | string  | 导航栏背景色                   |
-| `enablePullDownRefresh`        | boolean | 开启下拉刷新                   |
-| `disableScroll`                | boolean | 禁止页面滚动                   |
-
-## 🚀 页面跳转
-
-### ejs.page.open
-
-```javascript
-// 同模块跳转
-ejs.page.open("./profile");
-
-// 跨模块跳转
-ejs.page.open("../order/list");
-
-// 带参数跳转
-ejs.page.open({
-  pageUrl: "./detail",
-  data: {
-    id: "12345",
-  },
-  success: (result) => {
-    // 页面关闭后回调
-  },
-});
-```
-
-### 获取路由参数
-
-**Vue2**：
-
-```javascript
-created() {
-    const id = Util.getExtraDataByKey('id') || '';
-    this.loadData(id);
-}
-```
-
-**Vue3**：
-
-```typescript
-import { onLoad } from "@dcloudio/uni-app";
-
-onLoad((options) => {
-  const id = options?.id || "";
-  loadData(id);
-});
-```
-
-## ⚠️ 注意事项
-
-1. **无需 import**：router.js 中不需要导入组件
-2. **路径匹配**：path 必须与 vue 文件名对应
-3. **数组格式**：routes 必须是数组
-4. **有效参数**：仅 `path` 和 `style` 有效
-
-## 📦 分包配置
-
-```javascript
-const options = {
-  // 开启自动分包
-  autoSubPackages: true,
-};
-```
-
-分包后路由会自动放入 `subPackages`，减小主包体积。
-
-## 🏠 首页配置
-
-```javascript
-const options = {
-  autoSubPackages: false, // 必须关闭分包
-  isFirstModule: true, // 设为首页模块
-};
-```
-
-**注意**：所有模块仅支持一个首页模块。
-
-## ✅ 检查清单
-
-- [ ] router.js 放在模块目录下
-- [ ] routes 为数组格式
-- [ ] path 与 vue 文件名匹配
-- [ ] 未在 router.js 中 import 组件
-- [ ] 新页面已添加路由配置

package/data/standards/README.md

@@ -1,82 +0,0 @@
-# M8 前端开发规范文档
-
-> 📚 本规范文档为 M8 移动前端框架开发提供统一的编码标准与最佳实践指南。
-
-## 📖 文档索引
-
-| 编号 | 模块                | 说明                               | 快速链接                 |
-| ---- | ------------------- | ---------------------------------- | ------------------------ |
-| 01   | **项目规范**        | 项目结构、命名规范、版本检测       | [查看](./01-project/)    |
-| 02   | **Vue 规范**        | Vue2/Vue3 开发规范、组件、状态管理 | [查看](./02-vue/)        |
-| 03   | **CSS 规范**        | 样式规范、BEM 命名、性能优化       | [查看](./03-css/)        |
-| 04   | **API 规范**        | EJS API、Ajax 请求、Util 工具方法  | [查看](./04-api/)        |
-| 05   | **TypeScript 规范** | 类型定义、接口规范                 | [查看](./05-typescript/) |
-| 06   | **Mock 规范**       | 模拟数据规范                       | [查看](./06-mock/)       |
-| 07   | **路由规范**        | 路由配置与管理                     | [查看](./07-router/)     |
-
-## 🎯 核心原则
-
-1. **版本兼容** - 所有代码必须与检测到的 Vue 版本完全兼容
-2. **样式分离** - Vue 文件中禁止直接编写 CSS，统一使用外部 SCSS 文件
-3. **全局变量** - `Config`、`Util`、`ejs` 等全局变量直接使用，禁止 import 导入
-
-## 🚀 快速开始
-
-### 1. 确定 Vue 版本
-
-通过 `package.json` 中的 vue 依赖确定版本：
-
-- Vue2: `"vue": "^2.x.x"`
-- Vue3: `"vue": "^3.x.x"`
-
-### 2. 选择开发模式
-
-根据需求选择对应的开发模式：
-
-- **列表详情页** → 参考 [列表页示例](./02-vue/examples.md#列表页面)
-- **表单提交页** → 参考 [表单页示例](./02-vue/examples.md#表单页面)
-
-## 📁 标准项目结构
-
-```
-ejs.m8.project/
-├── src/
-│   ├── components/          # 通用组件
-│   ├── pages/               # 页面视图
-│   │   └── [module_name]/   # 模块目录
-│   │       ├── css/         # 样式文件
-│   │       │   └── [module_name].scss
-│   │       ├── images/      # 图片资源
-│   │       ├── [module_name].vue
-│   │       ├── router.js    # 路由配置
-│   │       ├── store.js     # 状态管理
-│   │       └── mock.js      # Mock 数据
-│   ├── shared/              # 配置文件
-│   ├── common/              # 通用文件
-│   └── static/              # 静态资源
-└── package.json
-```
-
-## 📋 规范检查清单
-
-开发完成后，请确保：
-
-- [ ] 代码与 Vue 版本兼容
-- [ ] CSS 代码已分离到独立 SCSS 文件
-- [ ] 全局变量（Config、Util）未使用 import 导入
-- [ ] 所有输入框已设置 placeholder
-- [ ] readonly 输入框已添加 `is-link` 和 `clickable` 属性
-- [ ] 组件 props、data、methods 已添加中文注释
-- [ ] 文件头部已添加标准注释
-- [ ] 路由已在 router.js 中正确配置
-
-## 🔗 相关资源
-
-- [统一入口文件](./_index.md) - 便于 AI/工具批量读取
-- [epoint-mrc-mcp 服务](#) - 组件与 API 检索
-
----
-
-**版本**: 1.0.0  
-**更新日期**: 2026-01-08  
-**维护团队**: 国泰新点软件股份有限公司

package/data/standards/_index.md

@@ -1,215 +0,0 @@
-# M8 前端开发规范 - 统一入口
-
-> 本文件汇总所有规范要点，便于 AI/工具快速读取。
-
----
-
-## 一、项目规范
-
-### 1.1 版本检测
-
-- Vue2: `"vue": "^2.x.x"` → Options API
-- Vue3: `"vue": "^3.x.x"` → Composition API + `<script setup>`
-- **必须验证代码与 Vue 版本兼容**
-
-### 1.2 目录结构
-
-```
-src/pages/[module_name]/
-├── css/[module_name].scss    # 样式文件
-├── images/                    # 图片资源
-├── [module_name].vue          # 页面组件
-├── router.js                  # 路由配置
-├── store.js                   # 状态管理
-└── mock.js                    # Mock 数据
-```
-
-### 1.3 命名规范
-
-| 类型      | 规则        | 示例                |
-| --------- | ----------- | ------------------- |
-| 页面文件  | 小写+下划线 | `user_list.vue`     |
-| 通用组件  | PascalCase  | `UserCard.vue`      |
-| 变量/函数 | camelCase   | `userName`          |
-| CSS 类名  | BEM + 小写  | `.user-card__title` |
-| 图片资源  | `img_` 前缀 | `img_logo.png`      |
-
-### 1.4 全局变量
-
-**禁止 import，直接使用**：`Config`、`Util`、`ejs`
-
----
-
-## 二、Vue 规范
-
-### 2.1 样式分离
-
-```vue
-<!-- 禁止内联 CSS，使用外部引入 -->
-<style lang="scss" scoped>
-@import "./css/[module_name].scss";
-</style>
-```
-
-### 2.2 API 优先原则
-
-| 场景     | 使用方案             |
-| -------- | -------------------- |
-| 消息提示 | `ejs.ui.toast`       |
-| 确认框   | `ejs.ui.confirm`     |
-| 日期选择 | `ejs.ui.pickDate`    |
-| 加载提示 | `ejs.ui.showWaiting` |
-
-### 2.3 输入框规范
-
-- readonly 必须添加 `is-link` + `clickable`
-- 必须设置 `placeholder`
-- textarea 建议添加 `autosize`
-
-### 2.4 注释规范
-
-**Vue 文件必须包含头部注释**（位于文件最顶部）：
-
-```vue
-<!--
- * @作者: author
- * @创建时间: 2025-01-08 14:20:03
- * @修改时间: 2025-01-08 14:20:03
- * @版本: [1.0]
- * @版权: 国泰新点软件股份有限公司
- * @描述: 页面功能描述
--->
-```
-
-| 字段        | 说明                             |
-| ----------- | -------------------------------- |
-| `@作者`     | 开发者姓名                       |
-| `@创建时间` | 格式：`YYYY-MM-DD HH:mm:ss`      |
-| `@修改时间` | 每次修改后需更新                 |
-| `@版本`     | 如 `[1.0]`、`[1.1]`              |
-| `@版权`     | 固定：`国泰新点软件股份有限公司` |
-| `@描述`     | 页面功能简要描述                 |
-
-### 2.5 样式穿透
-
-- Vue2: `::v-deep`
-- Vue3: `:deep()`
-
-### 2.6 状态管理
-
-- Vue2: Vuex (`store.js`)
-- Vue3: Pinia (`store.ts`)
-
----
-
-## 三、CSS 规范
-
-### 3.1 BEM 命名
-
-```scss
-.block {
-}
-.block__element {
-}
-.block--modifier {
-}
-```
-
-### 3.2 书写顺序
-
-1. 位置属性 (position, display)
-2. 大小属性 (width, margin)
-3. 文字属性 (font, color)
-4. 背景边框 (background, border)
-5. 其他 (animation)
-
-### 3.3 避免
-
-- 深层嵌套 (>3 层)
-- !important
-- 标签选择器
-
----
-
-## 四、API 规范
-
-### 4.1 Ajax 请求
-
-```javascript
-Util.ajax({
-  url: Config.serverUrl + "/api/data",
-  data: { params: JSON.stringify({ id: "123" }) },
-}).then((res) => {});
-```
-
-### 4.2 页面跳转
-
-```javascript
-ejs.page.open("./detail", { id: "123" });
-ejs.page.close();
-```
-
-### 4.3 常用验证
-
-```javascript
-Util.string.isMobile("18888888888"); // 手机号
-Util.string.isEmail("test@qq.com"); // 邮箱
-Util.string.isIdCard("..."); // 身份证
-```
-
----
-
-## 五、路由规范
-
-```javascript
-// router.js - 无需 import 组件
-const routes = [
-  {
-    path: "pages/[module]/[page]",
-    style: { navigationBarTitleText: "标题" },
-  },
-];
-export default { routes, options: { autoSubPackages: true } };
-```
-
----
-
-## 六、Mock 规范
-
-```javascript
-// mock.js
-import Mock from "@mock";
-const resultData = [
-  {
-    methodUrl: "/rest/api/list",
-    input: {},
-    output: Mock.mock({
-      "infolist|10": [{ title: () => Mock.Random.csentence() }],
-    }),
-  },
-];
-export default resultData;
-```
-
----
-
-## 七、TypeScript 规范
-
-- 显式声明类型
-- 禁止使用 `any`
-- 接口用 `I` 前缀：`IUserInfo`
-- 类型用 `T` 前缀：`TStatus`
-- 用常量对象替代枚举
-
----
-
-## 八、检查清单
-
-- [ ] 代码与 Vue 版本兼容
-- [ ] CSS 已分离到 scss 文件
-- [ ] 使用 scoped 样式
-- [ ] 全局变量未 import
-- [ ] readonly 输入框有 is-link
-- [ ] 文件有头部注释
-- [ ] 路由已配置
-- [ ] 变量有中文注释

package/dist/index.d.ts

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-/**
- * m8-generator-mcp - MCP Server 入口
- *
- * 提供 M8 框架开发辅助工具：
- * - get_component_usage: 获取 UI 组件用法
- * - generate_module_structure: 生成模块目录结构
- */
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/knowledge/index.d.ts

@@ -1,47 +0,0 @@
-/**
- * 知识库模块 - 索引管理
- *
- * 负责加载和管理 M8 框架的知识库文档
- */
-export interface ComponentDoc {
-    name: string;
-    filename: string;
-    description: string;
-    props: string;
-    events: string;
-    examples: string[];
-    rawContent: string;
-}
-export interface KnowledgeBase {
-    components: ComponentDoc[];
-    standards: string;
-    fullStandards: string;
-    standardDocs: Map<string, string>;
-    utilDocs: Map<string, string>;
-}
-/**
- * 加载知识库
- */
-export declare function loadKnowledgeBase(): KnowledgeBase;
-/**
- * 获取组件文档
- */
-export declare function getComponentDoc(kb: KnowledgeBase, componentName: string): ComponentDoc | undefined;
-/**
- * 获取完整规范文档
- * 返回 01-07 目录下所有规范文件的完整内容，确保生成代码时严格遵循
- */
-export declare function getStandardDocs(kb: KnowledgeBase): string;
-/**
- * 获取 Util 工具文档
- */
-export declare function getUtilDocs(kb: KnowledgeBase, keyword: string): string | undefined;
-/**
- * 获取规范文档（按关键词检索）
- */
-export declare function getStandardRules(kb: KnowledgeBase, category: string): string | undefined;
-/**
- * 获取所有规范类别
- */
-export declare function getStandardCategories(): string[];
-//# sourceMappingURL=index.d.ts.map

package/dist/knowledge/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/knowledge/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAYjD;AAqLD;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAQlG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CAazD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWlF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBxF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAUhD"}

package/dist/templates/vue2.d.ts

@@ -1,41 +0,0 @@
-/**
- * Vue 2 代码模板
- */
-interface TemplateOptions {
-    moduleName: string;
-    pageName: string;
-    author: string;
-    description: string;
-    dateStr: string;
-}
-/**
- * 生成 Vue 2 页面模板
- */
-export declare function generateVue2Template(options: TemplateOptions): string;
-/**
- * 生成 Vue 2 SCSS 模板
- */
-export declare function generateVue2ScssTemplate(options: {
-    moduleName: string;
-}): string;
-/**
- * 生成 Vue 2 路由模板
- */
-export declare function generateVue2RouterTemplate(options: {
-    moduleName: string;
-    pageName: string;
-}): string;
-/**
- * 生成 Vue 2 Store 模板
- */
-export declare function generateVue2StoreTemplate(options: {
-    moduleName: string;
-}): string;
-/**
- * 生成 Vue 2 Mock 模板
- */
-export declare function generateVue2MockTemplate(options: {
-    moduleName: string;
-}): string;
-export {};
-//# sourceMappingURL=vue2.d.ts.map

package/dist/templates/vue2.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vue2.d.ts","sourceRoot":"","sources":["../../src/templates/vue2.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU,eAAe;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CA6ErE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAmBhF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAuBpG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAsCjF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAiChF"}

package/dist/templates/vue3.d.ts

@@ -1,41 +0,0 @@
-/**
- * Vue 3 代码模板
- */
-interface TemplateOptions {
-    moduleName: string;
-    pageName: string;
-    author: string;
-    description: string;
-    dateStr: string;
-}
-/**
- * 生成 Vue 3 页面模板
- */
-export declare function generateVue3Template(options: TemplateOptions): string;
-/**
- * 生成 Vue 3 SCSS 模板
- */
-export declare function generateVue3ScssTemplate(options: {
-    moduleName: string;
-}): string;
-/**
- * 生成 Vue 3 路由模板
- */
-export declare function generateVue3RouterTemplate(options: {
-    moduleName: string;
-    pageName: string;
-}): string;
-/**
- * 生成 Vue 3 Store 模板 (Pinia)
- */
-export declare function generateVue3StoreTemplate(options: {
-    moduleName: string;
-}): string;
-/**
- * 生成 Vue 3 Mock 模板
- */
-export declare function generateVue3MockTemplate(options: {
-    moduleName: string;
-}): string;
-export {};
-//# sourceMappingURL=vue3.d.ts.map

package/dist/templates/vue3.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vue3.d.ts","sourceRoot":"","sources":["../../src/templates/vue3.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,UAAU,eAAe;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAuErE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAmBhF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAuBpG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAkCjF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAiChF"}

package/dist/tools/generate_module_structure.d.ts

@@ -1,22 +0,0 @@
-/**
- * 模块结构生成工具
- *
- * 生成符合 M8 规范的目录结构和文件模板
- */
-export interface GenerateModuleOptions {
-    moduleName: string;
-    pageName: string;
-    vueVersion: "2" | "3";
-    author: string;
-    description: string;
-    skipMock?: boolean;
-}
-export interface GeneratedFile {
-    path: string;
-    content: string;
-}
-/**
- * 生成模块文件列表
- */
-export declare function generateModuleFiles(options: GenerateModuleOptions): GeneratedFile[];
-//# sourceMappingURL=generate_module_structure.d.ts.map

package/dist/tools/generate_module_structure.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate_module_structure.d.ts","sourceRoot":"","sources":["../../src/tools/generate_module_structure.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,qBAAqB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,GAAG,GAAG,GAAG,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,EAAE,CAkEnF"}