什么是 trace-to-svg？

trace-to-svg 工具是 Openclaw Skills 生态系统中一个强大的实用程序，旨在弥合位图图像与矢量图形之间的差距。通过利用 potrace 和 mkbitmap 的强大功能，此技能允许用户和 AI 代理以编程方式将 PNG 和 JPEG 等位图图像转换为高质量的 SVG 路径。

该技能在处理高对比度形状、标志和剪影方面特别有效，使它们能够直接用于下游应用。无论您是在为网页设计准备素材，还是为 CNC 和激光切割生成可制造的轮廓，trace-to-svg 都能提供现代 Openclaw Skills 集成所需的精度和自动化。

下载入口:https://github.com/openclaw/skills/tree/main/skills/ajmwagar/trace-to-svg

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

trace-to-svg 应用场景

• 将旧版位图标志转换为适用于网页和打印的可缩放矢量图形。
• 从手绘草图或参考图像中提取纯净轮廓，用于数字绘图。
• 对剪影图像进行预处理，以便在 create-dxf 等面向 CAD 的 Openclaw Skills 中使用。
• 自动从位图源生成可直接用于制造的矢量路径。

1. 输入的位图（PNG、JPG 或 WebP）首先由 mkbitmap 处理，以优化对比度并减少背景噪声。
2. potrace 引擎分析优化后的位图，以识别并追踪几何边界。
3. 应用用户定义的参数，如阈值和噪声抑制（turdsize），以细化路径精度。
4. 工具输出一个标准化的 SVG 文件，其中包含一个或多个代表原始图像剪影的路径元素。

trace-to-svg 配置指南

要使用此技能，您必须安装 potrace 和 mkbitmap 依赖项。这些是这些 Openclaw Skills 核心功能的必备条件。

在 macOS 上（通过 Homebrew）：

brew install potrace

在 Linux 上（通过 APT）：

sudo apt-get update && sudo apt-get install potrace

基本用法：

bash scripts/trace_to_svg.sh input.png --out out.svg

trace-to-svg 数据架构与分类体系

trace-to-svg 工具生成的矢量数据可无缝拟合到自动化设计流水线中。其输出结构便于提取路径数据。

使用这些 Openclaw Skills 时，生成的 SVG 路径可以直接映射到其他技术绘图工具中的属性。

name: trace-to-svg
description: Trace bitmap images (PNG/JPG/WebP) into clean SVG paths using potrace/mkbitmap. Use to convert logos/silhouettes into vectors for downstream CAD workflows (e.g., create-dxf etch_svg_path) and for turning reference images into manufacturable outlines.
metadata:
  openclaw:
    requires:
      bins: ["potrace", "mkbitmap"]
    install:
      - id: apt
        kind: apt
        package: potrace
        bins: ["potrace", "mkbitmap"]
        label: Install potrace + mkbitmap (apt)
      - id: brew
        kind: brew
        formula: potrace
        bins: ["potrace", "mkbitmap"]
        label: Install potrace + mkbitmap (brew)

trace-to-svg

Convert a bitmap into a vector SVG using mkbitmap + potrace.

Quick start

# 1) Produce a silhouette-friendly SVG
bash scripts/trace_to_svg.sh input.png --out out.svg

# 2) Higher contrast + less noise
bash scripts/trace_to_svg.sh input.png --out out.svg --threshold 0.6 --turdsize 20

# 3) Feed into create-dxf (example)
# - set create-dxf drawing.etch_svg_paths[].d to the SVG path `d` you want, or
# - store the traced SVG and reference it in your pipeline.

Notes

• This is best for logos, silhouettes, high-contrast shapes.
• For photos or complex shading, results depend heavily on thresholding.
• Output is usually one or more elements.