m8-codex-mcp 1.0.0

package/data/m8mpdoc//346/240/270/345/277/203/351/200/232/347/224/250Util/345/267/245/345/205/267/345/272/223//345/267/245/345/205/267/345/207/275/346/225/260/345/272/223.md

@@ -0,0 +1,398 @@
+# 核心通用Util
+
+    框架内置`Util`工具库通过框架自动全局引入，代码中可以直接使用，无需额外引入。
+
+## 使用场景
+
+框架内置核心`Util`
+
+- `Util`编写时，内部使用
+
+- `Widget`编写时，内部使用
+
+- 项目中任何需要用到核心通用函数的地方
+
+## 方法说明
+
+注：此工具集下的方法通过`Util.method()`调用，如`Util.uuid()`
+
+### os
+
+判断当前的运行环境
+
+__系统环境判断__
+
+```js
+// Android环境与iOS只会有一个为true
+Util.os.android;
+Util.os.ios;
+```
+
+__容器环境判断__
+
+```js
+// ejs，dd，h5容器只会有一个为true
+// 分别代表`EJS`容器，`钉钉`容器，`其它`(包括普通浏览器)容器
+Util.os.ejs;
+Util.os.dd;
+Util.os.h5;
+```
+__其他容器判断__
+
+```js
+// M7_v7.4.2版本支持
+// 分别代表`微信`容器，`企业微信`容器，`政务微信`容器，同时也是h5环境
+Util.os.wechat;
+Util.os.wxWork;
+Util.os.wxWorkLoacl;
+```
+__更多功能__
+
+```js
+// Android环境下
+// 获取Android的版本号以及是否是非Chrome的Android环境
+Util.os.version;
+Util.os.isBadAndroid;
+
+// iOS环境下
+// 获取iOS的版本号以及是否是苹果手机，是否是pad
+Util.os.version;
+Util.os.iphone;
+Util.os.ipad;
+```
+
+
+### uuid(options)
+
+生成一个随机uuid
+
+**平台差异**
+
+|  H5   | 新点小程序 | 微信小程序 | 支付宝小程序 |
+| :---: | :--------: | :--------: | :----------: |
+|   √   |     √      |     √      |      √       |
+
+__参数说明__
+
+| 参数 | 参数类型 | 说明 |
+| :------------- |:-------------:|:-------------|
+| len | Number | 长度，默认为32位，最大不能超过36，最小不能小于4 |
+| radix | Number | 随机的基数，如果小于等于10代表只用纯数字，最大为62，最小为2，默认为62 |
+| type | String | 类别，默认为`default`代表 a-c-c-d-e的连线模式，如果为` noline`代表不会有连线 |
+
+**示例**
+
+```js
+// 生成一个8-4-4-4-12格式的 32位uuid，例如 yczYoFSp-ooru-ANjl-Hrgg-XgXmMxSN
+var uuid = Util.uuid();
+
+// 生成一个只有数字的36位 uuid，例如 52616056-5161-7170-8460-802618729824
+var uuid = Util.uuid({
+    len: 36,
+    radix: 10
+});
+
+// 生成一个没有下划线的10位 uuid，例如 xOvHy03wfA
+var uuid = Util.uuid({
+    len: 10,
+    type: 'noline'
+});
+```
+
+
+### getExtraDataByKey(key)
+
+通过传入key值，得到页面key的初始化传值，实际情况是获取 `window.location.href` 中的参数的值
+
+__注意：__
+
+微信、支付宝小程序不支持获取`window.location.href`参数。
+
+在跨端框架中，页面传递参数可以统一从页面的`onLoad函数`中获取上一个页面传递的参数。
+
+**平台差异**
+
+|  H5   | 新点小程序 | 微信小程序 | 支付宝小程序 |
+| :---: | :--------: | :--------: | :----------: |
+|   √   |     √      |     x      |      x       |
+
+__参数说明__
+
+| 参数 | 参数类型 | 说明 |
+| :------------- |:-------------:|:-------------|
+| key | String | 对应的key值 |
+
+__返回说明__
+
+| 参数 | 参数类型 | 说明 |
+| :------------- |:-------------:|:-------------|
+| value | String | 返回href中对应的key的value |
+
+**示例**
+
+```js
+//查询参数,key对应的value
+var value = Util.getExtraDataByKey(key);
+
+// 建议在跨端框架中统一使用页面的onLoad函数获取上一个页面传递的参数
+export default {
+    data: function() {
+        return {
+            key: ''
+        }
+    }
+    onLoad: function (option) { //option为object类型，会序列化上个页面传递的参数
+        this.key = option.key;
+    }
+}
+```
+
+
+### getFullUrlByParams(url, data)
+
+将json参数拼接到url中
+
+**平台差异**
+
+|  H5   | 新点小程序 | 微信小程序 | 支付宝小程序 |
+| :---: | :--------: | :--------: | :----------: |
+|   √   |     √      |     √      |      √       |
+
+__参数说明__
+
+| 参数 | 参数类型 | 说明 |
+| :------------- |:-------------:|:-------------|
+| url | String | `必填`，需要拼接的url |
+| data | JSON | `必填`，对应需要拼接的JSON参数 |
+| isType | Boolean | `选填`，是否相对路径。 默认`false`，微信，支付宝小程序不支持istype=ture相对路径选项 |
+
+**示例**
+
+```js
+var url = 'http://app.epoint.com.cn/m8fedoc';
+var data = {
+    'key1': 'value1'
+};
+
+// 例如返回: http://app.epoint.com.cn/m8fedoc?key1=value1
+var finalUrl = Util.getFullUrlByParams(url, data);
+```
+
+### noop
+
+空函数
+
+**平台差异**
+
+|  H5   | 新点小程序 | 微信小程序 | 支付宝小程序 |
+| :---: | :--------: | :--------: | :----------: |
+|   √   |     √      |     √      |      √       |
+
+**示例**
+
+```js
+// 这个空函数: function() {};
+var noop = Util.noop;
+```
+
+### extend(deep, target, source1, source...)
+
+合并多个对象
+
+**平台差异**
+
+|  H5   | 新点小程序 | 微信小程序 | 支付宝小程序 |
+| :---: | :--------: | :--------: | :----------: |
+|   √   |     √      |     √      |      √       |
+
+__参数说明__
+
+| 参数 | 参数类型 | 说明 |
+| :------------- |:-------------:|:-------------|
+| deep | Boolean | 为true时会进行递归合并，可以省略（代表默认`false`） |
+| target | Object | `必填`，需要合并的目标对象，这个对象会随之修改，并且作为返回值 |
+| object1 | Object | `必填`，需要合并的目标对象 |
+| objectN | Object | 需要合并的目标对象 |
+
+**示例**
+
+```js
+var target = {
+  company: "epoint",
+  product: {
+    ejs: "ejs混合开发方案"
+  }
+};
+
+var obj1 = {
+  city: "suzhou",
+  product: {
+    m7: "m7移动框架"
+  }
+};
+
+// 非递归合并
+var newObj1 = Util.extend({}, target, object1);
+
+// 输出：{"company": "epoint", "product": {"m7": "m7移动框架"}, "city": "suzhou"}
+console.log(JSON.stringify(newObj1));
+
+// 递归合并
+var newObj2 = Util.extend(true, {}, target, obj1);
+
+// 输出：{"company": "epoint", "product": {"ejs": "ejs混合开发方案", "m7": "m7移动框架"}, "city": "suzhou"}
+console.log(JSON.stringify(newObj2));
+```
+
+### each(object, handler)
+
+遍历对象或数组
+
+**平台差异**
+
+|  H5   | 新点小程序 | 微信小程序 | 支付宝小程序 |
+| :---: | :--------: | :--------: | :----------: |
+|   √   |     √      |     √      |      √       |
+
+__参数说明__
+
+| 参数 | 参数类型 | 说明 |
+| :------------- |:-------------:|:-------------|
+| object | Object或Array | `必填`，需要遍历的对象或数组，若为对象，仅遍历对象根节点下的key |
+| handler | Function(Integer或String, Anything element) | `必填`，每个元素执行的回调函数；其中，index表示当前元素的下标或key(下标从0开始)，element表示当前匹配元素 |
+
+**示例**
+
+```js
+var array = [1,2,3];
+
+Util.each(array, function(index,item) {
+  console.log(item*item);
+});
+```
+
+### getProjectBasePath(patten)
+
+得到项目的根路径
+
+**平台差异**
+
+|  H5   | 新点小程序 | 微信小程序 | 支付宝小程序 |
+| :---: | :--------: | :--------: | :----------: |
+|   √   |     √      |     x      |      x       |
+
+__参数说明__
+
+| 参数 | 参数类型 | 说明 |
+| :------------- |:-------------:|:-------------|
+| patten | String | 匹配模式，如果在其它文件夹下面，需要换为对应的目录 |
+
+**示例**
+
+```js
+// 例如页面地址为http://127.0.0.1:5500/ejs.m8.mobileframe/dist/build/h5/index.html#/pages/utils/core
+
+// 结果: http://127.0.0.1:5500/ejs.m8.mobileframe/
+var basePath = Util.getProjectBasePath();
+
+// 结果: http://127.0.0.1:5500/ejs.m8.mobileframe/dist/build/
+var basePath2 = Util.getProjectBasePath('/h5/');
+```
+
+上述示例项目对应的目录结构为
+
+```
+ejs.m8.mobileframe
+    |- dist
+    |   |- build        
+    |    |    |- h5      
+    |    |    |   |- index.html      // 页面index.html路径
+```
+
+
+
+### getPathSuffix(path)
+
+得到文件的后缀
+
+**平台差异**
+
+|  H5   | 新点小程序 | 微信小程序 | 支付宝小程序 |
+| :---: | :--------: | :--------: | :----------: |
+|   √   |     √      |     √      |      √       |
+
+__参数说明__
+
+| 参数 | 参数类型 | 说明 |
+| :------------- |:-------------:|:-------------|
+| path | String |`必填`， 对应文件路径 |
+
+**示例**
+
+```js
+var path = 'pages/test.js';
+
+// 返回: 'js'
+var suffix = Util.getPathSuffix(path);
+```
+
+### dataProcess(response, options)
+
+处理返回数据，返回按指令处理过后的最终数据
+
+**平台差异**
+
+|  H5   | 新点小程序 | 微信小程序 | 支付宝小程序 |
+| :---: | :--------: | :--------: | :----------: |
+|   √   |     √      |     √      |      √       |
+
+__参数说明__
+
+| 参数 | 参数类型 | 说明 |
+| :------------- |:-------------:|:-------------|
+| response | JSON | `必填`，需要处理的数据 |
+| options | Object | 配置信息 |
+| options.dataPath | String或Array | 需要获取的路径指令 |
+
+__返回说明__
+
+返回一个`result`，以下是`result`中的对象
+
+注意，如果`dataPath`没传，默认不会处理数据，即返回的是原始数据`response`
+
+| 参数 | 参数类型 | 说明 |
+| :------------- |:-------------:|:-------------|
+| code | Number | 处理完的结果，为`1`代表处理成功，`0`代表失败，一般失败的原因是接口返回的`status`不正确或者格式不匹配 |
+| message | String | 处理完后的提示，例如错误信息提示等 |
+| data | JSON | 处理完后的最终数据，如果没有获取到对应节点下的数据，为`null` |
+
+**示例**
+
+```js
+var response = {
+    "custom": {
+        "infolist": [{
+            "title": "测试的title",
+            "guid": "131830"
+        }]
+    },
+    "status": {
+        "code": 1,
+        "text": "成功",
+        "url": ""
+    }
+};
+
+// 直接处理数据
+var result = Util.dataProcess(response, {
+    dataPath: 'custom.infolist'
+});
+
+// result.data才是最终数据
+console.log(result.data);
+
+// 或者也可以这样处理，这样会一直处理路径数组中的每一个，直到拿到数据为止或结束
+var result = Util.dataProcess(response, {
+    dataPath: ['custom.infolist', 'custom.infoList']
+});
+```

package/data/standards/01-project/naming.md

@@ -0,0 +1,158 @@
+# 命名规范
+
+> 定义 M8 项目中各类资源的命名规则。
+
+## 📝 文件命名
+
+### Vue 文件
+
+| 类型     | 规则                     | 示例                                |
+| -------- | ------------------------ | ----------------------------------- |
+| 页面组件 | 小写字母 + 数字 + 下划线 | `user_list.vue`, `order_detail.vue` |
+| 通用组件 | PascalCase（大驼峰）     | `UserCard.vue`, `SearchBar.vue`     |
+
+**禁止规则**：
+
+- ❌ 禁止使用中文
+- ❌ 禁止使用特殊字符
+- ❌ 禁止使用大写字母（页面组件）
+
+```
+✅ 正确: user_profile.vue, order_list.vue
+❌ 错误: UserProfile.vue, 用户列表.vue, order-list.vue
+```
+
+### 资源文件
+
+| 类型 | 规则                | 示例                             |
+| ---- | ------------------- | -------------------------------- |
+| 图片 | `img_` 前缀 + 描述  | `img_logo.png`, `img_banner.jpg` |
+| 图标 | `icon_` 前缀 + 描述 | `icon_home.svg`, `icon_user.png` |
+| 样式 | 与 Vue 文件同名     | `login.scss`, `user_list.scss`   |
+
+### 目录命名
+
+| 类型     | 规则              | 示例                          |
+| -------- | ----------------- | ----------------------------- |
+| 模块目录 | 小写字母 + 下划线 | `user_center`, `order_manage` |
+| 组件目录 | `components`      | 固定名称                      |
+| 样式目录 | `css`             | 固定名称                      |
+| 图片目录 | `images`          | 固定名称                      |
+
+## 🏷️ 代码命名
+
+### JavaScript/TypeScript
+
+| 类型 | 规则                  | 示例                              |
+| ---- | --------------------- | --------------------------------- |
+| 变量 | camelCase（小驼峰）   | `userName`, `orderList`           |
+| 常量 | UPPER_SNAKE_CASE      | `MAX_COUNT`, `API_BASE_URL`       |
+| 函数 | camelCase             | `getUserInfo()`, `handleSubmit()` |
+| 类   | PascalCase            | `UserService`, `OrderManager`     |
+| 接口 | PascalCase + `I` 前缀 | `IUserInfo`, `IOrderData`         |
+| 类型 | PascalCase + `T` 前缀 | `TStatus`, `TCallback`            |
+
+**变量声明原则**：
+
+```javascript
+// ✅ 优先使用 const
+const userName = "admin";
+const userList = [];
+
+// ⚠️ 仅在需要重新赋值时使用 let
+let currentPage = 1;
+currentPage = 2;
+
+// ❌ 禁止使用 var
+var oldStyle = "deprecated";
+```
+
+### CSS 命名
+
+采用 **BEM 命名规范**：
+
+| 类型               | 格式               | 示例                             |
+| ------------------ | ------------------ | -------------------------------- |
+| 块（Block）        | `.block`           | `.card`, `.header`               |
+| 元素（Element）    | `.block__element`  | `.card__title`, `.header__logo`  |
+| 修饰符（Modifier） | `.block--modifier` | `.card--active`, `.btn--primary` |
+
+```scss
+// ✅ 正确的 BEM 命名
+.user-card {
+  &__avatar {
+    /* 元素 */
+  }
+  &__name {
+    /* 元素 */
+  }
+  &--vip {
+    /* 修饰符 */
+  }
+}
+
+// ❌ 错误示例
+.userCard {
+  /* 禁止驼峰 */
+}
+.UserCard {
+  /* 禁止大写 */
+}
+```
+
+**class/id 命名规则**：
+
+- ✅ 使用小写字母
+- ✅ 使用中划线连接
+- ❌ 禁止使用大写
+- ❌ 禁止使用驼峰
+- ❌ 避免过度简写
+
+## 🛣️ 路由命名
+
+```javascript
+const routes = [
+  {
+    // 格式: pages/[module_name]/[page_name]
+    path: "pages/user_center/profile",
+    style: {
+      navigationBarTitleText: "个人中心",
+    },
+  },
+];
+```
+
+## 📦 Store 命名
+
+### Vue2 (Vuex)
+
+```javascript
+export default {
+  // 模块名与目录名一致
+  moduleName: "user_center",
+  namespaced: true,
+  state: {},
+  mutations: {},
+  actions: {},
+};
+```
+
+### Vue3 (Pinia)
+
+```typescript
+// 命名规则: use + 模块名 + Store
+export const useUserCenterStore = defineStore("user_center", {
+  state: () => ({}),
+  getters: {},
+  actions: {},
+});
+```
+
+## ✅ 命名检查清单
+
+- [ ] 页面 Vue 文件使用小写 + 下划线
+- [ ] 通用组件使用 PascalCase
+- [ ] 变量/函数使用 camelCase
+- [ ] 常量使用 UPPER_SNAKE_CASE
+- [ ] CSS 类名使用 BEM 规范
+- [ ] 图片资源使用 `img_` 前缀

package/data/standards/01-project/structure.md

@@ -0,0 +1,106 @@
+# 项目结构规范
+
+> 定义 M8 项目的标准目录结构与文件组织方式。
+
+## 📁 标准目录结构
+
+```
+ejs.m8.project/
+├── src/
+│   ├── components/              # 通用组件目录
+│   │   └── [ComponentName].vue  # PascalCase 命名
+│   │
+│   ├── pages/                   # 页面视图目录
+│   │   └── [module_name]/       # 模块目录（小写+下划线）
+│   │       ├── css/             # 样式文件目录
+│   │       │   └── [page_name].scss
+│   │       ├── images/          # 模块图片资源
+│   │       ├── [page_name].vue  # 页面组件
+│   │       ├── router.js        # 路由配置
+│   │       ├── store.js         # 状态管理（Vue2: Vuex）
+│   │       ├── store.ts         # 状态管理（Vue3: Pinia）
+│   │       └── mock.js          # Mock 数据定义
+│   │
+│   ├── shared/                  # 配置文件目录
+│   │   └── config.js            # 全局配置
+│   │
+│   ├── common/                  # 通用文件目录
+│   │   └── css/
+│   │       └── common.extend    # 拓展样式
+│   │
+│   └── static/                  # 静态资源目录
+│       └── [module_name]/       # 按模块存放静态资源
+│           └── img_[name].png   # 图片以 img_ 为前缀
+│
+├── package.json
+└── pages.json                   # 路由配置汇总（自动生成）
+```
+
+## 📄 文件组织规则
+
+### 1. 页面文件组织
+
+每个业务模块应包含以下文件：
+
+| 文件                     | 必需 | 说明                     |
+| ------------------------ | ---- | ------------------------ |
+| `[module_name].vue`      | ✅   | 页面主组件               |
+| `css/[module_name].scss` | ✅   | 页面样式（禁止内联样式） |
+| `router.js`              | ✅   | 路由配置                 |
+| `store.js/store.ts`      | ❌   | 状态管理（按需）         |
+| `mock.js`                | ❌   | Mock 数据（开发阶段）    |
+| `images/`                | ❌   | 模块专用图片资源         |
+
+### 2. 样式文件分离
+
+**规则**：Vue 文件中禁止直接编写 CSS 代码
+
+```
+src/pages/login/
+├── login.vue           # 页面组件
+└── css/
+    └── login.scss      # 对应的样式文件
+```
+
+**Vue 文件中引用方式**：
+
+```vue
+<!-- style 标签与 script 标签同级 -->
+<style lang="scss" scoped>
+@import "./css/login.scss";
+</style>
+```
+
+### 3. 静态资源存放
+
+```
+static/
+├── notice/              # 与路由模块同名
+│   ├── img_banner.png   # 以 img_ 为前缀
+│   └── img_icon.png
+└── login/
+    └── img_logo.png
+```
+
+**引用方式**：
+
+```html
+<image src="/static/notice/img_banner.png" />
+```
+
+## 🔒 强制规则
+
+| 规则             | 说明                 |
+| ---------------- | -------------------- |
+| 样式必须分离     | Vue 文件禁止内联 CSS |
+| 使用 scoped 样式 | 避免全局样式污染     |
+| 模块化存放       | 按模块组织文件       |
+| 统一命名         | 同模块文件名保持一致 |
+
+## ✅ 检查清单
+
+- [ ] 页面组件放置在 `src/pages/[module_name]/` 下
+- [ ] 样式文件放置在 `css/` 子目录
+- [ ] 静态资源放置在 `static/[module_name]/` 下
+- [ ] 图片命名以 `img_` 为前缀
+- [ ] 路由配置在 `router.js` 中定义