62 lines
2.3 KiB
Markdown
62 lines
2.3 KiB
Markdown
# z449 - 移动游戏项目展示页
|
||
|
||
跨学期 Unity 移动游戏毕设（448/449）的展示页：项目概览、团队、玩家排行榜、版本迭代记录、ML-Agents 实验。纯前端 Vue 3 应用，独立可渲染与维护，亦可作为 [mainPage](https://git.zikai.wang/zikai/zMainPage) 的子模块集成展示。
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
z449/
|
||
├── index.html Vite 入口
|
||
├── package.json
|
||
├── vite.config.js 含 /448 /449 开发代理
|
||
├── .npmrc npmmirror 镜像加速
|
||
├── README.md
|
||
├── docs/ 设计文档
|
||
└── src/
|
||
├── main.js 独立 app 挂载（i18n + 全局样式）
|
||
├── App.vue 便携式根组件（嵌入与独立两用）
|
||
├── config.js 静态配置（资源路径 / 排行榜接口 / 子标签）
|
||
├── i18n/ 独立 vue-i18n 实例 + 中英 locale
|
||
├── composables/
|
||
│ └── useLocale.js 语言辅助（直读自身 i18n 实例）
|
||
├── components/ Hero / 轮播 / 子标签 / 排行榜 / 时间线 / 实验
|
||
│ └── ui/ PageShell / Tag
|
||
├── data/ 团队成员 / 版本演进数据
|
||
└── styles/ variables.css（令牌）+ base.css（重置，仅独立 app 加载）
|
||
```
|
||
|
||
## 外部依赖
|
||
|
||
| 项 | 说明 |
|
||
|----|------|
|
||
| Node.js | ≥ 18 |
|
||
| `/448` 静态资源 | 游戏截图、WebGL 试玩、APK 下载（站点根提供） |
|
||
| `/449` 静态资源 + PHP | 玩家分数排行榜接口 `/449/449rest.php`（站点根提供） |
|
||
|
||
> 开发时 `vite.config.js` 已把 `/448` `/449` 代理到 `localhost:8080`；生产由 Apache 静态 / PHP 服务提供。
|
||
|
||
## 如何使用
|
||
|
||
```bash
|
||
# 克隆并安装
|
||
git clone https://git.zikai.wang/zikai/z449.git
|
||
cd z449
|
||
npm install # 已配 npmmirror 镜像加速
|
||
|
||
npm run dev # 开发服务器 http://localhost:5174
|
||
npm run build # 构建到 dist/
|
||
```
|
||
|
||
## 技术栈
|
||
|
||
| 项 | 选择 |
|
||
|----|------|
|
||
| 框架 | Vue 3.4（SFC，`<script setup>`） |
|
||
| 构建 | Vite 5 |
|
||
| 国际化 | vue-i18n 9（中文同步，英文懒加载） |
|
||
| 包源 | npmmirror.com（中国镜像加速） |
|
||
|
||
## 了解更多
|
||
|
||
- [嵌入 mainPage（i18n prop 桥接 / 样式隔离）](./docs/integration.md)
|