# 怪兽框架小程序-vitesse

**Repository Path**: dkgs/uniapp

## Basic Information

- **Project Name**: 怪兽框架小程序-vitesse
- **Description**: 多客怪兽框架小程序开发uniapp脚手架
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-16
- **Last Updated**: 2025-11-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align='center'>
  <img src='https://doc.dkyx.cc/vue3/images/logo-q.png' alt='多客怪兽 SaaS 框架' width='200'/>
</p>

<h1 align='center'>多客怪兽 UniApp 开发模板</h1>

<p align='center'>
基于 <a href="https://github.com/Ares-Chang/uni-vitesse">uni-vitesse</a> 的多客怪兽 SaaS 框架专用 UniApp 项目模板
</p>

<p align='center'>
  <a href="https://doc.dkyx.cc/vue3">📖 查看文档</a> |
  <a href="https://www.dkyx.cc">🌐 官网</a>
</p>

<br/>

## ✨ 特性

- ⚡️ **极速开发** - [Vue 3](https://github.com/vuejs/core) + [Vite](https://github.com/vitejs/vite) + [pnpm](https://pnpm.io/) 带来闪电般的开发体验
- 🎯 **多平台支持** - 一套代码，编译为微信/支付宝/抖音小程序、H5、App
- 🗂 **约定式路由** - 基于文件系统的自动路由生成
- 📦 **组件自动导入** - 无需手动 import，直接使用组件
- 📑 **布局系统** - 灵活的页面布局方案
- 🍍 **Pinia 状态管理** - 轻量、类型安全的状态管理
- 🎨 **UnoCSS** - 高性能的即时原子化 CSS 引擎
- 😃 **图标按需引入** - 支持任意图标集，自动按需加载
- 🔥 **`<script setup>`** - 使用 Vue 3 最新的 Composition API 语法
- 📥 **API 自动导入** - Vue、VueUse、uni-app API 无需 import
- 🦾 **TypeScript** - 完整的类型提示和检查
- 🔒 **pnpm 锁定** - 确保依赖版本一致性

<br/>

## 🚀 多客怪兽框架集成

本模板已深度集成多客怪兽 SaaS 框架的核心功能：

### 核心功能

- ✅ **多租户架构** - 支持 SaaS 多租户数据隔离
- ✅ **站点配置管理** - 动态配置，服务器端自动生成
- ✅ **HTTP 请求封装** - 统一请求拦截、自动携带租户信息
- ✅ **用户状态管理** - 用户信息、Token、上级关系自动管理
- ✅ **文件上传** - 开箱即用的文件上传功能
- ✅ **流式请求** - 支持 AI 对话等流式场景
- ✅ **全局状态** - `$siteinfo`、`$http` 全局可用

### 使用示例

```vue
<script setup lang="ts">
// 无需导入，自动可用
const { siteinfo } = useSiteInfo()
const { userId, userToken } = useUser()

// 发起请求（自动携带租户信息）
const data = await $http.get('api/getData')
</script>

<template>
  <view>
    <text>项目：{{ siteinfo.projectname }}</text>
    <text>用户ID：{{ userId }}</text>
  </view>
</template>
```

详细文档请查看 [MIGRATION.md](./MIGRATION.md)

<br/>

## 📦 技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| Vue | 3.4.21 | 渐进式 JavaScript 框架 |
| Vite | 6.3.4 | 下一代前端构建工具 |
| UniApp | 3.0.0-4070620250821001 | 跨平台应用开发框架 |
| TypeScript | 5.9.2 | JavaScript 的超集 |
| Pinia | 2.0.36 | Vue 状态管理库 |
| UnoCSS | 66.1.0 | 即时原子化 CSS 引擎 |
| VueUse | 13.8.0 | Vue 组合式 API 工具集 |

<br/>

## 🛠️ 快速开始

### 环境要求

- **Node.js** >= 16.0.0
- **pnpm** >= 8.0.0

### 安装依赖

```bash
pnpm install
```

### 开发调试

```bash
# 微信小程序
pnpm dev:mp-weixin

# H5
pnpm dev:h5

# 支付宝小程序
pnpm dev:mp-alipay

# 抖音小程序
pnpm dev:mp-toutiao

# App
pnpm dev:app
```

### 生产构建

```bash
# 微信小程序
pnpm build:mp-weixin

# H5
pnpm build:h5

# 其他平台
pnpm build:mp-alipay
pnpm build:mp-toutiao
pnpm build:app
```

<br/>

## 📁 目录结构

```
src/
├── siteinfo.js              # 站点配置（多租户动态生成）⚠️
├── main.ts                  # 应用入口
├── App.vue                  # 根组件
├── pages/                   # 主包页面
│   ├── index.vue           # 首页
│   └── example.vue         # 功能示例页面
├── pages-sub/               # 分包页面
├── components/              # 公共组件
├── composables/             # 组合式函数
│   ├── useSiteInfo.ts      # 站点信息
│   ├── useUser.ts          # 用户信息
│   └── useDark.ts          # 暗黑模式
├── stores/                  # Pinia 状态管理
├── utils/                   # 工具函数
│   └── http.ts             # HTTP 请求封装
├── layouts/                 # 布局组件
└── static/                  # 静态资源
```

<br/>

## 🔧 配置说明

### 站点配置（siteinfo.js）

**⚠️ 重要**：此文件位于 `src` 根目录，用于多租户动态配置。

```javascript
export default {
  baseUrl: 'https://your-api-domain.com', // API 地址
  plaid: 30, // 平台 ID
  platform_appid: 49, // 应用 ID
  addon_name: 'pic_magic', // 插件名称
  version: '1.0.0', // 版本号
  projectname: '灵图', // 项目名称
}
```

**多租户工作流程**：
1. 开发者打包小程序 → 上传到服务器
2. 租户提交小程序申请
3. 服务器根据租户信息生成专属 `siteinfo.js`
4. 自动覆盖原文件 → 生成租户专属小程序包

<br/>

## 📖 文档

- [功能迁移说明](./MIGRATION.md) - 核心功能使用文档
- [故障排查指南](./TROUBLESHOOTING.md) - 常见问题解决方案
- [多客怪兽官方文档](https://doc.dkyx.cc) - 框架完整文档

<br/>

## 🙏 致谢

本项目基于以下优秀开源项目构建：

- [uni-vitesse](https://github.com/Ares-Chang/uni-vitesse) - UniApp 版 Vitesse 模板
- [Vitesse](https://github.com/antfu/vitesse) - Anthony Fu 的固执己见的 Vite 模板
- [VueUse](https://github.com/vueuse/vueuse) - Vue 组合式 API 工具集
- [UnoCSS](https://github.com/unocss/unocss) - 即时原子化 CSS 引擎

特别感谢 [Ares-Chang](https://github.com/Ares-Chang) 提供的 uni-vitesse 模板！

<br/>

## 📄 开源协议

[MIT License](./LICENSE)

<br/>

## 🔗 相关链接

- **多客怪兽官网**：[https://www.dkgs.cc](https://www.dkgs.cc)
- **官方文档**：[https://doc.dkyx.cc](https://doc.dkyx.cc)
- **GitHub**：[多客怪兽框架](https://github.com/duoke-monster)
- **技术支持**：[联系我们](https://www.dkgs.cc/contact)

<br/>

<p align='center'>
  <sub>由 ❤️ 多客怪兽团队倾情打造</sub>
</p>