Arcticnewone 个人网站
北极新一（Arcticnewone）的个人网站，提供个人介绍、作品集、工作室服务、动态资讯、工具箱与联系页面，是一个现代化的展示型站点。
技术栈
- Nuxt 4 — 应用框架（服务端渲染 + 静态生成）
- Vue 3 — 视图层
- Tailwind CSS — 样式方案（通过
@nuxtjs/tailwindcss集成） - GSAP — 页面动画（配合 Lenis 平滑滚动）
- Pinia — 状态管理
- @nuxtjs/i18n — 国际化（中/英双语）
- @nuxt/icon — 图标
- pnpm — 包管理器
本地开发
环境要求
- Node.js ≥ 20（推荐 22，与 Docker 构建镜像一致）
- pnpm ≥ 9
安装与启动
# 1. 安装依赖
pnpm install
# 2. 启动开发服务器（默认 http://localhost:3000）
pnpm dev
开发服务器启动后访问 http://localhost:3000，代码修改会热更新生效。
常用命令
| 命令 | 说明 |
|---|---|
pnpm dev |
启动开发服务器 |
pnpm build |
构建生产版本（生成 .output/） |
pnpm generate |
静态站点生成（输出到 dist/） |
pnpm preview |
本地预览生产构建 |
pnpm start |
以 Node 方式启动 .output/server/index.mjs |
项目结构
.
├── app/ # 应用源码（Nuxt 4 约定目录）
│ ├── app.vue # 应用入口（全局 SEO / Meta）
│ ├── assets/ # 静态资源（样式、图片等）
│ ├── components/ # 组件（common / home）
│ ├── composables/ # 组合式函数
│ ├── layouts/ # 布局
│ ├── pages/ # 页面（首页、工作室、作品、动态、工具、联系）
│ ├── plugins/ # 插件（如 Lenis 平滑滚动）
│ ├── stores/ # Pinia 状态
│ └── types/ # 类型定义
├── i18n/
│ └── locales/ # 国际化文案（zh.json / en.json）
├── public/ # 公开静态文件（favicon、robots.txt 等）
├── Dockerfile # 容器镜像构建
├── deploy/ # 生产部署配置（Kubernetes Deployment/Service/Ingress）
├── docker-compose.yml # 本地容器编排（使用 SWR 镜像）
├── nuxt.config.ts # Nuxt 配置（模块、i18n、Tailwind 等）
├── tailwind.config.js # Tailwind 配置
└── package.json # 项目依赖与脚本
构建与部署
构建并推送镜像：
./build-and-push.sh
脚本从环境变量读取 SWR 凭据（SWR_REGISTRY、SWR_NAMESPACE、SWR_USERNAME、SWR_PASSWORD），
多架构（linux/amd64,linux/arm64）构建并推送到华为云 SWR：分架构推送后用 docker manifest 合并为 latest（标准 Docker manifest list，SWR 可正常解析）。
Dockerfile 基础镜像使用国内可访问的 DaoCloud 镜像源（docker.m.daocloud.io/library/node:22-alpine，Docker Hub 在国内不可达）。
本地启动（使用 SWR 镜像，与生产一致）：
docker compose up -d
生产部署使用 deploy/ 目录下的 Kubernetes 配置（Deployment / Service / Ingress），
镜像统一推送到华为云 SWR（swr.cn-north-4.myhuaweicloud.com/virtheart/arcticnewone:latest），
部署与回滚步骤见 deploy/README.md。
国际化（i18n）
项目使用 @nuxtjs/i18n 实现中/英双语：
- 语言文件位于
i18n/locales/：zh.json（中文）、en.json（英文） - 默认语言为中文（
defaultLocale: 'zh'），URL 不包含语言前缀（strategy: 'no_prefix'），不自动探测浏览器语言 - 组件中通过
useI18n()的t()方法读取文案，例如t('nav.home')
新增文案时，在 zh.json 和 en.json 中同步添加对应键即可。
说明
本项目不含任何密钥或敏感信息；本地环境变量请使用 .env 文件（已被 .gitignore 忽略）。