# shudu

**Repository Path**: wangwena/shudu

## Basic Information

- **Project Name**: shudu
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-22
- **Last Updated**: 2025-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数独小游戏

这是一个使用HTML/CSS/JavaScript实现的网页版数独游戏，包含以下主要功能：

## 功能特性
- 三种难度选择（简单、标准、困难）
- 笔记模式（用于标记可能的数字）
- 自动笔记生成功能
- 游戏计时器
- 游戏记录保存与统计
- 答案检查与完整解显示
- 游戏记录导出功能

## 技术架构
项目采用模块化设计，包含以下主要文件：

1. **game-logic.js** - 游戏核心逻辑
   - `SudokuGame`类处理游戏状态、输入逻辑和规则验证
   - 实现了数独游戏的核心机制，包括新游戏创建、计时器管理、网格渲染等功能

2. **sudoku-generator.js** - 数独谜题生成器
   - `SudokuGenerator`类负责生成完整的数独解决方案并根据难度去除数字
   - 包含数独求解算法和有效性检查功能

3. **storage.js** - 数据存储管理
   - `GameStorage`类处理浏览器本地存储，保存游戏记录和当前游戏状态
   - 提供游戏统计信息的计算功能

4. **app.js** - 应用程序入口
   - `SudokuApp`类初始化游戏并设置所有事件监听器
   - 处理用户界面交互和键盘事件

5. **index.html** - 页面结构
   - 定义了游戏界面的主要HTML结构
   - 包含游戏控制区、游戏棋盘、数字键盘和记录模态框

6. **style.css** - 样式表
   - 提供响应式设计，适配不同屏幕尺寸
   - 包含丰富的CSS动画和交互效果

## 使用说明
1. 选择难度级别开始新游戏
2. 点击单元格或使用键盘方向键选择要填写的位置
3. 在数字键盘区域选择数字进行填写
4. 使用"✏️ 笔记模式"按钮切换笔记模式
5. 使用"🔍 一键笔记"自动生成可能的数字标记
6. 完成后点击"检查答案"验证解答
7. 游戏记录会自动保存，可点击"📊 游戏记录"查看统计信息

## 许可证
本项目使用木兰宽松许可证第2版（Mulan PSL v2）开源，详细条款请参阅[LICENSE](LICENSE)文件。

## 贡献指南
欢迎贡献代码！请先阅读项目文档，然后提交PR或Issue。对于重大更新，请先创建Issue讨论更改。

## 安装与运行
直接打开index.html文件即可运行游戏，无需安装任何依赖。

## 致谢
感谢所有贡献者和测试人员。特别感谢木兰开源社区提供的宽松许可证框架。