# game-test

**Repository Path**: szzhoujiarui/game-test

## Basic Information

- **Project Name**: game-test
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-10
- **Last Updated**: 2026-08-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 猩红遗迹：破晓之刃

《猩红遗迹：破晓之刃》是一款运行在浏览器中的原创横版地下城动作游戏。玩家操控猩红骑士穿过两波杂兵，最终挑战锻炉暴君。战斗包含四段地面普通攻击、空中普通攻击、普攻取消接技能、位移与跳跃、三项技能、浮空、击退、硬直、倒地、连击评级、怒气强化和技能冷却。

游戏无需账号。打开页面后按 `Enter` 开始，击败第三波 Boss 获胜；生命归零则失败，结算画面可按 `Enter` 重开。

## 键位

| 键位 | 操作 | 说明 |
|------|------|------|
| `W` | 向场景深处移动 | 沿竞技场纵深向上移动 |
| `A` | 向左移动 | 改变水平位置与朝向 |
| `S` | 向场景近处移动 | 沿竞技场纵深向下移动 |
| `D` | 向右移动 | 改变水平位置与朝向 |
| `J` | 普通攻击 | 地面取消窗口内可衔接四段攻击，跳跃中执行单次空中攻击 |
| `K` | 跳跃 | 跳跃期间仍可水平移动 |
| `L` | 冲刺 | 持续 0.22 秒，前 0.12 秒无敌 |
| `U` | 血刃突进 | 地面三段突进攻击，冷却 4 秒 |
| `I` | 裂地斩 | 地面远距离浮空攻击，冷却 6 秒 |
| `O` | 崩山跃击 | 起跳后落地造成范围倒地攻击，冷却 8 秒；空中按键也可转入该技能 |
| `Escape` | 暂停或继续 | 在战斗中暂停，在暂停画面恢复 |
| `Enter` | 开始、确认或重开 | 从标题开始，并从胜利或失败画面重开 |

四段地面普攻均可在各自窗口内用 `U`、`I`、`O` 取消接可用技能，冷却中的技能会保留原攻击。满怒气施放技能会获得 1.25 倍伤害、猩红橙色命中特效和更强震动，并消耗 25 点怒气。每个有效的玩家攻击命中目标时增加 4 点怒气。敌方倒地重击会立即清空连击，普通硬直命中保留连击至自然超时。

游戏坐标以实体屏幕左上角 `position` 表示地面平面位置，并使用 `position.y + height` 作为统一脚底纵深。角色遮挡、敌人对线、阴影和攻击纵深均遵循该契约；攻击另有明确的离地高度命中范围。

## 开发

项目使用 TypeScript、原生 DOM、Canvas 2D、Web Audio API 和 Vite。测试通过 Node.js 内置测试运行器执行，由 `tsx` 加载 TypeScript。当前 `package.json` 没有 `dependencies` 或 `devDependencies`，仓库也没有依赖锁文件；项目脚本使用全局安装的 Vite、tsx 和 TypeScript。

```bash
# 全局安装项目脚本所需工具
npm install -g vite tsx typescript

# 启动开发服务器
npm run dev

# 运行测试
npm test

# 执行严格类型检查
npm run typecheck

# 类型检查并生成生产构建
npm run build
```

开发服务器由 Vite 启动。生产构建输出到 `dist/`。项目没有后端服务、环境变量或外部 API。

## 浏览器支持

运行环境需要支持 ES2022 模块、Canvas 2D、`requestAnimationFrame`、`matchMedia` 和标准键盘事件。支持 Web Audio API 时，首次键盘操作会解锁合成音效；音频上下文创建、恢复或播放失败时，游戏自动转为静音并继续运行。页面失焦或文档隐藏时，进行中的战斗自动暂停。

画布内部逻辑分辨率固定为 960 x 540，页面通过 CSS 保持 16:9 比例并缩放到可用宽度。游戏使用完整键盘操作，移动端页面可自适应显示，当前代码未提供触屏控制。

## 文档

- [项目文档入口](./.monkeycode/docs/README.md)
- [项目文档索引](./.monkeycode/docs/INDEX.md)
- [架构说明](./.monkeycode/docs/ARCHITECTURE.md)
- [接口与事件契约](./.monkeycode/docs/INTERFACES.md)
- [开发者指南](./.monkeycode/docs/DEVELOPER_GUIDE.md)

## 素材说明

场景、角色、敌人、HUD、战斗特效和音效均由项目代码使用 Canvas 图元与 Web Audio 振荡器实时生成。仓库中没有外部图片、字体或音频素材文件。