Looming 使用说明

更新日期：2026-06-01 · Fashion Node Studio 完整工作流手册

1. 快速入门

适用场景

首次使用 Looming，可以不选择身份，直接从空画布完成「参考 → 渲染 → 精修 → 制版 → 交付」链路。身份偏好只作为后续个性化设置，不是进入产品的前置步骤。

步骤

1. 登录或以访客身份进入节点画布；空画布以一个主按钮、少量工作流入口和右侧交付预览呈现。打开生成中心、快速出图等全屏面板时，空画布引导会自动隐藏，关闭面板后恢复。
2. 左侧垂直工具栏：**H** 打开生成中心出图，**R** 打开精修工作台，**G** 打开制版工作台。
3. 或点击 Agent 面板（**Ctrl+K**），使用快捷芯片「CSM 标准流程」一键搭流。
4. 从输出端口拖拽连线到输入端口，点击 Render / TechPack 节点上的「生成」。
5. **Ctrl+E** 导出，或 **Shift+F** 打开扒版交付导出工厂包。
6. 右下角 **?** 打开使用说明（位于 Agent 按钮上方）；点击「交互式指南」可查看五步新手导览动画；悬停左侧工具栏图标可查看快捷键提示。
7. 右上角头像胶囊为 **Dashboard / 账号中心**，点击头像直接打开个人面板；旁边小箭头保留订阅、API 配置、切换账号等菜单。
8. 左侧工具栏顶部可 **展开 / 固定**：展开后显示工具名称，固定后画布自动让位，适合长时间精修或制版。

快捷键

相关节点

`imageRef` · `render` · `retouch` · `techPack` · `exportOutput`

常见问题

**Q：空画布不知道第一步做什么？** A：点击主按钮「生成工作流」，或点「常用入口」「入门指引」。也可以点右下角 **? → 交互式指南**，按五步动画进入生成、精修、制版和导出。

**Q：Quick 模式与 Node 模式区别？** A：Quick 模式偏对话式简流程；Node 模式保留完整节点图，适合专业迭代。

2. Privileged 与 BYOK 配置

适用场景

• **Privileged 用户**：平台已注入密钥，开箱即用。
• **BYOK 用户**：自备 OpenAI / fal.ai / Replicate 等密钥，无平台额度限制。

账户类型

Privileged 账户无需手动填密钥即可出图、ET 背面推演、Vision 评图；公开用户配置 BYOK 后无平台额度上限，按服务商计费。

步骤

1. 打开 **设置**（**Ctrl+,**）→ **Providers / API 密钥**。
2. Privileged 账户顶部显示绿色提示「平台已配置 fal.ai（alma/proxima 账号），无需 BYOK」。
3. BYOK：在对应服务商卡片填入 API Key → 点击「测试连接」→ 保存。
4. 渲染前确认 **Renderer** 选项卡中模型与密钥来源匹配（生成中心会显示「平台密钥」或「BYOK」）。
5. BYOK 用户首次渲染失败时，按提示先完成密钥配置再出图。

快捷键

Ctrl+, 打开设置

相关节点

所有含 AI 生成的节点（`render`、`retouch`、`techPack`、`deconstruction` 等）

常见问题

**Q：Privileged 和 Pro 订阅是否相同？** A：Privileged 指账户白名单可使用平台托管密钥；Pro 订阅提供额度与功能，二者可叠加。

**Q：密钥存在哪里？** A：BYOK 密钥仅存本地浏览器，不上传服务器。

**Q：「图片上传失败」和「生成失败」有什么区别？** A：**上传失败**发生在把本地 data URL / blob 图传到 fal.ai CDN 阶段（精修、ET 背面、img2img 参考图）。常见原因：未配置 FAL Key、密钥无效（401/403）、图片过大（>10MB）、或网络/CORS 问题。**生成失败**发生在 CDN URL 已就绪、调用 FLUX/inpaint 模型阶段，可能是 prompt、模型配额或生成超时。设置 → Providers 可分别「测试连接」与「测试上传 initiate」。

**Q：报错让我检查 API 密钥，但密钥明明填了？** A：先看错误是否含「网络连接失败」— 那是网络问题而非密钥。若含「密钥无效」请确认 FAL Key 格式为 `xxx:yyy`（无 `Key ` 前缀）。Privileged 账号需重新登录以注入 `VITE_FAL_KEY`；公开用户须 BYOK。

**Q：上传和生成分别需要什么密钥？** A：二者均使用同一 fal.ai FAL Key。上传走 `rest.fal.ai/storage/upload/initiate`；生成走 `fal.run` 模型端点。缺密钥时精修工作台与 ET 一键打版 Tab 顶部会显示琥珀色横幅提示。

**Q：局部精修 / 智能精修报错怎么办？** A：精修走 fal.ai FLUX 局部重绘端点（`fal-ai/flux-lora/inpainting`），原图与蒙版会一起上传到 CDN，二者必须同分辨率。新版错误提示已区分：**密钥**（去设置填 FAL Key）、**网络**（重试）、**蒙版与原图尺寸不一致**（重新涂抹后再生成）、**参数有误 422**（补全涂抹区域与修改描述）、**图片过大 >10MB**（压缩）。瞬时 5xx/超时会自动重试一次；若平台 fal 暂不可用且已配置 nano-banana 密钥，会自动降级为整图编辑兜底（不带蒙版，精度略降）。

## 2.5 订阅、额度与商业交付

方案

额度与密钥

• Privileged 账户（alma/proxima）使用平台托管密钥和最高权限，仅限指定账号。
• 公开用户可升级 Pro，也可在设置中配置 BYOK。BYOK 密钥只保存在本地浏览器。
• 积分用于平台托管生成；BYOK 路径按用户自己的服务商账单计费。
• 积分包为独立购买项，走微信一次性支付；支付成功后由服务端回调累加账户 credits，前端轮询到账，不直接本地伪增额。

付费触发点

上线前人工确认

正式对外售卖前，必须确认支付后台、Webhook、退款/取消规则、发票/税务说明、隐私条款、服务条款与用户支持入口均已可用。工程检查清单见 `docs/launch-readiness-checklist.md`。

3. CSM 标准流程

适用场景

Central Saint Martins 式教学路径：参考图 → 效果图 → 精修 → 工艺单 → 导出。适合学生与需要标准交付顺序的设计师。

步骤

1. Agent 快捷芯片「CSM 标准流程」，或输入「CSM标准」「标准流程」。
2. 系统自动搭建 5 节点：`imageRef` → `render` → `retouch` → `techPack` → `exportOutput`。
3. 在参考图节点上传灵感/款式参考。
4. 依次执行 Render → Retouch → TechPack 生成。
5. Export 节点导出 PDF 工艺包。

快捷键

Agent 面板内一键触发；垂直工具栏可配合 H / R / G 分步打开面板

相关节点

`imageRef` · `render` · `retouch` · `techPack` · `exportOutput`

常见问题

**Q：与「完整设计+精修流水线」区别？** A：CSM 标准更短、偏教学交付；full_pipeline 含 ideation、印花转印等更多节点。

## 3.5 制版工作台（G）

适用场景

从选 block 到工厂 ZIP 的完整制版路径；替代在多个面板间盲目切换。

工作流阶段

**新增导出文件（2026-06-01）**

**闭环验证**：解压 ZIP 后运行 `node scripts/verify-et-bundle.mjs <目录>`，全部 ✅ 再交付工厂。

工作台 **选款** 阶段可编辑款号与 **colorway**；**量位** 阶段点击 POM 数值可 inline 编辑（同步 measureStore）。ET 管道完成后自动匹配 block 到 step 1。

常见问题

**Q：无款式图怎么办？** A：空状态提示 Shift+G ET 打版或 Shift+F 上传正背面。

**Q：下一步按钮跳去哪？** A：按阶段：量位→U 测量；正背→Shift+F；评图→评图面板；导出→全套导出模态。

4. ET 一键打版（et_pattern_full）

适用场景

对齐 ET 服装 CAD 六段流程：款式录入 → 比例 → 结构线 → 纸样 → 放码 → 工艺输出。适合工厂交接前快速搭建打版节点图并**自动生成可交付工厂包**。

步骤

1. **Shift+G** 一键 ET 打版，或 Agent 点击「一键 ET 打版」「ET打版」，或输入「ET打版」「一键打版」「打版出图」。
2. 自动创建 7 节点：`imageRef`×2 → `silhouette` / `fabric` / `construction` → `techPack` → `exportOutput`（ZIP），已自动连线。
3. **若有画布图片**：立即运行扒版 AI 管道（识别品类 → 描摹 → 评图 → POM → 打包）。
4. **背面图处理（AI 生成 + 设计师评图）**：
5. - 已上传独立背面：直接使用。
6. - 未上传背面：Vision 分析正面结构 → **FLUX 2 Pro**（Privileged/Enterprise）或 FLUX 2 / Nano Banana 生成 2–3 张候选背面。
7. - **设计师评图流程**（扒版交付面板）：
8. - 每张候选与正面并排对比（全宽展示）；
9. - **采用此背面**：确认后继续管道（须通过正背面像素去重）；
10. - **不合格，说明原因**：填写评图说明（如「需展示后领深、无胸前口袋」）→ AI 注入说明重跑；
11. - **上传真实背面**：可选覆盖 AI 候选；
12. - 显示「第 N/3 次生成」；达 3 次仍不合格则阻塞，须上传真实背面或修正正面图。
13. - 导出门禁：`backViewSource = ai_generated` 时须 `backApprovedByDesigner = true`；`pattern_review.json` 记录生成次数。
14. **款号**：留空时自动分配 `ET-M-XXXX` 格式（基准码 + 4 位随机码），避免导出文件夹名为 DRAFT。
15. 面板流程：`measure`（比例原点）→ `patternTrace`（结构线）→ `factoryPatternTemplate`（扒版交付）。
16. 扒版交付面板显示描摹线稿预览、POM 表（≥8 行）、工艺说明，可 **Shift+F** 再次导出，或 **Ctrl+Shift+E** 导出制版全套资料。

工厂 QC 门禁（导出前硬拦截）

以下情况**阻止下载**工厂 ZIP（toast 为 error，须先修复）：

**提示分级**：须用户操作的问题显示 **warning/error**；AI 背面推演成功、DXF 描摹不足后 POM 降级等**信息性结果**显示 **info**（非 warning）。

无袖款式 POM 过滤

识别为无袖/吊带/ cap sleeve 时，自动过滤袖片、袖口、罗纹领等与版型矛盾的 POM 行与工艺说明条目（如无袖款不应出现「袖片」「2×2 罗纹领」）。

DXF 自动重试

`pieces.dxf` 优先从 Sobel 描摹轮廓生成；描摹点不足时**自动重试** POM 估算轮廓降级方案。降级成功时在 info 提示「裁片 DXF 已用 POM 估算轮廓」；两次均失败才报 warning。

交付物清单（工厂扒版包 ZIP）

**行业对齐说明**：Looming 覆盖 ET/Gerber 交接面的 2D 纸样 + POM + DXF stub；**不支持** CLO 3D 悬垂、Gerber Marker 自动嵌套、矢量点放码——见 `docs/pattern-studio-gap-tracker.md`。

**闭环验证**：`node scripts/verify-et-bundle.mjs <解压目录>`

制版师验收标准

• 拒绝：空图、POM 全零或少于 8 行、工艺说明为 generic 模板、DXF 仅为矩形
• 通过：ZIP > 50KB、评图分数 ≥ 75、含正背面 trace 线稿

快捷键

**Shift+G** 一键 ET 打版 · **G** 制版工作台 · **Shift+F** 扒版交付 · **Ctrl+Shift+E** 制版全套资料导出

相关节点

`imageRef`×2 · `silhouette` · `fabric` · `construction` · `techPack` · `exportOutput`

常见问题

**Q：背面只有正面图怎么办？** A：ET 管道会 Vision 分析正面后 AI 生成 2–3 张候选背面。设计师在扒版交付面板评图：可「采用此背面」、填写不合格说明让 AI 重跑（最多 3 次），或上传真实背面。采用后 `tech_spec.backViewSource = ai_generated` 且 `backApprovedByDesigner = true`。

**Q：AI 背面不合格怎么驳回重跑？** A：点「不合格，说明原因」，填写评图说明（如后领深、后育克、无前袋等），提交后 AI 将正面图、驳回说明与已失败候选作为负向参考重新生成。每次显示「第 N/3 次生成」。

**Q：导出被拦截？** A：查看 toast 与交接清单.txt 勾选状态；常见原因：正背面相同、评图未 passFactoryReady、POM 不足 8 行。

**Q：能否导出 DXF/PLT？** A：可以。`pieces.dxf` 从 Sobel 描摹轮廓生成（clipper 缝份偏移），非 POM 矩形占位。复杂款式仍需 ET/CAD 精修。

**Q：连衣裙和裤装 POM 一样吗？** A：否。管道根据视觉识别品类（dress/pants/jacket 等）加载 `patternBlocksDatabase` 对应版型，POM 与工艺说明不同。

5. 制版出图全流程（tech_pack_full）

适用场景

从效果图到完整工艺单：面料、细节、廓形、结构一并汇入 TechPack。Agent 意图「制版」「工艺单」默认触发。

步骤

1. 输入「制版」「打版」「tech pack」或制版工作台内一键搭建。
2. 节点链：`imageRef` + `fabric` + `detail` + `silhouette` + `construction` → `techPack`。
3. 上传效果图至 imageRef，填写款号/季节（TechPack 节点内）。
4. 运行 TechPack 生成正背面制版图与规格。
5. 节点内「导出工厂工艺包 ZIP」或 Export 面板工艺包 Tab。

快捷键

G 打开制版工作台 · Ctrl+Shift+G 同上

相关节点

`imageRef` · `fabric` · `detail` · `silhouette` · `construction` · `techPack`

常见问题

**Q：与 tech_pack_workflow 区别？** A：tech_pack_full 从设计参数构建；tech_pack_workflow 从效果图解构（deconstruction）反推。

6. 打版图生成（tech_pack_workflow）

适用场景

已有 AI 效果图，需反推打版技术图与工厂可读线稿。

步骤

1. 场景模板面板选择「打版图生成」，或输入「技术图」「techpack」。
2. 流程：`imageRef` → `deconstruction` → `detail` + `construction` → `techPack` → `exportOutput`。
3. 上传效果图，运行解构分析识别结构块。
4. TechPack 生成平面制版图，Export 导出 PDF。

快捷键

T 打开场景模板面板

相关节点

`imageRef` · `deconstruction` · `detail` · `construction` · `techPack` · `exportOutput`

常见问题

**Q：解构失败？** A：确保图片为清晰正面/全身款，避免 heavily styled 背景干扰。

7. 看图 Agent 搭流

适用场景

上传参考图 + 自然语言描述，由 Agent 自动选择模板并搭建节点图（不会手动连线的用户）。

步骤

1. **Ctrl+K** 打开 Agent，拖入图片或点击附件上传。
2. 输入需求，如「做一条夏季连衣裙」「参考这张图出 tech pack」。
3. Agent 解析意图（render / tech_pack / pattern_review 等）并调用 `buildWorkflowForCategory` 或 `buildWorkflowFromImageInstruction`。
4. 观察 Agent 面板内进度条（分步：解析 → 搭建 → 连线 → 布局）。
5. 检查画布节点，按需微调后执行生成。

快捷键

Ctrl+K · Ctrl+Shift+A 也可打开 Agent

相关节点

根据意图动态生成

常见问题

**Q：Agent 搭错模板？** A：明确说「CSM标准」「ET打版」「连衣裙」等关键词；或用手动场景模板覆盖。

8. 制版评图

适用场景

评估 AI 制版图是否达到工厂可打版标准：结构线、袖笼、领圈、省位等。

步骤

1. 制版工作台 → **制版评图** Tab，或 Agent 说「评图」「能不能给工厂」。
2. 导入正面款式图或 TechPack 输出图。
3. Agent 检查结构完整性并给出修改建议。
4. ET 一键打版完成后若有画布图会自动打开评图。
5. 根据反馈返回 TechPack 或印花描摹修正。

快捷键

G 进入制版工作台后切换 Tab

相关节点

`techPack` · `imageRef`

常见问题

**Q：评图能替代人工审版吗？** A：为 AI 辅助预审，正式投产仍需版师签字。

9. 扒版交付（Shift+F）

适用场景

工厂 CMT 交接：正背面 1:1 校准、POM、缝份元数据，一键 ZIP。与 ET 管道共用 measureStore 数据与 QC 门禁。

步骤

1. **Shift+F** 或 TechPack 节点「扒版交付」按钮，或制版工作台「扒版交付」Tab。
2. 拖入/导入正背面款式图（正面必填；背面可后补或由 AI 候选生成）。
3. **AI 背面评图**：若仅正面，运行「一键生成制版资料」后出现候选背面，与正面对比后「采用此背面」或「不合格，说明原因」触发重跑（最多 3 次）；也可上传真实背面覆盖。
4. 绘制已知长度参考线（如肩宽 40cm）完成 **1:1 比例校准**。
5. 填写款号（可留空，ET 流程自动 `ET-M-XXXX`）、季节、尺码范围、缝份 cm。
6. 点击「导出工厂扒版包」→ 通过 QC 门禁后下载 ZIP（front/back 1:1 PNG、pom_factory.csv、tech_spec.json、工艺说明.txt、pieces.dxf 等）。
7. 或使用 **Ctrl+Shift+E** 打开「一键导出制版全套资料」模态框（含历史记录与缓存 ZIP 重下）。

导出拦截说明

与 ET 管道共用 `assertFactoryExportAllowed`：正背面相同、`passFactoryReady` 为 false、款号空、POM <8 行、blocker 评图问题均**阻止下载**。修复后重新运行管道或更新评图/POM 即可。

快捷键

**Shift+F** · **Ctrl+Shift+E**（全套资料）

相关节点

`techPack` · `exportOutput`

常见问题

**Q：与 Export 面板工艺包区别？** A：扒版交付专注 1:1 打印级 PNG + 测量 CSV；Export 面板含 Lookbook 等多格式。

10. 精修工作台

适用场景

效果图生成后的局部精修：选区、换色、光影、印花贴合、瑕疵修复。含 **草图精修**（全宽视觉标注 + 文字说明 + 通用工具栏）。

步骤

1. **R** 打开精修工作台（Refine Studio）。
2. 选择 **草图精修**（首选入口）— 全宽圈划 + 下方文字说明。
3. 或 `retouch_workflow` / `retouch` 模板搭建 retouch 节点链。
4. Refine Studio 其他子面板：
5. - **智能精修**：选区 + 预设 + 强度，适合快速改领型/面料。
6. - **区域重绘（Inpaint）**：蒙版 + 文本指令，FLUX fill / fal inpaint。
7. - **局部调整**：笔刷蒙版局部参数。
8. - **专业工具**：抠图、背景去除等。
9. 完成精修后进入制版（CSM 路径第 3→4 步）。

10.1 草图精修（全宽标注 + 文字说明 + 通用工具）

行业术语：**Visual Prompt Editing**、**Paint-to-Edit**、**Scribble-guided Inpainting**。产品中文名：**草图精修**（亦称圈图精修）。

**布局**： - 图片宽度 = 面板可用宽度（等比例缩放，与屏幕同宽 minus 左侧工具栏）；过高时纵向滚动。 - 下方**修改说明**文本框始终可见，与标注一并送给 AI。 - 左侧 VerticalToolbar / PS 工具组保持可用：魔棒、画笔、套索、取色等自动映射到标注模式。

**流程**：上传或载入画布最新图 → 全宽圈划标注 → 填写修改说明 → **根据标注+文字生成** → 语义蒙版（keep/remove/change 分通道）→ FLUX Dev inpaint（fal.ai）→ 可选边界融合 → 前后对比验收。

**圈划手感**： - 画笔预览环与落笔位置像素对齐（相对图片舞台定位，不受面板 blur 影响） - 预览环颜色随模式变化：绿=保留、红=去掉、蓝=改这里、白=橡皮 - 快速移动时自动插值补点，线条更顺滑；支持触控笔/平板 pointer 事件 - 未圈出修改区域时点击生成会提示「请先在图上圈出要修改的区域」

**通用工具映射**：魔棒/魔术橡皮 → flood-fill 选区；取色 → 参照模式；画笔 → 改这里；橡皮 → 擦除标注。

**空状态引导**：「全宽显示便于圈划；可同时使用图上标注与下方文字说明。」

10.2 配色变体（我的图 + 对标图 + 矢量分割）

入口：左侧工具栏 **配色变体（C）**、空画布「配色变体」、或选中画布图片后打开配色面板。

**推荐流程**：

1. 上传 **我的图**：这是要被换色、精修或生成变体的原图。
2. 上传 **对标图 / 品牌调性**：可放品牌大片、参考图、Eagle 素材或想复刻的视觉调性。Agent 会在后台提取色彩比例、材质高光、对比度、温度和视觉记忆点，并作为隐藏参考送入站内精修模型。
3. 点击 **分析色块**：自动矢量化分色。
4. 调整 **色系数量**：控制一共识别多少组颜色；数值越高，分得越细。
5. 调整 **分割精度**：控制边缘、领口、袖口、图案、辅料等小区域的拆分细度。
6. 调整 **同色系容差**：控制相近颜色是否一起被选中；容差高会把更多近似色纳入同一换色范围。
7. 选择色块或同色系区域，设置目标色 / 批量色板 / Agent 变体计划，点击生成。

**后台发生什么**：用户只看到面板和结果；Agent 会把对标图的色彩比例、质感、高光和品牌调性写入隐藏 prompt，并把矢量化区域约束一起发送给 `refineImage` 站内链路，不需要离开网站处理图片。

快捷键

R · K · X · M · P · A · B · E · V · L · W · S · O · I

相关节点

`render` · `deconstruction` · `retouch` · `exportOutput`

常见问题

**Q：精修后颜色偏差？** A：使用色彩校正工具（C）并在 Render 节点锁定 colorPalette 输入。

11. 生成中心

适用场景

统一出图入口：选模型档位（草稿/标准/高清/旗舰）、批量渲染、BYOK 模型切换。

步骤

1. **H** 打开生成中心（Generation Hub）。
2. 选择模型档位；BYOK 用户先确认 Providers 已配置。
3. 推荐标签「[推荐]」适合日常迭代；旗舰档用于终稿。
4. 绑定画布 Render 节点或从中心直接触发。
5. 出图后 **R** 进入精修。

快捷键

H

相关节点

`render` · `promptMod`

常见问题

**Q：免费额度用尽？** A：升级 Pro 或配置 BYOK 密钥直连服务商。

12. 工厂工艺包导出

适用场景

跟单/工厂交接：工艺单 PDF、BOM CSV、正背面图、交接清单。含 ET **制版全套资料**一键导出。

步骤

1. TechPack 节点 →「导出工厂工艺包 ZIP」。
2. 或 **Ctrl+E** Export 面板 →「工艺包」Tab。
3. **Ctrl+Shift+E** 打开「一键导出制版全套资料」：预览 front/back 1:1、trace、POM、DXF、评图 JSON、工厂扒版包 ZIP；可重新跑管道或使用缓存 ZIP。
4. 确认款号、季节、sizeRange、缝份已填写（ET 流程可自动款号）。
5. 导出 ZIP：含正/背面图、工艺单 CSV、交接清单.txt、款式信息.txt。
6. 与扒版交付包可合并发送工厂（扒版包偏 1:1 测量，工艺包偏 BOM/工艺文字）。

快捷键

Ctrl+E · Shift+F（扒版专用包）· **Ctrl+Shift+E**（ET 全套资料）

相关节点

`techPack` · `exportOutput` · `costing`

常见问题

**Q：CSV 能导入 ERP 吗？** A：pom_factory.csv 含款号/POM/公差/缝份列，可 Excel 打开后映射。

13. 印花描摹

适用场景

从款式图提取印花线稿、结构轮廓，供工艺参考或 pattern trace 节点输入。

步骤

1. 制版工作台 → **印花描摹** Tab（Pattern Trace）。
2. 或 `pattern_dev_workflow` / `pattern_transfer` 模板。
3. 上传灵感图/款式图，选择边缘检测或 AI 线稿模式。
4. 调整阈值/export PNG。
5. 可选接入 `patternTransfer` 节点贴到 Render 输出服装上。

快捷键

G 打开制版工作台后切换 Tab

相关节点

`imageRef` · `deconstruction` · `patternTransfer` · `retouch`

常见问题

**Q：描摹图能当 ET 结构线吗？** A：为 raster 线稿参考，非矢量 CAD；工厂需重描或手工扒版。

14. 测量与放码

适用场景

POM 标注、号型放码预览、画布比例尺校准（与扒版交付共享 pxPerCm）。

步骤

1. **U** 打开测量工具，或制版工作台 → 测量 Tab。
2. 绘制测量线并标注部位名称与 cm 值。
3. 设置基码（默认 M）、档差规则，预览 XS–XXL 系数。
4. 导出 `pom_factory.csv` 或复制到剪贴板。
5. ET 流程第 2 步：在扒版交付/测量中完成比例原点校准。

快捷键

U

相关节点

`techPack` · Measure 面板 · `gradingTables` 数据

常见问题

**Q：能否自动几何放码？** A：v1 为 POM 表 + 系数预览，不含点放码矢量编辑。

15. 素材搜索

适用场景

搜索面料、印花、参考素材并拖入画布节点或素材库。

步骤

1. 命令面板或面板菜单打开 **Material Search**（素材搜索）。
2. 输入关键词（材质、花型、颜色）。
3. 预览结果，拖入 `fabric` / `imageRef` 节点。
4. **Shift+M** 或工具栏 **M** 打开素材库管理已收藏素材。
5. 面料库条目含 supplier code，拖入节点时保留 BOM 字段。

快捷键

M · Shift+M（素材库）

相关节点

`fabric` · `imageRef` · `materialLibrary`

常见问题

**Q：搜索结果版权？** A：请确认商用授权；上传自有素材最安全。

16. 品类设计模板

以下模板通过 Agent 关键词或 `buildWorkflowForCategory` 触发，节点均为「风格/面料/廓形/细节 → Render」结构。

16.1 连衣裙/裙装（dress）

16.2 外套/夹克（jacket）

适用：秋冬外套、街头夹克。关键词：外套、夹克、coat。节点含 hardware 细节（拉链、口袋）。

16.3 衬衫/上衣（blouse）

适用：通勤衬衫、休闲上衣。关键词：衬衫、上衣、top。

16.4 裤装（pants）

适用：牛仔、西裤、休闲裤。关键词：裤装、pants。

16.5 运动装（sportswear）

适用：功能运动、瑜伽服。含 functional 细节（反光条、透气面板）。

16.6 晚礼服（evening）

适用：红毯、宴会。含 lighting 节点 + 高 intensity 细节（ sequins、train）。

16.7 街头风（streetwear）

适用：潮牌、Oversized。含 accessory 节点（包、帽）与 graphic 细节。

17. 设计辅助流水线

17.1 快速出图（quick）

• **场景**：只要一张效果图，不需完整节点链。
• **步骤**：说「快速出图」→ promptMod + render → 生成。
• **节点**：promptMod · render

17.2 效果图精修流水线（retouch）

• **场景**：已有 render，两级 retouch 串联（锐化+色彩 → 质感+边缘）。
• **节点**：render · retouch ×2

17.3 印花转印流水线（pattern_transfer）

• **场景**：固定印花图贴到服装 render 上。
• **节点**：imageRef · render · patternTransfer · retouch

17.4 完整设计+精修流水线（full_pipeline）

• **场景**：从 ideation 到印花转印的全链路实验。
• **节点**：ideation · fabric · colorPalette · silhouette · render · retouch · patternTransfer

18. 场景工作流模板

通过 **T** 打开场景模板面板应用（会覆盖当前画布，需确认）。

19. 反向拆解与重设计

适用场景

分析现有款式结构，替换局部元素后精修出新款。

步骤

1. 输入「拆解」「deconstruct」「反向拆解」。
2. 模板：`imageRef` → `deconstruction` → `retouch`。
3. 上传参考款，运行解构选择结构块。
4. 文本/图像替换模式生成变体。
5. retouch 精修后导出或继续制版。

快捷键

Agent 关键词触发

相关节点

`imageRef` · `deconstruction` · `retouch`

常见问题

**Q：解构块不准？** A：换更高清正面图，或在 deconstruction 节点手动调整 blocks。

20. 快捷键总表

画布与通用

垂直工具栏

精修与草图标注（规划）

21. 常见问题

**Q：工作流被覆盖？** A：场景模板应用前会二次确认；Agent 搭流前建议 Ctrl+S 或新 Tab（Ctrl+T）。

**Q：渲染一直排队？** A：Pro 优先队列；或 BYOK 直连降低延迟。

**Q：TechPack 与 Pattern Studio 用哪个？** A：TechPack 节点出工艺单图像；Pattern Studio 整合评图/描摹/测量/扒版入口，二者互补。

**Q：如何获取帮助？** A：点击右下角 **?** 按钮（位于 Agent 圆形按钮**上方**），或按 **?** 键打开应用内使用说明面板；完整网页版 https://looming.cn/docs/user-manual ；可下载 `user-manual-export.md`。

**Q：刷新后节点图片不见了？ A：大体积 data URL 图片存入浏览器 IndexedDB，localStorage 仅保存节点结构与短 URL。若缓存被清理，占位符会提示重新上传；节点连线与 POM/款号等元数据仍保留。

**Q：localStorage 配额不足？** A：系统自动剥离 inline 图片、重试结构-only 持久化，并 toast 提示「画布图片未写入本地缓存」；不影响导出与 ET 管道。

22. 界面帮助与本地存储

界面易用性（面板内提示）

• **面包屑**：扒版交付、生成中心、精修工作台等弹窗标题上方显示「画布 > …」路径，便于确认当前位置。
• **重点 / 提示 / 注意**：与说明书相同的 callout 样式，出现在扒版、生成中心、草图精修、Render 节点等高频面板，说明下一步操作或常见误区。
• **信息层级**：主操作（导出、精修、测量）使用更大对比度与底部固定 CTA；元数据与高级选项为次要/三级区块，背面评图时会自动折叠次要区域以突出对比区。
• **底部状态栏**：ET 扒版警告、评图进度、导出拦截等非阻塞信息；成功类短提示仍用右上角 Toast。出现错误时左下角社交证明通知会自动隐藏，避免与状态栏抢注意力。
• **节点面板**：展开左侧节点面板时显示拖拽与连线说明；收起时悬停图标仍可看名称与快捷键。
• **可停靠面板**：标题栏按钮悬停可见「弹出浮动 / 停靠侧边 / 收起」；**双击标题栏**可将该面板设为主面板（宽屏下约占 60% 宽度）；拖拽标题栏可移动浮动窗口，右下角可拉大。
• **舒适布局自动调节**：无需手动设置。视口 ≥1600px 时侧栏约 400px、画布留白更宽；1280–1599px 侧栏约 360px；&lt;1280px 侧栏改为浮层抽屉不占满画布。同时打开 2 个以上侧栏或窄屏时自动切换紧凑密度；专注模式 / 草图精修 / 测量工具打开时画布内边距增至 24px 并隐藏次要 chrome。底部状态栏出现时主内容区自动抬高，避免与 FAB 栈重叠。

专注模式

• **入口**：草图精修工作台标题栏「专注」图标；或打开草图精修 / 测量工具时自动进入。
• **效果**：收起左侧节点面板为窄条、降低社交证明通知；画布区域轻微压暗非焦点层（全屏精修/扒版时）。
• **偏好**：手动开关写入本地 `fns-focus-mode`；关闭精修/测量后自动原因会解除，手动开启的偏好仍保留。

动态布局

• **视口模式**：`紧凑`（&lt;1280px 或同时打开 2+ 侧栏）、`舒适`（1280–1599px）、`宽屏`（≥1600px 且侧栏较少）— 影响面板最大宽度、正背面图并排/堆叠、画布边距。
• **上下文**：背面评图 `awaiting_back_review` 时扒版面板加宽并突出候选对比区；电商身份在生成中心强调白底 1:1 行；学生身份默认折叠高级出图模型档。
• **面板主次**：`fns-panel-layout` 记录主面板 ID；宽屏下主面板更宽、次面板收窄。
• **密度**：设置中可切换「紧凑 / 标准 / 宽松」（`--density-scale`），影响面板内边距与辅助文字大小。

Help 按钮（?）

• 位置：右下角 FAB 栈 — **Agent 在最下**，**? 帮助在其上方**，助手建议气泡在最上（见 `fabStack` 布局）。
• 点击或按 **?** 打开 `HelpManualPanel`：左侧章节目录、搜索、右侧正文；可跳转完整网页版或下载 Markdown。
• 数据来源：`/docs/user-manual-export.md`（与 `docs/user-manual.md` 同步）。

工具栏 Tooltip

左侧垂直工具栏悬停时，通过 **Portal** 渲染 tooltip（不受面板 overflow 裁剪），显示中文功能名 + 快捷键（如「一键 ET 打版 Shift+G」）。移动端可长按查看。

本地存储策略

用户可见影响：换浏览器或清站点数据后需重新上传图片；工作流拓扑与 ET 测量数据可保留。

底部状态栏（扒版 / 评图 / 导出门禁）

• 位置：屏幕底部居中窄条（不遮挡画布主体），用于 **非阻塞** 的 ET 管道警告、评图驳回进度、工厂 QC 拦截摘要等。
• 类型：错误（红）、注意（琥珀）、提示（蓝，约 8 秒自动消失）、完成（绿，仅 subtle 说明）。
• 与 Toast 分工：「已保存」「已导出」等成功确认仍走右上角 Toast；扒版未达工厂就绪、正背相同、导出 blocker 等走底部栏。
• 评图驳回后显示「已记录驳回原因，正在第 N 次生成…」等进度提示。

社交证明通知（可关闭）

• 左下角偶尔弹出「有设计师导出了 4K 效果图…」类轻量提示。
• 点击 **×** 关闭 24 小时；**不再显示** 永久关闭（写入 `fns-social-proof-dismissed`）。
• 底部状态栏出现错误时会自动隐藏，避免与 FAB / 画布工具重叠。

24. 不同身份的设计与制版快速上手

> 身份不是必选项，也不会在首次进入时阻塞画布。需要更细的个性化推荐时，可在 **设置 → 外观 → 使用身份** 切换。偏好保存在本地 `fns-user-persona`。身份会轻量影响 **H 生成中心、SimpleMode、Render 节点提示、Batch、画廊导出、Agent 搭流** 等推荐文案与默认值。

设计效果图（H / SimpleMode / Render 节点）

设计工作流（节点图 / Agent 搭流）

路径：**参考 → Render(H) → 精修(R) → 导出**；制版需 **G** 工作台。

制版师（按款式专长）

制版工作台顶部 **款式专长** 五键会预载对应 block 的 POM 模板到测量工具。

使用场景

测量工具（跨境 / 学生）

• **cm ↔ in**：测量面板标题栏切换；跨境身份默认 inch。
• **术语表**：学生身份下测量面板底部可展开 POM/放码/刀眼等词条。

内部参考

产品团队 persona 评审全文见仓库 `docs/persona-ux-feedback.md`（含各角色痛点与已实现 checkbox）。

25. 色彩与视觉规范

> 设计 token 定义于 `src/styles/color-tokens.css`；画布导出常量见 `src/styles/colorTokens.ts`。

品牌色角色

语义色

文本与对比

• 正文 `--color-text-primary` on `--color-bg-surface`：约 WCAG AA（大段 UI 文案）。
• 辅助 `--color-text-secondary` / `--color-text-muted`：说明、breadcrumb；避免低于 #6e6e84。
• 边框默认 `--color-border-default`（中性白 8%），**非** lime tint — 图像框不抢 render 主体。

Callout 样式

面板内 **重点 / 步骤 / 注意 / 提示** 与说明书一致，背景 opacity ~8%，深色模式下不 neon。类名：`panel-callout--*`。

视觉传达设计师快速上手

1. **设置 → 使用身份 → 视觉传达设计师**（可选，不影响直接使用画布）。
2. **H** 生成中心 → 3:4 lookbook 比例 → 标准/高清质量。
3. **画廊** 筛选 → 对比模式看 before/after → **Export Mood Board** / **Share Card**。
4. **Ctrl+E** 导出 → PDF Lookbook（作品集 persona 会高亮该区块）。
5. **R** 圈图精修 → ImageCompareSlider 查看精修前后。

> 评审记录与迭代清单见 `docs/persona-ux-feedback.md` §13 视觉传达设计师。

26. 全局界面风格（Apple 风格设计规范）

> 设计 token 与工具类：`src/styles/color-tokens.css`、`src/styles/apple-design-system.css`、`src/styles/layout-tokens.css`。

设计原则

色彩纪律

• **Lime**（`--color-accent-primary`）：主 CTA、选中工具、进度条填充。
• **紫**（`--color-accent-secondary`）：焦点环、节点连线；**不**用于并列渐变主按钮。
• 语义色（成功 / 注意 / 错误 / 提示）仅用于状态条与 callout，保持低饱和。

面板结构

1. **标题区** — `PanelHeader` / `.apple-panel-header`：面包屑 → 大标题 → 副标题。
2. **内容区** — `AdaptivePanelShell` 可滚动主体。
3. **底栏** — 可选 sticky 主 CTA（`.adaptive-panel-shell__footer`）。

空画布 `EmptyCanvasHero` 为全应用视觉基准：居中大标题、单主按钮、三宫格次入口、抽屉三级工作流。

工具栏与节点

• 顶栏 / 上下文条：`apple-toolbar`；图标按钮最小 44×44 触控区。
• 左侧 `VerticalToolbar`：激活态 lime 浅底，无紫粉渐变底。
• 节点 `RenderNode`：细边框 + 轻阴影，进度条纯色无彩虹渐变。

相关文件

• `src/components/PanelHeader.tsx`、`DockablePanel.tsx`、`AdaptivePanelShell.tsx`
• `src/components/ContextToolbar.tsx`、`VerticalToolbar.tsx`、`ActionBar.tsx`
• `src/panels/GenerationHubPanel.tsx`、`PatternMakingStudioPanel.tsx`、`FactoryPatternTemplatePanel.tsx`

23. 更新日志

2026-06-25（新手导览）

• **首访路径减负**：不再自动弹出身份选择；用户可直接进入画布开始设计。
• **交互式指南**：帮助面板「交互式指南」打开五步新手导览动画，并可跳转生成中心、精修、制版、导出和说明书。
• **身份偏好改为可选**：保留设置内个性化推荐，但不作为首次使用前置步骤。

2026-06-01（Apple 全局界面风格）

• **`apple-design-system.css`**：排版 / 主副按钮 / 分段控件 / 卡片 / 工具栏 / 面板 chrome 工具类。
• **共享组件**：PanelHeader、DockablePanel、ContextToolbar、VerticalToolbar、ActionBar、Toast、BottomStatusBar、UpgradePrompt。
• **高流量面板**：Generation Hub、制版工作台 Tab、扒版交付主 CTA、AI 助手去紫渐变、Render 节点进度条。
• **用户手册 §26**：Apple 风格全局规范。

2026-06-01（色彩与视觉）

• **色彩 token 集中**：`color-tokens.css` — bg / surface / border / accent / semantic / callout。
• **视觉传达 persona**：设置可选；画廊/导出/Share Card 品牌色对齐。
• **Callout 暗色舒适化**：降低 neon；status bar 语义 token。
• **图像框中性化**：gallery / compare / export 预览不抢时尚主体。
• **用户手册 §25**：色彩规范 + 视觉设计师快速上手。

2026-06-01（制版工作台工作流）

• **六步 stepper**：选款 → 量位 → 正背 → 评图 → 放码 → 导出；学生 4 步简化。
• **下一步 CTA**：按阶段跳转测量 / 扒版 / 评图 / 导出。
• **POM 预览 + 放码预览 + 工厂就绪 checklist** 内嵌工作台。
• **patternWorkflowStore** 持久化阶段与 block 选择。

2026-06-01（persona UX）

• **身份快速上手**：设置内切换；生成中心、Render、Batch、画廊与 Agent 按身份轻量调整推荐。
• **制版工作台**：款式专长五键（T 恤/西装/裙/牛仔/运动）预载 block + POM。
• **跨境 BOM**：中英列名、HS 编码占位、USD 成本 stub。
• **电商 / 作品集 / 学生**：Batch SKU 默认、画廊作品集 CTA、学生术语表与简化面板。

2026-06-01（下午）

• **底部状态栏**：扒版管道警告、评图驳回进度、工厂 QC / 导出 blocker 改在底部非阻塞提示栏展示；成功类操作仍用 Toast。
• **社交证明可关闭**：左下角活动通知支持 × 与「不再显示」，24h / 永久写入 localStorage。

2026-06-01

• **草图精修上线**：全宽等比例缩放、标注 overlay 像素对齐、下方文字说明始终可见、**根据标注+文字生成**；左侧通用工具栏（魔棒/画笔/套索/取色）在面板打开时自动路由到标注模式。

2026-05-31

• **ET 扒版管道**：Shift+G 一键打版；Shift+F 扒版交付；Ctrl+Shift+E 制版全套资料导出。
• **工厂 QC 门禁**：正背面相同、passFactoryReady false、款号空、POM<8、blocker 评图 — 拦截 ZIP 下载。
• **款号自动分配**：留空时生成 `ET-M-XXXX` 格式。
• **无袖 POM 过滤**：移除与无袖/吊带矛盾的袖片、罗纹领等条目。
• **背面 AI 推演与设计师评图**：Vision + FLUX 2 Pro 生成候选；设计师可评图驳回并重跑（最多 3 次）；导出须设计师确认 AI 背面。
• **DXF 自动重试**：描摹失败时 POM 降级轮廓，info 提示降级路径。
• **Privileged 账户**：alma/proxima 白名单自动注入平台密钥；公开用户 BYOK。
• **Help ? 按钮**：fabStack 重排（Agent 下、Help 上）。
• **工具栏 Tooltip**：Portal 悬停提示含快捷键。
• **存储优化**：localStorage 瘦身 + IndexedDB 图片缓存。

*Fashion Node Studio · Looming · 文档版本 2026-06-25（新手导览）*