使用说明

一这是什么

KnitMoss把「一张编织图解」变成「一份机器可执行的程序」，中间是一块可以像拖线圈一样编辑的画布。

完整的链路是这样走的：

能做什么

• 拖线圈设计花型，实时看到针织物真实形态（线圈互锁、行间咬合）
• 上传现成图解（照片、截图、扫描件），自动还原成可编辑的针法网格
• 导出 .k（knitout v2）程序，含起口、逐行织造、收口
• 自动校验：针数平衡、加减针依赖、麻花成对、纱长需求
• 查询 18 种针法的中文名 / 英文名 / 符号 / 机织实现（内置「针法符号总表」）

不能做什么（先说清楚）

二界面布局

工作台是三栏同屏的，三种「视图」是并列的面板，不是切换的标签页。

三针法总表

18 种针法，分四组。「机织实现」讲的是这个符号在你的机器上具体怎么走 —— 这一列是本站最有价值的部分。

基础（6 种）

减针（5 种）

三种方向务必分清 —— 这是看图解最容易错的地方：

加针（3 种）

其他（4 种）

四符号标准对照

本站的命名和符号不是自己编的，也不是只照一本教材抄的。依据是两套来源。

来源一：Craft Yarn Council（美国行业标准）

Craft Yarn Council 是美国纱线与手工行业的行业协会，它发布的 Knit Chart Symbols（编织图解符号）和 Knitting Abbreviations（缩写表）是北美出版业通用的规范，主流编织书和杂志的图解都遵守它。本站针法的英文名和符号形状对齐的正是这套标准。

这套标准里和本站直接相关的条目：

来源二：中文教材「编织符号」表

中文教材的符号体系（很多沿用日本 JIS 记号的排法）与 CYC 有细微差别。本站中文名用的是教材措辞，主要几条：

还没实现的（列在这里以便对照）

点击工具栏的 📖 针法符号总表 能看到完整对照表。以下标准针法本站尚未支持可视化编辑，只是列出来供你查：

五拖线圈交互

在线圈视图里，拖到哪个位置决定变成什么针法。这是本站最核心的操作方式。

左键拖动（改针法）

拖腿（扭针 / 并针）

用针法库（更精确）

左侧针法库列出全部 18 种，按基础 / 减针 / 加针 / 其他分组。三种用法：

• 单击针法项 → 应用到当前选中的格子
• 拖到画布两针之间 → 在該位置插入一个新针目
• 双击 → 进入持续模式，之后每点一格就用这个针法，按 Esc 退出

每一项右边有个 r= 数字，是这个针法的用纱系数（耗纱量相对普通下针的倍数）。超过 1 的会标 ⚠ —— 意味着同样一行里用它，纱线需求更高，密集使用可能超出机器的供纱能力。

右键（径向菜单）

按住右键停顿一下，会弹出 8 扇区径向菜单；朝某个方向甩动即可选中该扇区：

搬花型（右键拖动）

• 右键拖动 = 把花型块移动到新位置，拖动时会显示「移动 花型（Δ列 +2 · Δ行 −1）」的实时提示
• Ctrl + 右键拖动 = 复制花型块到新位置（原位置保留）
• 越界的部分会被丢弃，松手后提示「已复制 / N 针越界丢弃」

选择

• 点单格 = 选中一格
• 按住拖框 = 框选一块区域
• 点空白处 = 取消选择
• 文字视图里的记号也可以直接点选，便于快速定位某一段

六图解识别

上传现成的编织图解（图片或 PDF），自动还原成可编辑的针法网格。PDF 里的「文字版说明」不走图像识别，直接读文字解析。

怎么用

1. 把图解拖进去，或点上传、或直接 Ctrl+V 粘贴截图。支持 PNG / JPG / WEBP / GIF / PDF。图片会自动缩放到最大边 1000px。
2. 如果上传的是 PDF，会先扫全文找「文字版说明」（形如 Row 1: k2, p1, k2tog, yo…）：找到就按文字解析（精确、无需教符号），没找到才挑最像图解的一页做图像识别。文字解析结果可以「改用图片识别」切回图像通道。
3. 几秒后出现符号网格和识别统计。顶部状态栏会显示 网格 N 行 × M 列 · 格 W×H px。
4. 教它：在左侧选一个针法（如「下针」），然后点网格里对应的格子。教几格就够 —— 实测每类教 1~2 个，准确率能到 95% 以上。
5. 确认无误后点 导入到布面，识别结果成为可编辑的设计。

PDF 的两条通道

准确率预期

它是怎么工作的

知道原理能帮你在识别不准时判断该调哪里。

1. 找网格线：在灰度图上统计每一列/行的「非背景像素占比」。网格线是贯通整张图的，占比接近 100%；符号只占行高的一小段，占比低。用这个差别把线挑出来，线间距就是格宽，第一条线的位置就是原点。
2. 没有线怎么办：退回自相关分析找周期，再用整数倍消解排除谐波。
3. 提取特征：先把贯通的长线从二值图里去掉，再把每格内部切成 10×10 的网格算墨量分布，另外算 7 个整体标量（墨量比、中行/中列墨量、四角、中心墨量、环形度、两条对角）。
4. 分类：你教的格子作为样本，用最近邻匹配（带绝对距离门限和比值检验，防止少数样本把整片带偏）。没有样本或匹配不上时，退回到几何启发式「首猜」。

七导出机器程序

点 导出模型 .knit 打开导出弹层，里面有三个标签页。

另外，生成机器程序 按钮会跑一遍校验并给出逐行分解。

三条硬规则

这三条是分析 25 个官方样例后反推出来的，本站严格照办：

针法 → 机器指令映射

K   下针        knit 前针床
P   上针        xfer f→b + knit b + xfer b→f
T   集圈        tuck
S   滑针        不选针（挂圈，该行不织）
YO  空针        rack -2 腾空本针后成圈（留洞）
K2T 右上2并1    rack 2 + 把右邻跨床左移并合
SSK 左上2并1    rack 2 + 把本针跨床并入右邻（K2T 的镜像）
K3T 中上3并1    左右邻分别跨床移入本针，再成圈
P2T 上针2并1    并圈后再用上针方式成圈
M1L/M1R/KFB 加针   在该针位成圈 → 产生新线圈
DR  脱圈        drop
CO  起针        由起口挂纱建立
NO  无针区      该格不织

起口与收口

起口用的是官方的锯齿挂纱法：inhook → 两组交错的 tuck 覆盖全部针位 → releasehook。两组交错是为了让纱线呈锯齿状挂在针上，比单趟更平整。

收口用 drop 把全部线圈放掉。如果你的设计需要正式收边（bind-off），请在最后一行显式放「套针 B」。

上机前的试片流程（重要，别跳过）

这是整份文档里最需要照做的一节。原因很直白：导出程序从来没有人上机验证过，格式合规不代表机构动作对、纱长够、密度准。试片是唯一能在浪费整卷纱之前发现问题的手段。

一、试片织什么

不要一上来就织正式花型。按这个顺序，每片只验证一件事：

二、具体怎么做

1. 备纱：用你最终要织的那种纱线，不要拿别的线替代试。张力与纱支直接决定密度，换了纱等于没试。
2. 设零 / 对位：按机器手册把针床归零，确认 f0 / b0 的位置和程序里假设的一致。这一条最容易错 —— 程序里的针位是从 0 起的索引，机器上要有对应的物理零点。
3. 记下起始状态：纱嘴位置、张力盘刻度、机头速度档、起针数。
4. 导入程序：按你机器的流程把导出的程序送进去。
5. 先空跑一遍（不喂纱或松开张力）：让机构把选针 / 移圈 / 翻针动作走完，眼睛盯着针床确认没有撞针、没有该选没选。空跑能救下整卷纱。
6. 正式织：慢速档开始。前三行手动盯着，起口是最容易出问题的地方。
7. 下机后别急着拆：先平铺，别拉扯，让织物松弛静置 30 分钟以上再量（纱线有回缩，马上量会偏大）。

三、要量什么、记什么

把试片的照片和上面这组数字存下来。下次换纱或换机型，这就是你的基准，能省掉重试。

四、怎么判断试片过没过

五、常见失败现象对照

六、正式开织之前

• 用试片量到的密度回填到密度设置，再看一遍版型尺寸对不对
• 按试片的纱耗备足纱，多留 10~15% 余量
• 把整件程序先在机器上再空跑一遍，确认总行数、最大针位
• 正式织的前 10 行仍然要盯着 —— 试片过了不代表每一片都过

换行方向

机头是蛇形往复的，所以奇偶行的编织顺序会反过来 —— 程序里 knit + / knit - 的方向标记就是干这个的。看图解时不用管，导出时自动处理。

八自动校验

点 生成机器程序 时会跑一遍校验，结果分三级。

九快捷键

选中格子后按字母直接应用针法。

基础

减针

加针

其他

十常见问题

识别出来的网格行列不对怎么办？

展开识别面板右侧的网格参数，手动改。改 格宽/格高 时画布会实时预览，调到格子正好框住每个符号为止；再调 原点 让网格线对齐图解上的格线。

为什么教了格子还是有认错的？

通常是两种情况：一是网格没对齐（特征取歪了，教也没用）；二是那一格的符号和别的太像（比如都是细斜线）。遇到后者，多教几个同类的样本，或者直接手动点对了再导入。

「放针」去哪了？

改名成「脱圈」了。原因见第四节：标准术语里放针 = 加针，而那个功能是让线圈脱落，两者正好相反。真正的加针是现在的 M1L / M1R / kfb。

导出的文件能直接给机器吗？

不能直接给机器 —— 它是 knitout v2 格式，属于「中间表示」。你需要用机器厂商的工具（或 CMU 的 knitout 工具链）把它转成机器的原生格式。本站的职责是把设计准确翻译成 knitout。

画布上那些绿线绿点是什么？

是行间嵌套标注，视图栏 ⌒ 互锁 开关控制。 绿弧画的是每针的环口（跨在左右脚跟之间），绿点是上一行线圈的头套进这个环的落点。 鼠标悬停上去会浮出具体说明。它不是纱线的一部分，只是把「行与行怎么咬合」画给你看 —— 不想要就点 ⌒ 互锁 关掉。

画布上的虚线格子是什么？和纸质图解一样吗？

是针目网格，视图栏 ▦ 网格 开关控制，默认格子是正方形（列距 1.20）。 真实针织图解的格子就是正方形、用浅灰细虚线画 —— 本站按同一画法做的，所以你可以对着纸质图解一格一格核对。

线圈视图里线圈挤在一起 / 太散？

调工具栏的 列距 滑杆。默认值 1.20（= 行高 48 ÷ 线圈宽 40），让格子保持正方形，与真实针织图解的格线一致；往小调线圈排得更密。

图纸是彩色的，能识别吗？

识别走的是黑白墨迹分析，不接受彩色直接转针法。但你可以先在面板里选针法颜色，把配色信息用作辅助 —— 或者干脆把彩色图当配色参考，手动把针法铺上去。

怎么上传自己的程序 / 作品图？

文件上传功能还在开发中（后端已上线，但上传链路尚未实现）。在那之前，请到「联系我们」页用飞书表单提交文件，我们会人工录入。页面上所有「上传」区域都明确标了状态，不会出现点上去没反应的情况。

首页那个「AI转换工作台」是干什么的？

那是流程说明页 —— 用六步讲清楚「上传图解 → 选机型 → 识别 → 修正 → 设密度 → 导出」的完整链路。真实可用的识别功能在设计工作室里，页面上有直达按钮。两者不要混：工作台看流程，工作室做实事。

数据存在哪？

设计保存在你浏览器本地浏览器的 localStorage（保存 / 加载），不上传服务器。换台电脑就看不到了，重要设计请用「导出模型」存一份文件。

十一账号与社区

账号是「轻账号」：一个用户名、一个密码，没有手机号、没有实名、也没有第三方登录。

注册与登录

登录后能做什么

• 收藏与点赞云端保存：换设备也在（未登录时只存在本机浏览器）
• 评论：在作品页留言
• 举报：每条评论都能举报；一条评论被举报满 3 次会自动转人工复核并从前台隐藏

还不能做什么（先说清楚）

数据存在哪

账号、收藏、点赞、评论存在服务器数据库（SQLite，库文件放在网站根目录之外）。设计稿例外：工作室里的设计仍存在你本机浏览器的 localStorage，不会自动上传 —— 重要设计请用「导出模型」存成文件。

十二自由设计引擎（v14）

首页「软件为核心」预览区、顶部导航「自由设计」、以及独立页 lab/design_v14.html 都是同一个引擎 —— 一个可点选方格、实时立体渲染的自由设计器。与旧版「上针/下针两针法」相比，v14 支持下针 · 上针 · 扭针 · 麻花 · 滑针多针法笔刷，并能整排搬花型。

锚点刚性化（本版本核心改进）

渲染引擎在计算层级（z，决定谁压谁）之外，另加一个「物理子层 dz」：同一针的冠与腿在 2D 投影下会物理冲突（跨行的硬规则边压在本针冠腿上），v14 用 z + dz 排序把同针冠腿在视觉上分离开（garter 搓板、罗纹的冠/腿不再糊成一片），而 z 层级本身不动 —— 因此自动校验（audit）零回归：物理层序完全不变，只调渲染子层。

怎么用

点方格切换针目针法（笔刷/点选）；切换「对标针法」或整排图案后，右下方织片实时重渲。要导出机器程序，把工作室里的设计保存成模型即可。

十三实物校准（让渲染 ≈ 实物）

工作室顶部「🎯 实物校准」是一个标定工具：把渲染出来的织物往实物织物靠。目标是让屏幕上的小样在颜色、毛羽、光泽、层叠上贴近你手里那块 6×6cm 的针法小样。

三步标定

① 传实物图：中性灰卡背景、5000K 正面光、拍一块 6×6cm 针法小样，从左侧上传。
② 调参数：中间五个滑块 —— 毛羽量 / 纤维贴图 / 各向异性 / 线圈长 S / 针距，选对机型（kh970 / sk840）和对标针法，右下方「渲染小样」会随参数实时更新，可直接对照左侧实物图。
③ 看残差：右侧自动算 L2 色度 ΔE（渲染主色 vs 实物主色）与 L3 层差（该针法理论层数 vs 你观测的实物层数）。ΔE 越小、层差越 0 越接近实物。

保存与载入标定

点「保存标定 JSON」会下载 calib_机型_针法.json 并存入本地（localStorage）；点「载入」优先读本地缓存，其次读服务器 calib/机型/default.json（部署后可在线载入每台机型的标定基线）。把调好的参数「应用」后，工作室主画布会按这套标定重新渲染。

提示：本地直接打开（file://）时服务器标定读不到、会用内置默认参数；部署到网站后自动接入对应机型的标定库。