z449/README.md

z449 - 移动游戏项目展示页

跨学期 Unity 移动游戏毕设（448/449）的展示页：项目概览、团队、玩家排行榜、版本迭代记录、ML-Agents 实验。纯前端 Vue 3 应用，独立可渲染与维护，亦可作为 mainPage 的子模块集成展示。

项目结构

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 服务提供。

如何使用

# 克隆并安装
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 桥接 / 样式隔离）