从 sudokuonline.io 获取数独谜题，支持 4×4/6×6/9×9 多种难度，可渲染为 PDF/PNG/HTML 并分步揭示答案，适合休闲解谜与教学打印。
说明：
## 核心用法
Sudoku Skill 是一款基于 Python 的数独工具，通过命令行接口与 `sudokuonline.io` API 交互，实现谜题获取、渲染输出和答案揭示三大功能。
**获取谜题**：支持 8 种规格（4×4/6×6/9×9 数字/字母版，及四种经典难度），可批量获取（`–count N`）或通过 UUID 片段精准定位（`–id `）。数据以 JSON 格式持久化存储，便于后续操作。
**渲染输出**：提供三种格式——A4 PDF（打印优化）、PNG 图片（屏幕查看）、极简 HTML（网页嵌入）。支持按 ID 回溯渲染历史谜题。
**揭示答案**：灵活度高，可输出完整解答（PDF/PNG/单图），也可按需揭示单格（`–cell row col`）或单宫（`–box index`），适合教学场景的分步引导。
**分享功能**：生成 SudokuPad 或 SCL 格式的在线分享链接，支持 Telegram 的按钮式短链接排版。
## 显著优点
– **多格式覆盖**：打印、屏幕、网页三种场景兼顾，PDF 排版简洁专业
– **难度梯度完整**：从儿童版到 Evil 难度，满足不同水平玩家
– **精准回溯**：UUID 片段匹配机制，避免全 ID 输入的繁琐
– **分步揭示**：单格/单宫揭示功能，优于传统「全或无」的答案模式
– **零配置依赖**：仅需标准 Python3 与三个常见库（requests/Pillow/lzstring）
## 潜在缺点与局限性
– **网络依赖**：谜题源绑定 sudokuonline.io，离线无法获取新题
– **无原生求解器**：仅能揭示预存答案，无法对用户自定义谜题进行求解验证
– **ID 冲突风险**：UUID 片段匹配在大量存储时可能产生歧义，需二次确认
– **渲染定制有限**：字体、颜色、格子大小等视觉参数不可调
– **社区支持弱**：GitHub 仓库星标少，长期维护存在不确定性
## 适合人群
– 数独爱好者（尤其是需要批量打印的教练/教师）
– casual 玩家：偏好「获取-解答-对答案」的轻量流程
– 内容创作者：需要生成标准化谜题图片或分享链接
## 常规风险
– **网络请求风险**：向第三方站点发送请求，存在隐私泄露与可用性依赖
– **依赖库安全**：Pillow 处理图像时可能受恶意构造图片攻击（历史 CVE 存在）
– **数据持久化**：JSON 文件权限若配置不当，可能导致谜题数据被其他进程读取
– **供应链风险**：pip 安装的依赖包存在被投毒可能，建议使用虚拟环境与哈希校验
会员专属
