SuperAPI AI 工具集

validate-piles-notation

通用与其它

查看项目

更新于 10-16 03:43

技能介绍

用途:在把用户提供的 PILES 字符串传给 generate_puzzle() 之前进行校验,调试融合组问题,向用户解释记法,以及测试解析与序列化的往返一致性。

主要能力:validate_piles_syntax() 检查语法(括号不匹配、非法字符、空组等);parse_piles() 将字符串解析为整数向量列表,如 "1-2-3,4-5" 得到 list(c(1,2,3), c(4,5)),"1:6,7-8" 中冒号表示含端点的范围;parse_fusion() 可结合拼图结果对象自动识别格式并解析关键词;to_piles() 将组列表转回 PILES 字符串。

使用方式:先做语法校验,再解析为组,必要时用拼图结果对象校验拼块 ID 是否存在、关键词是否可解析、融合拼块是否相邻,最后做往返序列化验证,要求 identical(groups, groups2) 为 TRUE。关键词如 center、ring1、R1、boundary 需要拼图上下文,应传给 parse_fusion() 而非 parse_piles()。

适用场景:拼图生成前的输入校验、融合组调试、向非技术用户解释记法、解析与序列化一致性测试。

限制:拼块 ID 从 1 开始;融合非相邻拼块虽可运行但可能产生意外视觉效果;关键词缺少拼图上下文时无法解释;序列化可能规范化记法(如排序或展开范围),只要组列表一致即可接受。相关技能包括 generate-puzzle、add-puzzle-type、run-puzzle-tests。