Sudoku

核心功能

sudoku skill 是一款面向数独爱好者的 Python 命令行工具，通过与 sudokuonline.io 网站集成，提供完整的题目获取、渲染、分享和解答流程。核心工作流包括：get 抓取并存储题目为本地 JSON，render 生成可打印的 A4 PDF 或 PNG 图像，reveal 按需揭示完整解答或指定单元格/宫格，以及 share 生成 SudokuPad 或 SCL 格式的在线分享链接。

显著优点

• 丰富的题型支持：涵盖从儿童 4×4/6×6（含字母变体）到经典 9×9 的四种难度（Easy/Medium/Hard/Evil），满足全年龄段需求
• 灵活的输出格式：支持 PDF（打印优化）、PNG（ clean 图像）、HTML（带粗线边框的轻量网页）三种渲染方式
• 精细的解答控制：除完整解答外，支持单 cell 或单 box 的局部揭示，便于教学或自我挑战
• 批量与精准获取：--count 支持批量抓取，--id 支持 UUID 片段精准定位历史题目
• 分享生态集成：原生支持 SudokuPad 和 SCL 两大主流数独平台的链接生成

潜在局限

• 外部依赖强：核心数据来源于单一第三方网站 sudokuonline.io，若该站服务变更或关闭将导致功能失效
• 网络与解析风险：依赖 requests 进行 HTTP 抓取和 lzstring 进行数据解压，存在解析逻辑被恶意输入利用的潜在面
• 无本地生成算法：题目非本地算法生成，无法实现离线无限题库或自定义难度参数
• 格式锁定：JSON 存储结构固定，与其他数独软件的数据交换可能需要手动转换

适合人群

数独教学者、出版物编辑、休闲玩家及需要批量获取标准化题目的内容创作者。尤其适合需要打印友好格式或在线分享链接的场景。

常规风险

• 供应链风险：依赖的 lzstring 为较冷门压缩库，维护活跃度低于主流库
• 隐私泄露：分享链接生成时可能向第三方平台暴露题目数据
• 持久化风险：本地 JSON 文件若未妥善管理，可能导致历史解答记录残留

核心用法

该 Skill 通过 Python 脚本提供完整的数独工作流：

1. 获取谜题：./scripts/sudoku.py get <type> 从 sudokuonline.io 拉取谜题，支持 4×4/6×6/9×9 多种难度（kids4n 至 evil9），JSON 格式本地存储。
2. 渲染输出：render 子命令生成 PNG 图片或 A4 PDF；html 子命令输出带粗线边框的精简网页，便于打印或屏幕阅读。
3. 揭晓答案：reveal 支持整板揭晓、单格揭晓（--cell row col）或单宫揭晓（--box index），兼顾学习对照与作弊需求。
4. 分享链接：内置 SudokuPad 与 SCL 两种分享格式，一键生成可粘贴的 Markdown 链接。

批量获取（--count）、ID 精确匹配（--id <fragment>）等设计提升了实用性。

显著优点

• 功能聚焦：单一职责，边界清晰，无冗余代码。
• 安全透明：MIT 协议开源，知名作者维护；静态/动态扫描均无高危发现，无 eval/exec/system 调用。
• 离线友好：谜题落盘为 JSON，渲染纯本地，分享链接生成亦不依赖敏感数据上传。
• 跨场景覆盖：从儿童启蒙（字母版 4×4）到硬核挑战（Evil 9×9），从屏幕查看到实体打印，需求全覆盖。

潜在局限

• 平台小瑕疵：字体路径硬编码为 macOS Helvetica，非 macOS 环境可能回退至默认字体，影响打印美观度。
• 网络单点：谜题源仅 sudokuonline.io，若服务不可用则无法获取新题（本地已存谜题不受影响）。
• 无协作功能：无实时对战、无多用户进度同步，纯单机体验。

适合人群

数独爱好者、需要 printable 作业纸的教师、追求离线解谜的隐私敏感用户，以及希望学习“干净 Python 脚本结构”的开发者。

常规风险

• 信息泄露风险极低：不读取环境变量密钥，不向第三方传输用户行为数据。
• 供应链风险可控：依赖 requests/Pillow/lzstring 均为成熟库，无已知 CVE。
• 建议：生产环境部署时仍可配置出站防火墙仅放行 sudokuonline.io 与 sudokupad.svencodes.com，进一步缩小攻击面。