UniApp 快速开始
UniApp 是 Vue 3 + uni-app 多端客户端（H5、微信小程序等），与 Web 同属 C 端，共用 Service app 侧 API，UI 使用 tt-shaduni。
前置条件
| 依赖 | 说明 |
|---|---|
| Service | 后端先启动（H5 代理默认 http://127.0.0.1:3000） |
| vome-core | EPS 客户端 |
| tt-shaduni | postinstall 自动 link 到 uni_modules |
| Bun / Node | 安装与 CLI |
安装与启动（H5）
bash
cd uniapp
bun install
bun run dev:h5独立仓库 Clone / ZIP 见 源码下载。
H5 端口 6600：
http://localhost:6600其他平台
bash
bun run dev:mp-weixin
bun run build:h5
bun run build:mp-weixin
# 更多见 package.json → dev:mp-* / build:mp-*启动后
bootEps()（side: 'app'）- 路由守卫（token 刷新）
- 有 token 时
connectWs() - 移动 / 宽屏双布局（见 路由与页面）
文档目录
| 文档 | 内容 |
|---|---|
| 目录结构 | 树、别名、约定式路由 |
| 配置说明 | host / 小程序域名 |
| 路由与页面 | vite-plugin-uni-pages、Tab 壳 |
| tt-shaduni 技术栈 | 栈与条件编译 |
| API 与 EPS | request、service |
| 登录与路由鉴权 | H5 / 小程序登录 |
| Socket.IO | uni-socket.io |
| Stores | Pinia |
| 主题 | tt 主题变量 |
| 构建自有组件库 | tt + vm-* |
| 调试 | 排错 |
| 部署 | H5 / 各小程序 |
与 Web
| 项 | UniApp | Web |
|---|---|---|
| 端口 (H5) | 6600 | 9900 |
| 路由 | 约定式 → pages.json | vue-router glob |
| UI | tt-shaduni | shadcn-vue |
| Socket 包 | @wu-xj/uni-socket.io | socket.io-client |
| 存储前缀 | vome_uni_* | vome_web_* |