# Sudoku

**Repository Path**: zldnn/sudoku

## Basic Information

- **Project Name**: Sudoku
- **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-15
- **Last Updated**: 2026-02-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数独游戏 (Sudoku Game)

一个使用 Electron 构建的跨平台数独游戏应用。

## 功能特性

- 三种难度级别：简单、中等、烧脑
- 计时器功能
- 游戏进度保存和加载
- 提示功能
- 实时错误检查和高亮
- 最佳成绩记录
- 键盘和鼠标输入支持
- 现代化的用户界面

## 安装和运行

### 安装依赖

```bash
npm install
```

### 开发模式运行

```bash
npm start
```

### 打包应用

```bash
npm run build
```

打包后的应用将生成在 `dist/` 目录中。

## 游戏操作

### 鼠标操作
- 点击单元格选中
- 使用底部数字按钮输入数字
- 点击"清除"按钮清空选中单元格

### 键盘操作
- 方向键：在单元格之间导航
- 数字键 1-9：输入数字
- Delete/Backspace：清空单元格
- Ctrl+N：新游戏
- Ctrl+S：保存游戏

### 游戏控制
- **新游戏**：开始一个新的游戏
- **暂停/继续**：暂停或继续游戏计时
- **提示**：在选中单元格填入正确数字（会增加提示计数）
- **保存**：保存当前游戏进度

## 游戏规则

1. 在每个空格中填入 1-9 的数字
2. 每行、每列、每个 3x3 宫格内的数字不能重复
3. 完成所有 81 个格子即完成游戏

## 难度说明

- **简单**：约 35 个空格，适合初学者
- **中等**：约 45 个空格，适合有一定经验的玩家
- **烧脑**：约 54 个空格，适合数独高手

## 项目结构

```
Sudoku/
├── main.js                 # Electron 主进程
├── preload.js              # 预加载脚本
├── package.json            # 项目配置
├── src/
│   ├── game/
│   │   ├── sudoku.js       # 数独核心逻辑
│   │   ├── generator.js    # 数独生成器
│   │   ├── validator.js    # 验证逻辑
│   │   └── solver.js       # 求解器
│   ├── ui/
│   │   ├── index.html      # 主界面
│   │   ├── styles.css      # 样式文件
│   │   └── renderer.js     # 渲染进程逻辑
│   └── utils/
│       ├── timer.js        # 计时器工具
│       ├── storage.js      # 本地存储
│       └── error-checker.js # 错误检查工具
└── resources/
    └── icons/              # 应用图标
```

## 技术栈

- **Electron**: 跨平台桌面应用框架
- **HTML/CSS/JavaScript**: 前端技术
- **Node.js**: 后端逻辑

## 开发说明

### 添加应用图标

将图标文件放入 `resources/icons/` 目录：
- Windows: `icon.ico`
- macOS: `icon.icns`
- Linux: `icon.png`

### 修改游戏难度

在 `src/game/generator.js` 中修改 `getRemoveCount` 方法可以调整难度级别。

## 许可证

ISC