# 数独

**Repository Path**: lsxweb/sudoku

## Basic Information

- **Project Name**: 数独
- **Description**: 基于 舞蹈链算法 (Dancing Links X) 快速生成数独的迷题以及求解，并实现最基本的桌面端数独小游戏。后端golang，前端vue3，wails构建跨平台桌面端。
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-01-09
- **Last Updated**: 2025-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


<div align="center" style="text-align: center;">
    <img src="__img/logo.jpg"/>
</div>

<h1 align="center" style="text-align: center;">
    Sudoku
</h1>

<div align="center" style="text-align: center;">
    <a href="LICENSE">
        <img src="https://img.shields.io/badge/LICENSE-MIT-white.svg"/>
    </a>
    <img src="https://img.shields.io/badge/Go-1.22-blue.svg"/>
    <img src="https://img.shields.io/badge/Wails-2.8-red.svg"/>
    <img src="https://img.shields.io/badge/Vue-3.2-green.svg"/>
</div>

---

## 为什么开发此项目
开发这款数独游戏的背后，其实藏着一个有趣的小故事。
我的老爸老妈退休后，就像两个侦探一样，一头扎进了数独的谜团中。
他们每天都在房间里忙碌地破解着那些看似无序的数字组合，仿佛是在寻找什么宝藏。

而我得感谢我这位`侦探老爸`，他的数学逻辑和推理能力，就像魔法一样，一直默默地影响着我。
更神奇的是，这种魔力还传递给了我那只有5岁的`小侦探`儿子。
现在，这个`小侦探`也迷上了数独，整天拿着小铅笔在纸上涂涂画画，一副`福尔摩斯`附体的模样。

看到他们如此热衷于数独，我突然有了一个大胆的想法——为什么不亲自开发一款数独游戏呢？
这样，我们就可以在更广阔的数字世界里一起探险，共同破解更多的数独谜团了！
于是，我化身为`游戏开发者`，开始了一段充满挑战和乐趣的旅程。

现在，这款数独游戏已经准备就绪，就让我们一起在数字的海洋中畅游，用智慧和勇气去征服那些看似不可能的任务！

> 游戏主界面

![游戏主界面](__img/游戏主界面.jpg)

---

## 为什么开源此项目

当我跳入这个数独项目的坑时，没想到这竟然是个`深渊迷宫`！
从最初的`回溯小试`开始，我就像个小小探险家，试图解开这个谜一样的世界，
然后，我又遇到了传说中的`舞蹈链大挑战`，
它就像是个穿着芭蕾裙的精灵，优雅地在我眼前旋转，但我就是抓不到它的`舞步要领`！

不过，这可算是我第一个真正意义上的开源项目，对我而言，不仅仅是一个项目，
更是一场与数字、逻辑、还有我那不断挑战自我的勇气之间的`较量`。

所以，我在这里向各路大神发出邀请：
如果你也是数独的`狂热粉丝`，或者你有破解数独游戏的`独门秘籍`，
甚至你只是想来围观一下这场`数字大战`，
都联系我，欢迎一切助力，谢谢！

[ISSUES](https://gitee.com/fakis/sudoku/issues)
| [fakis738@qq.com](mailto:fakis738@qq.com)

---

## 游戏介绍
> 基于 `舞蹈链算法` (Dancing Links X)，可快速生成数独的迷题以及求解，实现最基本的数独小游戏

### 技术选型
- `Golang` 主要实现数独游戏的核心算法，包括数独的生成、解题、验证等。
- `Vue3` 主要实现数独游戏的界面，包括页面显示和游戏操作流程。
- `Wails` 主要以 `GO` 和 `WebView2` 技术，构建跨平台的桌面端应用。

### 思维导图
![思维导图](__img/思维导图.jpg)

### 流程图
![流程图](__img/流程图.png)

---

## 游戏页面

### 游戏主界面 / 游戏说明
<img src="__img/游戏主界面.jpg" width="48%">
<img src="__img/游戏说明.jpg" width="48%">

### 主菜单选择游戏难度级别 / 暂停游戏
<img src="__img/选择难度.jpg" width="48%">
<img src="__img/暂停游戏.jpg" width="48%">

### 挑战成功
<img src="__img/成功.jpg" width="48%">
<img src="__img/挑战成功.jpg" width="48%">

### 挑战失败
<img src="__img/失败.jpg" width="48%">
<img src="__img/挑战失败.jpg" width="48%">

---

## 运行此项目
### 克隆代码
将项目克隆到本地
```shell
git clone https://gitee.com/fakis/sudoku.git
```

### 安装Wails
开发环境未安装Wails的，需要先安装Wails Cli，如安装了可跳过此步骤
```shell
go install github.com/wailsapp/wails/v2/cmd/wails@latest
```

### 运行调试
```shell
wails dev
```

### 打包项目
```shell
wails build
```

---

## 相关链接
### 更新日志
[CHANGELOG.md](CHANGELOG.md)
### 开源协议
[MIT](LICENSE)