源码已开源,基础包(v1.0)从 GitHub Releases 免费下载;付费档属于自愿支持,拿到的是持续更新的最新版。
9号造物 STL 转换工具:把一张线稿变成能 3D 打印的浮雕
本项目已开源:源代码托管在 GitHub(starxxy/9haozaowu-stl-converter)。 ⚠️ GitHub Releases 已同步 v1.1 安装包 —— 版本首发与更新记录都在本站:新版本、版本记录与下载说明第一时间在这里发布;GitHub 上的 v1.0 保留不动,代码与发布包持续同步。
做掐丝珐琅(景泰蓝)或者平面浮雕,卡人的往往不是手上的功夫,而是从一张图到一块能打印的模型这一步:图是平面的,打印机要的是立体的,中间得有人把轮廓描出来、拉出厚度、再修成能切片的网格。
这个工具就是把这段路走完:导入一张线稿或照片,实时预览提取效果,一键生成带底板、带包边的可打印模型,导出 STL 后直接送进 Bambu Studio 切片。
它是 PyQt6 + OpenCV + trimesh + pymeshlab 写的原生桌面程序,Windows 10 / 11 x64 可用,发布版 exe 不需要装 Python。

下载与支持
⬇ GitHub Releases 免费下载(v1.1) ☕ 支持开发 ¥2.90(含安装包 · 持续更新) 🛠 Win11 安装被拦截?看这篇引导
软件免费提供 —— 源码在 GitHub 上公开,安装包也能从 Releases 下载。付费档属于自愿支持:
- ¥2.90 支持开发(含安装包 · 持续更新):付款后页面直接给出安装包下载链接(不是发邮箱、不用等你确认), 拿到的是本站最新版,走阿里云 OSS 直连(国内比 GitHub 快很多);这笔钱用于服务器与 OSS 下载的流量和维护成本。
- 一次性支持,不含订阅、不会过期;后续每个新版本都从本站拿。
它解决的是哪一段
整条流程可以拆成四步,每一步都能自己调:
| 环节 | 做什么 | 关键点 |
|---|---|---|
| 图像 → 轮廓 | 线稿走二值化 / 自适应阈值,照片走 Canny 边缘检测 | 阈值、反色、Canny 上下限、闭运算、膨胀、线宽、平滑、缩放都能调,改完即时预览 |
| 轮廓 → 三维 | 轮廓多边形化后拉伸成实体网格 | 底板可「跟随轮廓」或自动/自定义圆形、矩形;包边留白间隙可调 |
| 模型处理 | 网格自检与修补、按比例减面 | 基于 pymeshlab 修非流形、破洞、法线;抽面可保留边界 |
| 导出与联动 | 导出 .stl,一键在 Bambu Studio 中打开 | 自动搜索常见安装路径与注册表 |
尺寸不是”看起来差不多”:像素 → 毫米的换算基于可配置 DPI,你设 96 DPI 还是 300 DPI,成品实际多大就是多大。这对掐丝这种对线宽和成品尺寸都敏感的手艺很关键。

两种输入模式,别选错
这是最容易踩的一步,模式选错提取结果会差很多:
- 线稿模式:适合白底黑线的矢量风格图。走二值化 / 自适应阈值,线条干净、边缘锐利,是掐丝图案最常用的模式。
- 照片模式:适合灰度连续的真实图片。走 Canny 边缘检测,把明暗过渡转成轮廓。
💡 没有合适的线稿图?软件左侧内置了「AI 出图助手」:一键复制一段专门写给图像生成模型的提示词(纯黑线、纯白底、3–6px 匀线宽、线条闭合形成封闭填色格、无灰阶无水印、四周留白适合圆角矩形底板),贴到即梦 / 豆包 / ChatGPT / 通义万相任意一个,让它帮你出一张合格的线稿,再回本软件生成。
底板与包边
这两个是浮雕类的刚需,单独做了一组参数:
- 底板:先把模型外轮廓桥接闭合、填掉内部封闭孔洞,再按实心外轮廓向下拉伸——出来的是一块能真正承托图案的实心底板,不是只有镂空线条。形状可以跟随轮廓,也可以指定圆形 / 方形 / 长方形并自动或手动定尺寸;底板高度、外沿延伸量(margin)都可调。
- 包边:只沿最外圈轮廓外侧生成一圈与图案线宽相同的凸起线条,内部每个孔洞不会再各围一圈;间距可调。做珐琅掐丝的时候,外框这一圈往往决定成品像不像”有边”。
模型处理:修复与抽面
生成的网格面数经常很大(一张复杂图案轻松上十万面),切片器不一定吃得消。所以内置了两个动作:
- 一键修复:基于 pymeshlab 做网格自检与修补 —— 非流形边、破洞、法线朝向等,一次过一遍。
- 按比例简化(抽面):指定目标面数百分比,在保留边界的前提下做 Quadric Edge Collapse 减面,显著降低切片负担。
实测参考:一张 887×1774 的复杂中式线稿,提取出 35 个轮廓区域,生成的网格是 60,596 顶点 / 121,212 面,一次生成完成,可在视口里直接旋转检查。
怎么用
- 拿安装包:GitHub Releases 有 v1.1(187.2 MB);要国内快速下载、拿本站最新版,从商店「支持开发 ¥2.90」拿;
- 解压到任意英文路径目录(exe 为单文件打包,首次启动要解包到临时目录,等几秒是正常的);
- 双击
9号造物stl转换工具.exe; - 导入图片 → 选线稿 / 照片模式 → 调阈值与线宽 → 生成网格 → (可选)修复 / 抽面 → 导出 STL → 送入切片软件。
⚠️ 首次运行可能被拦:exe 没有数字签名,全新安装的 Win11 可能被「智能应用控制」拦下(症状是双击没有任何反应), 按 Win11 智能应用控制安装引导 里的 6 步处理即可。 PyInstaller 打包的程序也常被杀毒软件误报,添加信任即可。
系统要求
- Windows 10 / 11,x64
- 显卡支持 OpenGL 2.1 及以上(没有独显会自动回退软件渲染)
- 发布版 exe 内置全部依赖,不需要装 Python;从源码运行则需要 Python 3.12
关于收费
软件本身免费提供,没有试用期、没有功能锁 —— 源码在 GitHub 上公开,安装包也能从 Releases 下载。
商店里的「支持开发 ¥2.90」是给愿意支持的人准备的,点下面这行直接进收银台:
付款后页面直接给出安装包下载链接,这笔钱用来覆盖服务器与 OSS 下载的流量和维护成本。一次性支持,不含订阅、不会过期;后续每个新版本都从本站拿(国内 OSS 直连,下载更快)。
也可以先看看商品页再决定 —— 本站拿到的是最新版,付款即出链接。
从源码运行 / 自行打包
# 建议 Python 3.12pip install -r requirements.txtpython main.py打包(仓库内的 spec 可移植,不含任何开发机绝对路径):
pip install pyinstallerpyinstaller 9号造物stl转换工具.spec --noconfirm产物在 dist/9号造物stl转换工具.exe。spec 里做了两类瘦身且不影响功能:排除与本作无关的第三方大包(torch / paddle / transformers 等),以及剔除运行期永不加载的死重(旧版 FFmpeg DLL、AVIF 插件、Qt PDF、pymeshlab 测试网格与静态库)。
依赖版本(打包时锁定)
| 依赖 | 版本 | 用途 |
|---|---|---|
| PyQt6 | 6.11.0 | 图形界面 |
| PyOpenGL | 3.1.10 | 三维视口渲染 |
| opencv-python | 4.13.0.92 | 图像处理与边缘提取 |
| numpy | 2.2.6 | 数值计算 |
| scipy | 1.14.1 | 科学计算支撑 |
| trimesh | 4.5.3 | 网格构建与导出 |
| pymeshlab | 2025.7.post1 | 网格修复与抽面 |
| shapely | 2.0.6 | 轮廓多边形运算 |
| manifold3d | 3.5.1 | 布尔运算引擎 |
| Pillow | 12.2.0 | 图像读写 |
版本记录
| 版本 | 时间 | 关键变化 |
|---|---|---|
| 1.1 | 2026-10-17 | 底板与包边改为基于实心外轮廓生成:底板不再只是镂空线条、而是能真正承托的实心面,「跟随轮廓」下会把断开的线段桥接、填掉封闭孔洞;包边只沿最外圈围一圈(不再给每个内部孔洞各围一圈)。另外重写了「AI 出图助手」的线稿提示词(按掐丝珐琅工艺:封闭掐丝格、3–6px 匀线宽、圆角矩形留白),并恢复软件图标 |
| 1.0 | 2026-10-12 | 首个发布版:Windows 单文件 exe,两种输入模式、底板与包边、网格修复与抽面、导出 STL、一键送 Bambu Studio |
官方频道
- B 站:https://space.bilibili.com/50622066
- MakerWorld(中国):@9hao
- MakerWorld(国际):@stary19
有问题、有需求,或者想要别的功能,去留言页告诉我 —— 留言只有我看得到。