用途:该技能用于调用 jigsawR 包统一 API 生成拼图 SVG 文件,适合按指定类型与配置制作拼图、测试不同参数、为文档或演示生成样例,以及用 geom_puzzle_*() 创建 ggplot2 拼图可视化。
主要能力与输入:必需参数为拼图类型(rectangular、hexagonal、concentric、voronoi、random、snic)和网格维度(矩形等用 c(cols, rows),六边形与同心圆用 c(rings));可选参数包括尺寸(mm,默认随类型变化)、随机种子(默认 42)、偏移量(0 为互锁,大于 0 为分离)、布局(矩形可为 grid 或 repel)以及融合组(PILES 记法字符串)。不同类型还支持 tabsize、n_interior、do_warp、do_trunc、center_shape、compactness 等额外参数。
使用方式:先读取 inst/config.yml 确认所选类型的 grid、size、tabsize 等参数合法范围,再把请求映射为 generate_puzzle() 参数;建议把 library(jigsawR) 和生成调用写入 R 脚本文件,避免复杂 -e 命令的 shell 转义问题。通过 WSL 执行 Rscript,例如 R_EXE="/mnt/c/Program Files/R/R-4.5.0/bin/Rscript.exe" 后跟脚本路径。生成后检查 output/ 下 SVG 是否存在、内容是否以 <?xml 或 <svg 开头、拼块数是否符合网格公式,并确认相同种子输出一致。
限制与注意:不要使用 --vanilla 标志,以免破坏 renv 激活;网格表示拼块数量,尺寸是物理毫米,两者不可混淆;snic 类型需安装 snic 包;若结果对象中 $files 为空,可用 writeLines(result$svg_content, "output/puzzle.svg") 显式保存。具体默认值与约束以项目 inst/config.yml 为准。