npm - create-koa-boot - Versions diffs - 1.0.0 - Mend

create-koa-boot 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (935) hide show

package/templates/example/uniapp/http/requestEnhancer.js ADDED Viewed

@@ -0,0 +1,109 @@
+/**
+ * HTTP 请求增强工具
+ *
+ * 提供：请求重试、请求去重/取消、简单内存缓存
+ */
+/**
+ * 请求重试装饰器
+ * @param {Function} apiFn - 原始请求函数
+ * @param {Object} options
+ * @param {number} options.maxRetries - 最大重试次数，默认 3
+ * @param {number} options.retryDelay - 重试间隔(ms)，默认 1000
+ * @param {Function} options.shouldRetry - 判断是否应重试，默认网络错误才重试
+ * @returns {Function} 带重试的请求函数
+ */
+export function withRetry(apiFn, options = {}) {
+	const { maxRetries = 3, retryDelay = 1000, shouldRetry } = options
+	const defaultShouldRetry = error => {
+		// 仅网络超时或网络错误才重试，业务错误不重试
+		const msg = error?.message || error?.errMsg || ''
+		return (
+			msg.includes('timeout') ||
+			msg.includes('网络') ||
+			msg.includes('network') ||
+			msg.includes('request:fail')
+		)
+	}
+	return async function (...args) {
+		let lastError
+		const check = shouldRetry || defaultShouldRetry
+		for (let i = 0; i <= maxRetries; i++) {
+			try {
+				return await apiFn(...args)
+			} catch (error) {
+				lastError = error
+				if (i < maxRetries && check(error)) {
+					console.log(`[Retry] 第 ${i + 1} 次重试...`)
+					await new Promise(resolve => setTimeout(resolve, retryDelay * (i + 1)))
+				} else {
+					throw lastError
+				}
+			}
+		}
+		throw lastError
+	}
+}
+/**
+ * 创建请求取消控制器
+ * @returns {{ signal: Promise, abort: Function }}
+ */
+export function createAbortController() {
+	let abortFn = null
+	const signal = new Promise((_, reject) => {
+		abortFn = () => reject(new Error('请求已取消'))
+	})
+	return { signal, abort: abortFn }
+}
+/**
+ * 简单内存缓存（用于 GET 请求结果缓存）
+ */
+class MemCache {
+	constructor(maxAge = 60000) {
+		this._cache = new Map()
+		this._maxAge = maxAge
+	}
+	get(key) {
+		const item = this._cache.get(key)
+		if (!item) return null
+		if (Date.now() - item.time > this._maxAge) {
+			this._cache.delete(key)
+			return null
+		}
+		return item.data
+	}
+	set(key, data) {
+		this._cache.set(key, { data, time: Date.now() })
+	}
+	clear() {
+		this._cache.clear()
+	}
+}
+export const memCache = new MemCache()
+/**
+ * 带缓存的请求
+ * @param {Function} apiFn - 请求函数
+ * @param {number} maxAge - 缓存有效期(ms)，默认 60s
+ */
+export function withCache(apiFn, maxAge = 60000) {
+	const cache = new MemCache(maxAge)
+	return async function (...args) {
+		const key = JSON.stringify(args)
+		const cached = cache.get(key)
+		if (cached !== null) return cached
+		const data = await apiFn(...args)
+		cache.set(key, data)
+		return data
+	}
+}

package/templates/example/uniapp/index.html ADDED Viewed

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <script>
+      var coverSupport = 'CSS' in window && typeof CSS.supports === 'function' && (CSS.supports('top: env(a)') ||
+        CSS.supports('top: constant(a)'))
+      document.write(
+        '<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0' +
+        (coverSupport ? ', viewport-fit=cover' : '') + '" />')
+    </script>
+    <title></title>
+    <!--preload-links-->
+    <!--app-context-->
+  </head>
+  <body>
+    <div id="app"><!--app-html--></div>
+    <script type="module" src="/main.js"></script>
+  </body>
+</html>

package/templates/example/uniapp/lint-staged.config.js ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+ * Pre-commit 检查配置
+ *
+ * 安装依赖后生效：
+ *   npx husky install
+ *   npx husky add .husky/pre-commit "npx lint-staged"
+ */
+// lint-staged 配置（需安装 lint-staged）
+module.exports = {
+	'*.{js,vue}': ['eslint --fix', 'prettier --write'],
+	'*.{css,scss,json,md}': ['prettier --write']
+}

package/templates/example/uniapp/locales/en.js ADDED Viewed

@@ -0,0 +1,48 @@
+/**
+ * English language pack
+ */
+export default {
+	common: {
+		confirm: 'Confirm',
+		cancel: 'Cancel',
+		save: 'Save',
+		delete: 'Delete',
+		edit: 'Edit',
+		search: 'Search',
+		reset: 'Reset',
+		submit: 'Submit',
+		back: 'Back',
+		loading: 'Loading...',
+		noData: 'No Data',
+		loadMore: 'Load More',
+		noMore: 'No More',
+		refresh: 'Refresh',
+		success: 'Success',
+		fail: 'Failed',
+		retry: 'Retry',
+		copy: 'Copy',
+		copied: 'Copied'
+	},
+	network: {
+		offline: 'Network disconnected',
+		timeout: 'Request timeout, please retry',
+		error: 'Network error, please check and retry'
+	},
+	login: {
+		title: 'Login',
+		welcome: 'Welcome Back',
+		subtitle: 'Please enter your account information',
+		username: 'Account / Phone Number',
+		password: 'Login Password',
+		remember: 'Remember',
+		forgot: 'Forgot Password',
+		loginBtn: 'Login',
+		logging: 'Logging in...',
+		logout: 'Logout',
+		expired: 'Login expired, please login again',
+		success: 'Login Successful',
+		fail: 'Login Failed',
+		emptyAccount: 'Please enter your account',
+		emptyPassword: 'Please enter your password'
+	}
+}

package/templates/example/uniapp/locales/index.js ADDED Viewed

@@ -0,0 +1,82 @@
+/**
+ * i18n 国际化模块
+ *
+ * 基于 uni-app 原生国际化能力 + vue-i18n 兼容方案
+ * 如果使用 vue-i18n: npm install vue-i18n@9
+ *
+ * @example
+ * import { t } from '@/locales'
+ * console.log(t('common.confirm'))  // 确认 / Confirm
+ */
+// 语言包
+import zhCN from './zh-CN'
+import en from './en'
+const messages = {
+	'zh-CN': zhCN,
+	en
+}
+/** 当前语言 */
+let currentLocale = 'zh-CN'
+/**
+ * 初始化语言
+ */
+export function initLocale() {
+	try {
+		const sysInfo = uni.getSystemInfoSync()
+		const lang = sysInfo.language || 'zh-CN'
+		if (lang.startsWith('en')) {
+			currentLocale = 'en'
+		}
+	} catch {
+		currentLocale = 'zh-CN'
+	}
+}
+/**
+ * 获取翻译文本
+ * @param {string} path - 点号分隔的路径，如 'common.confirm'
+ * @param {Object} params - 插值参数
+ * @returns {string}
+ */
+export function t(path, params = {}) {
+	const keys = path.split('.')
+	let value = messages[currentLocale]
+	for (const key of keys) {
+		if (value && typeof value === 'object') {
+			value = value[key]
+		} else {
+			return path
+		}
+	}
+	if (typeof value !== 'string') return path
+	// 插值替换 {key}
+	return value.replace(/\{(\w+)\}/g, (_, k) => params[k] ?? `{${k}}`)
+}
+/**
+ * 设置语言
+ * @param {string} locale - 'zh-CN' | 'en'
+ */
+export function setLocale(locale) {
+	if (messages[locale]) {
+		currentLocale = locale
+		uni.setStorageSync('locale', locale)
+	}
+}
+/**
+ * 获取当前语言
+ */
+export function getLocale() {
+	return currentLocale
+}
+// 初始化
+initLocale()
+export default { t, setLocale, getLocale }

package/templates/example/uniapp/locales/zh-CN.js ADDED Viewed

@@ -0,0 +1,48 @@
+/**
+ * 简体中文语言包
+ */
+export default {
+	common: {
+		confirm: '确认',
+		cancel: '取消',
+		save: '保存',
+		delete: '删除',
+		edit: '编辑',
+		search: '搜索',
+		reset: '重置',
+		submit: '提交',
+		back: '返回',
+		loading: '加载中...',
+		noData: '暂无数据',
+		loadMore: '加载更多',
+		noMore: '没有更多了',
+		refresh: '刷新',
+		success: '操作成功',
+		fail: '操作失败',
+		retry: '重试',
+		copy: '复制',
+		copied: '已复制'
+	},
+	network: {
+		offline: '网络连接已断开',
+		timeout: '请求超时，请重试',
+		error: '网络异常，请检查网络后重试'
+	},
+	login: {
+		title: '登录',
+		welcome: '欢迎登录',
+		subtitle: '请输入您的账号信息',
+		username: '请输入账号 / 手机号',
+		password: '请输入登录密码',
+		remember: '记住密码',
+		forgot: '忘记密码',
+		loginBtn: '登录',
+		logging: '登录中...',
+		logout: '退出登录',
+		expired: '登录已过期，请重新登录',
+		success: '登录成功',
+		fail: '登录失败',
+		emptyAccount: '请输入账号',
+		emptyPassword: '请输入密码'
+	}
+}

package/templates/example/uniapp/main.js ADDED Viewed

@@ -0,0 +1,18 @@
+import App from './App'
+import uvUI from './uni_modules/uv-ui-tools'
+import * as Pinia from 'pinia'
+import store from './stores/index'
+// #ifdef VUE3
+import { createSSRApp } from 'vue'
+export function createApp() {
+	const app = createSSRApp(App)
+	app.use(store)
+	app.use(uvUI)
+	return {
+		app,
+		Pinia
+	}
+}
+// #endif

package/templates/example/uniapp/manifest.json ADDED Viewed

@@ -0,0 +1,99 @@
+{
+    "name" : "uniapp-scaffold",
+    "appid" : "__UNI__5755590",
+    "description" : "基于 uni-app Vue3 的跨平台应用开发脚手架",
+    "versionName" : "1.0.0",
+    "versionCode" : 100,
+    "transformPx" : false,
+    "app-plus" : {
+        "usingComponents" : true,
+        "nvueStyleCompiler" : "uni-app",
+        "compilerVersion" : 3,
+        "splashscreen" : {
+            "alwaysShowBeforeRender" : true,
+            "waiting" : true,
+            "autoclose" : true,
+            "delay" : 0
+        },
+        "modules" : {
+            "Geolocation" : {},
+            "Push" : {}
+        },
+        "distribute" : {
+            "android" : {
+                "permissions" : [
+                    "<uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/>",
+                    "<uses-permission android:name=\"android.permission.ACCESS_WIFI_STATE\"/>",
+                    "<uses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\"/>",
+                    "<uses-permission android:name=\"android.permission.ACCESS_COARSE_LOCATION\"/>",
+                    "<uses-permission android:name=\"android.permission.INTERNET\"/>",
+                    "<uses-permission android:name=\"android.permission.POST_NOTIFICATIONS\"/>",
+                    "<uses-permission android:name=\"android.permission.VIBRATE\"/>"
+                ]
+            },
+            "ios" : {
+                "dSYMs" : false
+            },
+            "sdkConfigs" : {
+                "push" : {
+                    "unipush" : {
+                        "version" : "2"
+                    }
+                }
+            }
+        }
+    },
+    "quickapp" : {},
+    "mp-weixin" : {
+        "appid" : "",
+        "setting" : {
+            "urlCheck" : false
+        },
+        "usingComponents" : true,
+        "permission" : {
+            "scope.userLocation" : {
+                "desc" : "你的位置信息将用于地图选点定位"
+            }
+        },
+        "requiredPrivateInfos" : [ "getLocation" ]
+    },
+    "mp-alipay" : {
+        "usingComponents" : true
+    },
+    "mp-baidu" : {
+        "usingComponents" : true
+    },
+    "mp-toutiao" : {
+        "usingComponents" : true
+    },
+    "uniStatistics" : {
+        "enable" : false
+    },
+    "vueVersion" : "3",
+    "h5" : {
+        "devServer" : {
+            "port" : 8088,
+            "https" : false,
+            "proxy" : {
+                "/api" : {
+                    "target" : "http://192.168.124.35:3000",
+                    "changeOrigin" : true
+                }
+            }
+        },
+        "router" : {
+            "mode" : "hash",
+            "base" : "./"
+        },
+        "title" : "uni-app Scaffold",
+        "sdkConfigs" : {
+            "maps" : {
+                "amap" : {
+                    "key" : "806549e615b9cd0e979055e5d83942c2",
+                    "securityJsCode" : "1393417f2c174f71c5d0d9b566a78926",
+                    "serviceHost" : ""
+                }
+            }
+        }
+    }
+}

package/templates/example/uniapp/mixins/unreadBadge.js ADDED Viewed

@@ -0,0 +1,77 @@
+/**
+ * unreadBadge - 首页/分类页顶部消息铃铛的未读红点 mixin
+ *
+ * 提供：
+ *  - unreadCount：未读消息数
+ *  - hasUnread：是否有未读（>0 时显示红点）
+ *  - onNoticeClick：点击铃铛进入消息中心（未登录先提示登录）
+ *
+ * 行为：
+ *  - onShow 拉取一次并启动 30s 轮询（从消息中心返回、后台新消息都能及时反映）
+ *  - onHide / onUnload 停止轮询
+ *  - 未登录不请求接口、不显示红点
+ */
+import { useUserStore } from '@/stores/user'
+import { messageApi } from '@/services/modules/message'
+const POLL_INTERVAL = 30 * 1000
+export default {
+	data() {
+		return {
+			unreadCount: 0,
+			unreadTimer: null
+		}
+	},
+	computed: {
+		hasUnread() {
+			return this.unreadCount > 0
+		}
+	},
+	onShow() {
+		this.refreshUnread()
+		this.startUnreadPolling()
+	},
+	onHide() {
+		this.stopUnreadPolling()
+	},
+	onUnload() {
+		this.stopUnreadPolling()
+	},
+	methods: {
+		/** 拉取未读消息数（静默失败，不影响页面展示） */
+		async refreshUnread() {
+			if (!useUserStore().isLogin) {
+				this.unreadCount = 0
+				return
+			}
+			try {
+				const res = await messageApi.getUnreadCount({ silent: true })
+				this.unreadCount = (res.data && res.data.count) || 0
+			} catch (e) {
+				// 静默失败，保持原值
+			}
+		},
+		/** 启动未读数轮询（先停旧定时器，避免重复） */
+		startUnreadPolling() {
+			this.stopUnreadPolling()
+			this.unreadTimer = setInterval(() => this.refreshUnread(), POLL_INTERVAL)
+		},
+		/** 停止未读数轮询 */
+		stopUnreadPolling() {
+			if (this.unreadTimer) {
+				clearInterval(this.unreadTimer)
+				this.unreadTimer = null
+			}
+		},
+		/** 消息铃铛点击：未登录先登录，已登录进入消息中心 */
+		onNoticeClick() {
+			if (!useUserStore().isLogin) {
+				uni.showToast({ title: '请先登录', icon: 'none' })
+				setTimeout(() => uni.reLaunch({ url: '/pages/login/index' }), 600)
+				return
+			}
+			uni.navigateTo({ url: '/pages/message/index' })
+		}
+	}
+}

package/templates/example/uniapp/mock/index.js ADDED Viewed

@@ -0,0 +1,92 @@
+/**
+ * Mock 数据支持
+ *
+ * 开发阶段启用 mock，不依赖真实后端接口
+ *
+ * 使用方式：
+ * 1. 在 .env.development 中设置 VUE_APP_MOCK = 'true'
+ * 2. 在 mock/modules/ 下创建对应的 mock 模块
+ * 3. 在 main.js 中按需引入：import './mock'（仅在开发环境）
+ */
+const ENABLE_MOCK = process.env.VUE_APP_MOCK === 'true'
+if (ENABLE_MOCK) {
+	console.log('[Mock] Mock 数据已启用')
+	// 拦截 uni.request
+	const originalRequest = uni.request
+	uni.request = function (options) {
+		const url = options.url || ''
+		// 尝试匹配 mock 规则
+		const mockResponse = matchMock(url, options)
+		if (mockResponse) {
+			console.log(`[Mock] ${options.method || 'GET'} ${url} → mock`)
+			return new Promise(resolve => {
+				setTimeout(() => {
+					options.success?.({ statusCode: 200, data: mockResponse })
+					resolve({ statusCode: 200, data: mockResponse })
+				}, mockResponse._delay || 200)
+			})
+		}
+		// 无匹配则走真实请求
+		return originalRequest(options)
+	}
+}
+/** mock 路由表 */
+const mockRoutes = {
+	'GET /demo/list': () => ({
+		code: 200,
+		message: 'success',
+		data: {
+			rows: [
+				{ id: 1, name: '示例数据 1', status: '正常', createTime: '2024-01-01 12:00:00' },
+				{ id: 2, name: '示例数据 2', status: '正常', createTime: '2024-01-02 12:00:00' },
+				{ id: 3, name: '示例数据 3', status: '禁用', createTime: '2024-01-03 12:00:00' }
+			],
+			total: 3,
+			page: 1,
+			size: 10
+		}
+	}),
+	'GET /demo/detail': () => ({
+		code: 200,
+		message: 'success',
+		data: {
+			id: 1,
+			name: '示例数据 1',
+			status: '正常',
+			createTime: '2024-01-01 12:00:00'
+		}
+	})
+}
+function matchMock(url, options) {
+	const method = (options.method || 'GET').toUpperCase()
+	const key = `${method} ${url}`
+	// 精确匹配
+	if (mockRoutes[key]) {
+		return mockRoutes[key]()
+	}
+	// 模糊匹配（支持路径参数）
+	for (const routeKey of Object.keys(mockRoutes)) {
+		const [routeMethod, routePath] = routeKey.split(' ')
+		if (method === routeMethod && matchPath(routePath, url)) {
+			return mockRoutes[routeKey]()
+		}
+	}
+	return null
+}
+function matchPath(pattern, path) {
+	const regex = pattern.replace(/:\w+/g, '[^/]+')
+	return new RegExp(`^${regex}$`).test(path)
+}

package/templates/example/uniapp/package.json ADDED Viewed

@@ -0,0 +1,49 @@
+{
+	"name": "uniapp-scaffold",
+	"version": "1.0.0",
+	"description": "基于 uni-app (Vue3 + Pinia) 的轻量级跨平台应用开发脚手架",
+	"main": "main.js",
+	"scripts": {
+		"dev:h5": "uni",
+		"dev:app": "uni -p app",
+		"dev:mp-weixin": "uni -p mp-weixin",
+		"build:h5": "uni build",
+		"build:app": "uni build -p app-plus",
+		"build:mp-weixin": "uni build -p mp-weixin",
+		"lint": "eslint --ext .js,.vue ./",
+		"lint:fix": "eslint --ext .js,.vue ./ --fix",
+		"format": "prettier --write \"**/*.{js,vue,json,css,scss,md}\"",
+		"prepare": "husky install"
+	},
+	"keywords": [
+		"uni-app",
+		"vue3",
+		"pinia",
+		"scaffold",
+		"cross-platform"
+	],
+	"author": "gyx",
+	"license": "MIT",
+	"dependencies": {
+		"@dcloudio/uni-app": "3.0.0-5010520260709002",
+		"@dcloudio/uni-components": "3.0.0-5010520260709002",
+		"@dcloudio/uni-h5": "3.0.0-5010520260709002",
+		"pinia": "~2.1.7",
+		"vue": "3.4.21",
+		"vue-i18n": "^9.10.0"
+	},
+	"devDependencies": {
+		"@dcloudio/types": "^3.4.8",
+		"@dcloudio/uni-cli-shared": "3.0.0-5010520260709002",
+		"@dcloudio/vite-plugin-uni": "3.0.0-5010520260709002",
+		"@vue/eslint-config-prettier": "^9.0.0",
+		"eslint": "^8.56.0",
+		"eslint-plugin-vue": "^9.20.0",
+		"husky": "^9.0.0",
+		"lint-staged": "^15.2.0",
+		"miniprogram-api-typings": "^3.12.0",
+		"prettier": "^3.2.0",
+		"sass": "^1.77.0",
+		"vite": "5.2.8"
+	}
+}