Support custom slime chunk patterns in CUDA finder

bench/README.md

@@ -1,6 +1,6 @@
 # slime-bench：普通分支全种子搜索基准
 
-指定中心区块、曼哈顿半径和实心 `n×n` 图案，搜索范围内每个锚点的全部有效种子，输出 JSON 结果及计时。支持 NVIDIA CUDA 单卡、多卡。
+指定中心区块、曼哈顿半径和自定义图案（或实心 `n×n`），搜索范围内每个锚点的全部有效种子，输出 JSON 结果及计时。支持 NVIDIA CUDA 单卡、多卡。
 
 ## 本地编译与运行
 
@@ -16,6 +16,37 @@ mkdir -p artifacts
 
 默认编译 `sm_86` 并附带 PTX，适合本机 RTX 3060 Laptop。换架构时用 `-B` 强制重建；仅改变 Make 变量不会使已有文件自动过期。
 
+## 自定义图案：6×6 苦力怕
+
+`--pattern` 接受 `/` 分隔的行，或用 `--pattern-file` 读取每行一排的文本文件。`#` 必须是史莱姆区块，`.` 必须不是，`?` 不限制。支持非正方形，宽、高分别为 1～64，至少含一个 `#`；不能与 `--size` 同时指定。不自动旋转或镜像。
+
+内置示例 [patterns/creeper-6x6.txt](patterns/creeper-6x6.txt) 将脸部像素设为史莱姆：
+
+```text
+##..##
+##..##
+..##..
+.####.
+.####.
+.#..#.
+```
+
+```sh
+./bench/bin/slime-bench --radius 512 \
+  --pattern-file bench/patterns/creeper-6x6.txt \
+  --position-batch 128 --max-results 100 --output artifacts/creeper.json
+
+# 也可直接输入；必须使用引号保护 #、? 等字符
+./bench/bin/slime-bench --radius 512 \
+  --pattern '##..##/##..##/..##../.####./.####./.#..#.' --max-results 100
+```
+
+目标是上面的正色模板：眼睛、鼻子和嘴巴为史莱姆区块，背景必须不是。已检查原点半径 2048、中心 `(51069,419124)` 半径 1024、32 个分散区域各半径 256、另外 128 个分散区域各半径 512；还筛选了 65,536 个坐标，选出低位候选最多的 64 个坐标类，检查这些类在世界边界内的全部 104,538 个实际位置。累计 82,047,228 次锚点检查仍未命中（不同路线可能重叠，见[搜索记录](results/creeper-6x6-search.json)）。这不证明正色不存在；不能用反色图案作为该目标的搜索结果。
+
+每行从左到右沿 `+X`，从上到下沿 `+Z`。返回坐标仍是矩形左上角，即使该格是 `.` 或 `?`。将 `.` 改为 `?` 可只要求轮廓、允许背景出现额外史莱姆区块。JSON 包含原始 `pattern` 行、宽高及两类约束数；自定义输入的 `square_size` 为 `null`。
+
+筛选和区间求解只使用 `#` 格，随后精确核对所有 `.` 格；`?` 不参与计算。稀疏图案的候选可能很多，搜索时间不能直接套用实心方阵的基准。搜索口径仍为普通分支，不包含拒绝重抽补扫。
+
 ## H100 服务器
 
 将仓库内的 `bench/` 和 `include/` 一起复制到服务器，保持相对路径；CLI 依赖 `include/slime/` 中的共用头文件。
@@ -53,7 +84,7 @@ abs(anchor_x - x) + abs(anchor_z - z) <= radius
 ```
 
 - `x,z,radius` 的单位都是区块，不是方块。
-- 锚点是图案最小 X、最小 Z 的角；图案沿 `+X,+Z` 延伸。
+- 锚点是图案最小 X、最小 Z 的角；图案沿 `+X,+Z` 延伸。自定义图案的锚点是外接矩形的角。
 - 半径限制锚点，图案允许超出菱形范围。
 - 不自动按世界边界裁剪；锚点和整块图案须在 int32 坐标范围内，否则报错。
 - `--size` 支持 1～6，默认 5。小尺寸匹配种子极多，全种子计数也可能耗时很久，不能用 1×1 推断 5×5 性能。
@@ -108,7 +139,7 @@ make -C bench test       # 无需 GPU：范围、输入、可变尺寸数学对
 make -C bench test-gpu   # 需要 GPU：实际搜索与文件输出验证
 ```
 
-验证内容包括：半径 0～64 的完整菱形枚举，较大半径抽样，1～6 中多个尺寸的组 mask 对照，已知 24 个命中，小根批分拆一致性，4×4 的全部 422 个示例经独立 Java 算法验证，6×6 的已知种子子集对照，以及半径 2 批量结果与全部 13 个位置分别搜索的完整列表一致。
+验证内容包括：自定义图案解析和边界、稀疏图案高位枚举对照、带忽略格及非史莱姆格的 GPU 结果与独立 Java 算法筛选对照，以及半径 0～64 的完整菱形枚举，较大半径抽样，1～6 中多个尺寸的组 mask 对照，已知 24 个命中，小根批分拆一致性，4×4 的全部 422 个示例经独立 Java 算法验证，6×6 的已知种子子集对照，以及半径 2 批量结果与全部 13 个位置分别搜索的完整列表一致。
 
 本机实测：RTX 3060 Laptop，中心 `(0,0)`，半径 512，5×5，`--position-batch 128 --repeat 3`。525,313 个锚点，三轮均有 368,935 个低位根任务、0 个命中，扫描墙钟中位数约 **3.990 秒**。原始 JSON 在 [results/local-r512-n5.json](results/local-r512-n5.json)。另有半径 64 的快速环境验证记录；其批大小为默认 32，与上述正式样例不同。