用户手册：QSUDOKU

1 简介

1.1 概述

QSUDOKU 是一个拥有简易图形界面的能够生成数独游戏并求解数独问题程序。

1.2 功能

1. 生成不重复的数独终局；
2. 读取文件内的数独问题，求解并将结果输出至文件；
3. 根据传入参数可调整指定路径、生成数量、难度、挖空范围等生成条件；
4. 用户在简单图形界面上可以对谜题进行填空，完成后程序提供正确/错误信息。

1.3 系统要求

运行环境为 64-bit Windows 10。

2 使用说明

2.1 直接运行

qsudoku.exe [gui]

弹出图形界面为随机生成的一个数独题目，用户可使用鼠标选择方框，点击右侧数字进行填入。完成后会在标题界面输出成功/失败信息。

2.2 生成数独终盘

qsudoku.exe -c 需要的数独终盘数量

-c 范围：1-1000000。

结果包括数独游戏和数独游戏的解。输出到 puzzle.txt 文件。

2.3 生成数独问题

qsudoku.exe -n 需要的游戏数量

-n 范围：1-10000。

结果输出到 puzzle.txt 文件。

2.3.1 参数说明

可选参数：

-m：生成游戏的难度，难度界定为 1-3 级，等级 1 挖空范围为 20-30，等级 2 挖空范围为 31-40，等级 3 挖空范围为 41-50。必须和参数 -n 一起使用，不得与参数 -r -t 一起使用。范围：1-3。

-r：生成游戏中挖空的数量下界。必须和参数 -n -t 一起使用，不得与参数 -m 一起使用。范围：20-55，且保证小于等于 -t 的参数。

-t：生成游戏中挖空数量的上界。必须和参数 -n -r 一起使用，不得与参数 -m 一起使用。范围：20-55，且保证大于等于 -r 的参数。

-u：生成游戏的解唯一。必须和参数 -n 一起使用。

2.3.2 示例

qsudoku.exe -n 1000 -m 1

表示生成 1000 个数独游戏，难度为等级 1。

qsudoku.exe -n -20 -r 20 -t 55

表示生成 20 个数独游戏，挖空范围为 20-55。

qsudoku.exe -n -20 -u

表示生成 20 个解唯一的数独游戏。

2.4 求解数独问题

qsudoku.exe -s 需要解的数独棋盘的文件路径

-s 范围：绝对或相对路径。

结果输出到 sudoku.txt 文件。

3 版本历史

github