# gomoku

**Repository Path**: startshineye/gomoku

## Basic Information

- **Project Name**: gomoku
- **Description**: 五子棋
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 五子棋 (Gomoku)

纯前端五子棋小游戏，支持双人对弈。

## 功能

- **15×15 标准棋盘**，黑方先行
- **五子连珠判定** — 水平、垂直、对角线四个方向检测
- **悔棋** — 回退上一步操作
- **重新开始** — 重置棋盘
- **胜负高亮** — 获胜时高亮五子连线

## 快速开始

```bash
# 安装依赖（仅用于类型检查）
npm install

# 启动开发服务器（Python）
python3 -m http.server 3000

# 浏览器打开
open http://localhost:3000
```

## 脚本

| 命令 | 说明 |
|------|------|
| `npm run typecheck` | TypeScript 类型检查 |

## 项目结构

```
gomoku/
├── index.html          # 入口页面
├── package.json        # 项目配置
├── CLAUDE.md           # Claude Code 配置
├── css/
│   └── styles.css      # 棋盘与棋子样式
└── js/
    ├── board.js         # 棋盘状态管理
    ├── game.js          # 游戏逻辑（落子、胜负、悔棋）
    ├── renderer.js      # DOM 渲染器
    └── main.js          # 入口，协调各模块
```

## 技术栈

- 原生 JavaScript（ES Modules）
- 纯 CSS 渲染棋盘（无 Canvas）
- TypeScript 类型检查（JSDoc 注解）

## 许可

MIT