# html_game_polytrack_manual0

**Repository Path**: enzoism/html_game_polytrack_manual0

## Basic Information

- **Project Name**: html_game_polytrack_manual0
- **Description**: html_game_polytrack_manual0 让AI帮我进行游戏开发过程的还原
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-19
- **Last Updated**: 2026-10-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PolyTrack Core Rebuild（poly_track_v1）

从零开始、分 **11 步**复刻 [PolyTrack](https://www.polytrack.io)（© Kodub）核心玩法的学习型项目。
原实现参考同目录的 `ai-website-cloner-template`（MIT）。本仓库起步时**只保留静态资源**（`public/sites/polytrack/`），
全部代码按"项目生长过程"逐步重建——**每一步一个 git commit + 一份讲解文档**，git 历史即教程。

## 运行

```bash
npm install
npm run dev        # http://localhost:3000（被占用时自动换端口）
# 或生产模式
npm run build && npm start
```

## 玩法

- **WASD / 方向键** 驾驶，**R R**（双击）重生回起点，**C** 切换追逐/驾驶舱相机
- HUD 工具栏：Reset / Camera / **Next Track**（`?track=<id>` 同步到 URL，可刷新保持/分享）
- 17 条官方赛道（Summer/Winter/Desert），检查点计时、个人最佳自动存 localStorage

## 11 步生长索引

| Step | 内容 | 讲解文档 |
|---|---|---|
| 01 | Next.js 脚手架与欢迎页（手写 5 份配置） | [docs/steps/step-01](docs/steps/step-01-nextjs-scaffold.md) |
| 02 | App Router 游戏路由 | [docs/steps/step-02](docs/steps/step-02-app-router-route.md) |
| 03 | three.js 引擎骨架与 React 挂载 | [docs/steps/step-03](docs/steps/step-03-engine-skeleton.md) |
| 04 | 赛道数据层（弧长参数化的前置） | [docs/steps/step-04](docs/steps/step-04-track-data.md) |
| 05 | 赛道样条渲染与环境资产 ★核心技术 | [docs/steps/step-05](docs/steps/step-05-track-rendering.md) |
| 06 | DRACO/GLTF 加载车模 | [docs/steps/step-06](docs/steps/step-06-load-car.md) |
| 07 | 键盘输入与街机车辆物理 ★手感所在 | [docs/steps/step-07](docs/steps/step-07-input-physics.md) |
| 08 | 追逐/驾驶舱相机（速度感三件套） | [docs/steps/step-08](docs/steps/step-08-camera.md) |
| 09 | 计时/检查点/个人最佳 | [docs/steps/step-09](docs/steps/step-09-timing.md) |
| 10 | 竞速 HUD 与 CSS 子集提取 | [docs/steps/step-10](docs/steps/step-10-hud.md) |
| 11 | 收尾验证与复刻文档 | [docs/steps/step-11](docs/steps/step-11-finalize.md) |

复刻方法论、决策与偏差清单见 [website.md](website.md)。

## 技术栈

Next.js 16 · React 19 · TypeScript 5 · three.js 0.186（原生 API）· Tailwind 4（仅壳）

## 致谢与许可

- [PolyTrack](https://www.polytrack.io) © [Kodub](https://www.kodub.com) —— 本项目为其本地学习性复刻，资源版权归原作所有，请勿商用
- 参考实现 `ai-website-cloner-template`，MIT
- 本仓库代码 MIT