# cat-rogue

**Repository Path**: musha233/cat-rogue

## Basic Information

- **Project Name**: cat-rogue
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-12
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 猫咪地牢 (Cat Rogue)

一款类似元气骑士的猫咪主题肉鸽地牢 Web 游戏，支持多地图、天赋、主副武器、可破坏障碍物等玩法。

## 如何运行

项目是纯前端静态页面，需要通过本地 HTTP 服务打开（直接双击 `index.html` 会因 ES Module 限制无法加载）。

### 方法一：Python（推荐）

已安装 Python 时，在项目根目录执行：

```bash
# Python 3
python3 -m http.server 8080

# 或 Python 2
python -m SimpleHTTPServer 8080
```

浏览器访问：**http://localhost:8080**

### 方法二：Node.js

```bash
npx serve .
# 或
npx http-server -p 8080
```

然后打开终端提示的地址（一般为 http://localhost:8080 或 3000）。

### 方法三：VS Code

安装插件 **Live Server**，在 `index.html` 上右键选择「Open with Live Server」即可。

## 如何停止服务

### Python / Node 启动的服务

在运行服务的终端里按 **Ctrl + C** 即可停止。

若终端已关闭或服务在后台运行，可先查出占用端口的进程再结束：

```bash
# 查看占用 8080 端口的进程（macOS / Linux）
lsof -i:8080

# 结束该进程（将 PID 替换为上面输出的进程号）
kill -9 <PID>

# 或一行命令直接结束 8080 端口上的进程
lsof -ti:8080 | xargs kill -9
```

### VS Code Live Server

点击编辑器右下角状态栏的 **「Port: 5500」** 或 **「Go Live」** 按钮即可停止，或在 `index.html` 上右键选择「Stop Live Server」。

---

## 操作说明

| 操作     | 按键           |
|----------|----------------|
| 移动     | WASD / 方向键  |
| 瞄准/攻击 | 鼠标           |
| 冲刺     | 空格 / Shift   |
| 切换武器 | Q / Tab        |
| 拾取武器 | E（靠近掉落武器时） |
| 暂停     | ESC            |

## 技术栈

- 原生 HTML5 + Canvas 2D
- 原生 JavaScript（ES Module）
- 无构建工具，直接浏览器运行