# 数独

**Repository Path**: shanewa/sudoku

## Basic Information

- **Project Name**: 数独
- **Description**: 四宫数独：一个专注于数独游戏的开源项目，提供算法解析、生成及验证功能，适合教育与娱乐应用。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 四宫数独出题项目

用于生成可直接打印的四宫数独题单（A4），支持标准数独、不规则数独、对角线数独，并同时输出题目与答案 PNG。

## 快速开始

1. 安装依赖：
   - `npm install`
2. 修改配置：
   - `scripts/sudoku-config.js`
3. 生成题单：
   - `node scripts/generate-sudoku.js`

生成完成后，题目与答案会输出到 `模拟题/` 目录。

## scripts 使用说明

### `scripts/sudoku-config.js`

这个文件控制出题规则、输出命名和版式。

- `generator`：题目生成参数
  - `palaceCount`：宫数（当前内置为 `4`）
  - `difficulty`：`easy` / `normal` / `hard`
  - `setCount`：连续生成多少套题
  - `maxGivensByDifficulty`：不同难度对应的最大已知数
  - `typeCounts`：每套题的题型分配与顺序（当前为 `standard 6 -> irregular 1 -> diagonal 1`）
  - `randomSeed`：随机种子（相同配置可复现）
- `output`：输出控制
  - `directoryName`：输出目录名
  - `questionPrefix` / `answerPrefix`：题目与答案文件名前缀
  - `startSetNumber`：起始套号
  - `generateAnswerSheet`：是否生成答案图
  - `pngWidth`：PNG 宽度像素
- `layout`：A4 排版参数
  - 页面尺寸、边距、列数、间距、棋盘尺寸、线宽等

### `scripts/generate-sudoku.js`

读取配置并执行完整生成流程：

- 校验配置合法性
- 按题型数量生成题目（保证唯一解）
- 渲染为 A4 SVG 后转 PNG
- 输出题目图与答案图

文件命名已包含难度，格式如下：

- 题目：`<questionPrefix>-<难度>-<套号>.png`
- 答案：`<answerPrefix>-<难度>-<套号>.png`

例如：`四宫数独模拟题-中等-1.png`

## 目录说明

- `scripts/`：生成脚本与配置
- `模拟题/`：生成结果（PNG）
- `比赛要求/`：比赛规程与原图
- `数独技巧/`：解题技巧文档

## 相关文档

- 比赛规程：[`比赛要求/README.md`](./比赛要求/README.md)
- 解题技巧：[`数独技巧/四宫数独解题技巧.md`](./数独技巧/四宫数独解题技巧.md)