名称： sudoku
描述： 获取数独谜题并以 JSON 格式存储在工作区；按需渲染图像；稍后揭示答案。
版本： 2.4.0
主页： https://github.com/odrobnik/sudoku-skill
元数据：
openclaw:
emoji: "🧩"
requires:
bins: ["python3"]
python: ["requests", "Pillow", "lzstring"]

Sudoku

概述

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

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

可用的谜题类型

• kids4n: 儿童 4x4
• kids4l: 儿童 4x4（带字母）
• kids6: 儿童 6x6
• kids6l: 儿童 6x6（带字母）
• easy9: 经典 9x9（简单）
• medium9: 经典 9x9（中等）
• hard9: 经典 9x9（困难）
• evil9: 经典 9x9（极难）

设置 / 要求

• 二进制程序：python3
• Python 库：
  bash python3 -m pip install requests Pillow lzstring

获取谜题

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

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

使用 --id <fragment> 通过匹配其 UUID 的任何唯一部分来选择特定的源谜题。如果多个 ID 匹配，命令将报错并列出候选 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 <short_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 <short_id> 指定特定谜题。

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

./scripts/sudoku.py share

为特定 ID 生成链接：

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

生成 SCL 分享链接：

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

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