SuperAPI AI 工具集

add-puzzle-type

通用与其它

查看项目

更新于 10-16 03:42

技能介绍

用途:在 jigsawR 包中完整添加一种全新拼图类型,按 CLAUDE.md 的 10 点管线清单,把新类型从头到尾接入所有集成点,避免遗漏。

主要能力:步骤 1 创建 R/<type>puzzle.R,实现 generate<type>pieces_internal(params, seed),返回含 pieces、edges、adjacency、metadata 的列表,可参考 R/voronoi_puzzle.R 或 R/snic_puzzle.R。步骤 2 在 R/jigsawR_clean.R 的 valid_types 中登记类型、提取参数、校验约束并映射文件名前缀。步骤 3 在 R/unified_piece_generation.R 添加分发分支及 PILES 融合处理。步骤 4 在 R/piece_positioning.R 添加定位分发。步骤 5 在 R/unified_renderer.R 添加渲染与 get<type>edge_paths()、get<type>piece_name()。步骤 6 在 R/adjacency_api.R 让 get_neighbors()、get_adjacency() 支持新类型。步骤 7 在 R/geom_puzzle.R 用 make_puzzle_layer() 工厂创建 geom_puzzle<type>()。步骤 8 在 R/stat_puzzle.R 添加 stat 分发与默认参数。步骤 9 更新 DESCRIPTION(Description、Suggests、Collate)。步骤 10 更新 inst/config.yml 的默认值与约束。步骤 11 扩展 inst/shiny-app/app.R 的 UI 与 server。步骤 12 创建 tests/testthat/test-<type>-puzzles.R。

必要用法:需提供小写类型名、几何描述、是否需外部包(加入 Suggests),可选额外参数、参考实现。输入“<type>”为占位符,实际使用时替换。验证包括 generate_puzzle(type = "<type>") 可用、devtools::test() 通过、devtools::check() 无错误无警告、Shiny 可渲染、配置约束生效、邻接与融合正确、document() 成功。

限制与注意:易漏分发导致静默失败或 unknown type;用 paste 拼邻接键遇负数会产生如 1--1,建议用 | 分隔并以 \| 拆分;日志用 cli 包装(log_info 等)而非 cat();Collate 须按字母或依赖顺序。外部依赖缺失时测试应 skip_if_not_installed()。