数独

概述

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

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

支持的谜题类型

• kids4n：儿童 4×4（数字版）
• kids4l：儿童 4×4（字母版）
• kids6：儿童 6×6（数字版）
• kids6l：儿童 6×6（字母版）
• easy9：标准 9×9（简单）
• medium9：标准 9×9（中等）
• hard9：标准 9×9（困难）
• evil9：标准 9×9（极难）

环境准备 / 依赖要求

• 二进制程序：python3
• Python 库：

  python3 -m pip install requests Pillow lzstring
  

获取谜题

获取一道新谜题并以 JSON 格式保存。默认输出为 JSON（使用 --text 可获得人类可读格式的输出）。

使用 --count N 可在一次调用中获取并保存多道谜题。若单批请求未返回足够数量的未见过谜题，命令将自动追加请求，直至满足数量要求。

使用 --id 可通过匹配其 UUID 的任意唯一片段来选择特定来源谜题。若多个 ID 匹配，命令将报错并列出所有候选 ID。

获取一道标准简易谜题：

./scripts/sudoku.py get easy9

一次性获取多道新谜题（例如：4 道简易 9×9 谜题）：

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

获取一道儿童 6×6 谜题：

./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 （例如 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

仅揭晓某个 3×3 宫格（索引为 5）：

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

生成分享链接

为已保存的谜题生成分享链接。默认作用于最新谜题；使用 --id 可指定特定谜题。

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

./scripts/sudoku.py share

为指定 ID 生成分享链接：

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

生成 SCL 分享链接：

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

Telegram 排版提示： 可将链接格式化为简洁按钮式链接，隐藏完整 URL： [Easy Classic []]()。