数独

概述

获取、呈现并揭示数独谜题。使用sudoku.py从sudokuonline.io获取新谜题，生成可打印的PDF文件或图片，并揭示答案。

关于保存的JSON格式的详细信息，请参阅DATA_FORMAT.md。

可用的谜题类型

• kids4n：儿童4x4
• kids4l：带字母的儿童4x4
• kids6：儿童6x6
• kids6l：带字母的儿童6x6
• easy9：经典9x9（简单）
• medium9：经典9x9（中等）
• hard9：经典9x9（困难）
• 邪恶9：经典 9x9（邪恶难度）

设置/要求

• 二进制文件：python3
• Python 库：

  python3 -m pip install requests Pillow lzstring
  

获取谜题

获取一个新谜题并将其存储为 JSON 格式。默认输出为 JSON（使用--text选项可输出人类可读的格式）。

使用--count N可在一次调用中获取/存储多个谜题。如果一批中没有足够的新谜题，该命令将获取额外的批次，直到满足数量要求。

使用--id <片段>通过匹配其 UUID 的任何唯一部分来选择特定的源谜题。如果多个 ID 匹配，命令将报错并列出候选项。

获取一个经典简单难度的谜题：

./scripts/sudoku.py get easy9

一次获取多个新谜题（例如 4 个简单 9x9 谜题）：

./scripts/sudoku.py get easy9 --count 4

获取一个儿童 6x6 谜题：

./scripts/sudoku.py get kids6

渲染谜题

将谜题渲染为图像、PDF或极简HTML。

将最新谜题渲染为A4尺寸PDF（用于打印）：

./scripts/sudoku.py render --pdf

将最新谜题渲染为清晰的PNG图像（用于查看）：

./scripts/sudoku.py render

通过短ID渲染特定的先前谜题：

./scripts/sudoku.py render --id a09f3680

渲染极简HTML（方形单元格 + 粗体框线）：

./scripts/sudoku.py html --id a09f3680

显示答案

显示最新或特定谜题的答案。使用--id <短ID>（例如，a09f3680）来指定特定谜题。

显示完整答案为可打印的PDF：

./scripts/sudoku.py reveal --pdf

显示特定ID的完整答案：

./scripts/sudoku.py reveal --id a09f3680 --image

显示完整答案为PNG图像：

./scripts/sudoku.py reveal

显示单个单元格（第3行，第7列）：

./scripts/sudoku.py reveal --cell 3 7

显示特定的3x3宫格（索引5）：

./scripts/sudoku.py reveal --box 5

分享链接

为已存储的谜题生成分享链接。默认针对最新谜题；使用--id <短ID>来指定特定谜题。

生成一个SudokuPad分享链接（默认）：

./scripts/sudoku.py share

为特定ID生成链接：

./scripts/sudoku.py share --id a09f3680

生成一个SCL分享链接：

./scripts/sudoku.py share --type scl

Telegram格式提示：将链接格式化为短按钮式链接并隐藏完整URL：[简单经典 \[<id>\]](<url>)。