前言¶
做写字机(pen plotter / 绘图机)项目时,常见流程是:先把图片做矢量化,得到 SVG 路径,再把 SVG 转成 G 代码,最后送去机器执行。中间通常要跑好几样工具——追踪图片的脚本、转换 SVG 到 G 代码的库,可能还有手动调参数的环节。每一步的输入输出格式还不一样,串起来要花不少时间。
下面介绍的这个 Skill 把这条链路压成一步:你给它一个图片路径,它同时产出一个 SVG 矢量图和一个用于写字机绘图的 G 代码文件,两个文件放在同一目录下。对想快速验证「这张图能不能被写字机画出来」的人来说,省掉了搭流水线的成本。
这是什么¶
Skill 名称是「图片转 SVG 并生成 G 代码」,坐标 @user_baad803c/img-to-gcode,版本 1.0.0,由社区开发者 user_baad803c 发布和维护,归类在 dev-programming 下,来源标记为 community。
它解决的问题很具体:给定一张图片,产出绘图机可直接使用的 G 代码,同时保留一份 SVG 作为中间结果,方便后续人工查看或再加工。
按页面标签,该 Skill 不需要 API Key(requires_api_key=false)。
核心功能¶
这个 Skill 的能力边界在官方简介里写得很明确,一共两件事:
1、生成一个 SVG 矢量图。
2、生成一份 G 代码,用于写字机绘图。
输入是图片路径,输出是同目录下的 SVG 和 G 代码两个文件。资料中没有提到额外的参数选项(比如线宽、速度、压力、层数等),也没有提到支持批量目录处理,因此这些能力不要假设它具备。
安装与启用¶
官方页面提供了 SkillHub 上的坐标和地址:
名称: 图片转 SVG 并生成 G 代码
坐标: @user_baad803c/img-to-gcode
版本: 1.0.0
分类: dev-programming
来源: community
地址: https://api.skillhub.cn/user_baad803c/img-to-gcode
页面: https://www.skillhub.cn/skills/user_baad803c/img-to-gcode
需要说明的是,抓取到的官方资料里没有给出具体的安装命令(例如 npx / claude / codex 之类),也没有写出配置文件路径和字段名。因此这里不臆造命令。你在对应客户端里按照 SkillHub 的通用安装方式添加这个坐标即可;如果安装时遇到差异,以官方页面的最新说明为准。
该 Skill 基于通用 SKILL.md 格式,理论上适用于支持这一格式的 Agent 客户端,但具体在哪个客户端上可用,资料中未明确,需要自行确认。
典型用法¶
官方简介给出的使用方式是:复制图片路径,提交。
也就是说,调用时你要做的是把图片的路径传给它,例如本机某个图片文件的位置:
输入: /path/to/your/image.png
提交之后,它会在同一目录下返回两个产物:
输出: /path/to/your/image.svg
/path/to/your/image.gcode
如果你的需求正好是「拿一张图试试写字机能不能画」,这一步就够了:拿到 G 代码之后可以直接送到写字机执行,拿到 SVG 之后可以打开看路径是否合理。
资料中没有提供更复杂的示例(比如多图批量、指定画笔颜色或纸张尺寸),所以上面的流程就是目前能核实到的全部用法。
适用场景与注意¶
适合的场景:
- 想快速判断一张图片能否被写字机正确绘制,不需要先搭一套矢量化和代码转换的工具链。
- 只需要 SVG 中间产物和对应的 G 代码,不打算做深度定制。
- 不想填写 API Key,希望本地直接跑通。
需要注意的地方:
- 资料中只提到了「提交图片路径」,没有说明图片格式支持范围(常见如 PNG、JPEG、JPG 等是否都在支持列表里)。用之前先用一张图试一下,确认能正常出文件。
- 没有提到对图片复杂度或分辨率的限制。图片里线条太密或对比度太低,矢量化结果通常不会理想,这种情况下 SVG 和 G 代码的质量都会受影响。
- 该 Skill 只负责转换,不负责把 G 代码发给机器,也不负责绘图效果的后期调优。如果画出来的位置或比例不对,需要自己调整输入图片或后续参数。
- 版本是 1.0.0,说明还比较早期,功能和稳定性可能后续会有变化,建议关注页面上的版本更新。
结语¶
一句话回顾:它把「图片 → SVG → 写字机 G 代码」这条链路收成了一步,输入一个图片路径,输出同目录下的 SVG 和 G 代码,不需要 API Key。对于想快速验证写字机绘图效果的场景,这是一个可以直接上手的小工具。
官方地址:https://api.skillhub.cn/user_baad803c/img-to-gcode
SkillHub 页面:https://www.skillhub.cn/skills/user_baad803c/img-to-gcode