cmpt-huitu-cli 1.0.0

package/templates/default/src/utils/index.js

@@ -0,0 +1,519 @@
+/**
+ * @FileDescription: 系统通用工具类
+ */
+
+export function isProd() {
+  // 推荐：使用import.meta.env.DEV 和 import.meta.env.PROD进行环境判断，而非直接检查MODE,因为MODE可能被环境变量文件或者命令改变
+  if (import.meta.env.PROD) {
+    return true
+  }
+  return false
+}
+
+export function isDev() {
+  if (import.meta.env.DEV) {
+    return true
+  }
+  return false
+}
+
+// 获取上传后图片的地址
+export function getFileFullPathNoBucket(fileName, filePath) {
+  const uploadUrl = window.HT_EnvConfig?.uploadUrl || '/upload'
+  return uploadUrl + '/api/oss/minio/objects/file?filename=' + fileName + '&filepath=' + filePath
+}
+
+// 获取上传后图片的地址（带 bucket）
+export function getFileFullPathByBucket(fileName, filePath, bucketname = 'default') {
+  const uploadUrl = window.HT_EnvConfig?.uploadUrl || '/upload'
+  return uploadUrl + '/api/oss/minio/objects/file-by-bucketname?bucketname=' + bucketname + '&filename=' + fileName + '&filepath=' + filePath
+}
+
+/**
+ * Parse the time to string
+ * @param {(Object|string|number)} time
+ * @param {string} cFormat
+ * @returns {string}
+ */
+export function parseTimeNative(time, cFormat) {
+  if (arguments.length === 0) {
+    return null
+  }
+  const format = cFormat || '{y}-{m}-{d} {h}:{i}:{s}'
+  let date
+
+  if (typeof time === 'object') {
+    date = time
+  } else {
+    if (typeof time === 'string' && /^[0-9]+$/.test(time)) {
+      time = Number.parseInt(time)
+    }
+    if (typeof time === 'number' && time.toString().length === 10) {
+      time = time * 1000
+    }
+    date = new Date(time)
+  }
+  const formatObj = {
+    y: date.getFullYear(),
+    m: date.getMonth() + 1,
+    d: date.getDate(),
+    h: date.getHours(),
+    i: date.getMinutes(),
+    s: date.getSeconds(),
+    a: date.getDay(),
+  }
+  const timeStr = format.replace(/{(y|m|d|h|i|s|a)+}/g, (result, key) => {
+    let value = formatObj[key]
+    // Note: getDay() returns 0 on Sunday
+    if (key === 'a') {
+      return ['日', '一', '二', '三', '四', '五', '六'][value]
+    }
+    if (result.length > 0 && value < 10) {
+      value = '0' + value
+    }
+    return value || 0
+  })
+  return timeStr
+}
+
+/**
+ * @param {number} time
+ * @param {string} option
+ * @returns {string}
+ */
+export function formatTime(time, option) {
+  if (('' + time).length === 10) {
+    time = Number.parseInt(time) * 1000
+  } else {
+    time = +time
+  }
+  const d = new Date(time)
+  const now = Date.now()
+
+  const diff = (now - d) / 1000
+
+  if (diff < 30) {
+    return '刚刚'
+  } else if (diff < 3600) {
+    // less 1 hour
+    return Math.ceil(diff / 60) + '分钟前'
+  } else if (diff < 3600 * 24) {
+    return Math.ceil(diff / 3600) + '小时前'
+  } else if (diff < 3600 * 24 * 2) {
+    return '1天前'
+  }
+  if (option) {
+    return parseTimeNative(time, option)
+  } else {
+    return d.getMonth() + 1 + '月' + d.getDate() + '日' + d.getHours() + '时' + d.getMinutes() + '分'
+  }
+}
+
+/**
+ * @param {string} url
+ * @returns {Object}
+ */
+export function getQueryParameters(url) {
+  const search = url.split('?')[1]
+  if (!search) {
+    return {}
+  }
+  return JSON.parse('{"' + decodeURIComponent(search).replace(/"/g, '\\"').replace(/&/g, '","').replace(/=/g, '":"').replace(/\+/g, ' ') + '"}')
+}
+// 移除地址栏？参数
+export function removeQueryParameters(str, name) {
+  var reg = new RegExp(name + '=([^&]*)(&?)', 'i')
+  var r = str.match(reg)
+  if (r != null) {
+    str = str.replace(reg, '')
+    // console.log(str)
+    // alert()
+  }
+  return str
+}
+export function hasClass(elem, cls) {
+  cls = cls || ''
+  if (cls.replace(/\s/g, '').length === 0) return false // 当cls没有参数时，返回false
+  return new RegExp(' ' + cls + ' ').test(' ' + elem.className + ' ')
+}
+
+export function addClass(elem, cls) {
+  if (!hasClass(elem, cls)) {
+    elem.className = elem.className === '' ? cls : elem.className + ' ' + cls
+  }
+}
+
+export function removeClass(elem, cls) {
+  if (hasClass(elem, cls)) {
+    let newClass = ' ' + elem.className.replace(/[\t\r\n]/g, '') + ' '
+    while (newClass.indexOf(' ' + cls + ' ') >= 0) {
+      newClass = newClass.replace(' ' + cls + ' ', ' ')
+    }
+    elem.className = newClass.replace(/^\s+|\s+$/g, '')
+  }
+}
+
+export function tansParamsString(obj) {
+  if (!obj) return ''
+  const pairs = []
+  for (const key in obj) {
+    const value = obj[key]
+
+    if (value instanceof Array) {
+      for (let i = 0; i < value.length; ++i) {
+        pairs.push(encodeURIComponent(key + '[' + i + ']') + '=' + encodeURIComponent(value[i]))
+      }
+      continue
+    }
+
+    pairs.push(encodeURIComponent(key) + '=' + encodeURIComponent(obj[key]))
+  }
+
+  return pairs.join('&')
+}
+
+/**
+ * [strToNull 处理提交JSON后台不接受""空字符串]
+ * @author: cm
+ * @param  {对象} data
+ */
+export const strToNull = (data) => {
+  for (const x in data) {
+    if (data[x] === '') {
+      // 如果是空字符串 把直接内容转为 null
+      data[x] = ''
+    } else {
+      if (Array.isArray(data[x])) {
+        // 是数组遍历数组 递归继续处理
+        data[x] = data[x].map((z) => {
+          return strToNull(z)
+        })
+      }
+      if (typeof data[x] === 'object') {
+        // 是json 递归继续处理
+        data[x] = strToNull(data[x])
+      }
+    }
+  }
+  return data
+}
+
+// 防抖函数
+// 用法示例： methods：{ testFun: debounce(function(params){}, 500)}
+export const debounce = (fn, t) => {
+  const delay = t || 500
+  let timer
+  return function () {
+    const args = arguments
+    if (timer) {
+      clearTimeout(timer)
+    }
+    timer = setTimeout(() => {
+      timer = null
+      fn.apply(this, args)
+    }, delay)
+  }
+}
+
+/**
+ * 函数节流
+ * @param fn
+ * @param interval
+ * @returns {Function}
+ * @constructor
+ */
+export const throttle = (fn, t) => {
+  let last
+  let timer
+  const interval = t || 500
+  return function () {
+    const args = arguments
+    const now = +new Date()
+    if (last && now - last < interval) {
+      clearTimeout(timer)
+      timer = setTimeout(() => {
+        last = now
+        fn.apply(this, args)
+      }, interval)
+    } else {
+      last = now
+      fn.apply(this, args)
+    }
+  }
+}
+
+/**
+ * 获取数值指定小数点位数
+ * @param num 数值
+ * @param digit 小数点位数
+ * @returns {null}
+ */
+export function getNumberByDigit(num, digit) {
+  if (!isNum(num)) return ''
+  if (digit === 3 && num % 1 === 0) return num
+  const retNum = Number.parseFloat(num).toFixed(digit)
+  return retNum == 0 ? 0 : Number.parseFloat(num).toFixed(digit) * 1 // 此方法会触发四舍五入 - 此处万不能使用绝对等于号
+  // return Math.ceil(0.007 * 100) / 100
+}
+
+/**
+ * 对比对象差异并返回差异属性
+ * @param obj1
+ * @param obj2
+ * @return {*}
+ */
+export function diffObjProps(obj1, obj2) {
+  return Object.fromEntries([...Object.entries(obj1), ...Object.entries(obj2)].filter(([key]) => obj1[key] !== obj2[key]))
+}
+
+/**
+ * 判断字符是否为中文汉字
+ * @param str
+ * @return {boolean}
+ */
+export function isChinese(str) {
+  const reg = /^[\u4E00-\u9FA5]+$/
+  return reg.test(str)
+}
+
+/**
+ * 经度验证，最长2位，小数点后最长7位数
+ * @param val
+ * @return {*}
+ * @constructor
+ */
+export function lgtdIsValid(val) {
+  const regex = /^[-+]?[0-9]{1,3}(\.[0-9]{1,7})?$/
+  return regex.test(val)
+}
+
+/**
+ * 纬度验证，最长2位，小数点后最长7位数
+ * @param val
+ * @return {*}
+ * @constructor
+ */
+export function lttdIsValid(val) {
+  const regex = /^[-+]?[0-9]{1,2}(\.[0-9]{1,7})?$/
+  return regex.test(val)
+}
+
+/**
+ * 深拷贝
+ *
+ */
+export function deepCopy(obj) {
+  if (typeof obj !== 'object' || obj === null) {
+    return obj // 如果不是对象类型或者是null，直接返回
+  }
+
+  let copy
+  if (Array.isArray(obj)) {
+    copy = [] // 如果是数组，创建一个空数组
+    for (let i = 0; i < obj.length; i++) {
+      copy[i] = deepCopy(obj[i]) // 递归拷贝数组中的每个元素
+    }
+  } else {
+    copy = {} // 如果是对象，创建一个空对象
+    for (const key in obj) {
+      if (obj.hasOwnProperty(key)) {
+        copy[key] = deepCopy(obj[key]) // 递归拷贝对象中的每个属性值
+      }
+    }
+  }
+  return copy // 返回深拷贝后的对象或数组
+}
+
+/**
+ * 导出前的HTML元素图片转换
+ * @param dataurl
+ * @return {Blob}
+ */
+export function dataURLToBlob(dataurl) {
+  const arr = dataurl.split(',')
+  const mime = arr[0].match(/:(.*?);/)[1]
+  const bstr = atob(arr[1])
+  let n = bstr.length
+  const u8arr = new Uint8Array(n)
+  while (n--) {
+    u8arr[n] = bstr.charCodeAt(n)
+  }
+  return new Blob([u8arr], { type: mime })
+}
+
+/**
+ * 将相对路径转换为绝对URL地址
+ * @param {string} url - 需要转换的相对路径
+ * @returns {string|null} 返回转换后的绝对URL地址，如果转换失败则返回null
+ */
+export const requireFile = (url) => {
+  // 方式一：容易错误
+  // try {
+  //   // 如果是以 / 开头的绝对路径，直接返回
+  //   if (url.startsWith('/')) {
+  //     return url
+  //   }
+  //   // 使用new URL时路径需基于当前文件位置计算相对路径，@别名可能失效需改用../
+  //   return new URL(url, import.meta.url).href
+  // } catch (error) {
+  //   console.error(error)
+  //   return null
+  // }
+
+  // 方式二：推荐
+  // 静态扫描 src/assets 下所有图片资源，生成路径映射（构建时执行）
+  // 匹配规则：递归扫描所有子目录，支持 png/jpg/jpeg/gif/svg 格式
+  const imageResourceMap = import.meta.glob(
+    '/src/assets/**/*.{png,jpg,jpeg,gif,svg}',
+    { eager: true, import: 'default' } // 立即加载并获取资源路径
+  )
+  try {
+    // 拼接完整的资源路径（基于 src 目录）
+    const fullResourcePath = `/src${url}`
+    // 从映射表中获取对应资源的处理后路径（开发/生产环境自适应）
+    return imageResourceMap[fullResourcePath] || null
+  } catch (error) {
+    console.error('图片资源路径解析失败：', error)
+    return null
+  }
+}
+
+// 判断是否为数值  true 数值类型 false 其他
+function isNum(val) {
+  // 先判定是否为number
+  if (typeof val !== 'number') {
+    return false
+  }
+  if (!isNaN(val)) {
+    return true
+  } else {
+    return false
+  }
+}
+// 截断到指定位数（不四舍五入）
+const truncateToDecimal = (num, digit) => {
+  const multiplier = Math.pow(10, digit)
+  // 正数用Math.floor，负数用Math.ceil（避免-0.25截断为-0.3）
+  return num >= 0 ? Math.floor(num * multiplier) / multiplier : Math.ceil(num * multiplier) / multiplier
+}
+// 判断是否为数值  true 数值类型 false 其他
+export const formatNum = (val, digit) => {
+  // 异常值判断：无效输入返回 '-'
+  if (val === null || isNaN(Number(val)) || val === undefined || val === '' || val === ' ') return '-'
+
+  // 1. 转换为数值并截断到指定位数（不四舍五入）
+  const num = Number(val)
+  const truncatedNum = truncateToDecimal(num, digit) // 核心：截断逻辑
+
+  // 2. 转为带指定位数的字符串（确保至少有digit位小数，补0）
+  // 用toFixed临时转换，再处理截断后的结果（避免浮点数精度问题）
+  const fixedStr = truncatedNum.toFixed(digit)
+
+  // 3. 分割整数和小数部分
+  const [integerPart, decimalPart] = fixedStr.split('.')
+
+  // 4. 判断是否为整数（小数部分全为0）
+  const isInteger = decimalPart.split('').every((char) => char === '0')
+
+  if (isInteger) {
+    // 整数：强制保留digit位小数（补0）
+    return `${integerPart}.${decimalPart}`
+  } else {
+    // 非整数：去掉小数部分尾部的0
+    const trimmedDecimal = decimalPart.replace(/0+$/, '')
+    return `${integerPart}.${trimmedDecimal}`
+  }
+  // // 异常值判断
+  // if (val === null || isNaN(val) || val === undefined || val === '' || val === ' ') return '--'
+  // // 数值 或 字符串数值
+  // val = Number.parseFloat(val).toFixed(digit)
+
+  // // 删除尾部的‘0’
+  // if (val.endsWith('0')) {
+  //   val = val.substring(0, val.lastIndexOf('0'))
+  // }
+
+  // // 删除尾部的‘.’
+  // if (val.endsWith('.')) {
+  //   val = val.substring(0, val.lastIndexOf('.'))
+  // }
+  // return val
+}
+/**
+ * @description: 数据深拷贝
+ * @param {*} obj 对象
+ * @return {*}
+ */
+export const deepClone = (obj) => {
+  const isObj = (v) => v && typeof v === 'object'
+  if (!isObj(obj)) return obj
+  const newObj = Array.isArray(obj) ? [] : {}
+  for (const key in obj) {
+    const item = obj[key]
+    newObj[key] = isObj(item) ? deepClone(item) : item
+  }
+  return newObj
+}
+
+/**
+ * @description: 文件下载
+ * @param {*} data 文件流
+ * @return {String} fileName 下载显示的文件名称
+ */
+export function downloadFileXls(data, fileName) {
+  // application/vnd.ms-excel,采用后台响应的content-type值
+  downloadFile(data, fileName, 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
+}
+export function downloadFileDoc(data, fileName) {
+  downloadFile(data, fileName, 'application/msword')
+}
+export function downloadFilePpt(data, fileName) {
+  downloadFile(data, fileName, 'application/vnd.ms-powerpoint')
+}
+export function downloadFileZip(data, fileName) {
+  downloadFile(data, fileName, 'application/zip')
+}
+export function downloadFileTxt(data, fileName) {
+  downloadFile(data, fileName, 'application/plain')
+}
+export function downloadFile(data, fileName, type) {
+  // 生成blob对象
+  //const blob = new Blob([data], { type: `${type}` })
+  const blob = new Blob([data], { type: `${type};charset=utf-8` })
+
+  if (window.navigator.msSaveOrOpenBlob) {
+    window.navigator.msSaveBlob(blob, fileName)
+    return
+  }
+
+  // 生成下载链接
+  const downElement = document.createElement('a')
+  downElement.style.display = 'none'
+  const href = window.URL.createObjectURL(blob)
+  downElement.href = href
+  downElement.download = fileName
+  document.body.appendChild(downElement)
+  downElement.click()
+  window.URL.revokeObjectURL(href)
+  downElement.remove()
+}
+
+/**
+ * 预加载图片资源
+ *
+ * @param {string[]} arrUrl - 图片URL数组
+ * @returns {Promise} 返回一个Promise，当所有图片加载完成时resolve，任意一张图片加载失败时reject
+ */
+export function preloadImages(arrUrl) {
+  return Promise.all(
+    arrUrl.map(
+      (url) =>
+        new Promise((resolve, reject) => {
+          const img = new Image()
+          img.onload = () => resolve(img)
+          img.onerror = reject
+          img.src = url
+        })
+    )
+  )
+}

package/templates/default/src/utils/requestAxios.js

@@ -0,0 +1,148 @@
+/**
+ * @FileDescription: 系统ajax请求封装库
+ * @Author: yans
+ * @Date: 2025-12-26
+ * @LastEditors: yans
+ * @LastEditTime: 2025-12-30
+ */
+import axios from 'axios'
+import { getToken, clearAuth } from '@utils/auth'
+import { tansParamsString } from '@huitu/utils'
+import errorCode from '@utils/errorCode'
+
+// 全局默认基础配置
+const _BaseURL = window.HT_EnvConfig.apiUrlNew
+// 请求超时设置
+const _TimeOut = 30000
+// 请求数据大小限制
+const _LimitSize = 5 * 1024 * 1024
+
+// 默认请求头参数设置
+axios.defaults.headers['Content-Type'] = 'application/json;charset=utf-8'
+
+/**
+ * 创建Axios实例的函数
+ * @param {Object} config - 配置对象，包含baseURL、timeOut、limitSize等配置项
+ * @param {string} [config.baseURL] - 请求的基础URL
+ * @param {number} [config.timeOut] - 请求超时时间
+ * @param {number} [config.limitSize] - 请求数据大小限制
+ * @returns {Object} 返回配置好的Axios实例
+ */
+export function createAxiosInstance(config) {
+  // 0、基础配置
+  const baseURL = config.baseURL || _BaseURL
+  // 请求超时设置
+  const timeOut = config.timeOut || _TimeOut
+  // 请求数据大小限制
+  const limitSize = config.limitSize || _LimitSize
+
+  // 1、创建axios实例
+  const service = axios.create({
+    // axios中请求配置有baseURL选项，表示请求URL公共部分
+    baseURL: baseURL,
+    // 超时
+    timeout: timeOut,
+  })
+
+  // 2、请求拦截器
+  service.interceptors.request.use(
+    (config) => {
+      console.log('请求参数:', config)
+      // 是否需要设置 token
+      const isToken = (config.headers || {}).isToken === false
+      if (getToken() && !isToken) {
+        const token = getToken()
+        // 自动添加 Token 到请求头
+        // 根据后端要求选择以下方式之一：
+        config.headers['Authorization'] = `Bearer ${token}`
+
+        // 如果需要添加其他认证信息，请在此处添加
+        // 例如：config.headers['tenantId'] = 'your-tenant-id'
+      }
+
+      // 处理特殊代理路径（如果需要）
+      // 如果请求路径匹配特殊代理规则，则不使用 baseURL
+      // 示例：config.url?.startsWith('/special-api') && (config.baseURL = null)
+      // 默认使用 baseURL
+      if (!config.baseURL) {
+        config.baseURL = baseURL
+      }
+
+      // get请求映射params参数
+      if (config.method === 'get' && config.params) {
+        const url = config.url + '?' + tansParamsString(config.params)
+        config.params = {}
+        config.url = url
+      }
+
+      // post等请求处理
+      if (config.method === 'post' || config.method === 'put') {
+        const requestObj = typeof config.data === 'object' ? JSON.stringify(config.data) : config.data // 请求数据
+        const requestSize = (requestObj || '').length // 请求数据大小
+        if (requestSize >= limitSize) {
+          return Promise.reject(new Error('请求数据大小超出允许的5M限制。'))
+        }
+      }
+
+      return config
+    },
+    (error) => {
+      console.log('request error：', error)
+      return Promise.reject(error)
+    }
+  )
+
+  // 3、响应拦截器
+  service.interceptors.response.use(
+    (res) => {
+      // 未设置状态码则默认成功状态
+      const code = res.data?.code || 200
+      // 获取错误信息
+      const message = errorCode[code] || res.data?.msg || errorCode['default']
+      // 二进制数据则直接返回
+      if (res.request.responseType === 'blob' || res.request.responseType === 'arraybuffer') {
+        // 访问成功
+        return res.data
+      }
+      // debugger
+      if (code === 401) {
+        // 非法访问
+        clearAuth()
+        window.location.href = import.meta.env.BASE_URL + '/login'
+        return Promise.reject('无效的会话或会话已过期，请重新登录。')
+      } else if (code !== 200 && code !== 0 && code !== '0' && code !== 1000) {
+        // 后台报错
+        console.log('response error：', message)
+        return Promise.reject(new Error(message))
+      } else {
+        // 访问成功
+        return res.data
+      }
+    },
+    (error) => {
+      console.log('response error：', error)
+      let { message } = error
+      if (message == 'Network Error') {
+        message = '后端接口连接异常'
+      } else if (message.includes('timeout')) {
+        message = '系统接口请求超时'
+      } else if (message.includes('Request failed with status code')) {
+        message = '系统接口' + message.substr(message.length - 3) + '异常'
+      } else if (message == 'canceled') {
+        message = '系统接口canceled异常'
+      }
+      console.log('response error message：', message)
+      return Promise.reject(error)
+    }
+  )
+
+  // 返回ajax实例
+  return service
+}
+
+// ***********创建ajax请求实例*********** //
+export const axiosInstance = createAxiosInstance({
+  baseURL: _BaseURL,
+  timeOut: _TimeOut,
+  limitSize: _LimitSize,
+})

package/templates/default/src/utils/theme.js

@@ -0,0 +1,20 @@
+/*
+ * @Description: '主题切换函数 data-theme属性： light | dark'
+ */
+
+// 设置主题
+import { cache } from '@huitu/utils'
+const { local } = cache
+export const setTheme = (theme) => {
+  local.set('data-theme', theme)
+  document.documentElement.setAttribute('data-theme', theme)
+}
+// 获取当前主题
+export const getTheme = () => {
+  return local.get('data-theme') || 'light'
+}
+// 初始化主题 默认浅色系
+export const initTheme = () => {
+  const theme = getTheme()
+  setTheme(theme)
+}

package/templates/default/src/views/About.vue

@@ -0,0 +1,6 @@
+<template>
+  <div class="about">
+    <h1>关于模版</h1>
+    <p>此模版旨在快速启动新的前端项目，复用现有的 UI 组件库和工具函数库。</p>
+  </div>
+</template>