1. 从手工劳动到数字设计：artcraft 的起点
artcraft 这个名字，最初是我在一次手工市集摆摊后随手起的代号。当时我正被一批定制拼布图案折磨得够呛：图案在图纸上画得好好的，一到实际裁布、对花、拼接，针脚和缝份就会让纹样变得歪歪扭扭。市集结束后我把图纸、样布、剪刀、直尺摊了一桌子，突然意识到——我真正缺的不是手工技巧，而是一套能让我在“屏幕上的精度”和“手里的误差”之间自由换算的工作流。
于是我花了几个月时间，把零散代码收拢成一套名为 artcraft 的工具链。它能做三件事：用参数化方式生成纹样；把纹样映射到不同材质与工艺参数上；输出可以直接拿去裁切、刺绣、印刷或雕刻的工艺文档。对独立创作者来说，它像一个“手工艺放大器”——你不需要掌握复杂的绘图软件，也不需要重新学习数学，只要给定几个关键参数，就能得到精确到毫米、可复现的工艺图纸。
如果你是做拼布、刺绣、木工、皮革、热转印、激光切割这类手工艺的人，或者你只是喜欢用代码生成视觉图案，那这套思路都值得参考。这篇记录不是广告，也不打算教你怎么装一个现成软件，而是把我在设计 artcraft 时踩过的坑、做过的取舍、以及最终跑通的流程摊开来讲。
2. 整体设计思路：把工艺问题拆成“生成-映射-输出”三段
2.1 为什么不做成“所见即所得”的画图软件
最开始我设想过把 artcraft 做成图形界面，像普通绘图工具那样用鼠标拖拽、缩放、填色。但很快发现这个方向行不通：手工艺人对“画面好看”的需求远低于对“尺寸准确、工序清晰”的需求。用鼠标画一条曲线很容易，但这条曲线到了切割机上时，要换算成多大的功率、多快的走刀速度、几毫米的切割缝宽，图形界面反而会把关键信息藏起来。
所以我换成了“三段式”架构。第一部分是图案生成核心，负责用数学函数、随机种子和约束条件生成矢量纹样；第二部分是工艺映射层，把一个抽象纹样翻译成对应纸张、布料、木板、皮革上的具体参数；第三部分是文档输出模块，把最终结果排版成可打印的PDF、可导入切割机的SVG、以及给人工操作的工序清单。三段之间通过一份通用的中间数据格式传递信息，不互相搅和。
这个拆法让我受益很大。一开始我只想解决拼布图纸的问题，结果因为生成和输出是分开的，后来做激光切割、丝网印刷甚至简单的刺绣针法模拟时，我只需新增一个映射配置，不用推翻前面的生成代码。如果你也在做类似的工具，建议从一开始就把“计算”和“呈现”分离，哪怕你只是想做个给自家工作室用的内部工具。
2.2 中间格式的选型：为什么我坚持用 SVG 作为底座
在 artcraft 里，所有纹样的中间表达都基于 SVG（可缩放矢量图形）。这么说可能有点抽象，你可以把它理解成一份“用坐标和路径写成的配方”，而不是一张“已经烤好的图片”。图片放大就会糊，配方不会；图片上的一个像素对应屏幕上的一个小点，配方里的坐标却可以随时换算成毫米、英寸、像素、针距。
选择 SVG 还有几个实际原因。第一，它是文本格式，可以用普通代码直接生成和修改，调试的时候打开文件就能看到问题；第二，无论是激光切割软件、刺绣软件还是普通的矢量绘图工具，几乎都能导入 SVG，兼容性比我试过的其他格式好得多；第三，SVG 支持单位换算，我可以在根元素里同时保留 viewBox 和实际物理尺寸，这样在处理不同分辨率的输出设备时，不会因为单位错乱导致图案飘移。
当然 SVG 也有缺点，比如复杂曲线渲染性能一般，但对手工艺纹样来说，单个文件几千个节点完全够用。我不建议一上来就引入复杂的 CAD 内核或专业图形引擎，过度设计会让项目沉没在依赖地狱里。
2.3 模块之间的接口设计：一份工艺参数的“通用语言”
在三段式架构里，最核心的接口是“工艺参数表”。它是一份简单的 JSON 结构，描述了一个纹样在不同制作场景下需要哪些参数。我举一个刺绣的例子：同样一条花瓣曲线，做十字绣时要知道它是第几号绣线、在哪个区域、方向如何；做缎绣时要知道针距、针迹长度、是否分层；做激光切割时要知道线宽、切割速度、功率、甚至期望的切割缝宽补偿。
所以我在 artcraft 里定义了统一的“工艺键”列表，比如 stitch_length、cut_width、material_thickness、feed_rate、color_hex、layer_name。图案生成模块只输出几何路径和逻辑颜色，映射层再把逻辑颜色映射到真实色号、线材和切割参数。这样做的好处是，更换材料时我只需要改一张映射表，不需要动生成算法。
下面是一个简化版的映射表示意，我实际项目里这份表会长很多，但因为用了相同结构，新材料的适配成本很低：
| 逻辑颜色 | 用途 | 布艺场景映射 | 木工场景映射 | 纸张场景映射 |
|---|---|---|---|---|
| C1 | 主体轮廓 | 6号深蓝绣线，针距2mm | 切割线，速度20mm/s | 折痕线，半切 |
| C2 | 填充区域 | 4号浅灰棉线，针距3mm | 雕刻区，功率40% | 印刷区，CMYK值 |
| C3 | 辅助标记 | 水溶性笔虚线 | 装配标记，浅刻 | 裁切标记 |
3. 参数化图案生成：从公式到可绣纹样的核心细节
3.1 用约束而不是硬编码来保证图案不出格
artcraft 的图案生成模块从不直接写死一个图案。比如我要生成一个适合刺绣挂件的花环纹样，我不会去手绘一遍路径，而是定义一组数学约束：花朵数量、花瓣长度、环形半径、花心间距、最小相邻角度。生成算法在满足这些约束的前提下，引入随机种子来产生自然变化。
为什么这样做？因为手工艺的实物往往有物理边界。刺绣挂件直径不能超过6厘米，否则绣绷不好夹；激光切割吊坠的最小孔洞不能小于1.5毫米，否则木头会崩裂。如果是手绘，你很难精确控制“每个花瓣都在半径5.2厘米的圆环上”，但约束式生成可以做到：所有坐标先由公式计算，再统一缩放和平移，最后整图检查最小间距。
这部分的数学不难，但有一个细节必须强调：所有尺寸都应该用实际物理单位参与计算，而不是用像素。我在早期版本里犯过一个很蠢的错误——先用像素生成图案，打算导出时再转毫米，结果导出时发现不同屏幕的 DPI 不一样，同一个图案在一台电脑上是5cm，换另一台就变成6.3cm。后来我改成所有计算都以毫米为基准，内部统一用一个 scale 系数转成 SVG 的 viewBox，图标预览和实物尺寸才稳定下来。
3.2 一个具体例子：用极坐标生成环状绣花纹样
我以后来做挂件时使用的模块为例，简化一下核心代码。这段代码不完整，但能看出约束式生成的基本思路。
import math import random import json def polar_to_cartesian(radius, angle_deg, center=(0, 0)): rad = math.radians(angle_deg) x = center[0] + radius * math.cos(rad) y = center[1] + radius * math.sin(rad) return round(x, 2), round(y, 2) def generate_floral_ring( petal_count=8, ring_radius=22.0, petal_length=6.5, petal_width=3.2, center_x=0.0, center_y=0.0, seed=42 ): random.seed(seed) paths = [] step = 360.0 / petal_count for i in range(petal_count): base_angle = i * step # 在极坐标中生成一片花瓣的关键点 tip = polar_to_cartesian(ring_radius + petal_length, base_angle, (center_x, center_y)) left = polar_to_cartesian(ring_radius, base_angle + 8, (center_x, center_y)) right = polar_to_cartesian(ring_radius, base_angle - 8, (center_x, center_y)) inner = polar_to_cartesian(ring_radius - 2.2, base_angle, (center_x, center_y)) # 花瓣路径，用三次贝塞尔曲线连接关键点 path = { "type": "petal", "points": [inner, left, tip, right], "logical_color": "C1" if i % 2 == 0 else "C2" } paths.append(path) return { "projection": "polar_floral", "unit": "mm", "paths": paths } result = generate_floral_ring() print(json.dumps(result, ensure_ascii=False))这段代码的灵感来自经典的海龟绘图，但关键区别在于：我返回的是带工艺逻辑颜色的路径点，而不是直接画到屏幕上。这样在后续映射层，我可以决定 C1 色花瓣用深蓝色绣线，C2 色花瓣用浅灰色绣线，也可以把 C1 当成切割线、C2 当成雕刻区。你可能会问，为什么花瓣不是直接输出一个闭合的 SVG path，而是要输出控制点？因为不同工艺对“线”的理解不一样，刺绣需要针迹顺序，切割需要连续轮廓，印刷需要闭合填充。只有保留几何拓扑结构，才能无歧义地转换。
3.3 随机种子是“可控的随机”，不是混乱
在生成艺术里，随机是一件双刃剑。没有随机，图案会显得死板；随机过度，又无法复现。artcraft 的做法是让每个生成的图案都绑定一个 seed 参数，比如上面代码里的 seed=42，这样同一个 seed 永远生成同一组花瓣排列。你可能会问：那随机还有什么意义？我的答案是，随机只负责“变化量”，比如花瓣尖角的轻微偏移、叶片弧度的微小波动、颜色交替的起始位置。而整体结构仍然由约束参数锁死。
我在实际创作中，经常先把 seed 从1试到 50，快速渲染成小预览图，挑出变化最合适的一个，然后固定下来。这个流程对量产特别重要——一旦你发现某一版花纹很好看，就可以永久复现它；如果某一批材料做坏了，重新按同样 seed 输出一批工艺文档即可，不用重新设计。
注意：不要把随机种子用在关键尺寸上。比如花瓣间距、孔径、刀具补偿这类参数必须固定或者单独设置随机区间，否则很容易出现“这次打样的孔是1.6mm，下一版随机成1.4mm，同样刀具做出来就取不出零件”的尴尬状况。
4. 工艺映射与实操记录：一只刺绣挂件的完整流程
4.1 从灵感到模型：定尺寸、定参数、定工序
为了验证 artcraft 的流程，我做了一款直径60毫米的圆形刺绣挂件，主题是“环状花瓣”。这个尺寸适合放进8cm的绣绷，也能塞进常见的透明吊坠壳里。
我先把约束参数列出来：外环半径28mm，内环半径18mm，花瓣数8片，花瓣长度6.5mm，花瓣宽度3.2mm。然后用上一节提到的生成代码，以 seed=42 生成矢量纹样。这时的输出只是一个带逻辑颜色的几何文件，还没法和刺绣连线对应上，所以要进入工艺映射层。
工艺映射层要做的事有两件：一是将几何路径转成刺绣机能理解的“针法单元”；二是生成一个配色清单。我选择的是最普通的平绣针迹，也就是沿着花瓣轮廓走一圈，然后在内部用一定间距的平行线填充。这里的核心参数是“针距”，也就是相邻两针之间的距离。针距越大，绣线越稀疏，手感越硬；针距越小，耗时越长，图案越细腻。我实测下来，2mm 针距在普通棉布上表现最稳，1.5mm 会有点密，导致布面起皱；3mm 则会露底。
针距与路径长度的换算很简单。比如一片花瓣的外轮廓长约20mm，按2mm针距走一圈，大概需要10针，加上内部填充，每个花瓣大约40针，整件挂件8片花瓣就是320针左右。这个数字只是估算，但能帮你快速估算工时和线材耗量：以我的绣花机速度，320针大约3到4分钟完成，非常符合小挂件的量产节奏。
4.2 生成切割模板与配色方案
刺绣挂件需要两层材料：一层是绣有花纹的面布，一层是背后的硬衬。硬衬我选用2mm厚的不织布，用激光切割机切出直径60mm的圆形，并且在外圈预留1.2mm的缝份，这样包边之后总直径还是60mm。这里出现了一个很重要的参数——“切割缝宽补偿”。激光切割不是理论刀路，激光束本身有宽度，通常在0.1到0.3mm之间。如果不做补偿，切出来的圆形会比设计值小一圈，多个零件拼装时就会松动。
在 artcraft 中，我在映射表里加入了 cut_width 参数。比如实际切割缝宽是0.2mm，那么我让切割路径向外偏移0.1mm，这样切割后实物恰好是60mm。不同机器的缝宽不一样，需要你拿同一台机器试切几块废料来校准。我自己的校准方法是切一个直径50mm的圆，用卡尺量实际直径，然后反复调整偏移量。这不是什么高深技术，却是手工艺数字化里最影响成品率的一环。
配色方案我单独输出成一套色卡文件。逻辑颜色 C1 对应深蓝色绣线，C2 对应浅灰色绣线，C3 是水溶性笔手绘定位标记，切割后的布料上会残留浅蓝色笔痕，下水后会消失。整个配色表可以直接让客户确认，也方便订阅线材库的人快速下单。
4.3 导出工艺文档：图纸、清单、工序卡
当几何模型和工艺映射都准备好后，artcraft 的最后一步是打包输出。我通常输出三类文件：
- 按1:1打印的PDF图纸，包含每个零件的外轮廓、切割线、开孔位置、对位标记；
- 给切割机用的SVG文件，按图层区分：切割层、雕刻层、折痕层、定位层，每一层颜色固定；
- 给人工操作或外部工厂用的工序清单，列出材料类型、数量、工艺参数、质检注意事项。
工序清单非常关键，尤其是当你需要找别人代工时。我遇到过几次代工厂反馈“图纸看懂了，但不知道该先刺绣还是先切割”的问题。后来我在清单顶部用加粗字写清楚了“先切割后刺绣”还是“先刺绣后切割”，并且标注了如果先刺绣，绣花机夹持会压住不织布导致变形。增加这行字后，返工率直接降了下来。
实际上，我导出 PDF 时会在页面右下角生成一个二维码，里面存的是该项目所有参数和版本号。每次修改参数后，都会重新生成二维码。这样实物和数字文档一一对应，后续追溯问题非常方便。
5. 常见问题与排查技巧实录
5.1 图案输出后边缘变形，多半是坐标单位搞错了
我在实际使用 artcraft 时翻车最多的，是导出 SVG 后图案尺寸不对。现象是：图案在电脑预览里完美，打印或切割出来却偏小或偏大，甚至边缘被裁掉。排查下来，90% 是因为坐标系统和物理单位没有对齐。
SVG 的根节点有两个关键属性：width 和 viewBox。width 表示最终要显示的物理尺寸，viewBox 表示内部坐标系的范围。正确做法是让 viewBox 里的长度单位直接与毫米对应，比如我家刺绣机的有效工作区域是 100×100mm，那么我设置 viewBox="0 0 100 100"，width="100mm"，此时 1 个 viewBox 单位就等于 1mm。如果你在生成图案时用的是像素，千万别忘记在最外层做一次坐标缩放。
我给自己定了一条铁律：code 内部永远存毫米，只有渲染到屏幕预览时才转成像素。屏幕预览的分辨率变化不影响最终的 SVG 文件，这样就不会出现"这台电脑看着正常，另一台电脑缩小了一圈"的问题。
5.2 切割尺寸偏差：补偿值不能凭感觉
不少比我新的使用者会抱怨：“我的激光切割机切出来总是小0.2mm，是不是该换个镜头？”其实没必要换镜头，你要做的是切割补偿校准。同一台设备，切割不同材料、甚至同一材料在不同湿度下，缝宽都会变化。3mm 厚椴木和1mm 厚卡纸的缝宽可能差出 0.1mm 以上。
我常用的校准方法是切一组系列矩形，每个矩形在设计图中都设定为 20mm 宽，但同时按补偿值 0、0.05、0.1、0.15、0.2mm 各生成一份，切完后用卡尺测量，找出最接近 20mm 的那个补偿值。然后把这个值写入 artcraft 的材质映射表。以后使用同一种材料时，不用重新测量。这个方法很土，但最可靠。
5.3 配色偏差：屏幕和实物容易“打架”
如果你做刺绣或印刷，一定会遇到屏幕上的颜色和实物线色不一致的问题。屏幕是 RGB 发光，布料是染料反射，两者原理不同。artcraft 本身不是一个专业的色彩管理系统，所以我的经验是：在映射表里，不直接存“看起来像什么颜色”，而是存“标准色号库里的编号”，比如线材品牌的编号、丝网印刷的 Pantone 编号。这样在不同设备上查看时，至少有一个不依赖屏幕的共识。
另外，刺绣线材在不同批次、不同光线下会有肉眼可见的色差。我给工艺清单加了一行“请使用同一批次线材”，有效减少了成品饱和度不一致的问题。这个方法没什么技术含量，却是我交付后客户满意度提升最多的一步。
5.4 常见问题速查表
| 现象 | 最可能原因 | 解决思路 |
|---|---|---|
| 图案打印缩小或放大 | viewBox 和 width 单位不一致 | 统一用毫米生成和导出 |
| 切割件边缘塌陷 | 切割速度过快或功率不足 | 降低速度，先试切小块材料 |
| 刺绣后布料起皱 | 针距太密或绣绷张力过大 | 增大针距到2.2mm以上 |
| 同一项目两次生成花纹不同 | 忘了固定随机种子 | 在参数中固定 seed |
| 文件导入切割机图层重叠 | 不同图层用了相同 RGB 颜色 | 用标准色库区分图层 |
| 零件拼装时缝隙过大 | 切割缝宽未补偿 | 测量实际缝宽，修改补偿值 |
6. 写在工具之外：一点真实体会
artcraft 这个项目从起名到现在，最让我意外的不是代码有多好用，而是它逼着我重新理解了“工艺”这个词。手工制作最大的魅力是随机和温度，但数字化工具的职责不是抹掉随机，而是把随机控制在“美的区间”内。我至今保留了一个习惯：每完成一种新材料的映射，都会先切出一批小样，用卡尺和色卡挨个记录，再把数据补进 artcraft 的材质库里。这套流程听起来很笨，但正是这些笨功夫，让我在之后做任何新项目时都敢大胆改参数。
如果你也想搭一套类似的工具，建议从最小闭环开始：先只做一条线，比如“输入几个数字，生成一个圆形纹样，再打印成 PDF”就够了。不要一开始就追求万能，工具是越用越活的。
最后分享一个小技巧：用 artcraft 生成图纸后，我习惯在图纸角落画一个 10mm 的实测参考方块，同时标注“打印后请用卡尺确认此方块边长为10mm”。这个小方块成本为零，却能挡住大量因为打印机缩放设置引起的返工。你也可以在未来的每个项目里保留这一步。
