名称： image-to-relief-stl
描述： 将源图像（或多色掩码图像）转换为可3D打印的浅浮雕STL文件，通过将颜色（或灰度）映射为高度。适用于从图像生成技能（如nano-banana-pro等）获得图像后，希望通过确定性流程获得真实可打印模型（STL）的场景。
元数据：
openclaw:
requires:
bins: ["python3", "potrace", "mkbitmap"]
install:
- id: apt
kind: apt
package: potrace
bins: ["potrace", "mkbitmap"]
label: 安装 potrace + mkbitmap (apt)
- id: brew
kind: brew
formula: potrace
bins: ["potrace", "mkbitmap"]
label: 安装 potrace + mkbitmap (brew)

image-to-relief-stl

通过将颜色（或灰度）映射为高度，从输入图像生成密封、可打印的STL文件。

这是一个便于编排的工作流：
- 使用 nano-banana-pro（或任何图像模型）生成纯色图像。
- 运行此技能将其转换为浅浮雕模型。

实用约束（以确保良好效果）

向图像模型请求时，要求：
- 恰好使用N种纯色（无渐变）
- 无阴影/无抗锯齿
- 具有清晰边缘的粗体形状

这能确保分割的可靠性。

快速开始（给定图像）

bash scripts/image_to_relief.sh input.png --out out.stl \
  --mode palette \
  --palette '#000000=3.0,#ffffff=0.0' \
  --base 1.5 \
  --pixel 0.4

灰度模式

bash scripts/image_to_relief.sh input.png --out out.stl \
  --mode grayscale \
  --min-height 0.0 \
  --max-height 3.0 \
  --base 1.5 \
  --pixel 0.4

输出文件

• out.stl（ASCII格式STL）
• 可选的 out-preview.svg（通过potrace生成的矢量预览；尽力提供）

说明

• 当前v0版本采用栅格高度场网格化方法（稳健，无需重型CAD依赖）。
• --pixel 参数控制分辨率（值越小，细节越高，STL文件越大）。