vue2server7 7.0.118 → 7.0.119

package/test/mini2.0-main/components.d.ts

@@ -0,0 +1,21 @@
+/* eslint-disable */
+// @ts-nocheck
+// biome-ignore lint: disable
+// oxlint-disable
+// ------
+// Generated by unplugin-vue-components
+// Read more: https://github.com/vuejs/core/pull/3399
+
+export {}
+
+/* prettier-ignore */
+declare module 'vue' {
+  export interface GlobalComponents {
+    RouterLink: typeof import('vue-router')['RouterLink']
+    RouterView: typeof import('vue-router')['RouterView']
+    VanButton: typeof import('vant/es')['Button']
+    VanCellGroup: typeof import('vant/es')['CellGroup']
+    VanField: typeof import('vant/es')['Field']
+    VanForm: typeof import('vant/es')['Form']
+  }
+}

package/test/mini2.0-main/docs/MX_API.md

@@ -0,0 +1,244 @@
+# MX 原生桥接 API 使用指南
+
+## 概述
+
+`core/mxApi` 是敏行混合应用的原生桥接模块，提供与原生 Android/iOS 应用通信的能力。
+
+## 功能列表
+
+### UI 控制
+
+```typescript
+import { hideWebViewTitle, showOptionMenu, setCustomHeaderMenu } from '@/core/mxApi'
+
+// 隐藏原生标题栏
+hideWebViewTitle()
+
+// 显示右上角菜单
+showOptionMenu()
+
+// 设置自定义菜单
+setCustomHeaderMenu({
+  menus: [
+    { id: '1', title: '设置' },
+    { id: '2', title: '关于' }
+  ]
+})
+```
+
+### 获取用户信息
+
+```typescript
+import { getCurrentUser } from '@/core/mxApi'
+
+const user = await getCurrentUser()
+console.log(user.id, user.name, user.token)
+```
+
+### 选人组件
+
+```typescript
+import { MXSelectUsers } from '@/core/mxApi'
+
+const users = await MXSelectUsers({
+  enableSelectDept: false,  // 是否允许选择部门
+  canSelectSelf: true       // 是否可选自己
+})
+
+console.log('选中的用户:', users)
+```
+
+### 原生 HTTP 请求（绕过跨域）
+
+```typescript
+import { ajaxGet, ajaxPost, ajaxPut, ajaxDelete } from '@/core/mxApi'
+
+// GET 请求
+const { data } = await ajaxGet('/api/users', { page: 1, limit: 10 })
+
+// POST 请求
+const { data } = await ajaxPost('/api/users', { name: '张三' })
+
+// PUT 请求
+await ajaxPut('/api/users/123', { name: '李四' })
+
+// DELETE 请求
+await ajaxDelete('/api/users', '123')
+```
+
+### 环境检测
+
+```typescript
+import { isNativeApp } from '@/core/mxApi'
+
+if (isNativeApp()) {
+  // 在原生环境中，可使用所有原生 API
+  const user = await getCurrentUser()
+} else {
+  // 在浏览器中，使用 axios 或降级方案
+  import('@/utils/request').then(({ request }) => {
+    // 使用 axios 发起请求
+  })
+}
+```
+
+## 与 axios 的区别
+
+| 特性 | axios | MX ajax |
+|------|-------|---------|
+| 跨域限制 | 受同源策略限制 | 无限制 |
+| 认证信息 | 需手动添加 Token | 可复用原生层认证 |
+| 网络代理 | 无 | 使用原生层代理配置 |
+| SSL 证书 | 浏览器验证 | 可使用企业证书 |
+| 适用环境 | 浏览器、WebView | 仅混合应用原生环境 |
+
+## 项目中的两种 HTTP 方案
+
+### 方案 1：axios（默认）
+
+```typescript
+// src/utils/request.ts
+import axios from 'axios'
+import { apiConfig } from '@/config/env'
+
+const service = axios.create({
+  baseURL: apiConfig.baseURL,
+  timeout: apiConfig.timeout,
+})
+
+export default service
+```
+
+**适用场景**：
+- 浏览器开发调试
+- 不需要绕过跨域限制
+- 使用标准 RESTful API
+
+### 方案 2：原生 AJAX
+
+```typescript
+// src/core/mxApi/index.ts
+import { ajaxGet, ajaxPost } from '@/core/mxApi'
+
+// 使用原生 HTTP 客户端
+const { data } = await ajaxGet('/api/users')
+```
+
+**适用场景**：
+- 需要绕过浏览器跨域限制
+- 使用原生层认证信息
+- 需要企业证书支持
+- 在敏行 App 中运行
+
+## 智能切换示例
+
+```typescript
+import { isNativeApp, ajaxGet as nativeGet } from '@/core/mxApi'
+import { request } from '@/utils/request'
+
+export async function fetchUsers(page: number) {
+  if (isNativeApp()) {
+    // 使用原生 AJAX
+    const { data } = await nativeGet('/api/users', { page })
+    return data
+  } else {
+    // 使用 axios
+    const res = await request({
+      url: '/api/users',
+      params: { page }
+    })
+    return res.data
+  }
+}
+```
+
+## 注意事项
+
+### 1. 设备就绪机制
+
+mxApi 内置任务队列，在设备未就绪时会自动缓存调用请求。无需手动处理 `deviceready` 事件。
+
+### 2. 环境变量
+
+原生 AJAX 使用 `VITE_API_BASE_URL` 作为基础 URL，与 axios 配置保持一致。
+
+### 3. 错误处理
+
+当原生接口不存在时，会抛出错误。建议在调用前检测环境：
+
+```typescript
+import { isNativeApp } from '@/core/mxApi'
+
+if (!isNativeApp()) {
+  showToast('请在敏行 App 中使用此功能')
+  return
+}
+```
+
+### 4. TypeScript 类型支持
+
+所有 API 都有完整的类型定义，包括：
+- `MXUser` - 用户信息
+- `MXSelectUsersOptions` - 选人配置
+- `MXAjaxResponse<T>` - AJAX 响应
+
+## 开发调试
+
+在浏览器中开发时，原生接口不可用。建议：
+
+1. **使用条件判断**：根据环境选择不同的请求方式
+2. **使用 Vant 组件**：如 `showToast` 显示提示
+3. **日志输出**：mxApi 会自动输出调用日志
+
+```typescript
+// 开发环境提示
+if (!isNativeApp()) {
+  console.warn('当前为浏览器环境，原生 API 不可用')
+}
+```
+
+## 完整示例
+
+```vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { showToast } from 'vant'
+import { isNativeApp, getCurrentUser, MXSelectUsers } from '@/core/mxApi'
+import type { MXUser } from '@/core/mxApi'
+
+const user = ref<MXUser | null>(null)
+const selectedUsers = ref<MXUser[]>([])
+
+onMounted(async () => {
+  if (isNativeApp()) {
+    try {
+      user.value = await getCurrentUser()
+      showToast(`欢迎, ${user.value.name}`)
+    } catch (err) {
+      console.error('获取用户失败:', err)
+    }
+  }
+})
+
+const handleSelectUsers = async () => {
+  if (!isNativeApp()) {
+    showToast('请在敏行 App 中使用')
+    return
+  }
+
+  try {
+    selectedUsers.value = await MXSelectUsers()
+    showToast(`已选择 ${selectedUsers.value.length} 人`)
+  } catch (err) {
+    console.error('选人失败:', err)
+  }
+}
+</script>
+
+<template>
+  <div>
+    <van-cell title="当前用户" :value="user?.name || '未登录'" />
+    <van-button @click="handleSelectUsers">选择联系人</van-button>
+  </div>
+</template>
+```

package/test/mini2.0-main/docs/REQUEST.md

@@ -0,0 +1,217 @@
+# 统一请求中转层使用指南
+
+## 概述
+
+`core/request` 是请求中转层，**接口与 `src/utils/request.ts` 完全一致**。
+
+```
+应用层（API 模块）
+    │
+    ▼
+┌─────────────────────────────────────┐
+│   中转层 core/request                │
+│                                     │
+│   request()  ← 与 utils/request 接口一致 │
+│                                     │
+│   • 自动环境检测                     │
+│   • 统一请求头管理                   │
+│   • Token 管理                      │
+└───────────────┬─────────────────────┘
+                │
+      ┌─────────┴─────────┐
+      ▼                   ▼
+ ┌────────┐         ┌────────┐
+ │ axios  │         │ mxApi  │
+ │(已封装) │         │(原生)   │
+ └────────┘         └────────┘
+```
+
+---
+
+## 核心特性
+
+### 1. 接口完全一致
+
+```typescript
+// 原来使用 utils/request
+import { request } from '@/utils/request'
+
+// 现在使用 core/request（接口完全一致）
+import { request } from '@/core/request'
+
+// 用法完全相同，无需修改任何调用代码
+const res = await request<UserInfo>({ url: '/user/1' })
+```
+
+### 2. 自动环境检测
+
+- **浏览器环境**：调用 `utils/request`（axios 封装）
+- **原生环境**：调用 `core/mxApi`（原生 AJAX）
+
+### 3. 统一请求头
+
+所有请求自动携带：
+- `Content-Type: application/json`
+- `Authorization: Bearer {token}`（如有）
+
+---
+
+## 使用方式
+
+### Token 管理
+
+```typescript
+import { setToken, getToken, clearToken } from '@/core/request'
+
+// 登录后保存 Token
+setToken('your-jwt-token')
+
+// 获取 Token
+const token = getToken()
+
+// 退出登录
+clearToken()
+```
+
+### 请求函数
+
+```typescript
+import { request } from '@/core/request'
+
+// GET 请求
+const user = await request<UserInfo>({ url: '/user/1' })
+
+// POST 请求
+const { token } = await request<{ token: string }, LoginParams>({
+  url: '/login',
+  method: 'POST',
+  data: { username: 'admin', password: '123' }
+})
+
+// 带查询参数
+const users = await request<UserList>({
+  url: '/users',
+  params: { page: 1, limit: 10 }
+})
+
+// 自定义请求头
+const res = await request({
+  url: '/upload',
+  method: 'POST',
+  data: formData,
+  headers: { 'Content-Type': 'multipart/form-data' }
+})
+```
+
+---
+
+## API 模块示例
+
+### 用户模块
+
+```typescript
+// src/api/user.ts
+import { request } from '@/core/request'
+
+interface UserInfo {
+  id: number
+  username: string
+  avatar: string
+}
+
+export function getUserInfo(id: number) {
+  return request<UserInfo>({ url: `/user/${id}` })
+}
+
+export function login(data: { username: string; password: string }) {
+  return request<{ token: string }, typeof data>({
+    url: '/login',
+    method: 'POST',
+    data
+  })
+}
+
+export function updateUser(id: string, data: UpdateUserParams) {
+  return request<User, typeof data>({
+    url: `/user/${id}`,
+    method: 'PUT',
+    data
+  })
+}
+
+export function deleteUser(id: string) {
+  return request({
+    url: `/user/${id}`,
+    method: 'DELETE'
+  })
+}
+```
+
+### 在组件中使用
+
+```vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { showToast } from 'vant'
+import { getUserInfo, login } from '@/api/user'
+import { setToken } from '@/core/request'
+
+const user = ref<UserInfo | null>(null)
+
+onMounted(async () => {
+  try {
+    const res = await getUserInfo(1)
+    user.value = res.data
+  } catch (error) {
+    showToast('获取用户失败')
+  }
+})
+
+const handleLogin = async () => {
+  try {
+    const res = await login({
+      username: 'admin',
+      password: '123'
+    })
+    setToken(res.data.token)
+    showToast('登录成功')
+  } catch (error) {
+    showToast('登录失败')
+  }
+}
+</script>
+
+<template>
+  <div>
+    <van-cell title="用户名" :value="user?.username" />
+    <van-button @click="handleLogin">登录</van-button>
+  </div>
+</template>
+```
+
+---
+
+## 导出说明
+
+| 导出 | 类型 | 说明 |
+|------|------|------|
+| `request` | 函数 | 核心中转函数，与 `utils/request` 接口一致 |
+| `setToken` | 函数 | 设置 Token |
+| `getToken` | 函数 | 获取 Token |
+| `clearToken` | 函数 | 清除 Token |
+| `getCommonHeaders` | 函数 | 获取公共请求头 |
+| `RequestConfig` | 类型 | 请求配置接口 |
+
+---
+
+## 与 utils/request 的关系
+
+| 特性 | utils/request | core/request |
+|------|---------------|--------------|
+| 底层实现 | axios | axios + mxApi |
+| 环境支持 | 仅浏览器 | 浏览器 + 原生 |
+| 接口格式 | ✅ | ✅ 完全一致 |
+| Token 管理 | ❌ | ✅ 内置 |
+| 请求头管理 | 分散 | 统一 |
+
+**核心优势**：只需将 `import { request } from '@/utils/request'` 改为 `import { request } from '@/core/request'`，即可自动获得原生环境支持，无需修改任何业务代码。

package/test/mini2.0-main/docs/package-json-guide.md

@@ -0,0 +1,132 @@
+# package.json 说明
+
+## 项目信息
+
+| 字段 | 值 | 说明 |
+|------|-----|------|
+| `name` | `mini2.0` | 项目名称 |
+| `version` | `0.0.0` | 当前版本（开发初期未正式定版） |
+| `private` | `true` | 私有项目，禁止发布到 npm |
+| `type` | `module` | 使用 ES Module 规范（`import/export`） |
+| `engines.node` | `^20.19.0 \|\| >=22.12.0` | 要求 Node.js 20.19+ 或 22.12+ |
+
+---
+
+## 脚本命令（scripts）
+
+### 开发
+
+| 命令 | 作用 |
+|------|------|
+| `npm run dev` | 启动 Vite 开发服务器（默认 `.env.development` 环境变量） |
+| `npm run dev:test` | 以 test 模式启动开发服务器，加载 `.env.test` 环境变量，用于本地联调测试环境接口 |
+
+### 构建
+
+| 命令 | 作用 |
+|------|------|
+| `npm run build` | 生产构建，先运行 TypeScript 类型检查（`vue-tsc --build`），再执行 Vite 构建 |
+| `npm run build:test` | 测试环境构建，串行执行类型检查 + Vite 构建（`--mode test`） |
+| `npm run build:prod` | 生产环境构建，串行执行类型检查 + Vite 构建（`--mode production`） |
+| `npm run build-only` | **仅**执行 Vite 构建，不做类型检查，适合快速出包调试 |
+| `npm run build-only:test` | 仅构建，使用 test 模式 |
+| `npm run build-only:prod` | 仅构建，使用 production 模式 |
+| `npm run preview` | 启动 Vite 静态文件预览服务器，用于本地查看构建产物 |
+
+> `build` 命令使用 `npm-run-all2` 的 `run-p`（并行）执行类型检查和构建；`build:test` / `build:prod` 使用 `run-s`（串行）先类型检查再构建。
+
+### 代码质量
+
+| 命令 | 作用 |
+|------|------|
+| `npm run lint` | 串行执行所有 `lint:*` 子命令 |
+| `npm run lint:oxlint` | 使用 OxLint 对代码做快速 lint 检查并自动修复 |
+| `npm run lint:eslint` | 使用 ESLint 做完整 lint 检查并自动修复，结果会缓存（`--cache`） |
+| `npm run format` | 使用 Prettier 格式化 `src/` 目录下的代码 |
+
+> `npm run lint` 会先执行 oxlint 再执行 eslint，两者分工：oxlint 速度快，适合捕获常见错误；eslint 规则更全面，特别是 Vue/TypeScript 相关规则。
+
+---
+
+## 生产依赖（dependencies）
+
+这些包会被打包到最终产物中，直接影响用户侧。
+
+| 包名 | 版本 | 作用 |
+|------|------|------|
+| `vue` | `^3.5.32` | Vue 3 核心框架，提供响应式系统、组件系统和模板编译 |
+| `vue-router` | `^5.0.4` | Vue 官方路由，管理页面导航和 URL 映射 |
+| `pinia` | `^3.0.4` | Vue 官方状态管理库，替代 Vuex，支持组合式 API |
+| `vant` | `^4.9.24` | 有赞出品的移动端 Vue 3 组件库，提供丰富的 UI 组件（按钮、弹窗、表单等） |
+| `axios` | `^1.16.1` | HTTP 客户端，用于发起 API 请求，支持拦截器、取消请求等 |
+| `@iconify/vue` | `^5.0.1` | Iconify 图标库的 Vue 组件封装，可使用数千个图标集（如 Material Design、Tabler 等） |
+| `@vueuse/core` | `^14.3.0` | Vue 组合式工具函数集，提供 `useStorage`、`useDebounceFn`、`useClipboard` 等常用 hooks |
+| `dayjs` | `^1.11.21` | 轻量级日期时间处理库（仅 2KB），Moment.js 的替代品 |
+| `crypto-js` | `^4.2.0` | 加密算法库，支持 AES、MD5、SHA 等，用于前端数据加密/签名 |
+| `clipboard` | `^2.0.11` | 剪贴板操作库，实现一键复制文本到系统剪贴板 |
+| `nprogress` | `^0.2.0` | 页面顶部细线进度条，常用于路由切换或接口请求时的加载反馈 |
+| `qrcode` | `^1.5.4` | 二维码生成库，可在 Canvas/SVG/Node.js 中生成二维码图片 |
+
+---
+
+## 开发依赖（devDependencies）
+
+这些包仅在开发/构建阶段使用，不会进入最终产物。
+
+### 构建工具
+
+| 包名 | 版本 | 作用 |
+|------|------|------|
+| `vite` | `^8.0.8` | 下一代前端构建工具，提供极快的冷启动和热更新 |
+| `@vitejs/plugin-vue` | `^6.0.6` | Vite 官方 Vue 插件，处理 `.vue` 单文件组件的编译 |
+| `vite-plugin-vue-devtools` | `^8.1.1` | Vue DevTools 的 Vite 插件集成，开发时提供组件树、状态检查等调试能力 |
+| `unplugin-vue-components` | `^32.1.0` | 组件自动导入插件，无需手动 `import` 即可使用 Vant 等组件（按需引入） |
+| `postcss-px-to-viewport-8-plugin` | `^1.2.5` | PostCSS 插件，自动将 CSS 中的 `px` 单位转换为 `vw`，实现移动端视口适配 |
+| `less` | `^4.6.4` | Less CSS 预处理器，支持变量、嵌套、混入等语法 |
+| `npm-run-all2` | `^8.0.4` | 提供 `run-s`（串行）和 `run-p`（并行）命令，用于组合多个 npm scripts |
+| `jiti` | `^2.6.1` | 运行时 TypeScript/ESM 模块加载器，部分工具链（如 ESLint flat config）依赖它在 Node 中直接解析 TS 配置文件 |
+
+### TypeScript
+
+| 包名 | 版本 | 作用 |
+|------|------|------|
+| `typescript` | `~6.0.0` | TypeScript 编译器，提供静态类型检查 |
+| `vue-tsc` | `^3.2.6` | Vue 单文件组件的 TypeScript 类型检查工具（基于 `tsc`，支持 `.vue` 文件） |
+| `@tsconfig/node24` | `^24.0.4` | Node.js 24 的 `tsconfig.json` 基础配置预设 |
+| `@types/node` | `^24.12.2` | Node.js 内置模块（`fs`、`path` 等）的类型声明 |
+| `@vue/tsconfig` | `^0.9.1` | Vue 项目的 `tsconfig.json` 基础配置预设 |
+
+### 代码规范
+
+| 包名 | 版本 | 作用 |
+|------|------|------|
+| `eslint` | `^10.2.1` | JavaScript/TypeScript 代码静态分析工具，检测代码风格和潜在错误 |
+| `eslint-plugin-vue` | `~10.8.0` | ESLint 的 Vue 规则插件，检查 `.vue` 文件的模板和脚本 |
+| `@vue/eslint-config-typescript` | `^14.7.0` | Vue 官方的 TypeScript ESLint 配置预设 |
+| `eslint-plugin-oxlint` | `~1.60.0` | 让 ESLint 跳过 OxLint 已覆盖的规则，避免重复检查 |
+| `eslint-config-prettier` | `^10.1.8` | 关闭 ESLint 中与 Prettier 冲突的格式化规则，保证两者不打架 |
+| `oxlint` | `~1.60.0` | Rust 编写的超快 linter（比 ESLint 快 50-100 倍），用于替代部分 ESLint 规则 |
+| `prettier` | `3.8.3` | 代码格式化工具，统一缩进、引号、分号等风格，只管格式不管逻辑 |
+
+---
+
+## 依赖关系速览
+
+```
+开发流程
+├── 代码编写阶段
+│   ├── TypeScript (类型检查)
+│   ├── ESLint + OxLint (代码规范)
+│   └── Prettier (代码格式化)
+│
+├── 开发调试阶段
+│   ├── Vite (开发服务器 + HMR)
+│   ├── Vue / Vant (UI 开发)
+│   └── vite-plugin-vue-devtools (调试工具)
+│
+└── 构建部署阶段
+    ├── vue-tsc (类型检查)
+    ├── Vite (打包构建)
+    ├── postcss-px-to-viewport-8-plugin (移动端适配)
+    └── unplugin-vue-components (按需引入)
+```

package/test/mini2.0-main/env.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_APP_ENV: 'development' | 'test' | 'production'
+  readonly VITE_API_BASE_URL: string
+  readonly VITE_PROXY_TARGET?: string
+  readonly VITE_API_TIMEOUT: string
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}

package/test/mini2.0-main/eslint.config.ts

@@ -0,0 +1,26 @@
+import { globalIgnores } from 'eslint/config'
+import { defineConfigWithVueTs, vueTsConfigs } from '@vue/eslint-config-typescript'
+import pluginVue from 'eslint-plugin-vue'
+import pluginOxlint from 'eslint-plugin-oxlint'
+import skipFormatting from 'eslint-config-prettier/flat'
+
+// To allow more languages other than `ts` in `.vue` files, uncomment the following lines:
+// import { configureVueProject } from '@vue/eslint-config-typescript'
+// configureVueProject({ scriptLangs: ['ts', 'tsx'] })
+// More info at https://github.com/vuejs/eslint-config-typescript/#advanced-setup
+
+export default defineConfigWithVueTs(
+  {
+    name: 'app/files-to-lint',
+    files: ['**/*.{vue,ts,mts,tsx}'],
+  },
+
+  globalIgnores(['**/dist/**', '**/dist-ssr/**', '**/coverage/**']),
+
+  ...pluginVue.configs['flat/essential'],
+  vueTsConfigs.recommended,
+
+  ...pluginOxlint.buildFromOxlintConfigFile('.oxlintrc.json'),
+
+  skipFormatting,
+)

package/test/mini2.0-main/index.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="">
+  <head>
+    <meta charset="UTF-8">
+    <link rel="icon" href="/favicon.ico">
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, user-scalable=no"
+    />
+    <title>平台</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>