fix

.commitlintrc.cjs

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+}

.cursor/rules/api-http-patterns.mdc

@@ -0,0 +1,51 @@
+# API 和 HTTP 请求规范
+
+## HTTP 请求封装
+- 可以使用 `简单http` 或者 `alova` 或者 `@tanstack/vue-query` 进行请求管理
+- HTTP 配置在 [src/http/](mdc:src/http/) 目录下
+- `简单http` - [src/http/http.ts](mdc:src/http/http.ts)
+- `alova` - [src/http/alova.ts](mdc:src/http/alova.ts)
+- `vue-query` - [src/http/vue-query.ts](mdc:src/http/vue-query.ts)
+- 请求拦截器在 [src/http/interceptor.ts](mdc:src/http/interceptor.ts)
+- 支持请求重试、缓存、错误处理
+
+## API 接口规范
+- API 接口定义在 [src/api/](mdc:src/api/) 目录下
+- 按功能模块组织 API 文件
+- 使用 TypeScript 定义请求和响应类型
+- 支持 `简单http`、`alova` 和 `vue-query` 三种请求方式
+
+
+## 示例代码结构
+```typescript
+// API 接口定义
+export interface LoginParams {
+  username: string
+  password: string
+}
+
+export interface LoginResponse {
+  token: string
+  userInfo: UserInfo
+}
+
+// alova 方式
+export const login = (params: LoginParams) => 
+  http.Post<LoginResponse>('/api/login', params)
+
+// vue-query 方式
+export const useLogin = () => {
+  return useMutation({
+    mutationFn: (params: LoginParams) => 
+      http.post<LoginResponse>('/api/login', params)
+  })
+}
+```
+
+## 错误处理
+- 统一错误处理在拦截器中配置
+- 支持网络错误、业务错误、认证错误等
+- 自动处理 token 过期和刷新
+---
+globs: src/api/*.ts,src/http/*.ts
+---

.cursor/rules/development-workflow.mdc

@@ -0,0 +1,43 @@
+# 开发工作流程
+
+## 项目启动
+1. 安装依赖：`pnpm install`
+2. 开发环境：
+   - H5: `pnpm dev` 或 `pnpm dev:h5`
+   - 微信小程序: `pnpm dev:mp`
+   - 支付宝小程序: `pnpm dev:mp-alipay`
+   - APP: `pnpm dev:app`
+
+## 代码规范
+- 使用 ESLint 进行代码检查：`pnpm lint`
+- 自动修复代码格式：`pnpm lint:fix`
+- 使用 eslint 格式化代码
+- 遵循 TypeScript 严格模式
+
+## 构建和部署
+- H5 构建：`pnpm build:h5`
+- 微信小程序构建：`pnpm build:mp`
+- 支付宝小程序构建：`pnpm build:mp-alipay`
+- APP 构建：`pnpm build:app`
+- 类型检查：`pnpm type-check`
+
+## 开发工具
+- 推荐使用 VSCode 编辑器
+- 安装 Vue 和 TypeScript 相关插件
+- 使用 uni-app 开发者工具调试小程序
+- 使用 HBuilderX 调试 APP
+
+## 调试技巧
+- 使用 console.log 和 uni.showToast 调试
+- 利用 Vue DevTools 调试组件状态
+- 使用网络面板调试 API 请求
+- 平台差异测试和兼容性检查
+
+## 性能优化
+- 使用懒加载和代码分割
+- 优化图片和静态资源
+- 减少不必要的重渲染
+- 合理使用缓存策略
+---
+description: 开发工作流程和最佳实践指南
+---

.cursor/rules/project-overview.mdc

@@ -0,0 +1,36 @@
+---
+alwaysApply: true
+---
+# unibest 项目概览
+
+这是一个基于 uniapp + Vue3 + TypeScript + Vite5 + UnoCSS 的跨平台开发框架。
+
+## 项目特点
+- 支持 H5、小程序、APP 多平台开发
+- 使用最新的前端技术栈
+- 内置约定式路由、layout布局、请求封装、登录拦截、自定义tabbar等功能
+- 无需依赖 HBuilderX，支持命令行开发
+
+## 核心配置文件
+- [package.json](mdc:package.json) - 项目依赖和脚本配置
+- [vite.config.ts](mdc:vite.config.ts) - Vite 构建配置
+- [pages.config.ts](mdc:pages.config.ts) - 页面路由配置
+- [manifest.config.ts](mdc:manifest.config.ts) - 应用清单配置
+- [uno.config.ts](mdc:uno.config.ts) - UnoCSS 配置
+
+## 主要目录结构
+- `src/pages/` - 页面文件
+- `src/components/` - 组件文件
+- `src/layouts/` - 布局文件
+- `src/api/` - API 接口
+- `src/http/` - HTTP 请求封装
+- `src/store/` - 状态管理
+- `src/tabbar/` - 底部导航栏
+- `src/App.ku.vue` - 全局根组件（类似 App.vue 里面的 template作用）
+
+## 开发命令
+- `pnpm dev` - 开发 H5 版本
+- `pnpm dev:mp` - 开发微信小程序
+- `pnpm dev:mp-alipay` - 开发支付宝小程序（含钉钉）
+- `pnpm dev:app` - 开发 APP 版本
+- `pnpm build` - 构建生产版本

.cursor/rules/styling-css-patterns.mdc

@@ -0,0 +1,54 @@
+# 样式和 CSS 开发规范
+
+## UnoCSS 原子化 CSS
+- 项目使用 UnoCSS 作为原子化 CSS 框架
+- 配置在 [uno.config.ts](mdc:uno.config.ts)
+- 支持预设和自定义规则
+- 优先使用原子化类名，减少自定义 CSS
+
+## SCSS 规范
+- 使用 SCSS 预处理器
+- 样式文件使用 `lang="scss"` 和 `scoped` 属性
+- 遵循 BEM 命名规范
+- 使用变量和混入提高复用性
+
+## 样式组织
+- 全局样式在 [src/style/](mdc:src/style/) 目录下
+- 组件样式使用 scoped 作用域
+- 图标字体在 [src/style/iconfont.css](mdc:src/style/iconfont.css)
+- 主题变量在 [src/uni_modules/uni-scss/](mdc:src/uni_modules/uni-scss/) 目录下
+
+## 示例代码结构
+```vue
+<template>
+  <view class="container flex flex-col items-center p-4">
+    <text class="title text-lg font-bold mb-2">标题</text>
+    <view class="content bg-gray-100 rounded-lg p-3">
+      <!-- 内容 -->
+    </view>
+  </view>
+</template>
+
+<style lang="scss" scoped>
+.container {
+  min-height: 100vh;
+  
+  .title {
+    color: var(--primary-color);
+  }
+  
+  .content {
+    width: 100%;
+    max-width: 600rpx;
+  }
+}
+</style>
+
+## 响应式设计
+- 使用 rpx 单位适配不同屏幕
+- 支持横屏和竖屏布局
+- 使用 flexbox 和 grid 布局
+- 考虑不同平台的样式差异
+---
+globs: *.vue,*.scss,*.css
+---

.cursor/rules/uni-app-patterns.mdc

@@ -0,0 +1,62 @@
+# uni-app 开发规范
+
+## 页面开发
+- 页面文件放在 [src/pages/](mdc:src/pages/) 目录下
+- 使用约定式路由，文件名即路由路径
+- 页面配置在仅需要在 宏`definePage` 中配置标题等内容即可，会自动生成到 `pages.json` 中
+
+## 组件开发
+- 组件文件放在 [src/components/](mdc:src/components/) 或者 [src/pages/xx/components/](mdc:src/pages/xx/components/) 目录下
+- 使用 uni-app 内置组件和第三方组件库
+- 支持 wot-ui\uview-pro\uv-ui\sard-ui\uview-plus 等多种第三方组件库 和 z-paging 组件
+- 自定义组件遵循 uni-app 组件规范
+
+## 平台适配
+- 使用条件编译处理平台差异
+- 支持 H5、小程序、APP 多平台
+- 注意各平台的 API 差异
+- 使用 uni.xxx API 替代原生 API
+
+## 示例代码结构
+```vue
+<script setup lang="ts">
+// #ifdef H5
+import { h5Api } from '@/utils/h5'
+// #endif
+
+// #ifdef MP-WEIXIN
+import { mpApi } from '@/utils/mp'
+// #endif
+
+const handleClick = () => {
+  // #ifdef H5
+  h5Api.showToast('H5 平台')
+  // #endif
+  
+  // #ifdef MP-WEIXIN
+  mpApi.showToast('微信小程序')
+  // #endif
+}
+</script>
+
+<template>
+  <view class="page">
+    <!-- uni-app 组件 -->
+    <button @click="handleClick">点击</button>
+    
+    <!-- 条件渲染 -->
+    <!-- #ifdef H5 -->
+    <view>H5 特有内容</view>
+    <!-- #endif -->
+  </view>
+</template>
+```
+
+## 生命周期
+- 使用 uni-app 页面生命周期
+- onLoad、onShow、onReady、onHide、onUnload
+- 组件生命周期遵循 Vue3 规范
+- 注意页面栈和导航管理
+---
+globs: src/pages/*.vue,src/components/*.vue
+---

.cursor/rules/vue-typescript-patterns.mdc

@@ -0,0 +1,53 @@
+# Vue3 + TypeScript 开发规范
+
+## Vue 组件规范
+- 使用 Composition API 和 `<script setup>` 语法
+- 组件文件使用 PascalCase 命名
+- 页面文件放在 `src/pages/` 目录下
+- 全局组件文件放在 `src/components/` 目录下
+- 局部组件文件放在页面的 `/components/` 目录下
+
+## Vue SFC 组件规范
+- `<script setup lang="ts">` 标签必须是第一个子元素
+- `<template>` 标签必须是第二个子元素
+- `<style scoped>` 标签必须是最后一个子元素（因为推荐使用原子化类名，所以很可能没有）
+
+## TypeScript 规范
+- 严格使用 TypeScript，避免使用 `any` 类型
+- 为 API 响应数据定义接口类型
+- 使用 `interface` 定义对象类型，`type` 定义联合类型
+- 导入类型时使用 `import type` 语法
+
+## 状态管理
+- 使用 Pinia 进行状态管理
+- Store 文件放在 `src/store/` 目录下
+- 使用 `defineStore` 定义 store
+- 支持持久化存储
+
+## 示例代码结构
+```vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import type { UserInfo } from '@/types/user'
+
+const userInfo = ref<UserInfo | null>(null)
+
+onMounted(() => {
+  // 初始化逻辑
+})
+</script>
+
+<template>
+  <view class="container">
+    <!-- 模板内容 -->
+  </view>
+</template>
+
+<style lang="scss" scoped>
+.container {
+  // 样式
+}
+</style>
+---
+globs: *.vue,*.ts,*.tsx
+---

.editorconfig

@@ -0,0 +1,13 @@
+root = true
+
+[*] # 表示所有文件适用
+charset = utf-8 # 设置文件字符集为 utf-8
+indent_style = space # 缩进风格（tab | space）
+indent_size = 2 # 缩进大小
+end_of_line = lf # 控制换行类型(lf | cr | crlf)
+trim_trailing_whitespace = true # 去除行首的任意空白字符
+insert_final_newline = true # 始终在文件末尾插入一个新行
+
+[*.md] # 表示仅 md 文件适用以下规则
+max_line_length = off # 关闭最大行长度限制
+trim_trailing_whitespace = false # 关闭末尾空格修剪

.gitignore

@@ -0,0 +1,48 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+.DS_Store
+dist
+*.local
+
+# Editor directories and files
+.idea
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+.hbuilderx
+
+.stylelintcache
+.eslintcache
+
+docs/.vitepress/dist
+docs/.vitepress/cache
+
+src/types
+# 单独把这个文件排除掉，用以解决部分电脑生成的 auto-import.d.ts 的API不完整导致类型提示报错问题
+!src/types/auto-import.d.ts
+src/manifest.json
+src/pages.json
+
+# 2025-10-15 by 菲鸽： lock 文件还是需要加入版本管理，今天又遇到版本不一致导致无法运行的问题了。
+# pnpm-lock.yaml
+# package-lock.json
+
+# TIPS：如果某些文件已经加入了版本管理，现在重新加入 .gitignore 是不生效的，需要执行下面的操作
+# `git rm -r --cached .` 然后提交 commit 即可。
+
+# git rm -r --cached file1 file2  ## 针对某些文件
+# git rm -r --cached dir1 dir2  ## 针对某些文件夹
+# git rm -r --cached .  ## 针对所有文件
+
+# 更新 uni-app 官方版本
+# npx @dcloudio/uvm@latest

.husky/commit-msg

@@ -0,0 +1 @@
+npx --no-install commitlint --edit "$1"

.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged --allow-empty

.npmrc

@@ -0,0 +1,9 @@
+# registry = https://registry.npmjs.org
+registry = https://registry.npmmirror.com
+
+strict-peer-dependencies=false
+auto-install-peers=true
+shamefully-hoist=true
+ignore-workspace-root-check=true
+install-workspace-root=true
+node-options=--max-old-space-size=8192

.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "printWidth": 80,
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "useTabs": false,
+  "endOfLine": "auto"
+}

.trae/rules/project_rules.md

@@ -0,0 +1,122 @@
+# unibest 项目概览
+
+这是一个基于 uniapp + Vue3 + TypeScript + Vite5 + UnoCSS 的跨平台开发框架。
+
+## 项目特点
+- 支持 H5、小程序、APP 多平台开发
+- 使用最新的前端技术栈
+- 内置约定式路由、layout布局、请求封装等功能
+- 无需依赖 HBuilderX，支持命令行开发
+
+## 核心配置文件
+- [package.json](mdc:package.json) - 项目依赖和脚本配置
+- [vite.config.ts](mdc:vite.config.ts) - Vite 构建配置
+- [pages.config.ts](mdc:pages.config.ts) - 页面路由配置
+- [manifest.config.ts](mdc:manifest.config.ts) - 应用清单配置
+- [uno.config.ts](mdc:uno.config.ts) - UnoCSS 配置
+
+## 主要目录结构
+- `src/pages/` - 页面文件
+- `src/components/` - 组件文件
+- `src/layouts/` - 布局文件
+- `src/api/` - API 接口
+- `src/http/` - HTTP 请求封装
+- `src/store/` - 状态管理
+- `src/tabbar/` - 底部导航栏
+- `src/App.ku.vue` - 全局根组件（类似 App.vue 里面的 template作用）
+
+## 开发命令
+- `pnpm dev` - 开发 H5 版本
+- `pnpm dev:mp` - 开发微信小程序
+- `pnpm dev:mp-alipay` - 开发支付宝小程序(含钉钉)
+- `pnpm dev:app` - 开发 APP 版本
+- `pnpm build` - 构建生产版本
+
+## Vue 组件规范
+- 使用 Composition API 和 `<script setup>` 语法
+- 组件文件使用 PascalCase 命名
+- 页面文件放在 `src/pages/` 目录下
+- 全局组件文件放在 `src/components/` 目录下
+- 局部组件文件放在页面的 `/components/` 目录下
+
+## TypeScript 规范
+- 严格使用 TypeScript，避免使用 `any` 类型
+- 为 API 响应数据定义接口类型
+- 使用 `interface` 定义对象类型，`type` 定义联合类型
+- 导入类型时使用 `import type` 语法
+
+## 状态管理
+- 使用 Pinia 进行状态管理
+- Store 文件放在 `src/store/` 目录下
+- 使用 `defineStore` 定义 store
+- 支持持久化存储
+
+## UnoCSS 原子化 CSS
+- 项目使用 UnoCSS 作为原子化 CSS 框架
+- 配置在 [uno.config.ts]
+- 支持预设和自定义规则
+- 优先使用原子化类名，减少自定义 CSS
+
+## Vue SFC 组件规范
+- `<script setup lang="ts">` 标签必须是第一个子元素
+- `<template>` 标签必须是第二个子元素
+- `<style scoped>` 标签必须是最后一个子元素（因为推荐使用原子化类名，所以很可能没有）
+
+## 页面开发
+- 页面文件放在 [src/pages/]目录下
+- 使用约定式路由，文件名即路由路径
+- 页面配置在仅需要在 宏`definePage` 中配置标题等内容即可，会自动生成到 `pages.json` 中
+
+## 组件开发
+- 全局组件文件放在 `src/components/` 目录下
+- 局部组件文件放在页面的 `/components/` 目录下
+- 使用 uni-app 内置组件和第三方组件库
+- 支持 wot-ui\uview-pro\uv-ui\sard-ui\uview-plus 等多种第三方组件库 和 z-paging 组件
+- 自定义组件遵循 uni-app 组件规范
+
+## 平台适配
+- 使用条件编译处理平台差异
+- 支持 H5、小程序、APP 多平台
+- 注意各平台的 API 差异
+- 使用 uni.xxx API 替代原生 API
+
+## 示例代码结构
+```vue
+<script setup lang="ts">
+// #ifdef H5
+import { h5Api } from '@/utils/h5'
+// #endif
+
+// #ifdef MP-WEIXIN
+import { mpApi } from '@/utils/mp'
+// #endif
+
+const handleClick = () => {
+  // #ifdef H5
+  h5Api.showToast('H5 平台')
+  // #endif
+  
+  // #ifdef MP-WEIXIN
+  mpApi.showToast('微信小程序')
+  // #endif
+}
+</script>
+
+<template>
+  <view class="page">
+    <!-- uni-app 组件 -->
+    <button @click="handleClick">点击</button>
+    
+    <!-- 条件渲染 -->
+    <!-- #ifdef H5 -->
+    <view>H5 特有内容</view>
+    <!-- #endif -->
+  </view>
+</template>
+```
+
+## 生命周期
+- 使用 uni-app 页面生命周期
+- onLoad、onShow、onReady、onHide、onUnload
+- 组件生命周期遵循 Vue3 规范
+- 注意页面栈和导航管理

.vscode/extensions.json

@@ -0,0 +1,15 @@
+{
+  "recommendations": [
+    "vue.volar",
+    "dbaeumer.vscode-eslint",
+    "antfu.unocss",
+    "antfu.iconify",
+    "evils.uniapp-vscode",
+    "uni-helper.uni-helper-vscode",
+    "uni-helper.uni-app-schemas-vscode",
+    "uni-helper.uni-highlight-vscode",
+    "uni-helper.uni-ui-snippets-vscode",
+    "uni-helper.uni-app-snippets-vscode",
+    "streetsidesoftware.code-spell-checker"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,100 @@
+{
+  // 配置语言的文件关联
+  "files.associations": {
+    "pages.json": "jsonc", // pages.json 可以写注释
+    "manifest.json": "jsonc" // manifest.json 可以写注释
+  },
+
+  "stylelint.enable": false, // 禁用 stylelint
+  "css.validate": false, // 禁用 CSS 内置验证
+  "scss.validate": false, // 禁用 SCSS 内置验证
+  "less.validate": false, // 禁用 LESS 内置验证
+
+  "typescript.tsdk": "node_modules\\typescript\\lib",
+  "explorer.fileNesting.enabled": true,
+  "explorer.fileNesting.expand": false,
+  "explorer.fileNesting.patterns": {
+    "README.md": "index.html,favicon.ico,robots.txt,CHANGELOG.md",
+    "docker.md": "Dockerfile,docker*.md,nginx*,.dockerignore",
+    "pages.config.ts": "manifest.config.ts,openapi-ts-request.config.ts",
+    "package.json": "tsconfig.json,pnpm-lock.yaml,pnpm-workspace.yaml,LICENSE,.gitattributes,.gitignore,.gitpod.yml,CNAME,.npmrc,.browserslistrc",
+    "eslint.config.mjs": ".commitlintrc.*,.prettier*,.editorconfig,.commitlint.cjs,.eslint*"
+  },
+
+  // Disable the default formatter, use eslint instead
+  "prettier.enable": false,
+  "editor.formatOnSave": false,
+
+  // Auto fix
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit",
+    "source.organizeImports": "never"
+  },
+
+  // Silent the stylistic rules in you IDE, but still auto fix them
+  "eslint.rules.customizations": [
+    { "rule": "style/*", "severity": "off", "fixable": true },
+    { "rule": "format/*", "severity": "off", "fixable": true },
+    { "rule": "*-indent", "severity": "off", "fixable": true },
+    { "rule": "*-spacing", "severity": "off", "fixable": true },
+    { "rule": "*-spaces", "severity": "off", "fixable": true },
+    { "rule": "*-order", "severity": "off", "fixable": true },
+    { "rule": "*-dangle", "severity": "off", "fixable": true },
+    { "rule": "*-newline", "severity": "off", "fixable": true },
+    { "rule": "*quotes", "severity": "off", "fixable": true },
+    { "rule": "*semi", "severity": "off", "fixable": true }
+  ],
+
+  // Enable eslint for all supported languages
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "vue",
+    "html",
+    "markdown",
+    "json",
+    "jsonc",
+    "yaml",
+    "toml",
+    "xml",
+    "gql",
+    "graphql",
+    "astro",
+    "svelte",
+    "css",
+    "less",
+    "scss",
+    "pcss",
+    "postcss"
+  ],
+  "cSpell.words": [
+    "alova",
+    "Aplipay",
+    "attributify",
+    "chooseavatar",
+    "climblee",
+    "commitlint",
+    "dcloudio",
+    "iconfont",
+    "oxlint",
+    "qrcode",
+    "refresherrefresh",
+    "scrolltolower",
+    "tabbar",
+    "Toutiao",
+    "uniapp",
+    "unibest",
+    "unocss",
+    "uview",
+    "uvui",
+    "Wechat",
+    "WechatMiniprogram",
+    "Weixin"
+  ],
+  "i18n-ally.localesPaths": [
+    "src/locale"
+  ],
+  "i18n-ally.keystyle": "nested"
+}

.vscode/vue3.code-snippets

@@ -0,0 +1,77 @@
+{
+  // Place your unibest 工作区 snippets here. Each snippet is defined under a snippet name and has a scope, prefix, body and
+  // description. Add comma separated ids of the languages where the snippet is applicable in the scope field. If scope
+  // is left empty or omitted, the snippet gets applied to all languages. The prefix is what is
+  // used to trigger the snippet and the body will be expanded and inserted. Possible variables are:
+  // $1, $2 for tab stops, $0 for the final cursor position, and ${1:label}, ${2:another} for placeholders.
+  // Placeholders with the same ids are connected.
+  // Example:
+  // "Print to console": {
+  // 	"scope": "javascript,typescript",
+  // 	"prefix": "log",
+  // 	"body": [
+  // 		"console.log('$1');",
+  // 		"$2"
+  // 	],
+  // 	"description": "Log output to console"
+  // }
+  "Print unibest Vue3 SFC": {
+    "scope": "vue",
+    "prefix": "v3",
+    "body": [
+      "<script lang=\"ts\" setup>",
+      "definePage({",
+      "  style: {",
+      "    navigationBarTitleText: '$1',",
+      "  },",
+      "})",
+      "</script>\n",
+      "<template>",
+      "  <view class=\"\">$3</view>",
+      "</template>\n",
+      "<style lang=\"scss\" scoped>",
+      "//$4",
+      "</style>\n",
+    ],
+  },
+  "Print unibest style": {
+    "scope": "vue",
+    "prefix": "st",
+    "body": [
+      "<style lang=\"scss\" scoped>",
+      "//",
+      "</style>\n"
+    ],
+  },
+  "Print unibest script": {
+    "scope": "vue",
+    "prefix": "sc",
+    "body": [
+      "<script lang=\"ts\" setup>",
+      "//$1",
+      "</script>\n"
+    ],
+  },
+  "Print unibest script with definePage": {
+    "scope": "vue",
+    "prefix": "scdp",
+    "body": [
+      "<script lang=\"ts\" setup>",
+      "definePage({",
+      "  style: {",
+      "    navigationBarTitleText: '$1',",
+      "  },",
+      "})",
+      "</script>\n"
+    ],
+  },
+  "Print unibest template": {
+    "scope": "vue",
+    "prefix": "te",
+    "body": [
+      "<template>",
+      "  <view class=\"\">$1</view>",
+      "</template>\n"
+    ],
+  },
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 菲鸽
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,98 @@
+<p align="center">
+  <a href="https://github.com/unibest-tech/unibest">
+    <img width="160" src="./src/static/logo.svg">
+  </a>
+</p>
+
+<h1 align="center">
+  <a href="https://github.com/unibest-tech/unibest" target="_blank">unibest - 最好的 uniapp 开发框架</a>
+</h1>
+
+<div align="center">
+旧仓库 codercup 进不去了，star 也拿不回来，这里也展示一下那个地址的 star.
+
+[![GitHub Repo stars](https://img.shields.io/github/stars/codercup/unibest?style=flat&logo=github)](https://github.com/codercup/unibest)
+[![GitHub forks](https://img.shields.io/github/forks/codercup/unibest?style=flat&logo=github)](https://github.com/codercup/unibest)
+
+</div>
+
+<div align="center">
+
+[![GitHub Repo stars](https://img.shields.io/github/stars/feige996/unibest?style=flat&logo=github)](https://github.com/feige996/unibest)
+[![GitHub forks](https://img.shields.io/github/forks/feige996/unibest?style=flat&logo=github)](https://github.com/feige996/unibest)
+[![star](https://gitee.com/feige996/unibest/badge/star.svg?theme=dark)](https://gitee.com/feige996/unibest/stargazers)
+[![fork](https://gitee.com/feige996/unibest/badge/fork.svg?theme=dark)](https://gitee.com/feige996/unibest/members)
+![node version](https://img.shields.io/badge/node-%3E%3D18-green)
+![pnpm version](https://img.shields.io/badge/pnpm-%3E%3D7.30-green)
+![GitHub package.json version (subfolder of monorepo)](https://img.shields.io/github/package-json/v/feige996/unibest)
+![GitHub License](https://img.shields.io/github/license/feige996/unibest)
+
+</div>
+
+`unibest` —— 最好的 `uniapp` 开发模板，由 `uniapp` + `Vue3` + `Ts` + `Vite5` + `UnoCss` + `wot-ui` + `z-paging` 构成，使用了最新的前端技术栈，无需依靠 `HBuilderX`，通过命令行方式运行 `web`、`小程序` 和 `App`（编辑器推荐 `VSCode`，可选 `webstorm`）。
+
+`unibest` 内置了 `约定式路由`、`layout布局`、`请求封装`、`请求拦截`、`登录拦截`、`UnoCSS`、`i18n多语言` 等基础功能，提供了 `代码提示`、`自动格式化`、`统一配置`、`代码片段` 等辅助功能，让你编写 `uniapp` 拥有 `best` 体验 （ `unibest 的由来`）。
+
+![](https://raw.githubusercontent.com/andreasbm/readme/master/screenshots/lines/rainbow.png)
+
+<p align="center">
+  <a href="https://unibest.tech/" target="_blank">📖 文档地址(new)</a>
+  <span style="margin:0 10px;">|</span>
+  <a href="https://feige996.github.io/hello-unibest/" target="_blank">📱 DEMO 地址</a>
+</p>
+
+---
+
+注意旧的地址 [codercup](https://github.com/codercup/unibest) 我进不去了，使用新的 [feige996](https://github.com/feige996/unibest)。PR和 issue 也请使用新地址，否则无法合并。
+
+## 平台兼容性
+
+| H5  | IOS | 安卓 | 微信小程序 | 字节小程序 | 快手小程序 | 支付宝小程序 | 钉钉小程序 | 百度小程序 |
+| --- | --- | ---- | ---------- | ---------- | ---------- | ------------ | ---------- | ---------- |
+| √   | √   | √    | √          | √          | √          | √            | √          | √          |
+
+注意每种 `UI框架` 支持的平台有所不同，详情请看各 `UI框架` 的官网，也可以看 `unibest` 文档。
+
+## ⚙️ 环境
+
+- node>=18
+- pnpm>=7.30
+- Vue Official>=2.1.10
+- TypeScript>=5.0
+
+## 新版分支 
+- main == base
+- base --> base-i18n
+- base-login --> base-login-i18n
+
+## &#x1F4C2; 快速开始
+
+执行 `pnpm create unibest` 创建项目
+执行 `pnpm i` 安装依赖
+执行 `pnpm dev` 运行 `H5`
+执行 `pnpm dev:mp` 运行 `微信小程序`
+
+## 📦 运行（支持热更新）
+
+- web平台： `pnpm dev:h5`, 然后打开 [http://localhost:9000/](http://localhost:9000/)。
+- weixin平台：`pnpm dev:mp` 然后打开微信开发者工具，导入本地文件夹，选择本项目的`dist/dev/mp-weixin` 文件。
+- APP平台：`pnpm dev:app`, 然后打开 `HBuilderX`，导入刚刚生成的`dist/dev/app` 文件夹，选择运行到模拟器(开发时优先使用)，或者运行的安卓/ios基座。(如果是 `安卓` 和 `鸿蒙` 平台，则不用这个方式，可以把整个unibest项目导入到hbx，通过hbx的菜单来运行到对应的平台。)
+
+## 🔗 发布
+
+- web平台： `pnpm build:h5`，打包后的文件在 `dist/build/h5`，可以放到web服务器，如nginx运行。如果最终不是放在根目录，可以在 `manifest.config.ts` 文件的 `h5.router.base` 属性进行修改。
+- weixin平台：`pnpm build:mp`, 打包后的文件在 `dist/build/mp-weixin`，然后通过微信开发者工具导入，并点击右上角的“上传”按钮进行上传。
+- APP平台：`pnpm build:app`, 然后打开 `HBuilderX`，导入刚刚生成的`dist/build/app` 文件夹，选择发行 - APP云打包。(如果是 `安卓` 和 `鸿蒙` 平台，则不用这个方式，可以把整个unibest项目导入到hbx，通过hbx的菜单来发行到对应的平台。)
+
+## 📄 License
+
+[MIT](https://opensource.org/license/mit/)
+
+Copyright (c) 2025 菲鸽
+
+## 捐赠
+
+<p align='center'>
+<img alt="special sponsor appwrite" src="https://oss.laf.run/ukw0y1-site/pay/wepay.png" height="330" style="display:inline-block; height:330px;">
+<img alt="special sponsor appwrite" src="https://oss.laf.run/ukw0y1-site/pay/alipay.jpg" height="330" style="display:inline-block; height:330px; margin-left:10px;">
+</p>

codes/README.md

@@ -0,0 +1,3 @@
+# 参考代码
+
+部分代码片段，供参考。

codes/docker/.dockerignore

@@ -0,0 +1,31 @@
+# 依赖目录
+node_modules
+
+# 版本控制
+.git
+.gitignore
+
+# 构建产物
+/dist
+
+# 开发工具配置
+.vscode/
+.idea/
+.trae/
+.cursor/
+
+# 其他配置文件
+.github/
+.husky/
+
+# 日志文件
+logs/
+
+# 缓存文件
+.cache/
+
+*.swp
+*.swo
+
+# 操作系统文件
+.DS_Store

codes/docker/Dockerfile

@@ -0,0 +1,38 @@
+# 使用 node:24-alpine 作为基础镜像，固定版本+减少体积
+FROM node:24-alpine AS builder
+
+# 在容器中创建目录
+WORKDIR /app
+
+# 安装pnpm（使用 npm 的 --global-style 可以减少依赖安装体积）
+RUN npm install -g pnpm@10.10.0 --global-style
+# 设置pnpm镜像源
+RUN pnpm config set registry https://registry.npmmirror.com
+# 复制依赖文件
+COPY package.json pnpm-lock.yaml ./
+# 先复制scripts目录，因为prepare脚本需要用到其中的文件
+COPY scripts ./scripts
+# 安装依赖，但跳过prepare脚本（这一步会缓存，只有 package.json 或 pnpm-lock.yaml 变化时才会重新运行）
+RUN pnpm install --ignore-scripts --frozen-lockfile
+# 手动执行我们需要的docker:prepare脚本
+RUN pnpm run docker:prepare
+# 复制其余源代码
+COPY . .
+# 构建项目
+RUN pnpm run build
+
+
+# 使用nginx作为服务
+FROM nginx:1.29.1-alpine3.22 AS production-stage
+
+# 将构建好的项目复制到nginx下
+COPY --from=builder /app/dist/build/h5 /usr/share/nginx/html
+
+COPY nginx.conf /etc/nginx/nginx.conf
+
+# 暴露端口
+EXPOSE 80
+EXPOSE 443
+
+# 启动nginx
+CMD ["nginx", "-g", "daemon off;"]

codes/docker/docker.md

@@ -0,0 +1,28 @@
+## Docker
+
+根据提供的 `Dockerfile`，可以通过以下步骤构建并运行镜像：
+
+### 1. 构建Docker镜像
+
+在项目根目录执行以下命令：
+
+- `-t unibest:v1-2025091701`：为镜像指定名称和标签，YYYYMMDD+编号
+- `.`：表示使用当前目录的Dockerfile
+
+```bash
+docker build -t unibest:v1-2025091701 .
+docker build -t unibest:v1-2025091702 .
+```
+### 2. 运行Docker容器
+使用以下命令运行容器：
+
+```bash
+docker run -d --name unibest-v1-2025091701 -p 80:80 unibest:v1-2025091701
+docker run -d --name unibest-v1-2025091702 -p 80:80 unibest:v1-2025091702
+```
+
+- `-d`：表示在后台运行容器
+- `-p 80:80`：将容器的80端口映射到主机的80端口
+- `--name unibest-v1-2025091701`：为容器指定一个名称
+
+

codes/docker/nginx.conf

@@ -0,0 +1,145 @@
+# 配置工作进程数，通常设置为 CPU 核心数
+worker_processes auto;
+
+# 错误日志配置
+error_log /var/log/nginx/error.log warn;
+pid /var/run/nginx.pid;
+
+events {
+  worker_connections 1024;
+  # 开启多路复用
+  use epoll;
+}
+
+# 文件描述符限制 - 移到这里，在http块之前
+worker_rlimit_nofile 65535;
+
+http {
+  # 日志格式定义
+  log_format main '$remote_addr - $remote_user [$time_local] "$request" '
+                  '$status $body_bytes_sent "$http_referer" '
+                  '"$http_user_agent" "$http_x_forwarded_for"';
+  
+  # 访问日志配置
+  access_log /var/log/nginx/access.log main;
+
+  # 高效文件传输设置
+  sendfile on;
+  tcp_nopush on;
+  tcp_nodelay on;
+  
+  # 连接超时设置
+  keepalive_timeout 65;
+  keepalive_requests 100;
+
+  # gzip 压缩优化
+  gzip on;
+  gzip_vary on;
+  gzip_comp_level 6;
+  gzip_min_length 1000;
+  gzip_buffers 16 8k;
+  gzip_http_version 1.1;
+  # 增加更多文件类型
+  gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript application/vnd.ms-fontobject application/x-font-ttf font/opentype image/svg+xml image/x-icon;
+
+  # 全局设置
+  # 合理限制请求体大小，根据实际需求调整
+  client_max_body_size 10m;
+  client_body_buffer_size 128k;
+  client_header_timeout 60s;
+  client_body_timeout 60s;
+  
+  server {
+    listen 80;
+    server_name _;
+    gunzip on;
+    gzip_static always;
+    include /etc/nginx/mime.types;
+    absolute_redirect off;
+    root /usr/share/nginx/html;
+
+    # 安全相关响应头
+    add_header X-Frame-Options SAMEORIGIN;
+    add_header X-XSS-Protection "1; mode=block";
+    add_header X-Content-Type-Options nosniff;
+    # 根据实际情况调整 CSP
+    # add_header Content-Security-Policy "default-src 'self'";
+
+    # 处理 SPA 应用路由
+    location / {
+      try_files $uri $uri/ /index.html;
+      index index.html index.htm;
+    }
+
+    # HTML 和 JSON 文件 - 短缓存策略
+    location ~ .*\.(html|json)$ {
+      add_header Cache-Control "public, max-age=300, must-revalidate";
+    }
+
+    # 静态资源 - 长缓存策略
+    location ~ .*\.(jpg|jpeg|png|gif|bmp|webp|svg|ico|ttf|woff|woff2|eot|mp4|mp3|swf)$ {
+      add_header Cache-Control "public, max-age=31536000, immutable";
+      expires 365d;
+      access_log off;
+    }
+
+    # JS 和 CSS - 带版本号的长缓存
+    location ~ .*\.(js|css)$ {
+      add_header Cache-Control "public, max-age=31536000, immutable";
+      expires 365d;
+      access_log off;
+    }
+
+    # 接口转发 - 替换为实际后端地址
+    # location ^~ /fg-api {
+    #   proxy_http_version 1.1;
+    #   proxy_set_header X-Real-IP $remote_addr;
+    #   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    #   proxy_set_header X-Forwarded-Proto $scheme;
+    #   proxy_set_header Host $host;
+
+    #   # 后端是HTTPS时的必要配置
+    #   proxy_ssl_server_name on;
+    #   proxy_ssl_protocols TLSv1.2 TLSv1.3;
+    #   proxy_ssl_session_reuse on;
+      
+    #   # 对于生产环境，应该尽量使用有效的证书而不是依赖``proxy_ssl_verify off;`` ，因为这会带来安全风险
+    #   proxy_ssl_verify off;
+
+    #   # TODO：替换为实际后端服务地址
+    #   # 注意在URL末尾添加了斜杠，这样Nginx会去掉 /fg-api 前缀
+    #   # 前端请求 http://your-domain.com/fg-api/users 转发到 https://ukw0y1.laf.run/users
+    #   proxy_pass https://ukw0y1.laf.run/;
+
+    #   # 上面一行的效果与下面2行一样的效果，都是为了去掉 /fg-api 前缀
+    #   # 显式移除/fg-api前缀
+    #   # rewrite ^/fg-api(.*)$ $1 break; 
+    #   # 域名末尾不需要斜杠了
+    #   # proxy_pass https://ukw0y1.laf.run;
+
+    #   proxy_connect_timeout 60s;
+    #   proxy_send_timeout 60s;
+    #   proxy_read_timeout 60s;
+
+    #   proxy_buffers 8 32k;
+    #   proxy_buffer_size 64k;
+    #   proxy_busy_buffers_size 128k;
+
+    #   proxy_next_upstream error timeout http_500 http_502 http_503 http_504;
+    # }
+
+    # 错误页面配置
+    error_page 404 /index.html;
+    error_page 500 502 503 504 /50x.html;
+    location = /50x.html {
+      root /usr/share/nginx/html;
+    }
+
+    # 禁止访问隐藏文件
+    location ~ /\. {
+      deny all;
+      access_log off;
+      log_not_found off;
+    }
+  }
+}

env/.env

@@ -0,0 +1,30 @@
+VITE_APP_TITLE = 'unibest'
+VITE_APP_PORT = 9000
+
+VITE_UNI_APPID = '__UNI__D1E5001'
+VITE_WX_APPID = 'wxa2abb91f64032a2b'
+
+# h5部署网站的base，配置到 manifest.config.ts 里的 h5.router.base
+# https://uniapp.dcloud.net.cn/collocation/manifest.html#h5-router
+# 比如你要部署到 https://unibest.tech/doc/ ，则配置为 /doc/
+VITE_APP_PUBLIC_BASE=/
+
+# 后台请求地址
+VITE_SERVER_BASEURL = 'https://ukw0y1.laf.run'
+# 备注：如果后台带统一前缀，则也要加到后面，eg: https://ukw0y1.laf.run/api
+
+# 注意，如果是微信小程序，还有一套请求地址的配置，根据 develop、trial、release 分别设置上传地址，见 `src/utils/index.ts`。
+
+# h5是否需要配置代理
+VITE_APP_PROXY_ENABLE = false
+# 下面的不用修改，只要不跟你后台的统一前缀冲突就行。如果修改了，记得修改 `nginx` 里面的配置
+VITE_APP_PROXY_PREFIX = '/fg-api'
+
+# 第二个请求地址 (目前alova中可以使用)
+VITE_SERVER_BASEURL_SECONDARY = 'https://ukw0y1.laf.run'
+
+# 认证模式，'single' | 'double' ==> 单token | 双token
+VITE_AUTH_MODE = 'single'
+
+# 原生插件资源复制开关，控制是否启用 copy-native-resources 插件
+VITE_COPY_NATIVE_RES_ENABLE = false

env/.env.development

@@ -0,0 +1,9 @@
+# 变量必须以 VITE_ 为前缀才能暴露给外部读取
+NODE_ENV = 'development'
+# 是否去除console 和 debugger
+VITE_DELETE_CONSOLE = false
+# 是否开启sourcemap
+VITE_SHOW_SOURCEMAP = false
+
+# 后台请求地址
+VITE_SERVER_BASEURL = 'http://192.168.1.15:8080'

env/.env.production

@@ -0,0 +1,9 @@
+# 变量必须以 VITE_ 为前缀才能暴露给外部读取
+NODE_ENV = 'production'
+# 是否去除console 和 debugger
+VITE_DELETE_CONSOLE = true
+# 是否开启sourcemap
+VITE_SHOW_SOURCEMAP = false
+
+# 后台请求地址
+# VITE_SERVER_BASEURL = 'https://prod.xxx.com'

env/.env.test

@@ -0,0 +1,9 @@
+# 变量必须以 VITE_ 为前缀才能暴露给外部读取
+NODE_ENV = 'development'
+# 是否去除console 和 debugger
+VITE_DELETE_CONSOLE = false
+# 是否开启sourcemap
+VITE_SHOW_SOURCEMAP = false
+
+# 后台请求地址
+# VITE_SERVER_BASEURL = 'https://test.xxx.com'

eslint.config.mjs

@@ -0,0 +1,58 @@
+import uniHelper from '@uni-helper/eslint-config'
+
+export default uniHelper({
+  unocss: true,
+  vue: true,
+  markdown: false,
+  ignores: [
+    // 忽略uni_modules目录
+    '**/uni_modules/',
+    // 忽略原生插件目录
+    '**/nativeplugins/',
+    'dist',
+    // unplugin-auto-import 生成的类型文件，每次提交都改变，所以加入这里吧，与 .gitignore 配合使用
+    'auto-import.d.ts',
+    // vite-plugin-uni-pages 生成的类型文件，每次切换分支都一堆不同的，所以直接 .gitignore
+    'uni-pages.d.ts',
+    // 插件生成的文件
+    'src/pages.json',
+    'src/manifest.json',
+    // 忽略自动生成文件
+    'src/service/**',
+  ],
+  // https://eslint-config.antfu.me/rules
+  rules: {
+    'no-useless-return': 'off',
+    'no-console': 'off',
+    'no-unused-vars': 'off',
+    'vue/no-unused-refs': 'off',
+    'unused-imports/no-unused-vars': 'off',
+    'eslint-comments/no-unlimited-disable': 'off',
+    'jsdoc/check-param-names': 'off',
+    'jsdoc/require-returns-description': 'off',
+    'ts/no-empty-object-type': 'off',
+    'no-extend-native': 'off',
+    'vue/singleline-html-element-content-newline': [
+      'error',
+      {
+        externalIgnores: ['text'],
+      },
+    ],
+    // vue SFC 调换顺序改这里
+    'vue/block-order': ['error', {
+      order: [['script', 'template'], 'style'],
+    }],
+  },
+  formatters: {
+    /**
+     * Format CSS, LESS, SCSS files, also the `<style>` blocks in Vue
+     * By default uses Prettier
+     */
+    css: true,
+    /**
+     * Format HTML files
+     * By default uses Prettier
+     */
+    html: true,
+  },
+})

index.html

@@ -0,0 +1,26 @@
+<!doctype html>
+<html build-time="%BUILD_TIME%">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="shortcut icon" href="favicon.ico" type="image/x-icon" />
+    <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>%VITE_APP_TITLE%</title>
+    <!--preload-links-->
+    <!--app-context-->
+  </head>
+
+  <body>
+    <div id="app"><!--app-html--></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

manifest.config.ts

@@ -0,0 +1,164 @@
+import path from 'node:path'
+import process from 'node:process'
+// manifest.config.ts
+import { defineManifestConfig } from '@uni-helper/vite-plugin-uni-manifest'
+import { loadEnv } from 'vite'
+
+// 手动解析命令行参数获取 mode
+function getMode() {
+  const args = process.argv.slice(2)
+  const modeFlagIndex = args.findIndex(arg => arg === '--mode')
+  return modeFlagIndex !== -1 ? args[modeFlagIndex + 1] : args[0] === 'build' ? 'production' : 'development' // 默认 development
+}
+// 获取环境变量的范例
+const env = loadEnv(getMode(), path.resolve(process.cwd(), 'env'))
+const {
+  VITE_APP_TITLE,
+  VITE_UNI_APPID,
+  VITE_WX_APPID,
+  VITE_APP_PUBLIC_BASE,
+  VITE_FALLBACK_LOCALE,
+} = env
+// console.log('manifest.config.ts env:', env)
+
+export default defineManifestConfig({
+  'name': VITE_APP_TITLE,
+  'appid': VITE_UNI_APPID,
+  'description': '',
+  'versionName': '1.0.0',
+  'versionCode': '100',
+  'transformPx': false,
+  'locale': VITE_FALLBACK_LOCALE, // 'zh-Hans'
+  'h5': {
+    router: {
+      base: VITE_APP_PUBLIC_BASE,
+    },
+  },
+  /* 5+App特有相关 */
+  'app-plus': {
+    usingComponents: true,
+    nvueStyleCompiler: 'uni-app',
+    compilerVersion: 3,
+    compatible: {
+      ignoreVersion: true,
+    },
+    splashscreen: {
+      alwaysShowBeforeRender: true,
+      waiting: true,
+      autoclose: true,
+      delay: 0,
+    },
+    /* 模块配置 */
+    modules: {},
+    /* 应用发布信息 */
+    distribute: {
+      /* android打包配置 */
+      android: {
+        minSdkVersion: 21,
+        targetSdkVersion: 30,
+        abiFilters: ['armeabi-v7a', 'arm64-v8a'],
+        permissions: [
+          '<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/>',
+          '<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>',
+          '<uses-permission android:name="android.permission.VIBRATE"/>',
+          '<uses-permission android:name="android.permission.READ_LOGS"/>',
+          '<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>',
+          '<uses-feature android:name="android.hardware.camera.autofocus"/>',
+          '<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>',
+          '<uses-permission android:name="android.permission.CAMERA"/>',
+          '<uses-permission android:name="android.permission.GET_ACCOUNTS"/>',
+          '<uses-permission android:name="android.permission.READ_PHONE_STATE"/>',
+          '<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>',
+          '<uses-permission android:name="android.permission.WAKE_LOCK"/>',
+          '<uses-permission android:name="android.permission.FLASHLIGHT"/>',
+          '<uses-feature android:name="android.hardware.camera"/>',
+          '<uses-permission android:name="android.permission.WRITE_SETTINGS"/>',
+        ],
+      },
+      /* ios打包配置 */
+      ios: {},
+      /* SDK配置 */
+      sdkConfigs: {},
+      /* 图标配置 */
+      icons: {
+        android: {
+          hdpi: 'static/app/icons/72x72.png',
+          xhdpi: 'static/app/icons/96x96.png',
+          xxhdpi: 'static/app/icons/144x144.png',
+          xxxhdpi: 'static/app/icons/192x192.png',
+        },
+        ios: {
+          appstore: 'static/app/icons/1024x1024.png',
+          ipad: {
+            'app': 'static/app/icons/76x76.png',
+            'app@2x': 'static/app/icons/152x152.png',
+            'notification': 'static/app/icons/20x20.png',
+            'notification@2x': 'static/app/icons/40x40.png',
+            'proapp@2x': 'static/app/icons/167x167.png',
+            'settings': 'static/app/icons/29x29.png',
+            'settings@2x': 'static/app/icons/58x58.png',
+            'spotlight': 'static/app/icons/40x40.png',
+            'spotlight@2x': 'static/app/icons/80x80.png',
+          },
+          iphone: {
+            'app@2x': 'static/app/icons/120x120.png',
+            'app@3x': 'static/app/icons/180x180.png',
+            'notification@2x': 'static/app/icons/40x40.png',
+            'notification@3x': 'static/app/icons/60x60.png',
+            'settings@2x': 'static/app/icons/58x58.png',
+            'settings@3x': 'static/app/icons/87x87.png',
+            'spotlight@2x': 'static/app/icons/80x80.png',
+            'spotlight@3x': 'static/app/icons/120x120.png',
+          },
+        },
+      },
+    },
+  },
+  /* 快应用特有相关 */
+  'quickapp': {},
+  /* 小程序特有相关 */
+  'mp-weixin': {
+    appid: VITE_WX_APPID,
+    setting: {
+      urlCheck: false,
+      // 是否启用 ES6 转 ES5
+      es6: true,
+      minified: true,
+    },
+    optimization: {
+      subPackages: true,
+    },
+    // 是否合并组件虚拟节点外层属性，uni-app 3.5.1+ 开始支持。目前仅支持 style、class 属性。
+    // 默认不开启（undefined），这里设置为开启。
+    mergeVirtualHostAttributes: true,
+    // styleIsolation: 'shared',
+    usingComponents: true,
+    // __usePrivacyCheck__: true,
+  },
+  'mp-alipay': {
+    usingComponents: true,
+    styleIsolation: 'shared',
+    optimization: {
+      subPackages: true,
+    },
+    // 解决支付宝小程序开发工具报错 【globalThis is not defined】
+    compileOptions: {
+      globalObjectMode: 'enable',
+      transpile: {
+        script: {
+          ignore: ['node_modules/**'],
+        },
+      },
+    },
+  },
+  'mp-baidu': {
+    usingComponents: true,
+  },
+  'mp-toutiao': {
+    usingComponents: true,
+  },
+  'uniStatistics': {
+    enable: false,
+  },
+  'vueVersion': '3',
+})

openapi-ts-request.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'openapi-ts-request'
+
+export default defineConfig([
+  {
+    describe: 'unibest-openapi-test',
+    schemaPath: 'https://ukw0y1.laf.run/unibest-opapi-test.json',
+    serversPath: './src/service',
+    requestLibPath: `import request from '@/http/vue-query';\n import { CustomRequestOptions_ } from '@/http/types';`,
+    requestOptionsType: 'CustomRequestOptions_',
+    isGenReactQuery: false,
+    reactQueryMode: 'vue',
+    isGenJavaScript: false,
+  },
+])

package.json

@@ -0,0 +1,200 @@
+{
+  "name": "dingding",
+  "type": "module",
+  "version": "1.0.0",
+  "unibest-version": "4.0.0",
+  "unibest-update-time": "2025-11-07",
+  "packageManager": "pnpm@10.10.0",
+  "description": "unibest - 最好的 uniapp 开发模板",
+  "generate-time": "用户创建项目时生成",
+  "author": {
+    "name": "feige996",
+    "zhName": "菲鸽",
+    "email": "1020103647@qq.com",
+    "github": "https://github.com/feige996",
+    "gitee": "https://gitee.com/feige996"
+  },
+  "license": "MIT",
+  "homepage": "https://unibest.tech",
+  "repository": "https://github.com/feige996/unibest",
+  "bugs": {
+    "url": "https://github.com/feige996/unibest/issues",
+    "url-old": "https://github.com/codercup/unibest/issues"
+  },
+  "engines": {
+    "node": ">=20",
+    "pnpm": ">=9"
+  },
+  "scripts": {
+    "preinstall": "npx only-allow pnpm",
+    "uvm": "npx @dcloudio/uvm@latest",
+    "uvm-rm": "node ./scripts/postupgrade.js",
+    "postuvm": "echo upgrade uni-app success!",
+    "dev:app": "uni -p app",
+    "dev:app:test": "uni -p app --mode test",
+    "dev:app:prod": "uni -p app --mode production",
+    "dev:app-android": "uni -p app-android",
+    "dev:app-ios": "uni -p app-ios",
+    "dev:custom": "uni -p",
+    "predev": "pnpm init-baseFiles",
+    "dev": "uni",
+    "dev:test": "uni --mode test",
+    "dev:prod": "uni --mode production",
+    "dev:h5": "uni",
+    "dev:h5:test": "uni --mode test",
+    "dev:h5:prod": "uni --mode production",
+    "dev:h5:ssr": "uni --ssr",
+    "dev:mp": "uni -p mp-weixin",
+    "dev:mp:test": "uni -p mp-weixin --mode test",
+    "dev:mp:prod": "uni -p mp-weixin --mode production",
+    "dev:mp-alipay": "uni -p mp-alipay",
+    "dev:mp-baidu": "uni -p mp-baidu",
+    "dev:mp-jd": "uni -p mp-jd",
+    "dev:mp-kuaishou": "uni -p mp-kuaishou",
+    "dev:mp-lark": "uni -p mp-lark",
+    "dev:mp-qq": "uni -p mp-qq",
+    "dev:mp-toutiao": "uni -p mp-toutiao",
+    "dev:mp-weixin": "uni -p mp-weixin",
+    "dev:mp-xhs": "uni -p mp-xhs",
+    "dev:quickapp-webview": "uni -p quickapp-webview",
+    "dev:quickapp-webview-huawei": "uni -p quickapp-webview-huawei",
+    "dev:quickapp-webview-union": "uni -p quickapp-webview-union",
+    "build:app": "uni build -p app",
+    "build:app:test": "uni build -p app --mode test",
+    "build:app:prod": "uni build -p app --mode production",
+    "build:app-android": "uni build -p app-android",
+    "build:app-ios": "uni build -p app-ios",
+    "build:custom": "uni build -p",
+    "build:h5": "uni build",
+    "build:h5:test": "uni build --mode test",
+    "build:h5:prod": "uni build --mode production",
+    "build": "uni build",
+    "build:test": "uni build --mode test",
+    "build:prod": "uni build --mode production",
+    "build:h5:ssr": "uni build --ssr",
+    "build:mp-alipay": "uni build -p mp-alipay",
+    "build:mp": "uni build -p mp-weixin",
+    "build:mp:test": "uni build -p mp-weixin --mode test",
+    "build:mp:prod": "uni build -p mp-weixin --mode production",
+    "build:mp-baidu": "uni build -p mp-baidu",
+    "build:mp-jd": "uni build -p mp-jd",
+    "build:mp-kuaishou": "uni build -p mp-kuaishou",
+    "build:mp-lark": "uni build -p mp-lark",
+    "build:mp-qq": "uni build -p mp-qq",
+    "build:mp-toutiao": "uni build -p mp-toutiao",
+    "build:mp-weixin": "uni build -p mp-weixin",
+    "build:mp-xhs": "uni build -p mp-xhs",
+    "build:quickapp-webview": "uni build -p quickapp-webview",
+    "build:quickapp-webview-huawei": "uni build -p quickapp-webview-huawei",
+    "build:quickapp-webview-union": "uni build -p quickapp-webview-union",
+    "type-check": "vue-tsc --noEmit",
+    "openapi": "openapi-ts",
+    "init-husky": "git init && husky",
+    "init-baseFiles": "node ./scripts/create-base-files.js",
+    "init-json": "pnpm init-baseFiles",
+    "prepare": "pnpm init-husky & pnpm init-baseFiles",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix"
+  },
+  "dependencies": {
+    "@alova/adapter-uniapp": "^2.0.14",
+    "@alova/shared": "^1.3.1",
+    "@dcloudio/uni-app": "3.0.0-4080520251106001",
+    "@dcloudio/uni-app-harmony": "3.0.0-4080520251106001",
+    "@dcloudio/uni-app-plus": "3.0.0-4080520251106001",
+    "@dcloudio/uni-components": "3.0.0-4080520251106001",
+    "@dcloudio/uni-h5": "3.0.0-4080520251106001",
+    "@dcloudio/uni-mp-alipay": "3.0.0-4080520251106001",
+    "@dcloudio/uni-mp-baidu": "3.0.0-4080520251106001",
+    "@dcloudio/uni-mp-harmony": "3.0.0-4080520251106001",
+    "@dcloudio/uni-mp-jd": "3.0.0-4080520251106001",
+    "@dcloudio/uni-mp-kuaishou": "3.0.0-4080520251106001",
+    "@dcloudio/uni-mp-lark": "3.0.0-4080520251106001",
+    "@dcloudio/uni-mp-qq": "3.0.0-4080520251106001",
+    "@dcloudio/uni-mp-toutiao": "3.0.0-4080520251106001",
+    "@dcloudio/uni-mp-weixin": "3.0.0-4080520251106001",
+    "@dcloudio/uni-mp-xhs": "3.0.0-4080520251106001",
+    "@dcloudio/uni-quickapp-webview": "3.0.0-4080520251106001",
+    "abortcontroller-polyfill": "^1.7.8",
+    "alova": "^3.3.3",
+    "dayjs": "1.11.10",
+    "js-cookie": "^3.0.5",
+    "pinia": "2.0.36",
+    "pinia-plugin-persistedstate": "3.2.1",
+    "vue": "^3.4.21",
+    "vue-i18n": "^9.1.9",
+    "vue-router": "4.5.1",
+    "wot-design-uni": "latest",
+    "z-paging": "2.8.7"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@dcloudio/types": "^3.4.8",
+    "@dcloudio/uni-automator": "3.0.0-4080520251106001",
+    "@dcloudio/uni-cli-shared": "3.0.0-4080520251106001",
+    "@dcloudio/uni-stacktracey": "3.0.0-4080520251106001",
+    "@dcloudio/vite-plugin-uni": "3.0.0-4080520251106001",
+    "@esbuild/darwin-arm64": "0.20.2",
+    "@esbuild/darwin-x64": "0.20.2",
+    "@iconify-json/carbon": "^1.2.4",
+    "@iconify/utils": "^3.0.2",
+    "@rollup/rollup-darwin-x64": "^4.28.0",
+    "@types/node": "^20.17.9",
+    "@uni-helper/eslint-config": "0.5.0",
+    "@uni-helper/plugin-uni": "0.1.0",
+    "@uni-helper/uni-app-types": "1.0.0-alpha.6",
+    "@uni-helper/uni-env": "0.1.8",
+    "@uni-helper/uni-types": "1.0.0-alpha.6",
+    "@uni-helper/unocss-preset-uni": "0.2.11",
+    "@uni-helper/vite-plugin-uni-components": "0.2.3",
+    "@uni-helper/vite-plugin-uni-layouts": "0.1.11",
+    "@uni-helper/vite-plugin-uni-manifest": "0.2.8",
+    "@uni-helper/vite-plugin-uni-pages": "0.3.19",
+    "@uni-helper/vite-plugin-uni-platform": "0.0.5",
+    "@uni-ku/bundle-optimizer": "v1.3.15-beta.2",
+    "@uni-ku/root": "1.4.1",
+    "@unocss/eslint-plugin": "^66.2.3",
+    "@unocss/preset-legacy-compat": "66.0.0",
+    "@unocss/transformer-directives": "^66.5.5",
+    "@vue/runtime-core": "^3.4.21",
+    "@vue/tsconfig": "^0.1.3",
+    "autoprefixer": "^10.4.20",
+    "cross-env": "^10.0.0",
+    "eslint": "^9.31.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-format": "^1.0.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.2.10",
+    "miniprogram-api-typings": "^4.1.0",
+    "openapi-ts-request": "^1.10.0",
+    "postcss": "^8.4.49",
+    "postcss-html": "^1.8.0",
+    "postcss-scss": "^4.0.9",
+    "prettier": "^3.6.2",
+    "rollup-plugin-visualizer": "^6.0.3",
+    "sass": "1.77.8",
+    "std-env": "^3.9.0",
+    "typescript": "~5.8.0",
+    "unocss": "66.0.0",
+    "unplugin-auto-import": "^20.0.0",
+    "vite": "5.2.8",
+    "vite-plugin-restart": "^1.0.0",
+    "vue-tsc": "^3.0.6"
+  },
+  "pnpm": {
+    "overrides": {
+      "unconfig": "7.3.2"
+    }
+  },
+  "overrides": {
+    "unconfig": "7.3.2"
+  },
+  "resolutions": {
+    "bin-wrapper": "npm:bin-wrapper-china",
+    "unconfig": "7.3.2"
+  },
+  "lint-staged": {
+    "*": "eslint --fix"
+  }
+}

pages.config.ts

@@ -0,0 +1,23 @@
+import { defineUniPages } from '@uni-helper/vite-plugin-uni-pages'
+import { tabBar } from './src/tabbar/config'
+
+export default defineUniPages({
+  globalStyle: {
+    navigationStyle: 'default',
+    navigationBarTitleText: 'unibest',
+    navigationBarBackgroundColor: '#f8f8f8',
+    navigationBarTextStyle: 'black',
+    backgroundColor: '#FFFFFF',
+  },
+  easycom: {
+    autoscan: true,
+    custom: {
+      '^fg-(.*)': '@/components/fg-$1/fg-$1.vue',
+      '^(?!z-paging-refresh|z-paging-load-more)z-paging(.*)':
+        'z-paging/components/z-paging$1/z-paging$1.vue',
+      '^wd-(.*)': 'wot-design-uni/components/wd-$1/wd-$1.vue',
+    },
+  },
+  // tabbar 的配置统一在 “./src/tabbar/config.ts” 文件中
+  tabBar: tabBar as any,
+})

scripts/create-base-files.js

@@ -0,0 +1,53 @@
+// 基础配置文件生成脚本
+// 此脚本用于生成 src/manifest.json 和 src/pages.json 基础文件
+// 由于这两个配置文件会被添加到 .gitignore 中，因此需要通过此脚本确保项目能正常运行
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+// 获取当前文件的目录路径（替代 CommonJS 中的 __dirname）
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+// 最简可运行配置
+const manifest = { }
+const pages = {
+  pages: [
+    {
+      path: 'pages/index/index',
+      type: 'home',
+      style: {
+        navigationStyle: 'custom',
+        navigationBarTitleText: '首页',
+      },
+    },
+    {
+      path: 'pages/me/me',
+      type: 'page',
+      style: {
+        navigationBarTitleText: '我的',
+      },
+    },
+  ],
+  subPackages: [],
+}
+
+// 使用修复后的 __dirname 来解析文件路径
+const manifestPath = path.resolve(__dirname, '../src/manifest.json')
+const pagesPath = path.resolve(__dirname, '../src/pages.json')
+
+// 确保 src 目录存在
+const srcDir = path.resolve(__dirname, '../src')
+if (!fs.existsSync(srcDir)) {
+  fs.mkdirSync(srcDir, { recursive: true })
+}
+
+// 如果 src/manifest.json 不存在，就创建它；存在就不处理，以免覆盖
+if (!fs.existsSync(manifestPath) || fs.statSync(manifestPath).size === 0) {
+  fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2))
+}
+
+// 如果 src/pages.json 不存在，就创建它；存在就不处理，以免覆盖
+if (!fs.existsSync(pagesPath) || fs.statSync(pagesPath).size === 0) {
+  fs.writeFileSync(pagesPath, JSON.stringify(pages, null, 2))
+}

scripts/open-dev-tools.js

@@ -0,0 +1,83 @@
+import { exec } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import process from 'node:process'
+
+/**
+ * 打开开发者工具
+ */
+function _openDevTools() {
+  const platform = process.platform // darwin, win32, linux
+  const { UNI_PLATFORM } = process.env //  mp-weixin, mp-alipay
+
+  const uniPlatformText = UNI_PLATFORM === 'mp-weixin' ? '微信小程序' : UNI_PLATFORM === 'mp-alipay' ? '支付宝小程序' : '小程序'
+
+  // 项目路径（构建输出目录）
+  const projectPath = path.resolve(process.cwd(), `dist/dev/${UNI_PLATFORM}`)
+
+  // 检查构建输出目录是否存在
+  if (!fs.existsSync(projectPath)) {
+    console.log(`❌ ${uniPlatformText}构建目录不存在:`, projectPath)
+    return
+  }
+
+  console.log(`🚀 正在打开${uniPlatformText}开发者工具...`)
+
+  // 根据不同操作系统执行不同命令
+  let command = ''
+
+  if (platform === 'darwin') {
+    // macOS
+    if (UNI_PLATFORM === 'mp-weixin') {
+      command = `/Applications/wechatwebdevtools.app/Contents/MacOS/cli -o "${projectPath}"`
+    }
+    else if (UNI_PLATFORM === 'mp-alipay') {
+      command = `/Applications/小程序开发者工具.app/Contents/MacOS/小程序开发者工具 --p "${projectPath}"`
+    }
+  }
+  else if (platform === 'win32' || platform === 'win64') {
+    // Windows
+    if (UNI_PLATFORM === 'mp-weixin') {
+      command = `"C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat" -o "${projectPath}"`
+    }
+  }
+  else {
+    // Linux 或其他系统
+    console.log('❌ 当前系统不支持自动打开微信开发者工具')
+    return
+  }
+
+  exec(command, (error, stdout, stderr) => {
+    if (error) {
+      console.log(`❌ 打开${uniPlatformText}开发者工具失败:`, error.message)
+      console.log(`💡 请确保${uniPlatformText}开发者工具服务端口已启用`)
+      console.log(`💡 可以手动打开${uniPlatformText}开发者工具并导入项目:`, projectPath)
+      return
+    }
+
+    if (stderr) {
+      console.log('⚠️ 警告:', stderr)
+    }
+
+    console.log(`✅ ${uniPlatformText}开发者工具已打开`)
+
+    if (stdout) {
+      console.log(stdout)
+    }
+  })
+}
+
+export default function openDevTools() {
+  // 首次构建标记
+  let isFirstBuild = true
+
+  return {
+    name: 'uni-devtools',
+    writeBundle() {
+      if (isFirstBuild && process.env.UNI_PLATFORM?.includes('mp')) {
+        isFirstBuild = false
+        _openDevTools()
+      }
+    },
+  }
+}

scripts/postupgrade.js

@@ -0,0 +1,95 @@
+// # 执行 `pnpm upgrade` 后会升级 `uniapp` 相关依赖
+// # 在升级完后，会自动添加很多无用依赖，这需要删除以减小依赖包体积
+// # 只需要执行下面的命令即可
+
+import { exec } from 'node:child_process'
+import { promisify } from 'node:util'
+
+// 日志控制开关，设置为 true 可以启用所有日志输出
+const FG_LOG_ENABLE = true
+
+// 将 exec 转换为返回 Promise 的函数
+const execPromise = promisify(exec)
+
+// 定义要执行的命令
+const dependencies = [
+  // TODO: 如果不需要某个平台的小程序，请手动删除或注释掉
+  '@dcloudio/uni-mp-baidu',
+  '@dcloudio/uni-mp-jd',
+  '@dcloudio/uni-mp-kuaishou',
+  '@dcloudio/uni-mp-qq',
+  '@dcloudio/uni-mp-xhs',
+  '@dcloudio/uni-quickapp-webview',
+]
+
+/**
+ * 带开关的日志输出函数
+ * @param {string} message 日志消息
+ * @param {string} type 日志类型 (log, error)
+ */
+function log(message, type = 'log') {
+  if (FG_LOG_ENABLE) {
+    if (type === 'error') {
+      console.error(message)
+    }
+    else {
+      console.log(message)
+    }
+  }
+}
+
+/**
+ * 卸载单个依赖包
+ * @param {string} dep 依赖包名
+ * @returns {Promise<boolean>} 是否成功卸载
+ */
+async function uninstallDependency(dep) {
+  try {
+    log(`开始卸载依赖: ${dep}`)
+    const { stdout, stderr } = await execPromise(`pnpm un ${dep}`)
+    if (stdout) {
+      log(`stdout [${dep}]: ${stdout}`)
+    }
+    if (stderr) {
+      log(`stderr [${dep}]: ${stderr}`, 'error')
+    }
+    log(`成功卸载依赖: ${dep}`)
+    return true
+  }
+  catch (error) {
+    // 单个依赖卸载失败不影响其他依赖
+    log(`卸载依赖 ${dep} 失败: ${error.message}`, 'error')
+    return false
+  }
+}
+
+/**
+ * 串行卸载所有依赖包
+ */
+async function uninstallAllDependencies() {
+  log(`开始串行卸载 ${dependencies.length} 个依赖包...`)
+
+  let successCount = 0
+  let failedCount = 0
+
+  // 串行执行所有卸载命令
+  for (const dep of dependencies) {
+    const success = await uninstallDependency(dep)
+    if (success) {
+      successCount++
+    }
+    else {
+      failedCount++
+    }
+
+    // 为了避免命令执行过快导致的问题，添加短暂延迟
+    await new Promise(resolve => setTimeout(resolve, 100))
+  }
+
+  log(`卸载操作完成: 成功 ${successCount} 个, 失败 ${failedCount} 个`)
+}
+
+// 执行串行卸载
+uninstallAllDependencies().catch((err) => {
+  log(`串行卸载过程中出现未捕获的错误: ${err}`, 'error')
+})

src/App.ku.vue

@@ -0,0 +1,41 @@
+<script setup lang="ts">
+import { ref } from 'vue'
+import FgTabbar from '@/tabbar/index.vue'
+import { isPageTabbar } from './tabbar/store'
+import { currRoute } from './utils'
+
+const isCurrentPageTabbar = ref(true)
+onShow(() => {
+  console.log('App.ku.vue onShow', currRoute())
+  const { path } = currRoute()
+  // “蜡笔小开心”提到本地是 '/pages/index/index'，线上是 '/' 导致线上 tabbar 不见了
+  // 所以这里需要判断一下，如果是 '/' 就当做首页，也要显示 tabbar
+  if (path === '/') {
+    isCurrentPageTabbar.value = true
+  }
+  else {
+    isCurrentPageTabbar.value = isPageTabbar(path)
+  }
+})
+
+const helloKuRoot = ref('Hello AppKuVue')
+
+const exposeRef = ref('this is form app.Ku.vue')
+
+defineExpose({
+  exposeRef,
+})
+</script>
+
+<template>
+  <view>
+    <!-- 这个先隐藏了，知道这样用就行 -->
+    <view class="hidden text-center">
+      {{ helloKuRoot }}，这里可以配置全局的东西
+    </view>
+
+    <KuRootView />
+
+    <FgTabbar v-if="isCurrentPageTabbar" />
+  </view>
+</template>

src/App.vue

@@ -0,0 +1,56 @@
+<script setup lang="ts">
+import { onHide, onLaunch, onShow } from '@dcloudio/uni-app'
+import { navigateToInterceptor } from '@/router/interceptor'
+import { useTokenStore } from '@/store/token'
+import { useAuthStore } from '@/store/auth'
+
+onLaunch((options) => {
+  console.log('App.vue onLaunch', options)
+  // 初始化 store
+  const tokenStore = useTokenStore()
+  const authStore = useAuthStore()
+  
+  // 钉钉免登录逻辑
+  async function handleDingTalkAutoLogin() {
+    try {
+      // 检查是否已经有有效的token
+      if (!tokenStore.isTokenExpired.value) {
+        console.log('已有有效登录状态，无需重新登录');
+        return;
+      }
+      
+      console.log('尝试钉钉免登录...');
+      // 尝试钉钉免登录
+      await authStore.authDingTalkLogin();
+      console.log('钉钉免登录成功');
+    }
+    catch (error) {
+      console.error('钉钉免登录失败，将跳转到登录页面:', error);
+      // 免登录失败，跳转到登录页面
+      // 注意：这里不立即跳转，避免影响应用启动性能
+      // 路由拦截器会在页面跳转时处理未登录情况
+    }
+  }
+  
+  // 执行钉钉免登录
+  handleDingTalkAutoLogin();
+})
+onShow((options) => {
+  console.log('App.vue onShow', options)
+  // 处理直接进入页面路由的情况：如h5直接输入路由、微信小程序分享后进入等
+  // https://github.com/unibest-tech/unibest/issues/192
+  if (options?.path) {
+    navigateToInterceptor.invoke({ url: `/${options.path}`, query: options.query })
+  }
+  else {
+    navigateToInterceptor.invoke({ url: '/' })
+  }
+})
+onHide(() => {
+  console.log('App Hide')
+})
+</script>
+
+<style lang="scss">
+
+</style>

src/api/auth.ts

@@ -0,0 +1,28 @@
+import type { IAuthLoginRes, ICaptcha } from '@/api/types/login'
+import { http } from '@/http/http'
+
+/**
+ * 登录表单
+ */
+export interface ILoginForm {
+  username: string
+  password: string
+  code?: string
+  uuid?: string
+}
+
+/**
+ * 获取验证码
+ * @returns ICaptcha 验证码
+ */
+export function getCaptcha() {
+  return http.get<ICaptcha>('/captchaImage')
+}
+
+/**
+ * 用户登录
+ * @param loginForm 登录表单
+ */
+export function login(loginForm: ILoginForm) {
+  return http.post<IAuthLoginRes>('/login', loginForm)
+}

src/api/foo-alova.ts

@@ -0,0 +1,17 @@
+import { API_DOMAINS, http } from '@/http/alova'
+
+export interface IFoo {
+  id: number
+  name: string
+}
+
+export function foo() {
+  return http.Get<IFoo>('/foo', {
+    params: {
+      name: '菲鸽',
+      page: 1,
+      pageSize: 10,
+    },
+    meta: { domain: API_DOMAINS.SECONDARY }, // 用于切换请求地址
+  })
+}

src/api/foo.ts

@@ -0,0 +1,43 @@
+import { http } from '@/http/http'
+
+export interface IFoo {
+  id: number
+  name: string
+}
+
+export function foo() {
+  return http.Get<IFoo>('/foo', {
+    params: {
+      name: '菲鸽',
+      page: 1,
+      pageSize: 10,
+    },
+  })
+}
+
+export interface IFooItem {
+  id: string
+  name: string
+}
+
+/** GET 请求 */
+export async function getFooAPI(name: string) {
+  return await http.get<IFooItem>('/foo', { name })
+}
+/** GET 请求；支持 传递 header 的范例 */
+export function getFooAPI2(name: string) {
+  return http.get<IFooItem>('/foo', { name }, { 'Content-Type-100': '100' })
+}
+
+/** POST 请求 */
+export function postFooAPI(name: string) {
+  return http.post<IFooItem>('/foo', { name })
+}
+/** POST 请求；需要传递 query 参数的范例；微信小程序经常有同时需要query参数和body参数的场景 */
+export function postFooAPI2(name: string) {
+  return http.post<IFooItem>('/foo', { name }, { a: 1, b: 2 })
+}
+/** POST 请求；支持 传递 header 的范例 */
+export function postFooAPI3(name: string) {
+  return http.post<IFooItem>('/foo', { name }, { a: 1, b: 2 }, { 'Content-Type-100': '100' })
+}

src/api/login.ts

@@ -0,0 +1,117 @@
+import type { IAuthLoginRes, ICaptcha, IDoubleTokenRes, IUpdateInfo, IUpdatePassword, IUserInfoRes } from './types/login'
+import { http } from '@/http/http'
+
+/**
+ * 登录表单
+ */
+export interface ILoginForm {
+  username: string
+  password: string
+  code: string
+  uuid: string
+}
+
+/**
+ * 获取验证码
+ * @returns ICaptcha 验证码
+ */
+export function getCaptcha() {
+  return http.get<ICaptcha>('/captchaImage')
+}
+
+/**
+ * 用户登录
+ * @param loginForm 登录表单
+ */
+export function login(loginForm: ILoginForm) {
+  return http.post<IAuthLoginRes>('/login', loginForm)
+}
+
+/**
+ * 刷新token
+ * @param refreshToken 刷新token
+ */
+export function refreshToken(refreshToken: string) {
+  return http.post<IDoubleTokenRes>('/auth/refreshToken', { refreshToken })
+}
+
+/**
+ * 获取用户信息
+ */
+export function getUserInfo() {
+  return http.get<IUserInfoRes>('/getInfo')
+}
+
+/**
+ * 退出登录
+ */
+export function logout() {
+  return http.get<void>('/logout')
+}
+
+/**
+ * 修改用户信息
+ */
+export function updateInfo(data: IUpdateInfo) {
+  return http.post('/user/updateInfo', data)
+}
+
+/**
+ * 修改用户密码
+ */
+export function updateUserPassword(data: IUpdatePassword) {
+  return http.post('/user/updatePassword', data)
+}
+
+/**
+ * 获取微信登录凭证
+ * @returns Promise 包含微信登录凭证(code)
+ */
+export function getWxCode() {
+  return new Promise<UniApp.LoginRes>((resolve, reject) => {
+    uni.login({
+      provider: 'weixin',
+      success: res => resolve(res),
+      fail: err => reject(new Error(err)),
+    })
+  })
+}
+
+/**
+ * 微信登录
+ * @param params 微信登录参数，包含code
+ * @returns Promise 包含登录结果
+ */
+export function wxLogin(data: { code: string }) {
+  return http.post<IAuthLoginRes>('/auth/wxLogin', data)
+}
+
+/**
+ * 获取钉钉登录凭证
+ * @returns Promise 包含钉钉登录凭证(code)
+ */
+export function getDingTalkCode() {
+  return new Promise<{ code: string }>((resolve, reject) => {
+    // #ifdef H5
+    // H5环境下，模拟获取code，实际项目中可能需要通过URL参数或其他方式获取
+    console.warn('H5环境下，需要手动传入钉钉code');
+    resolve({ code: 'mock-dingtalk-code' });
+    // #endif
+    // #ifdef APP-PLUS
+    // 钉钉小程序环境下，调用钉钉SDK获取code
+    plus.dingtalk.getAuthCode({
+      success: (res: { code: string }) => resolve(res),
+      fail: (err: any) => reject(new Error(JSON.stringify(err)))
+    });
+    // #endif
+  })
+}
+
+/**
+ * 钉钉登录
+ * @param authCode 钉钉授权码
+ * @returns Promise 包含登录结果
+ */
+export function dingTalkLogin(authCode: string) {
+  return http.get<IAuthLoginRes>(`/dingTalkLogin/${authCode}`)
+}

src/api/types/login.ts

@@ -0,0 +1,105 @@
+// 认证模式类型
+export type AuthMode = 'single' | 'double'
+
+// 单Token响应类型
+export interface ISingleTokenRes {
+  token: string
+  expiresIn: number // 有效期(秒)
+}
+
+// 双Token响应类型
+export interface IDoubleTokenRes {
+  accessToken: string
+  refreshToken: string
+  accessExpiresIn: number // 访问令牌有效期(秒)
+  refreshExpiresIn: number // 刷新令牌有效期(秒)
+}
+
+/**
+ * 登录返回的信息，其实就是 token 信息
+ */
+export type IAuthLoginRes = ISingleTokenRes | IDoubleTokenRes
+
+/**
+ * 用户信息
+ */
+export interface IUserInfoRes {
+  userId: number
+  username: string
+  nickname: string
+  avatar?: string
+  [key: string]: any // 允许其他扩展字段
+}
+
+// 认证存储数据结构
+export interface AuthStorage {
+  mode: AuthMode
+  tokens: ISingleTokenRes | IDoubleTokenRes
+  userInfo?: IUserInfoRes
+  loginTime: number // 登录时间戳
+}
+
+/**
+ * 获取验证码
+ */
+export interface ICaptcha {
+  captchaEnabled: boolean
+  uuid: string
+  img: string
+}
+/**
+ * 上传成功的信息
+ */
+export interface IUploadSuccessInfo {
+  fileId: number
+  originalName: string
+  fileName: string
+  storagePath: string
+  fileHash: string
+  fileType: string
+  fileBusinessType: string
+  fileSize: number
+}
+/**
+ * 更新用户信息
+ */
+export interface IUpdateInfo {
+  id: number
+  name: string
+  sex: string
+}
+/**
+ * 更新用户信息
+ */
+export interface IUpdatePassword {
+  id: number
+  oldPassword: string
+  newPassword: string
+  confirmPassword: string
+}
+
+/**
+ * 判断是否为单Token响应
+ * @param tokenRes 登录响应数据
+ * @returns 是否为单Token响应
+ */
+export function isSingleTokenRes(tokenRes: IAuthLoginRes | string): tokenRes is ISingleTokenRes {
+  // 如果是字符串，不是单token对象
+  if (typeof tokenRes === 'string') {
+    return false
+  }
+  return 'token' in tokenRes && !('refreshToken' in tokenRes)
+}
+
+/**
+ * 判断是否为双Token响应
+ * @param tokenRes 登录响应数据
+ * @returns 是否为双Token响应
+ */
+export function isDoubleTokenRes(tokenRes: IAuthLoginRes | string): tokenRes is IDoubleTokenRes {
+  // 如果是字符串，不是双token对象
+  if (typeof tokenRes === 'string') {
+    return false
+  }
+  return 'accessToken' in tokenRes && 'refreshToken' in tokenRes
+}

src/env.d.ts

@@ -0,0 +1,35 @@
+/// <reference types="vite/client" />
+/// <reference types="vite-svg-loader" />
+
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue'
+
+  const component: DefineComponent<{}, {}, any>
+  export default component
+}
+
+interface ImportMetaEnv {
+  /** 网站标题，应用名称 */
+  readonly VITE_APP_TITLE: string
+  /** 服务端口号 */
+  readonly VITE_SERVER_PORT: string
+  /** 后台接口地址 */
+  readonly VITE_SERVER_BASEURL: string
+  /** H5是否需要代理 */
+  readonly VITE_APP_PROXY_ENABLE: 'true' | 'false'
+  /** H5是否需要代理，需要的话有个前缀 */
+  readonly VITE_APP_PROXY_PREFIX: string
+  /** 后端是否有统一前缀 /api */
+  readonly VITE_SERVER_HAS_API_PREFIX: 'true' | 'false'
+  /** 认证模式，'single' | 'double' ==> 单token | 双token */
+  readonly VITE_AUTH_MODE: 'single' | 'double'
+  /** 是否清除console */
+  readonly VITE_DELETE_CONSOLE: string
+  // 更多环境变量...
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}
+
+declare const __VITE_APP_PROXY__: 'true' | 'false'

src/hooks/useRequest.ts

@@ -0,0 +1,54 @@
+import type { Ref } from 'vue'
+import { ref } from 'vue'
+
+interface IUseRequestOptions<T> {
+  /** 是否立即执行 */
+  immediate?: boolean
+  /** 初始化数据 */
+  initialData?: T
+}
+
+interface IUseRequestReturn<T, P = undefined> {
+  loading: Ref<boolean>
+  error: Ref<boolean | Error>
+  data: Ref<T | undefined>
+  run: (args?: P) => Promise<T | undefined>
+}
+
+/**
+ * useRequest是一个定制化的请求钩子，用于处理异步请求和响应。
+ * @param func 一个执行异步请求的函数，返回一个包含响应数据的Promise。
+ * @param options 包含请求选项的对象 {immediate, initialData}。
+ * @param options.immediate 是否立即执行请求，默认为false。
+ * @param options.initialData 初始化数据，默认为undefined。
+ * @returns 返回一个对象{loading, error, data, run}，包含请求的加载状态、错误信息、响应数据和手动触发请求的函数。
+ */
+export default function useRequest<T, P = undefined>(
+  func: (args?: P) => Promise<T>,
+  options: IUseRequestOptions<T> = { immediate: false },
+): IUseRequestReturn<T, P> {
+  const loading = ref(false)
+  const error = ref(false)
+  const data = ref<T | undefined>(options.initialData) as Ref<T | undefined>
+  const run = async (args?: P) => {
+    loading.value = true
+    return func(args)
+      .then((res) => {
+        data.value = res
+        error.value = false
+        return data.value
+      })
+      .catch((err) => {
+        error.value = err
+        throw err
+      })
+      .finally(() => {
+        loading.value = false
+      })
+  }
+
+  if (options.immediate) {
+    (run as (args: P) => Promise<T | undefined>)({} as P)
+  }
+  return { loading, error, data, run }
+}

src/hooks/useScroll.md

@@ -0,0 +1,116 @@
+# 上拉刷新和下拉加载更多
+
+在 unibest 框架中，我们通过组合 `useScroll` Hook 可结合 `scroll-view` 组件来轻松实现上拉刷新和下拉加载更多的功能。
+场景一 页面滚动
+
+```
+definePage({
+  style: {
+    navigationBarTitleText: '上拉刷新和下拉加载更多',
+    enablePullDownRefresh: true,
+    onReachBottomDistance: 100,
+  },
+})
+```
+
+场景二 局部滚动 结合 `scroll-view`
+
+## 关键文件
+
+- `src/hooks/useScroll.ts`: 提供了核心的滚动逻辑处理 Hook。
+- `src/pages-sub/demo/scroll.vue`: 一个具体的实现示例页面。
+
+## `useScroll` Hook
+
+`useScroll` 是一个 Vue Composition API Hook，它封装了处理下拉刷新和上拉加载的通用逻辑。
+
+### 主要功能
+
+- **管理加载状态**: 自动处理 `loading`（加载中）、`finished`（已加载全部）和 `error`（加载失败）等状态。
+- **分页逻辑**: 内部维护分页参数（页码 `page` 和每页数量 `pageSize`）。
+- **事件处理**: 提供 `onScrollToLower`（滚动到底部）、`onRefresherRefresh`（下拉刷新）等方法，用于在视图层触发。
+- **数据合并**: 自动将新加载的数据追加到现有列表 `list` 中。
+
+### 使用方法
+
+```typescript
+import { useScroll } from '@/hooks/useScroll'
+import { getList } from '@/service/list' // 你的数据请求API
+
+const {
+  list, // 响应式的数据列表
+  loading, // 是否加载中
+  finished, // 是否已全部加载
+  error, // 是否加载失败
+  onScrollToLower, // 滚动到底部时触发的事件
+  onRefresherRefresh, // 下拉刷新时触发的事件
+} = useScroll(getList) // 将获取数据的API函数传入
+```
+
+## `scroll-view` 组件
+
+`scroll-view` 是 uni-app 提供的可滚动视图区域组件，它提供了一系列属性来支持下拉刷新和上拉加载。
+
+### 关键属性
+
+- `scroll-y`: 允许纵向滚动。
+- `refresher-enabled`: 启用下拉刷新。
+- `refresher-triggered`: 控制下拉刷新动画的显示与隐藏，通过 `loading` 状态绑定。
+- `@scrolltolower`: 滚动到底部时触发的事件，绑定 `onScrollToLower` 方法。
+- `@refresherrefresh`: 触发下拉刷新时触发的事件，绑定 `onRefresherRefresh` 方法。
+
+## 示例代码
+
+以下是 `src/pages-sub/demo/scroll.vue` 中的核心代码，展示了如何将 `useScroll` 和 `scroll-view` 结合使用。
+
+```vue
+<template>
+  <view class="scroll-page">
+    <scroll-view
+      class="scroll-view"
+      scroll-y
+      :refresher-enabled="true"
+      :refresher-triggered="loading"
+      @scrolltolower="onScrollToLower"
+      @refresherrefresh="onRefresherRefresh"
+    >
+      <view v-for="item in list" :key="item.id" class="scroll-item">
+        {{ item.name }}
+      </view>
+
+      <!-- 加载状态提示 -->
+      <view v-if="loading" class="loading-tip">加载中...</view>
+      <view v-if="finished" class="finished-tip">没有更多了</view>
+      <view v-if="error" class="error-tip">加载失败，请重试</view>
+    </scroll-view>
+  </view>
+</template>
+
+<script setup lang="ts">
+import { useScroll } from '@/hooks/useScroll'
+import { getList } from '@/service/list'
+
+const { list, loading, finished, error, onScrollToLower, onRefresherRefresh } = useScroll(getList)
+</script>
+
+<style scoped>
+/* 样式省略 */
+.scroll-page, .scroll-view {
+  height: 100%;
+}
+</style>
+```
+
+## 实现步骤总结
+
+1.  **创建API**: 确保你有一个返回分页数据的API请求函数（例如 `getList`），它应该接受页码和页面大小作为参数。
+2.  **调用 `useScroll`**: 在你的页面脚本中，导入并调用 `useScroll` Hook，将你的API函数作为参数传入。
+3.  **模板绑定**:
+    -   使用 `scroll-view` 组件作为滚动容器。
+    -   将其 `refresher-triggered` 属性绑定到 `useScroll` 返回的 `loading` 状态。
+    -   将其 `@scrolltolower` 事件绑定到 `onScrollToLower` 方法。
+    -   将其 `@refresherrefresh` 事件绑定到 `onRefresherRefresh` 方法。
+4.  **渲染列表**: 使用 `v-for` 指令渲染 `useScroll` 返回的 `list` 数组。
+5.  **添加加载提示**: 根据 `loading`, `finished`, `error` 状态，在列表底部显示不同的提示信息，提升用户体验。
+
+通过以上步骤，你就可以在项目中快速集成一个功能完善、体验良好的上拉刷新和下拉加载列表。

src/hooks/useScroll.ts

@@ -0,0 +1,74 @@
+import type { Ref } from 'vue'
+import { onMounted, ref } from 'vue'
+
+interface UseScrollOptions<T> {
+  fetchData: (page: number, pageSize: number) => Promise<T[]>
+  pageSize?: number
+}
+
+interface UseScrollReturn<T> {
+  list: Ref<T[]>
+  loading: Ref<boolean>
+  finished: Ref<boolean>
+  error: Ref<any>
+  refresh: () => Promise<void>
+  loadMore: () => Promise<void>
+}
+
+export function useScroll<T>({
+  fetchData,
+  pageSize = 10,
+}: UseScrollOptions<T>): UseScrollReturn<T> {
+  const list = ref<T[]>([]) as Ref<T[]>
+  const loading = ref(false)
+  const finished = ref(false)
+  const error = ref<any>(null)
+  const page = ref(1)
+
+  const loadData = async () => {
+    if (loading.value || finished.value)
+      return
+
+    loading.value = true
+    error.value = null
+
+    try {
+      const data = await fetchData(page.value, pageSize)
+      if (data.length < pageSize) {
+        finished.value = true
+      }
+      list.value.push(...data)
+      page.value++
+    }
+    catch (err) {
+      error.value = err
+    }
+    finally {
+      loading.value = false
+    }
+  }
+
+  const refresh = async () => {
+    page.value = 1
+    finished.value = false
+    list.value = []
+    await loadData()
+  }
+
+  const loadMore = async () => {
+    await loadData()
+  }
+
+  onMounted(() => {
+    refresh()
+  })
+
+  return {
+    list,
+    loading,
+    finished,
+    error,
+    refresh,
+    loadMore,
+  }
+}

src/hooks/useUpload.ts

@@ -0,0 +1,171 @@
+import { ref } from 'vue'
+import { getEnvBaseUrl } from '@/utils/index'
+
+const VITE_UPLOAD_BASEURL = `${getEnvBaseUrl()}/upload`
+
+type TfileType = 'image' | 'file'
+type TImage = 'png' | 'jpg' | 'jpeg' | 'webp' | '*'
+type TFile = 'doc' | 'docx' | 'ppt' | 'zip' | 'xls' | 'xlsx' | 'txt' | TImage
+
+interface TOptions<T extends TfileType> {
+  formData?: Record<string, any>
+  maxSize?: number
+  accept?: T extends 'image' ? TImage[] : TFile[]
+  fileType?: T
+  success?: (params: any) => void
+  error?: (err: any) => void
+}
+
+export default function useUpload<T extends TfileType>(options: TOptions<T> = {} as TOptions<T>) {
+  const {
+    formData = {},
+    maxSize = 5 * 1024 * 1024,
+    accept = ['*'],
+    fileType = 'image',
+    success,
+    error: onError,
+  } = options
+
+  const loading = ref(false)
+  const error = ref<Error | null>(null)
+  const data = ref<any>(null)
+
+  const handleFileChoose = ({ tempFilePath, size }: { tempFilePath: string, size: number }) => {
+    if (size > maxSize) {
+      uni.showToast({
+        title: `文件大小不能超过 ${maxSize / 1024 / 1024}MB`,
+        icon: 'none',
+      })
+      return
+    }
+
+    // const fileExtension = file?.tempFiles?.name?.split('.').pop()?.toLowerCase()
+    // const isTypeValid = accept.some((type) => type === '*' || type.toLowerCase() === fileExtension)
+
+    // if (!isTypeValid) {
+    //   uni.showToast({
+    //     title: `仅支持 ${accept.join(', ')} 格式的文件`,
+    //     icon: 'none',
+    //   })
+    //   return
+    // }
+
+    loading.value = true
+    uploadFile({
+      tempFilePath,
+      formData,
+      onSuccess: (res) => {
+        // 修改这里的解析逻辑，适应不同平台的返回格式
+        let parsedData = res
+        try {
+          // 尝试解析为JSON
+          const jsonData = JSON.parse(res)
+          // 检查是否包含data字段
+          parsedData = jsonData.data || jsonData
+        }
+        catch (e) {
+          // 如果解析失败，使用原始数据
+          console.log('Response is not JSON, using raw data:', res)
+        }
+        data.value = parsedData
+        // console.log('上传成功', res)
+        success?.(parsedData)
+      },
+      onError: (err) => {
+        error.value = err
+        onError?.(err)
+      },
+      onComplete: () => {
+        loading.value = false
+      },
+    })
+  }
+
+  const run = () => {
+    // 微信小程序从基础库 2.21.0 开始， wx.chooseImage 停止维护，请使用 uni.chooseMedia 代替。
+    // 微信小程序在2023年10月17日之后，使用本API需要配置隐私协议
+    const chooseFileOptions = {
+      count: 1,
+      success: (res: any) => {
+        console.log('File selected successfully:', res)
+        // 小程序中res:{errMsg: "chooseImage:ok", tempFiles: [{fileType: "image", size: 48976, tempFilePath: "http://tmp/5iG1WpIxTaJf3ece38692a337dc06df7eb69ecb49c6b.jpeg"}]}
+        // h5中res:{errMsg: "chooseImage:ok", tempFilePaths: "blob:http://localhost:9000/f74ab6b8-a14d-4cb6-a10d-fcf4511a0de5", tempFiles: [File]}
+        // h5的File有以下字段：{name: "girl.jpeg", size: 48976, type: "image/jpeg"}
+        // App中res:{errMsg: "chooseImage:ok", tempFilePaths: "file:///Users/feige/xxx/gallery/1522437259-compressed-IMG_0006.jpg", tempFiles: [File]}
+        // App的File有以下字段：{path: "file:///Users/feige/xxx/gallery/1522437259-compressed-IMG_0006.jpg", size: 48976}
+        let tempFilePath = ''
+        let size = 0
+        // #ifdef MP-WEIXIN
+        tempFilePath = res.tempFiles[0].tempFilePath
+        size = res.tempFiles[0].size
+        // #endif
+        // #ifndef MP-WEIXIN
+        tempFilePath = res.tempFilePaths[0]
+        size = res.tempFiles[0].size
+        // #endif
+        handleFileChoose({ tempFilePath, size })
+      },
+      fail: (err: any) => {
+        console.error('File selection failed:', err)
+        error.value = err
+        onError?.(err)
+      },
+    }
+
+    if (fileType === 'image') {
+      // #ifdef MP-WEIXIN
+      uni.chooseMedia({
+        ...chooseFileOptions,
+        mediaType: ['image'],
+      })
+      // #endif
+
+      // #ifndef MP-WEIXIN
+      uni.chooseImage(chooseFileOptions)
+      // #endif
+    }
+    else {
+      uni.chooseFile({
+        ...chooseFileOptions,
+        type: 'all',
+      })
+    }
+  }
+
+  return { loading, error, data, run }
+}
+
+async function uploadFile({
+  tempFilePath,
+  formData,
+  onSuccess,
+  onError,
+  onComplete,
+}: {
+  tempFilePath: string
+  formData: Record<string, any>
+  onSuccess: (data: any) => void
+  onError: (err: any) => void
+  onComplete: () => void
+}) {
+  uni.uploadFile({
+    url: VITE_UPLOAD_BASEURL,
+    filePath: tempFilePath,
+    name: 'file',
+    formData,
+    success: (uploadFileRes) => {
+      try {
+        const data = uploadFileRes.data
+        onSuccess(data)
+      }
+      catch (err) {
+        onError(err)
+      }
+    },
+    fail: (err) => {
+      console.error('Upload failed:', err)
+      onError(err)
+    },
+    complete: onComplete,
+  })
+}

src/http/README.md

@@ -0,0 +1,13 @@
+# 请求库
+
+目前unibest支持3种请求库：
+- 菲鸽简单封装的 `简单版本http`，路径（src/http/http.ts），对应的示例在 src/api/foo.ts
+- `alova 的 http`，路径（src/http/alova.ts），对应的示例在 src/api/foo-alova.ts
+- `vue-query`, 路径（src/http/vue-query.ts）, 目前主要用在自动生成接口，详情看(https://unibest.tech/base/17-generate)，示例在 src/service/app 文件夹
+
+## 如何选择
+如果您以前用过 alova 或者 vue-query，可以优先使用您熟悉的。
+如果您的项目简单，简单版本的http 就够了，也不会增加包体积。（发版的时候可以去掉alova和vue-query，如果没有超过包体积，留着也无所谓 ^_^）
+
+## roadmap
+菲鸽最近在优化脚手架，后续可以选择是否使用第三方的请求库，以及选择什么请求库。还在开发中，大概月底出来（8月31号）。

src/http/alova.ts

@@ -0,0 +1,119 @@
+import type { uniappRequestAdapter } from '@alova/adapter-uniapp'
+import type { IResponse } from './types'
+import AdapterUniapp from '@alova/adapter-uniapp'
+import { createAlova } from 'alova'
+import { createServerTokenAuthentication } from 'alova/client'
+import VueHook from 'alova/vue'
+import { toLoginPage } from '@/utils/toLoginPage'
+import { ContentTypeEnum, ResultEnum, ShowMessage } from './tools/enum'
+
+// 配置动态Tag
+export const API_DOMAINS = {
+  DEFAULT: import.meta.env.VITE_SERVER_BASEURL,
+  SECONDARY: import.meta.env.VITE_SERVER_BASEURL_SECONDARY,
+}
+
+/**
+ * 创建请求实例
+ */
+const { onAuthRequired, onResponseRefreshToken } = createServerTokenAuthentication<
+  typeof VueHook,
+  typeof uniappRequestAdapter
+>({
+  // 如果下面拦截不到，请使用 refreshTokenOnSuccess by 群友@琛
+  refreshTokenOnError: {
+    isExpired: (error) => {
+      return error.response?.status === ResultEnum.Unauthorized
+    },
+    handler: async () => {
+      try {
+        // await authLogin();
+      }
+      catch (error) {
+        // 切换到登录页
+        toLoginPage({ mode: 'reLaunch' })
+        throw error
+      }
+    },
+  },
+})
+
+/**
+ * alova 请求实例
+ */
+const alovaInstance = createAlova({
+  baseURL: API_DOMAINS.DEFAULT,
+  ...AdapterUniapp(),
+  timeout: 5000,
+  statesHook: VueHook,
+
+  beforeRequest: onAuthRequired((method) => {
+    // 设置默认 Content-Type
+    method.config.headers = {
+      ContentType: ContentTypeEnum.JSON,
+      Accept: 'application/json, text/plain, */*',
+      ...method.config.headers,
+    }
+
+    const { config } = method
+    const ignoreAuth = !config.meta?.ignoreAuth
+    console.log('ignoreAuth===>', ignoreAuth)
+    // 处理认证信息   自行处理认证问题
+    if (ignoreAuth) {
+      const token = 'getToken()'
+      if (!token) {
+        throw new Error('[请求错误]：未登录')
+      }
+      // method.config.headers.token = token;
+    }
+
+    // 处理动态域名
+    if (config.meta?.domain) {
+      method.baseURL = config.meta.domain
+      console.log('当前域名', method.baseURL)
+    }
+  }),
+
+  responded: onResponseRefreshToken((response, method) => {
+    const { config } = method
+    const { requestType } = config
+    const {
+      statusCode,
+      data: rawData,
+      errMsg,
+    } = response as UniNamespace.RequestSuccessCallbackResult
+
+    // 处理特殊请求类型（上传/下载）
+    if (requestType === 'upload' || requestType === 'download') {
+      return response
+    }
+
+    // 处理 HTTP 状态码错误
+    if (statusCode !== 200) {
+      const errorMessage = ShowMessage(statusCode) || `HTTP请求错误[${statusCode}]`
+      console.error('errorMessage===>', errorMessage)
+      uni.showToast({
+        title: errorMessage,
+        icon: 'error',
+      })
+      throw new Error(`${errorMessage}：${errMsg}`)
+    }
+
+    // 处理业务逻辑错误
+    const { code, message, data } = rawData as IResponse
+    // 0和200当做成功都很普遍，这里直接兼容两者，见 ResultEnum
+    if (code !== ResultEnum.Success0 && code !== ResultEnum.Success200) {
+      if (config.meta?.toast !== false) {
+        uni.showToast({
+          title: message,
+          icon: 'none',
+        })
+      }
+      throw new Error(`请求错误[${code}]：${message}`)
+    }
+    // 处理成功响应，返回业务数据
+    return data
+  }),
+})
+
+export const http = alovaInstance

src/http/http.ts

@@ -0,0 +1,199 @@
+import type { IDoubleTokenRes } from '@/api/types/login'
+import type { CustomRequestOptions, IResponse } from '@/http/types'
+import { nextTick } from 'vue'
+import { useTokenStore } from '@/store/token'
+import { isDoubleTokenMode } from '@/utils'
+import { toLoginPage } from '@/utils/toLoginPage'
+import { ResultEnum } from './tools/enum'
+
+// 刷新 token 状态管理
+let refreshing = false // 防止重复刷新 token 标识
+let taskQueue: (() => void)[] = [] // 刷新 token 请求队列
+
+export function http<T>(options: CustomRequestOptions) {
+  // 1. 返回 Promise 对象
+  return new Promise<T>((resolve, reject) => {
+    uni.request({
+      ...options,
+      dataType: 'json',
+      // #ifndef MP-WEIXIN
+      responseType: 'json',
+      // #endif
+      // 响应成功
+      success: async (res) => {
+        const responseData = res.data as IResponse<T>
+        const { code } = responseData
+
+        // 检查是否是401错误（包括HTTP状态码401或业务码401）
+        const isTokenExpired = res.statusCode === 401 || code === 401
+
+        if (isTokenExpired) {
+          const tokenStore = useTokenStore()
+          if (!isDoubleTokenMode) {
+            // 未启用双token策略，清理用户信息，跳转到登录页
+            // tokenStore.logout()
+            toLoginPage()
+            return reject(res)
+          }
+
+          /* -------- 无感刷新 token ----------- */
+          const { refreshToken } = tokenStore.tokenInfo as IDoubleTokenRes || {}
+          // token 失效的，且有刷新 token 的，才放到请求队列里
+          if (refreshToken) {
+            taskQueue.push(() => {
+              resolve(http<T>(options))
+            })
+          }
+
+          // 如果有 refreshToken 且未在刷新中，发起刷新 token 请求
+          if (refreshToken && !refreshing) {
+            refreshing = true
+            try {
+              // 发起刷新 token 请求（使用 store 的 refreshToken 方法）
+              await tokenStore.refreshToken()
+              // 刷新 token 成功
+              refreshing = false
+              nextTick(() => {
+                // 关闭其他弹窗
+                uni.hideToast()
+                uni.showToast({
+                  title: 'token 刷新成功',
+                  icon: 'none',
+                })
+              })
+              // 将任务队列的所有任务重新请求
+              taskQueue.forEach(task => task())
+            }
+            catch (refreshErr) {
+              console.error('刷新 token 失败:', refreshErr)
+              refreshing = false
+              // 刷新 token 失败，跳转到登录页
+              nextTick(() => {
+                // 关闭其他弹窗
+                uni.hideToast()
+                uni.showToast({
+                  title: '登录已过期，请重新登录',
+                  icon: 'none',
+                })
+              })
+              // 清除用户信息
+              await tokenStore.logout()
+              // 跳转到登录页
+              setTimeout(() => {
+                toLoginPage()
+              }, 2000)
+            }
+            finally {
+              // 不管刷新 token 成功与否，都清空任务队列
+              taskQueue = []
+            }
+          }
+
+          return reject(res)
+        }
+
+        // 处理其他成功状态（HTTP状态码200-299）
+        if (res.statusCode >= 200 && res.statusCode < 300) {
+          // 处理业务逻辑错误
+          if (code !== ResultEnum.Success0 && code !== ResultEnum.Success200) {
+            uni.showToast({
+              icon: 'none',
+              title: responseData.msg || responseData.message || '请求错误',
+            })
+          }
+          return resolve(responseData)
+        }
+
+        // 处理其他错误
+        !options.hideErrorToast
+        && uni.showToast({
+          icon: 'none',
+          title: (res.data as any).msg || '请求错误',
+        })
+        reject(res)
+      },
+      // 响应失败
+      fail(err) {
+        uni.showToast({
+          icon: 'none',
+          title: '网络错误，换个网络试试',
+        })
+        reject(err)
+      },
+    })
+  })
+}
+
+/**
+ * GET 请求
+ * @param url 后台地址
+ * @param query 请求query参数
+ * @param header 请求头，默认为json格式
+ * @returns
+ */
+export function httpGet<T>(url: string, query?: Record<string, any>, header?: Record<string, any>, options?: Partial<CustomRequestOptions>) {
+  return http<T>({
+    url,
+    query,
+    method: 'GET',
+    header,
+    ...options,
+  })
+}
+
+/**
+ * POST 请求
+ * @param url 后台地址
+ * @param data 请求body参数
+ * @param query 请求query参数，post请求也支持query，很多微信接口都需要
+ * @param header 请求头，默认为json格式
+ * @returns
+ */
+export function httpPost<T>(url: string, data?: Record<string, any>, query?: Record<string, any>, header?: Record<string, any>, options?: Partial<CustomRequestOptions>) {
+  return http<T>({
+    url,
+    query,
+    data,
+    method: 'POST',
+    header,
+    ...options,
+  })
+}
+/**
+ * PUT 请求
+ */
+export function httpPut<T>(url: string, data?: Record<string, any>, query?: Record<string, any>, header?: Record<string, any>, options?: Partial<CustomRequestOptions>) {
+  return http<T>({
+    url,
+    data,
+    query,
+    method: 'PUT',
+    header,
+    ...options,
+  })
+}
+
+/**
+ * DELETE 请求（无请求体，仅 query）
+ */
+export function httpDelete<T>(url: string, query?: Record<string, any>, header?: Record<string, any>, options?: Partial<CustomRequestOptions>) {
+  return http<T>({
+    url,
+    query,
+    method: 'DELETE',
+    header,
+    ...options,
+  })
+}
+
+// 支持与 axios 类似的API调用
+http.get = httpGet
+http.post = httpPost
+http.put = httpPut
+http.delete = httpDelete
+
+// 支持与 alovaJS 类似的API调用
+http.Get = httpGet
+http.Post = httpPost
+http.Put = httpPut
+http.Delete = httpDelete

src/http/interceptor.ts

@@ -0,0 +1,69 @@
+import type { CustomRequestOptions } from '@/http/types'
+import { useTokenStore } from '@/store'
+import { getEnvBaseUrl } from '@/utils'
+import { stringifyQuery } from './tools/queryString'
+
+// 请求基准地址
+const baseUrl = getEnvBaseUrl()
+
+// 拦截器配置
+const httpInterceptor = {
+  // 拦截前触发
+  invoke(options: CustomRequestOptions) {
+    // 如果您使用了alova，则请把下面的代码放开注释
+    // alova 执行流程：alova beforeRequest --> 本拦截器 --> alova responded
+    // return options
+
+    // 非 alova 请求，正常执行
+    // 接口请求支持通过 query 参数配置 queryString
+    if (options.query) {
+      const queryStr = stringifyQuery(options.query)
+      if (options.url.includes('?')) {
+        options.url += `&${queryStr}`
+      }
+      else {
+        options.url += `?${queryStr}`
+      }
+    }
+    // 非 http 开头需拼接地址
+    if (!options.url.startsWith('http')) {
+      // #ifdef H5
+      if (JSON.parse(import.meta.env.VITE_APP_PROXY_ENABLE)) {
+        // 自动拼接代理前缀
+        options.url = import.meta.env.VITE_APP_PROXY_PREFIX + options.url
+      }
+      else {
+        options.url = baseUrl + options.url
+      }
+      // #endif
+      // 非H5正常拼接
+      // #ifndef H5
+      options.url = baseUrl + options.url
+      // #endif
+      // TIPS: 如果需要对接多个后端服务，也可以在这里处理，拼接成所需要的地址
+    }
+    // 1. 请求超时
+    options.timeout = 60000 // 60s
+    // 2. （可选）添加小程序端请求头标识
+    options.header = {
+      ...options.header,
+    }
+    // 3. 添加 token 请求头标识
+    const tokenStore = useTokenStore()
+    const token = tokenStore.validToken
+
+    if (token) {
+      options.header.Authorization = `Bearer ${token}`
+    }
+    return options
+  },
+}
+
+export const requestInterceptor = {
+  install() {
+    // 拦截 request 请求
+    uni.addInterceptor('request', httpInterceptor)
+    // 拦截 uploadFile 文件上传
+    uni.addInterceptor('uploadFile', httpInterceptor)
+  },
+}

src/http/tools/enum.ts

@@ -0,0 +1,68 @@
+export enum ResultEnum {
+  // 0和200当做成功都很普遍，这里直接兼容两者（PS：0和200通常都不会当做错误码，但是有的接口会返回0，有的接口会返回200）
+  Success0 = 0, // 成功
+  Success200 = 200, // 成功
+  Error = 400, // 错误
+  Unauthorized = 401, // 未授权
+  Forbidden = 403, // 禁止访问（原为forbidden）
+  NotFound = 404, // 未找到（原为notFound）
+  MethodNotAllowed = 405, // 方法不允许（原为methodNotAllowed）
+  RequestTimeout = 408, // 请求超时（原为requestTimeout）
+  InternalServerError = 500, // 服务器错误（原为internalServerError）
+  NotImplemented = 501, // 未实现（原为notImplemented）
+  BadGateway = 502, // 网关错误（原为badGateway）
+  ServiceUnavailable = 503, // 服务不可用（原为serviceUnavailable）
+  GatewayTimeout = 504, // 网关超时（原为gatewayTimeout）
+  HttpVersionNotSupported = 505, // HTTP版本不支持（原为httpVersionNotSupported）
+}
+export enum ContentTypeEnum {
+  JSON = 'application/json;charset=UTF-8',
+  FORM_URLENCODED = 'application/x-www-form-urlencoded;charset=UTF-8',
+  FORM_DATA = 'multipart/form-data;charset=UTF-8',
+}
+/**
+ * 根据状态码，生成对应的错误信息
+ * @param {number|string} status 状态码
+ * @returns {string} 错误信息
+ */
+export function ShowMessage(status: number | string): string {
+  let message: string
+  switch (status) {
+    case 400:
+      message = '请求错误(400)'
+      break
+    case 401:
+      message = '未授权，请重新登录(401)'
+      break
+    case 403:
+      message = '拒绝访问(403)'
+      break
+    case 404:
+      message = '请求出错(404)'
+      break
+    case 408:
+      message = '请求超时(408)'
+      break
+    case 500:
+      message = '服务器错误(500)'
+      break
+    case 501:
+      message = '服务未实现(501)'
+      break
+    case 502:
+      message = '网络错误(502)'
+      break
+    case 503:
+      message = '服务不可用(503)'
+      break
+    case 504:
+      message = '网络超时(504)'
+      break
+    case 505:
+      message = 'HTTP版本不受支持(505)'
+      break
+    default:
+      message = `连接出错(${status})!`
+  }
+  return `${message}，请检查网络或联系管理员！`
+}

src/http/tools/queryString.ts

@@ -0,0 +1,29 @@
+/**
+ * 将对象序列化为URL查询字符串，用于替代第三方的 qs 库，节省宝贵的体积
+ * 支持基本类型值和数组，不支持嵌套对象
+ * @param obj 要序列化的对象
+ * @returns 序列化后的查询字符串
+ */
+export function stringifyQuery(obj: Record<string, any>): string {
+  if (!obj || typeof obj !== 'object' || Array.isArray(obj))
+    return ''
+
+  return Object.entries(obj)
+    .filter(([_, value]) => value !== undefined && value !== null)
+    .map(([key, value]) => {
+      // 对键进行编码
+      const encodedKey = encodeURIComponent(key)
+
+      // 处理数组类型
+      if (Array.isArray(value)) {
+        return value
+          .filter(item => item !== undefined && item !== null)
+          .map(item => `${encodedKey}=${encodeURIComponent(item)}`)
+          .join('&')
+      }
+
+      // 处理基本类型
+      return `${encodedKey}=${encodeURIComponent(value)}`
+    })
+    .join('&')
+}

src/http/types.ts

@@ -0,0 +1,44 @@
+/**
+ * 在 uniapp 的 RequestOptions 和 IUniUploadFileOptions 基础上，添加自定义参数
+ */
+export type CustomRequestOptions = UniApp.RequestOptions & {
+  query?: Record<string, any>
+  /** 出错时是否隐藏错误提示 */
+  hideErrorToast?: boolean
+} & IUniUploadFileOptions // 添加uni.uploadFile参数类型
+
+/** 主要提供给 openapi-ts-request 生成的代码使用 */
+export type CustomRequestOptions_ = Omit<CustomRequestOptions, 'url'>
+
+export interface HttpRequestResult<T> {
+  promise: Promise<T>
+  requestTask: UniApp.RequestTask
+}
+
+// 通用响应格式（兼容 msg + message 字段）
+export type IResponse<T = any> = {
+  code: number
+  data: T
+  message: string
+  [key: string]: any // 允许额外属性
+} | {
+  code: number
+  data: T
+  msg: string
+  [key: string]: any // 允许额外属性
+}
+
+// 分页请求参数
+export interface PageParams {
+  page: number
+  pageSize: number
+  [key: string]: any
+}
+
+// 分页响应数据
+export interface PageResult<T> {
+  list: T[]
+  total: number
+  page: number
+  pageSize: number
+}

src/http/vue-query.ts

@@ -0,0 +1,30 @@
+import type { CustomRequestOptions } from '@/http/types'
+import { http } from './http'
+
+/*
+ * openapi-ts-request 工具的 request 跨客户端适配方法
+ */
+export default function request<T = unknown>(
+  url: string,
+  options: Omit<CustomRequestOptions, 'url'> & {
+    params?: Record<string, unknown>
+    headers?: Record<string, unknown>
+  },
+) {
+  const requestOptions = {
+    url,
+    ...options,
+  }
+
+  if (options.params) {
+    requestOptions.query = requestOptions.params
+    delete requestOptions.params
+  }
+
+  if (options.headers) {
+    requestOptions.header = options.headers
+    delete requestOptions.headers
+  }
+
+  return http<T>(requestOptions)
+}

src/layouts/default.vue

@@ -0,0 +1,15 @@
+<script lang="ts" setup>
+import { getI18nText } from '@/tabbar/i18n'
+import { getCurrentPageI18nKey } from '@/utils'
+
+onShow(() => {
+  console.log('layout default - onShow')
+  uni.setNavigationBarTitle({
+    title: getI18nText(getCurrentPageI18nKey()),
+  })
+})
+</script>
+
+<template>
+  <slot />
+</template>

src/locale/README.md

@@ -0,0 +1,12 @@
+# 注意事项
+
+> 文件夹名字必须为 `locale`, 这是 `uniapp` 官方约定的，如果改为别的，标题将不能正常切换多语言（其他内容还是正常）。
+>
+> `xxx.json` 的 `xxx` 多语言标识必须与 `uniapp` 官方约定的一致，否则也会出现 BUG。
+>
+> 查看截图 `screenshots/i18n.png`。
+
+## 参考文档
+
+[uniapp 国际化开发指南](https://uniapp.dcloud.net.cn/tutorial/i18n.html)
+[uniapp 国际化-注意事项](https://uniapp.dcloud.net.cn/api/ui/locale.html#onlocalechange) 最下面的注意事项

src/locale/en.json

@@ -0,0 +1,10 @@
+{
+  "tabbar.home": "Home",
+  "tabbar.about": "About",
+  "tabbar.me": "Me",
+  "i18n.title": "En Title",
+  "alova.title": "Alova Request",
+  "weight": "{heavy}KG",
+  "detail": "{0}cm, {1}KG",
+  "introduction": "I am {name},height:{detail.height},weight:{detail.weight}"
+}

src/locale/index.ts

@@ -0,0 +1,87 @@
+import { createI18n } from 'vue-i18n'
+
+import en from './en.json'
+import zhHans from './zh-Hans.json' // 简体中文
+
+const messages = {
+  en,
+  'zh-Hans': zhHans, // key 不能乱写，查看截图 screenshots/i18n.png
+}
+
+const i18n = createI18n({
+  locale: uni.getLocale(), // 获取已设置的语言，fallback 语言需要再 manifest.config.ts 中设置
+  messages,
+  allowComposition: true,
+})
+
+console.log(uni.getLocale())
+console.log(i18n.global.locale)
+
+/**
+ * 可以拿到原始的语言模板，非 vue 文件使用这个方法，
+ * @param { string } key 多语言的key，eg: "app.name"
+ * @returns {string} 返回原始的多语言模板，eg: "{heavy}KG"
+ */
+export function getTemplateByKey(key: string) {
+  if (!key) {
+    console.error(`[i18n] Function getTemplateByKey(), key param is required`)
+    return ''
+  }
+  const locale = uni.getLocale()
+  console.log('locale:', locale)
+
+  const message = messages[locale] // 拿到某个多语言的所有模板（是一个对象)
+  if (Object.keys(message).includes(key)) {
+    return message[key]
+  }
+
+  try {
+    const keyList = key.split('.')
+    let result = keyList.reduce((pre, cur) => {
+      return pre && typeof pre === 'object' ? pre[cur] : undefined
+    }, message)
+    // 确保返回的是字符串类型
+    return typeof result === 'string' ? result : ''
+  }
+  catch (error) {
+    console.error(`[i18n] Function getTemplateByKey(), key param ${key} is not existed.`)
+    return ''
+  }
+}
+
+/**
+ * formatI18n('我是{name},身高{detail.height},体重{detail.weight}',{name:'张三',detail:{height:178,weight:'75kg'}})
+ * 暂不支持数组
+ * @param template 多语言模板字符串，eg: `我是{name}`
+ * @param {object | undefined} data 需要传递的数据对象，里面的key与多语言字符串对应，eg: `{name:'菲鸽'}`
+ * @returns
+ */
+function formatI18n(template: string, data?: any) {
+  // 添加template有效性检查，避免在undefined上调用replace方法
+  if (!template || typeof template !== 'string') {
+    return template || ''
+  }
+  return template.replace(/\{([^}]+)\}/g, (match, key: string) => {
+    // console.log( match, key) // => { detail.height }  detail.height
+    const arr = key.trim().split('.')
+    let result = data
+    while (arr.length) {
+      const first = arr.shift()
+      result = result[first]
+    }
+    return result
+  })
+}
+
+/**
+ * t('introduction',{name:'张三',detail:{height:178,weight:'75kg'}})
+ * => formatI18n('我是{name},身高{detail.height},体重{detail.weight}',{name:'张三',detail:{height:178,weight:'75kg'}})
+ * 没有key的，可以不传 data；暂不支持数组
+ * @param template 多语言模板字符串，eg: `我是{name}`
+ * @param {object | undefined} data 需要传递的数据对象，里面的key与多语言字符串对应，eg: `{name:'菲鸽'}`
+ * @returns
+ */
+export function t(key, data?) {
+  return formatI18n(getTemplateByKey(key), data)
+}
+export default i18n

src/locale/zh-Hans.json

@@ -0,0 +1,10 @@
+{
+  "tabbar.home": "首页",
+  "tabbar.about": "关于",
+  "tabbar.me": "我的",
+  "i18n.title": "中文标题",
+  "alova.title": "Alova 请求",
+  "weight": "{heavy}公斤",
+  "detail": "{0}cm, {1}公斤",
+  "introduction": "我是 {name},身高:{detail.height},体重:{detail.weight}"
+}

src/main.ts

@@ -0,0 +1,21 @@
+import { createSSRApp } from 'vue'
+import App from './App.vue'
+import { requestInterceptor } from './http/interceptor'
+import i18n from './locale/index'
+import { routeInterceptor } from './router/interceptor'
+
+import store from './store'
+import '@/style/index.scss'
+import 'virtual:uno.css'
+
+export function createApp() {
+  const app = createSSRApp(App)
+  app.use(store)
+  app.use(i18n)
+  app.use(routeInterceptor)
+  app.use(requestInterceptor)
+
+  return {
+    app,
+  }
+}

src/pages-fg/404/README.md

@@ -0,0 +1,3 @@
+# 404 页面
+
+`404页面` 只有在路由不存在时才会显示，如果您不需要可以删除该页面。但是建议保留。

src/pages-fg/404/index.vue

@@ -0,0 +1,30 @@
+<script lang="ts" setup>
+import { HOME_PAGE } from '@/utils'
+
+definePage({
+  style: {
+    // 'custom' 表示开启自定义导航栏，默认 'default'
+    navigationStyle: 'custom',
+  },
+})
+
+function goBack() {
+  // 当pages.config.ts中配置了tabbar页面时，使用switchTab切换到首页
+  // 否则使用navigateTo返回首页
+  uni.switchTab({ url: HOME_PAGE })
+}
+</script>
+
+<template>
+  <view class="h-screen flex flex-col items-center justify-center">
+    <view> 404 </view>
+    <view> 页面不存在 </view>
+    <button class="mt-6 w-40 text-center" @click="goBack">
+      返回首页
+    </button>
+  </view>
+</template>
+
+<style lang="scss" scoped>
+//
+</style>

src/pages-fg/REAME.md

@@ -0,0 +1,3 @@
+# pages-fg 说明
+
+为了尽量减少主包的大小，一些无关紧要但经常需要的页面（如登录页、注册页、404页等）放在了 `pages-fg` 目录下。

src/pages-fg/login/README.md

@@ -0,0 +1,20 @@
+# 登录页
+需要输入账号、密码/验证码的登录页。
+
+## 适用性
+
+本页面主要用于 `h5` 和 `APP`。
+
+小程序通常有平台的登录方式 `uni.login` 通常用不到登录页，所以不适用于 `小程序`。（即默认情况下，小程序环境是不会走登录拦截逻辑的。）
+
+但是如果您的小程序也需要现实的 `登录页` 那也是可以使用的。
+
+在 `src/router/config.ts` 中有一个变量 `LOGIN_PAGE_ENABLE_IN_MP` 来控制是否在小程序中使用 `H5的登录页`。
+
+更多信息请看 `src/router` 文件夹的内容。
+
+## 登录跳转
+
+目前登录的跳转逻辑主要在 `src/router/interceptor.ts` 和 `src/pages/login/login.vue` 里面，默认会在登录后自动重定向到来源/配置的页面。
+
+如果与您的业务不符，您可以自行修改。

src/pages-fg/login/login.vue

@@ -0,0 +1,371 @@
+<script lang="ts" setup>
+import type { ILoginForm } from '@/api/login'
+import type { ICaptcha } from '@/api/types/login'
+import { computed, onMounted, ref } from 'vue'
+import { getCaptcha } from '@/api/login'
+import { useAuthStore } from '@/store/auth'
+
+definePage({
+  style: {
+    navigationBarTitleText: '登录',
+  },
+})
+
+const authStore = useAuthStore()
+
+// 验证码响应实体类
+const captchaInfo = ref<ICaptcha>({
+  captchaEnabled: false,
+  img: '',
+  uuid: '',
+})
+
+// 登录表单数据
+const loginForm = ref<ILoginForm>({
+  username: '',
+  password: '',
+  code: '',
+  uuid: '',
+})
+
+// 验证码相关数据
+const captchaData = ref({
+  code: '',
+  uuid: '',
+})
+
+// 重定向地址
+const redirectUrl = ref('')
+
+// 表单验证规则
+const formRules = computed(() => ({
+  username: {
+    required: true,
+    message: '请输入用户名',
+    trigger: 'blur',
+  },
+  password: {
+    required: true,
+    message: '请输入密码',
+    trigger: 'blur',
+  },
+  code: {
+    required: captchaInfo.value.captchaEnabled,
+    message: '请输入验证码',
+    trigger: 'blur',
+  },
+}))
+
+// 获取验证码接口
+async function loadCaptcha() {
+  try {
+    const resp = await getCaptcha()
+    console.log('获取验证码响应:', resp)
+    if (resp.captchaEnabled && resp.img) {
+      resp.img = `data:image/png;base64,${resp.img}`
+    }
+    captchaInfo.value = resp
+    loginForm.value.uuid = resp.uuid || ''
+  }
+  catch (error) {
+    console.error('获取验证码失败:', error)
+    uni.showToast({
+      title: '获取验证码失败',
+      icon: 'error',
+    })
+  }
+}
+
+// uni-app页面生命周期钩子
+onLoad((options) => {
+  // 获取重定向地址
+  if (options?.redirect) {
+    redirectUrl.value = decodeURIComponent(options.redirect)
+  }
+})
+
+onMounted(async () => {
+  await loadCaptcha()
+})
+
+// 处理登录
+async function handleLogin() {
+  try {
+    // 构建登录参数
+    const requestParam: ILoginForm = {
+      username: loginForm.value.username,
+      password: loginForm.value.password,
+      code: '',
+      uuid: '',
+    }
+
+    // 如果需要验证码，添加验证码参数
+    if (captchaInfo.value.captchaEnabled) {
+      requestParam.code = loginForm.value.code
+      requestParam.uuid = loginForm.value.uuid
+    }
+
+    // 调用登录接口
+    await authStore.authLogin(requestParam)
+
+    uni.showToast({
+      title: '登录成功',
+      icon: 'success',
+    })
+
+    // 登录成功后跳转
+    setTimeout(() => {
+      if (redirectUrl.value) {
+        // 如果有重定向地址，跳转到指定页面
+        if (redirectUrl.value.startsWith('/pages/')) {
+          // 检查是否为tabbar页面
+          if (redirectUrl.value === '/pages/index/index' || redirectUrl.value === '/pages/me/me') {
+            uni.switchTab({
+              url: redirectUrl.value,
+            })
+          }
+          else {
+            uni.redirectTo({
+              url: redirectUrl.value,
+            })
+          }
+        }
+        else {
+          uni.redirectTo({
+            url: redirectUrl.value,
+          })
+        }
+      }
+      else {
+        // 没有重定向地址，跳转到首页
+        uni.switchTab({
+          url: '/pages/index/index',
+        })
+      }
+    }, 1500)
+  }
+  catch (error) {
+    console.error('登录失败:', error)
+    uni.showToast({
+      title: '登录失败，请检查用户名密码',
+      icon: 'error',
+    })
+    // 处理验证码错误，刷新验证码
+    if (captchaInfo.value.captchaEnabled) {
+      await loadCaptcha()
+      loginForm.value.code = ''
+    }
+  }
+}
+
+// 表单提交
+function onSubmit() {
+  handleLogin()
+}
+
+// 刷新验证码
+function refreshCaptcha() {
+  loadCaptcha()
+}
+
+// 表单验证
+const formRef = ref()
+
+function validateForm() {
+  formRef.value?.validate().then(() => {
+    onSubmit()
+  }).catch(() => {
+    uni.showToast({
+      title: '请检查表单输入',
+      icon: 'error',
+    })
+  })
+}
+</script>
+
+<template>
+  <view class="login-container">
+    <!-- 登录头部 -->
+    <view class="login-header">
+      <view class="logo-container">
+        <image src="/static/logo.svg" class="logo" mode="aspectFit" />
+      </view>
+      <text class="login-title">用户登录</text>
+    </view>
+
+    <!-- 登录表单 -->
+    <view class="login-form">
+      <wd-form ref="formRef" :model="loginForm" :rules="formRules">
+        <!-- 用户名输入 -->
+        <wd-form-item prop="username" label="用户名" required>
+          <wd-input v-model="loginForm.username" placeholder="请输入用户名" clearable :show-clear="true" />
+        </wd-form-item>
+
+        <!-- 密码输入 -->
+        <wd-form-item prop="password" label="密码" required>
+          <wd-input v-model="loginForm.password" type="password" placeholder="请输入密码" clearable :show-clear="true" :show-password="true" />
+        </wd-form-item>
+
+        <!-- 验证码输入 -->
+        <wd-form-item v-if="captchaInfo && captchaInfo.captchaEnabled" prop="code" label="验证码" required>
+          <view class="captcha-container">
+            <wd-input v-model="loginForm.code" placeholder="请输入验证码" clearable :show-clear="true" class="captcha-input" />
+            <view class="captcha-image-wrapper" @click="refreshCaptcha">
+              <image v-if="captchaInfo && captchaInfo.img" :src="captchaInfo.img" class="captcha-image" mode="aspectFit" />
+              <text v-else class="captcha-placeholder">点击获取</text>
+            </view>
+          </view>
+        </wd-form-item>
+      </wd-form>
+
+      <!-- 登录按钮 -->
+      <view class="login-actions">
+        <wd-button type="primary" block round :loading="authStore.loginLoading" @click="validateForm">
+          {{ authStore.loginLoading ? '登录中...' : '登录' }}
+        </wd-button>
+      </view>
+    </view>
+  </view>
+</template>
+
+<style lang="scss" scoped>
+.login-container {
+  min-height: 100vh;
+  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  padding: 0 32rpx;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+}
+
+.login-header {
+  text-align: center;
+  margin-bottom: 80rpx;
+
+  .logo-container {
+    margin-bottom: 40rpx;
+
+    .logo {
+      width: 120rpx;
+      height: 120rpx;
+    }
+  }
+
+  .login-title {
+    display: block;
+    font-size: 48rpx;
+    font-weight: bold;
+    color: white;
+    margin-bottom: 16rpx;
+  }
+
+  .login-subtitle {
+    display: block;
+    font-size: 28rpx;
+    color: rgba(255, 255, 255, 0.8);
+  }
+}
+
+.login-form {
+  background: white;
+  border-radius: 24rpx;
+  padding: 48rpx 32rpx;
+  box-shadow: 0 8rpx 32rpx rgba(0, 0, 0, 0.1);
+
+  .test-section {
+    margin-bottom: 32rpx;
+    padding: 16rpx;
+    background: #f0f8ff;
+    border-radius: 8rpx;
+
+    text {
+      display: block;
+      margin-bottom: 16rpx;
+      font-size: 28rpx;
+      color: #333;
+    }
+  }
+
+  :deep(.wd-form-item) {
+    margin-bottom: 32rpx;
+  }
+
+  :deep(.wd-form-item__label) {
+    font-weight: 500;
+    color: #333;
+  }
+
+  :deep(.wd-input) {
+    height: 88rpx;
+    border-radius: 12rpx;
+    background: #f8f9fa;
+  }
+
+  .captcha-container {
+    display: flex;
+    align-items: center;
+    gap: 16rpx;
+
+    .captcha-input {
+      flex: 1;
+    }
+
+    .captcha-image-wrapper {
+      width: 160rpx;
+      height: 88rpx;
+      border-radius: 12rpx;
+      background: #f8f9fa;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      border: 2rpx solid #e9ecef;
+      cursor: pointer;
+      transition: all 0.3s ease;
+
+      &:active {
+        transform: scale(0.95);
+        background: #e9ecef;
+      }
+
+      .captcha-image {
+        width: 100%;
+        height: 100%;
+        border-radius: 8rpx;
+      }
+
+      .captcha-placeholder {
+        font-size: 24rpx;
+        color: #999;
+      }
+    }
+  }
+
+  .login-actions {
+    margin: 48rpx 0 32rpx;
+
+    :deep(.wd-button) {
+      height: 96rpx;
+      font-size: 32rpx;
+      font-weight: 600;
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      border: none;
+    }
+  }
+
+  .login-footer {
+    text-align: center;
+
+    .footer-text {
+      font-size: 28rpx;
+      color: #666;
+    }
+
+    .register-link {
+      font-size: 28rpx;
+      color: #667eea;
+      font-weight: 500;
+      margin-left: 8rpx;
+    }
+  }
+}
+</style>

src/pages-fg/login/register.vue

@@ -0,0 +1,34 @@
+<script lang="ts" setup>
+import { LOGIN_PAGE } from '@/router/config'
+
+definePage({
+  style: {
+    navigationBarTitleText: '注册',
+  },
+})
+
+function doRegister() {
+  uni.showToast({
+    title: '注册成功',
+  })
+  // 注册成功后跳转到登录页
+  uni.navigateTo({
+    url: LOGIN_PAGE,
+  })
+}
+</script>
+
+<template>
+  <view class="login">
+    <view class="text-center">
+      注册页
+    </view>
+    <button class="mt-4 w-40 text-center" @click="doRegister">
+      点击模拟注册
+    </button>
+  </view>
+</template>
+
+<style lang="scss" scoped>
+//
+</style>

src/pages/index/index.vue

@@ -0,0 +1,166 @@
+<script lang="ts" setup>
+import { onMounted, ref } from 'vue'
+import { http } from '@/http/http'
+import { toLoginPage } from '@/utils/toLoginPage'
+
+defineOptions({
+  name: 'Home',
+})
+definePage({
+  // 使用 type: "home" 属性设置首页，其他页面不需要设置，默认为page
+  type: 'home',
+  style: {
+    // 'custom' 表示开启自定义导航栏，默认 'default'
+    navigationStyle: 'custom',
+    navigationBarTitleText: '%tabbar.home%',
+  },
+})
+
+// 菜单项接口定义
+interface MenuItem {
+  /** 菜单ID */
+  id: string
+  /** 菜单名称 */
+  name: string
+  /** 图标 */
+  icon?: string
+  /** 链接地址 */
+  url?: string
+  /** 子菜单 */
+  children?: MenuItem[]
+  /** 图标颜色 */
+  iconColor?: string
+}
+
+// 菜单数据
+const menuData = ref<MenuItem[]>([])
+const loading = ref(false)
+const error = ref('')
+
+// Mock数据 - 由于接口可能调不通，使用模拟数据
+const mockMenuData: MenuItem[] = []
+
+// 获取菜单数据
+async function fetchMenuData() {
+  loading.value = true
+  error.value = ''
+  try {
+    // 尝试调用真实接口
+    const response = await http<MenuItem[]>({
+      url: '/getRouters',
+      method: 'GET',
+    })
+    menuData.value = response.data
+    console.log('菜单数据:', response)
+  }
+  catch (err) {
+    console.error('获取菜单失败:', err)
+    // 接口调用失败时使用mock数据
+    // menuData.value = mockMenuData
+    // 如果是token失效错误，会被http拦截器自动处理跳转到登录页
+    if (err.data.msg.includes('认证失败')) {
+      toLoginPage()
+    }
+  }
+  finally {
+    loading.value = false
+  }
+}
+
+// 处理菜单项点击
+function handleMenuItemClick(menu: MenuItem) {
+  if (menu.children && menu.children.length > 0) {
+    // 有子菜单的父菜单不跳转
+    return
+  }
+  // 根据菜单ID执行相应操作
+  if (menu.url) {
+    uni.navigateTo({
+      url: menu.url,
+    })
+  }
+  else {
+    uni.showToast({
+      title: `点击了${menu.meta?.title || menu.name}`,
+      icon: 'none',
+    })
+  }
+}
+onMounted(async () => {
+  // fetchMenuData()
+})
+onLoad(async () => {
+  fetchMenuData()
+})
+
+</script>
+
+<template>
+  <view class="min-h-screen bg-gray-100">
+    <!-- 菜单内容 -->
+    <view class="p-2">
+      <block v-if="loading">
+        <view class="text-center p-16">
+          <wd-loading size="large" type="ring"></wd-loading>
+          <text class="text-gray-500 text-sm mt-4 inline-block">加载中...</text>
+        </view>
+      </block>
+      <block v-else-if="error">
+        <view class="text-center p-16">
+          <wd-icon name="info-circle" size="60" color="#909399"></wd-icon>
+          <text class="text-gray-500 text-sm mt-4 inline-block">{{ error }}</text>
+        </view>
+      </block>
+      <block v-else>
+        <wd-card 
+          v-for="group in menuData" 
+          :key="group.id"
+          class="mb-3"
+          :title="group.meta?.title || group.name"
+          :border="true"
+          :shadow="false"
+        >
+          <wd-grid :column="4" :gutter="10">
+            <wd-grid-item 
+              v-for="item in group.children" 
+              :key="item.id"
+              @click="handleMenuItemClick(item)"
+              class="menu-item"
+            >
+              <wd-card 
+                size="small" 
+                :border="false"
+                class="menu-card"
+                :style="{ backgroundColor: (item.iconColor || '#4CAF50') + '20' }"
+              >
+                <wd-icon :name="item.meta?.icon || item.icon" color="#0083ff" size="30" />
+              </wd-card>
+              <text class="text-xs text-center mt-1">{{ item.meta?.title || item.name }}</text>
+            </wd-grid-item>
+          </wd-grid>
+        </wd-card>
+      </block>
+    </view>
+    <tabbar />
+  </view>
+</template>
+
+<style scoped>
+.menu-item {
+  padding: 10rpx 0;
+}
+
+.menu-card {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100rpx;
+  border-radius: 16rpx !important;
+  padding: 0;
+  margin: 0 8px;
+}
+/* 修复wot ui组件样式 */
+:deep(.wd-grid-item__content) {
+  padding: 0;
+}
+</style>

src/pages/me/me.vue

@@ -0,0 +1,275 @@
+<script lang="ts" setup>
+import { storeToRefs } from 'pinia'
+import { ref } from 'vue'
+import { LOGIN_PAGE } from '@/router/config'
+import { useUserStore } from '@/store'
+import { useTokenStore } from '@/store/token'
+
+
+definePage({
+  style: {
+    navigationBarTitleText: '我的',
+    tabBarHidden: true, // 隐藏底部的tabBar
+  },
+})
+
+const userStore = useUserStore()
+const tokenStore = useTokenStore()
+// 使用storeToRefs解构userInfo
+const { userInfo } = storeToRefs(userStore)
+console.log(userInfo.value)
+// 功能列表数据
+const featureList = [
+  // { name: '365会员', icon: 'vip', badge: '双11特价1元' },
+  // { name: '钉瓜瓜', icon: 'message', dot: true },
+  // { name: '钱包（支付宝）', icon: 'wallet' },
+  // { name: '权益', icon: 'gift', badge: '26积分待领取' },
+  // { name: '动态', icon: 'data-board' },
+  // { name: '收藏', icon: 'star' },
+  // { name: '客服与帮助', icon: 'customer-service' },
+  { name: '隐私', icon: 'setting' },
+]
+
+// 将图标名称转换为文本
+function getIconText(iconName: string): string {
+  const iconMap: Record<string, string> = {
+    'vip': '会员',
+    'message': '瓜',
+    'wallet': '钱',
+    'gift': '权',
+    'data-board': '动',
+    'star': '收',
+    'customer-service': '客',
+    'setting': '设'
+  }
+  return iconMap[iconName] || iconName.charAt(0)
+}
+// 处理功能项点击
+function handleFeature(featureName: string) {
+  uni.showToast({
+    title: `点击了${featureName}`,
+    icon: 'none'
+  })
+}
+
+// 微信小程序下登录
+async function handleLogin() {
+  /* #ifdef MP-WEIXIN */
+  // 微信登录
+  await tokenStore.wxLogin()
+
+  /* #endif */
+  /* #ifndef MP-WEIXIN */
+  uni.navigateTo({
+    url: `${LOGIN_PAGE}`,
+  })
+  /* #endif */
+}
+
+async function handleLogout() {
+  uni.showModal({
+    title: '提示',
+    content: '确定要退出登录吗？',
+    success: async (res) => {
+      if (res.confirm) {
+        // 清空用户信息，等待logout执行完毕
+        await useTokenStore().logout()
+        // 执行退出登录逻辑
+        uni.showToast({
+          title: '退出登录成功',
+          icon: 'success',
+        })
+        // 使用reLaunch清除所有页面栈并跳转到登录页
+        uni.reLaunch({
+          url: LOGIN_PAGE
+        })
+      }
+    },
+  })
+}
+</script>
+
+<template>
+  <view class="profile-container">
+    <!-- 头部信息区域 -->
+    <view class="header-section bg-white p-4">
+      <view class="user-info-flex">
+        <!-- 左侧名字四方框 -->
+        <view class="avatar-container">
+          <text class="avatar-text">{{ userInfo.nickname ? userInfo.nickname.charAt(0) : '游' }}</text>
+        </view>
+        <!-- 右侧人员信息 -->
+        <view class="user-details">
+          <view class="username">{{ userInfo.nickname || '游客' }}</view>
+          <view class="user-meta">
+            <text class="user-role">{{ userInfo.username || '普通用户' }}</text>
+          </view>
+        </view>
+      </view>
+    </view>
+
+    <!-- 功能列表 -->
+    <view class="feature-list mt-4 bg-white">
+      <view v-for="(item, index) in featureList" :key="index" class="feature-item" @click="handleFeature(item.name)">
+        <view class="feature-left">
+          <text class="feature-icon">{{ getIconText(item.icon) }}</text>
+          <text class="feature-name">{{ item.name }}</text>
+        </view>
+        <view class="feature-right">
+          <text v-if="item.badge" class="feature-badge">{{ item.badge }}</text>
+          <text v-if="item.dot" class="notification-dot"></text>
+          <text class="arrow">></text>
+        </view>
+      </view>
+    </view>
+    <!-- 退出登录按钮 -->
+    <view class="logout-section px-4 mb-8">
+      <button v-if="tokenStore.hasLogin" type="primary" class="w-full" @click="handleLogout">
+        退出登录
+      </button>
+      <button v-else type="primary" class="w-full" @click="handleLogin">
+        登录
+      </button>
+    </view>
+  </view>
+</template>
+
+<style scoped>
+.profile-container {
+  background-color: #f5f5f5;
+  min-height: 100vh;
+}
+
+.header-section {
+  background-color: white;
+  padding: 16px;
+}
+
+.user-info-flex {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+
+.avatar-container {
+  width: 60px;
+  height: 60px;
+  background-color: #1677ff;
+  border-radius: 4px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: white;
+}
+
+.avatar-text {
+  font-size: 24px;
+  font-weight: 500;
+}
+
+.user-details {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.username {
+  font-size: 18px;
+  font-weight: 500;
+  color: #333;
+}
+
+.user-meta {
+  display: flex;
+  gap: 8px;
+}
+
+.user-role {
+  font-size: 14px;
+  color: #666;
+}
+
+.feature-list {
+  margin-top: 16px;
+  background-color: white;
+}
+
+.feature-item {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 16px;
+  border-bottom: 1px solid #f0f0f0;
+}
+
+.feature-item:last-child {
+  border-bottom: none;
+}
+
+.feature-left {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+
+.feature-icon {
+  width: 24px;
+  height: 24px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background-color: #f0f9ff;
+  color: #1677ff;
+  border-radius: 4px;
+  font-size: 14px;
+  font-weight: 500;
+}
+
+.feature-name {
+  font-size: 16px;
+  color: #333;
+}
+
+.feature-right {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.feature-badge {
+  font-size: 12px;
+  color: #ff4d4f;
+  background-color: #fff1f0;
+  padding: 2px 6px;
+  border-radius: 10px;
+}
+
+.notification-dot {
+  width: 8px;
+  height: 8px;
+  background-color: #ff4d4f;
+  border-radius: 50%;
+}
+
+.arrow {
+  font-size: 14px;
+  color: #c0c4cc;
+}
+
+.version-info {
+  margin-top: 32px;
+  margin-bottom: 24px;
+  text-align: center;
+  font-size: 14px;
+  color: #909399;
+}
+
+.logout-section {
+  padding: 16px;
+  margin-bottom: 32px;
+}
+
+button {
+  width: 100%;
+}
+</style>

src/router/README.md

@@ -0,0 +1,55 @@
+# 登录 说明
+
+## 登录 2种策略
+- 默认无需登录策略： DEFAULT_NO_NEED_LOGIN
+- 默认需要登录策略： DEFAULT_NEED_LOGIN
+
+### 默认无需登录策略： DEFAULT_NO_NEED_LOGIN
+进入任何页面都不需要登录，只有进入到黑名单中的页面/或者页面中某些动作需要登录，才需要登录。
+
+比如大部分2C的应用，美团、今日头条、抖音等，都可以直接浏览，只有点赞、评论、分享等操作或者去特殊页面（比如个人中心），才需要登录。
+
+### 默认需要登录策略： DEFAULT_NEED_LOGIN
+
+进入任何页面都需要登录，只有进入到白名单中的页面，才不需要登录。默认进入应用需要先去登录页。
+
+比如大部分2B和后台管理类的应用，比如企业微信、钉钉、飞书、内部报表系统、CMS系统等，都需要登录，只有登录后，才能使用。
+
+### EXCLUDE_LOGIN_PATH_LIST
+`EXCLUDE_LOGIN_PATH_LIST` 表示排除的路由列表。
+
+在 `默认无需登录策略： DEFAULT_NO_NEED_LOGIN` 中，只有路由在 `EXCLUDE_LOGIN_PATH_LIST` 中，才需要登录，相当于黑名单。
+
+在 `默认需要登录策略： DEFAULT_NEED_LOGIN` 中，只有路由在 `EXCLUDE_LOGIN_PATH_LIST` 中，才不需要登录，相当于白名单。
+
+### excludeLoginPath
+definePage 中可以通过 `excludeLoginPath` 来配置路由是否需要登录。(类似过去的 needLogin 的功能)
+
+```ts
+definePage({
+  style: {
+    navigationBarTitleText: '关于',
+  },
+  // 登录授权(可选)：跟以前的 needLogin 类似功能，但是同时支持黑白名单，详情请见 src/router 文件夹
+  excludeLoginPath: true,
+  // 角色授权(可选)：如果需要根据角色授权，就配置这个
+  roleAuth: {
+    field: 'role',
+    value: 'admin',
+    redirect: '/pages/auth/403',
+  },
+})
+```
+
+## 登录注册页路由
+
+登录页 `login.vue` 对应路由是 `/pages/login/login`.
+注册页 `register.vue` 对应路由是 `/pages/login/register`.
+
+## 登录注册页适用性
+
+登录注册页主要适用于 `h5` 和 `App`，默认不适用于 `小程序`，因为 `小程序` 通常会使用平台提供的快捷登录。
+
+特殊情况例外，如业务需要跨平台复用登录注册页时，也可以用在 `小程序` 上，所以主要还是看业务需求。
+
+通过一个参数 `LOGIN_PAGE_ENABLE_IN_MP` 来控制是否在 `小程序` 中使用 `H5登录页` 的登录逻辑。

src/router/config.ts

@@ -0,0 +1,31 @@
+import { getAllPages } from '@/utils'
+
+export const LOGIN_STRATEGY_MAP = {
+  DEFAULT_NO_NEED_LOGIN: 0, // 黑名单策略，默认可以进入APP
+  DEFAULT_NEED_LOGIN: 1, // 白名单策略，默认不可以进入APP，需要强制登录
+}
+// TODO: 1/3 登录策略，默认使用`无需登录策略`，即默认不需要登录就可以访问
+export const LOGIN_STRATEGY = LOGIN_STRATEGY_MAP.DEFAULT_NO_NEED_LOGIN
+export const isNeedLoginMode = LOGIN_STRATEGY === LOGIN_STRATEGY_MAP.DEFAULT_NEED_LOGIN
+
+export const LOGIN_PAGE = '/pages-fg/login/login'
+export const REGISTER_PAGE = '/pages-fg/login/register'
+export const NOT_FOUND_PAGE = '/pages-fg/404/index'
+
+export const LOGIN_PAGE_LIST = [LOGIN_PAGE, REGISTER_PAGE]
+
+// 在 definePage 里面配置了 excludeLoginPath 的页面，功能与 EXCLUDE_LOGIN_PATH_LIST 相同
+export const excludeLoginPathList = getAllPages('excludeLoginPath').map(page => page.path)
+
+// 排除在外的列表，白名单策略指白名单列表，黑名单策略指黑名单列表
+// TODO: 2/3 在 definePage 配置 excludeLoginPath，或者在下面配置 EXCLUDE_LOGIN_PATH_LIST
+export const EXCLUDE_LOGIN_PATH_LIST = [
+  '/pages/xxx/index', // 示例值
+  '/pages-sub/xxx/index', // 示例值
+  ...excludeLoginPathList, // 都是以 / 开头的 path
+]
+
+// 在小程序里面是否使用H5的登录页，默认为 false
+// 如果为 true 则复用 h5 的登录逻辑
+// TODO: 3/3 确定自己的登录页是否需要在小程序里面使用
+export const LOGIN_PAGE_ENABLE_IN_MP = false

src/router/interceptor.ts

@@ -0,0 +1,170 @@
+import { isMp } from '@uni-helper/uni-env'
+/**
+ * by 菲鸽 on 2025-08-19
+ * 路由拦截，通常也是登录拦截
+ * 黑、白名单的配置，请看 config.ts 文件， EXCLUDE_LOGIN_PATH_LIST
+ */
+import { useTokenStore } from '@/store/token'
+import { isPageTabbar, tabbarStore } from '@/tabbar/store'
+import { getAllPages, getLastPage, HOME_PAGE, parseUrlToObj } from '@/utils/index'
+import { EXCLUDE_LOGIN_PATH_LIST, isNeedLoginMode, LOGIN_PAGE, LOGIN_PAGE_ENABLE_IN_MP, NOT_FOUND_PAGE } from './config'
+
+export const FG_LOG_ENABLE = false
+
+// 系统内部页面白名单（不需要检查路由存在性）
+const SYSTEM_INTERNAL_PATHS = [
+  '/__uniappchooselocation', // 选择位置页面
+  '/__uniapproute', // 路由页面
+  '/__uniappfilepicker', // 文件选择器
+  '/__uniappimagepicker', // 图片选择器
+]
+
+export function judgeIsExcludePath(path: string) {
+  const isDev = import.meta.env.DEV
+  if (!isDev) {
+    return EXCLUDE_LOGIN_PATH_LIST.includes(path)
+  }
+  const allExcludeLoginPages = getAllPages('excludeLoginPath') // dev 环境下，需要每次都重新获取，否则新配置就不会生效
+  return EXCLUDE_LOGIN_PATH_LIST.includes(path) || (isDev && allExcludeLoginPages.some(page => page.path === path))
+}
+
+// 检查是否为系统内部页面
+export function isSystemInternalPath(path: string): boolean {
+  return SYSTEM_INTERNAL_PATHS.includes(path)
+}
+
+// 检查路由是否存在
+export function isRouteExists(path: string): boolean {
+  // 系统内部页面始终认为存在
+  if (isSystemInternalPath(path)) {
+    return true
+  }
+
+  const allPages = getAllPages()
+  return allPages.some(page => page.path === path) || path === '/'
+}
+
+export const navigateToInterceptor = {
+  // 注意，这里的url是 '/' 开头的，如 '/pages/index/index'，跟 'pages.json' 里面的 path 不同
+  // 增加对相对路径的处理，BY 网友 @ideal
+  invoke({ url, query }: { url: string, query?: Record<string, string> }) {
+    if (url === undefined) {
+      return
+    }
+    let { path, query: _query } = parseUrlToObj(url)
+
+    FG_LOG_ENABLE && console.log('\n\n路由拦截器:-------------------------------------')
+    FG_LOG_ENABLE && console.log('路由拦截器 1: url->', url, ', query ->', query)
+    const myQuery = { ..._query, ...query }
+    // /pages/route-interceptor/index?name=feige&age=30
+    FG_LOG_ENABLE && console.log('路由拦截器 2: path->', path, ', _query ->', _query)
+    FG_LOG_ENABLE && console.log('路由拦截器 3: myQuery ->', myQuery)
+
+    // 处理相对路径
+    if (!path.startsWith('/')) {
+      const currentPath = getLastPage()?.route || ''
+      const normalizedCurrentPath = currentPath.startsWith('/') ? currentPath : `/${currentPath}`
+      const baseDir = normalizedCurrentPath.substring(0, normalizedCurrentPath.lastIndexOf('/'))
+      path = `${baseDir}/${path}`
+    }
+
+    // 系统内部页面直接放行（不检查路由存在性，不进行登录拦截）
+    if (isSystemInternalPath(path)) {
+      FG_LOG_ENABLE && console.log('系统内部页面，直接放行:', path)
+      return true
+    }
+
+    // 处理路由不存在的情况
+    if (!isRouteExists(path)) {
+      console.warn('路由不存在:', path)
+      uni.navigateTo({ url: NOT_FOUND_PAGE })
+      return false // 明确表示阻止原路由继续执行
+    }
+
+    // 处理直接进入路由非首页时，tabbarIndex 不正确的问题
+    tabbarStore.setAutoCurIdx(path)
+
+    // 小程序里面使用平台自带的登录，则不走下面的逻辑
+    if (isMp && !LOGIN_PAGE_ENABLE_IN_MP) {
+      return true // 明确表示允许路由继续执行
+    }
+
+    const tokenStore = useTokenStore()
+    FG_LOG_ENABLE && console.log('tokenStore.hasLogin:', tokenStore.hasLogin)
+
+    // 不管黑白名单，登录了就直接去吧（但是当前不能是登录页）
+    if (tokenStore.hasLogin) {
+      if (path !== LOGIN_PAGE) {
+        return true // 明确表示允许路由继续执行
+      }
+      else {
+        console.log('已经登录，但是还在登录页', myQuery.redirect)
+        const url = myQuery.redirect || HOME_PAGE
+        if (isPageTabbar(url)) {
+          uni.switchTab({ url })
+        }
+        else {
+          uni.navigateTo({ url })
+        }
+        return false // 明确表示阻止原路由继续执行
+      }
+    }
+    let fullPath = path
+
+    if (Object.keys(myQuery).length) {
+      fullPath += `?${Object.keys(myQuery).map(key => `${key}=${myQuery[key]}`).join('&')}`
+    }
+    const redirectUrl = `${LOGIN_PAGE}?redirect=${encodeURIComponent(fullPath)}`
+
+    // #region 1/2 默认需要登录的情况(白名单策略) ---------------------------
+    if (isNeedLoginMode) {
+      // 需要登录里面的 EXCLUDE_LOGIN_PATH_LIST 表示白名单，可以直接通过
+      if (judgeIsExcludePath(path)) {
+        return true // 明确表示允许路由继续执行
+      }
+      // 否则需要重定向到登录页
+      else {
+        if (path === LOGIN_PAGE) {
+          return true // 明确表示允许路由继续执行
+        }
+        FG_LOG_ENABLE && console.log('1 isNeedLogin(白名单策略) redirectUrl:', redirectUrl)
+        uni.navigateTo({ url: redirectUrl })
+        return false // 明确表示阻止原路由继续执行
+      }
+    }
+    // #endregion 1/2 默认需要登录的情况(白名单策略) ---------------------------
+
+    // #region 2/2 默认不需要登录的情况(黑名单策略) ---------------------------
+    else {
+      // 不需要登录里面的 EXCLUDE_LOGIN_PATH_LIST 表示黑名单，需要重定向到登录页
+      if (judgeIsExcludePath(path)) {
+        FG_LOG_ENABLE && console.log('2 isNeedLogin(黑名单策略) redirectUrl:', redirectUrl)
+        uni.navigateTo({ url: redirectUrl })
+        return false // 修改为false，阻止原路由继续执行
+      }
+      return true // 明确表示允许路由继续执行
+    }
+    // #endregion 2/2 默认不需要登录的情况(黑名单策略) ---------------------------
+  },
+}
+
+// 针对 chooseLocation 的特殊处理
+export const chooseLocationInterceptor = {
+  invoke(options: any) {
+    // 直接放行 chooseLocation 调用
+    FG_LOG_ENABLE && console.log('chooseLocation 调用，直接放行:', options)
+    return true
+  },
+}
+
+export const routeInterceptor = {
+  install() {
+    uni.addInterceptor('navigateTo', navigateToInterceptor)
+    uni.addInterceptor('reLaunch', navigateToInterceptor)
+    uni.addInterceptor('redirectTo', navigateToInterceptor)
+    uni.addInterceptor('switchTab', navigateToInterceptor)
+
+    // 添加 chooseLocation 的拦截器，确保直接放行
+    uni.addInterceptor('chooseLocation', chooseLocationInterceptor)
+  },
+}

src/service/index.ts

@@ -0,0 +1,6 @@
+/* eslint-disable */
+// @ts-ignore
+export * from './types';
+
+export * from './listAll';
+export * from './info';

src/service/info.ts

@@ -0,0 +1,14 @@
+/* eslint-disable */
+// @ts-ignore
+import request from '@/http/vue-query';
+import { CustomRequestOptions_ } from '@/http/types';
+
+import * as API from './types';
+
+/** 用户信息 GET /user/info */
+export function infoUsingGet({ options }: { options?: CustomRequestOptions_ }) {
+  return request<API.InfoUsingGetResponse>('/getInfo', {
+    method: 'GET',
+    ...(options || {}),
+  });
+}

src/service/listAll.ts

@@ -0,0 +1,18 @@
+/* eslint-disable */
+// @ts-ignore
+import request from '@/http/vue-query';
+import { CustomRequestOptions_ } from '@/http/types';
+
+import * as API from './types';
+
+/** 用户列表 GET /user/listAll */
+export function listAllUsingGet({
+  options,
+}: {
+  options?: CustomRequestOptions_;
+}) {
+  return request<API.ListAllUsingGetResponse>('/user/listAll', {
+    method: 'GET',
+    ...(options || {}),
+  });
+}

src/service/types.ts

@@ -0,0 +1,29 @@
+/* eslint-disable */
+// @ts-ignore
+
+export type InfoUsingGetResponse = {
+  code: number;
+  msg: string;
+  data: UserItem;
+};
+
+export type InfoUsingGetResponses = {
+  200: InfoUsingGetResponse;
+};
+
+export type ListAllUsingGetResponse = {
+  code: number;
+  msg: string;
+  data: UserItem[];
+};
+
+export type ListAllUsingGetResponses = {
+  200: ListAllUsingGetResponse;
+};
+
+export type UserItem = {
+  userId: number;
+  username: string;
+  nickname: string;
+  avatar: string;
+};