# Looming 使用说明

> Fashion Node Studio 完整工作流与用户手册  
> 更新日期：2026-06-25 · 在线版：https://looming.cn/docs/user-manual

---

## 目录

1. [快速入门](#1-快速入门)
2. [Privileged 与 BYOK 配置](#2-privileged-与-byok-配置)
2.5. [订阅、额度与商业交付](#25-订阅额度与商业交付)
3. [CSM 标准流程](#3-csm-标准流程)
3.5. [制版工作台（G）](#35-制版工作台g)
4. [ET 一键打版（et_pattern_full）](#4-et-一键打版et_pattern_full)
5. [制版出图全流程（tech_pack_full）](#5-制版出图全流程tech_pack_full)
6. [打版图生成（tech_pack_workflow）](#6-打版图生成tech_pack_workflow)
7. [看图 Agent 搭流](#7-看图-agent-搭流)
8. [制版评图](#8-制版评图)
9. [扒版交付（Shift+F）](#9-扒版交付shiftf)
10. [精修工作台](#10-精修工作台)
11. [生成中心](#11-生成中心)
12. [工厂工艺包导出](#12-工厂工艺包导出)
13. [印花描摹](#13-印花描摹)
14. [测量与放码](#14-测量与放码)
15. [素材搜索](#15-素材搜索)
16. [品类设计模板](#16-品类设计模板)
17. [设计辅助流水线](#17-设计辅助流水线)
18. [场景工作流模板](#18-场景工作流模板)
19. [反向拆解与重设计](#19-反向拆解与重设计)
20. [快捷键总表](#20-快捷键总表)
21. [常见问题](#21-常见问题)
22. [界面帮助与本地存储](#22-界面帮助与本地存储)
23. [更新日志](#23-更新日志)
24. [不同身份的快速上手](#24-不同身份的快速上手)
25. [色彩与视觉规范](#25-色彩与视觉规范)
26. [全局界面风格](#26-全局界面风格apple-风格设计规范)

---

## 1. 快速入门

> [!重点]
> 30 秒路径：直接进入画布 → **H** 出图 → **R** 精修 → **G** 制版 → **Ctrl+E** 导出。

> [!步骤]
> 1. 登录或访客进入节点画布；无需先选择身份，空画布提供一条「从设计到交付」主路径。
> 2. 左侧工具栏 **H** 生成中心出图，**R** 精修，**G** 制版。
> 3. 或 **Ctrl+K** 打开 Agent，点击「CSM 标准流程」一键搭流。
> 4. 连线后点击 Render / TechPack 节点「生成」。
> 5. **Ctrl+E** 导出；工厂交付前先通过制版与 QC 门禁。

> [!快捷键]
> Ctrl+K — Agent 对话
> H — 生成中心
> R — 精修工作台
> G — 制版工作台
> ? — 使用说明 / 交互式指南

> [!路径]
> 画布 → Agent/工具栏 → 节点生成 → 扒版交付 → 导出 ZIP

### 适用场景

首次使用 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. 左侧工具栏顶部可 **展开 / 固定**：展开后显示工具名称，固定后画布自动让位，适合长时间精修或制版。

### 快捷键

| 操作 | 快捷键 |
|------|--------|
| Agent 对话 | Ctrl+K |
| 生成中心 | H |
| 精修工作台 | R |
| 制版工作台 | G |
| 使用说明 / 交互式指南 | ? |

### 相关节点

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

### 常见问题

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

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

---

## 2. Privileged 与 BYOK 配置

> [!提示]
> 邮箱/用户名/显示名含 **alma** 或 **proxima**（不区分大小写）的 Privileged 账户，登录后自动注入平台 fal.ai / SiliconFlow / Nano Banana 密钥，无需 BYOK 即可出图、ET 背面推演与 Vision 评图。

> [!注意]
> 公开注册用户须自备 OpenAI / fal.ai / Replicate 等密钥（BYOK）；未配置密钥时 AI 生成节点会失败并提示先完成设置。

> [!步骤]
> 1. **Ctrl+,** 打开设置 → **Providers / API 密钥**。
> 2. Privileged 账户顶部显示绿色「平台已配置 fal.ai，无需 BYOK」。
> 3. BYOK：填入 API Key →「测试连接」→ 保存。
> 4. 渲染前确认生成中心显示「平台密钥」或「BYOK」来源。

### 适用场景

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

### 账户类型

| 类型 | 说明 |
|------|------|
| Privileged | 邮箱/用户名/显示名含 **alma** 或 **proxima**（不区分大小写），或命中白名单邮箱；登录后自动注入平台 fal.ai / SiliconFlow / Nano Banana 密钥 |
| 公开注册用户 | 须 BYOK（Bring Your Own Key），在设置中自备 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 订阅、额度与商业交付

> [!重点]
> 当前线上商业模型以 **Free / Pro / Enterprise / Enterprise+** 为准；更早期的入门付费档位已不再作为当前产品入口。

### 方案

| 方案 | 适合人群 | 核心权益 |
|------|----------|----------|
| Free | 试用、学生、轻量探索 | 基础节点、少量积分、带水印导出 |
| Pro | 独立设计师、商业接单 | 高级模型、批量、无水印、云同步、交付导出 |
| Enterprise | 工作室、小团队 | 协作、共享资产、API、团队管理 |
| Enterprise+ | 企业客户 | SSO、私有部署、定制集成、SLA |

### 额度与密钥

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

### 付费触发点

| 触发点 | 文案原则 |
|--------|----------|
| 积分不足 | 说明本次生成被阻止，提供 Pro / BYOK 两条路径 |
| 水印导出 | 明确「无水印客户交付」价值 |
| 批量生成 | 说明用于 SKU、配色、商业素材矩阵 |
| 高级模型 | 说明用于成稿、大片、交付预览 |
| 工厂包导出 | 仅在 QC 证据满足时承诺「工厂交付」 |

### 上线前人工确认

正式对外售卖前，必须确认支付后台、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）

> [!重点]
> **G** 打开制版工作台 — 六步线性工作流（学生身份四步）：选款 → 量位 → 正背 → 评图 → 放码 → 导出。

> [!步骤]
> 1. **G** 打开制版工作台；顶部 **工作流** 标签显示当前阶段 stepper。
> 2. **选款 / 版型**：点款式专长五键（针织/西装/裙/牛仔/运动）预载 block + POM；或从 block 列表点选。
> 3. **量位**：点「开始量位」或 **U** 打开测量工具；POM 预览实时同步；完成 1:1 比例校准。
> 4. **正背**：查看正/背面状态；若正背相同会警告 → **Shift+F** 扒版交付上传或 AI 背面确认。
> 5. **评图**：工作台内联显示分数与 blocker；完整评图打开制版评图面板。
> 6. **放码**：预览 XS–XXL 档差矩阵（block 联动女装字母码）；导出 ZIP 含 `grading_matrix.csv`；可一键下载电商尺码表 PNG。
> 7. **导出**：工厂就绪 checklist（款号、POM≥8、DXF 多部件、notches、passFactoryReady 等，未通过项可点「修复」）→ **Ctrl+Shift+E** 或扒版交付。

> [!快捷键]
> G — 制版工作台
> U — 测量工具（量位阶段）
> Shift+F — 扒版交付（正背阶段）
> Shift+G — 一键 ET 打版（空画布引导）
> Ctrl+Shift+E — 制版全套资料导出

> [!提示]
> 底部 **下一步** 按钮按当前阶段智能跳转。快捷跳转栏可不离屏打开扒版交付 / 评图 / ET 一键 / 全套导出。学生身份隐藏「一键打版」区并简化 stepper 为 4 步。

### 适用场景

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

### 工作流阶段

| 阶段 | 操作 | 快捷键 |
|------|------|--------|
| 选款/版型 | 款式专长 + block 预览 | G |
| 量位 | 测量工具 + POM 预览 | U |
| 正背 | 扒版交付正背面校准 | Shift+F |
| 评图 | 内联分数 + 制版评图 | — |
| 放码 | 档差表 + 全码矩阵预览 + grading_matrix.csv | — |
| 导出 | 就绪 checklist（含 DXF/notches）+ ZIP | Ctrl+Shift+E |

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

| 文件 | 说明 |
|------|------|
| `pieces.dxf` | 多裁片（前/后/袖/领）+ NOTCH / SEAM_ALLOWANCE 图层 |
| `pieces_aama.dxf` | AAMA-DXF stub（PIECE-BOUNDARY / SA-BOUNDARY） |
| `notches.json` | 刀眼 x,y 坐标 + matchPointPairs（pairId） |
| `grading_matrix.csv` | 5–6 码 POM 矩阵 |
| `grade_point_rules.csv` | 放码点 ΔX/ΔY 规则 stub |
| `grading_rules.txt` | 版型库档差说明 |
| `marker_estimate.txt` | 排料估算（裁片面积×缩水÷门幅） |
| `pipeline_steps.json` | 管道各步 pass/fail + 时间戳 |
| `tech_pack_summary.pdf` | 双语工艺单摘要（1 页 stub） |

**闭环验证**：解压 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）

> [!重点]
> **Shift+G** 一键搭建 7 节点 ET 流程并自动运行扒版 AI 管道，产出可交付工厂的 ZIP（正背面 1:1、POM、DXF、工艺说明）。

> [!步骤]
> 1. **Shift+G** 或 Agent「一键 ET 打版」→ 自动创建 imageRef×2 + silhouette/fabric/construction + techPack + export。
> 2. 有画布图片时立即跑管道：识别品类 → 描摹 → 评图 → POM → 打包。
> 3. 无背面图：Vision 分析正面 → FLUX 生成 2–3 张候选背面 → 在扒版交付面板点选。
> 4. 款号留空自动分配 **ET-M-XXXX**，避免 DRAFT 文件夹名。
> 5. 完成 measure 比例校准 → patternTrace 结构线 → **Shift+F** 或 **Ctrl+Shift+E** 导出。

> [!快捷键]
> Shift+G — 一键 ET 打版
> G — 制版工作台
> Shift+F — 扒版交付导出
> Ctrl+Shift+E — 制版全套资料

> [!路径]
> 画布 → Shift+G 搭流 → 扒版交付面板 → 选背面/校准 → 导出工厂 ZIP

> [!注意]
> 以下情况**阻止下载**工厂 ZIP：正背面 1:1 图内容相同（工厂拒收）、评图 passFactoryReady 为 false、款号被清空、POM 少于 8 行、评图 blocker 级问题。

> [!提示]
> AI 背面推演成功后 tech_spec.backViewSource = ai_generated，交接清单会备注「投产前请版师复核背面」；信息性提示（DXF POM 降级等）为 info 级别，非 error。

### 适用场景

对齐 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 生成 + 设计师评图）**：
   - 已上传独立背面：直接使用。
   - 未上传背面：Vision 分析正面结构 → **FLUX 2 Pro**（Privileged/Enterprise）或 FLUX 2 / Nano Banana 生成 2–3 张候选背面。
   - **设计师评图流程**（扒版交付面板）：
     - 每张候选与正面并排对比（全宽展示）；
     - **采用此背面**：确认后继续管道（须通过正背面像素去重）；
     - **不合格，说明原因**：填写评图说明（如「需展示后领深、无胸前口袋」）→ AI 注入说明重跑；
     - **上传真实背面**：可选覆盖 AI 候选；
     - 显示「第 N/3 次生成」；达 3 次仍不合格则阻塞，须上传真实背面或修正正面图。
   - 导出门禁：`backViewSource = ai_generated` 时须 `backApprovedByDesigner = true`；`pattern_review.json` 记录生成次数。
5. **款号**：留空时自动分配 `ET-M-XXXX` 格式（基准码 + 4 位随机码），避免导出文件夹名为 DRAFT。
6. 面板流程：`measure`（比例原点）→ `patternTrace`（结构线）→ `factoryPatternTemplate`（扒版交付）。
7. 扒版交付面板显示描摹线稿预览、POM 表（≥8 行）、工艺说明，可 **Shift+F** 再次导出，或 **Ctrl+Shift+E** 导出制版全套资料。

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

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

| 拦截条件 | 说明 |
|----------|------|
| 正背面 1:1 图内容相同 | 像素级比对相同，工厂会拒收 |
| AI 背面未经设计师确认 | `backViewSource=ai_generated` 但设计师未点「采用此背面」 |
| `passFactoryReady === false` | 制版评图未达工厂就绪（通常 <75 分或有 blocker） |
| 款号为空 | 管道会自动补 `ET-M-XXXX`，但若被清空仍拦截 |
| POM < 8 行 | 测量表不完整 |
| 评图 blocker 级问题 | 如结构缺失、品类矛盾 |

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

### 无袖款式 POM 过滤

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

### DXF 自动重试

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

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

| 文件 | 说明 |
|------|------|
| `front_1to1.png` | 正面 1:1 制版图（300 DPI 等效，≥2000px 或含物理 cm 元数据） |
| `back_1to1.png` | 背面 1:1 制版图 |
| `trace_front.png` | 正面 Sobel 描摹线稿（从实际上传图提取） |
| `trace_back.png` | 背面描摹线稿 |
| `pom_factory.csv` | 款号/季节/尺码/部位/尺寸cm/公差/缝份（≥8 行） |
| `tech_spec.json` | styleNo、colorway、season、sizeRange、pxPerCm、fabricClass、seamAllowance |
| `工艺说明.txt` | 中文缝制顺序（≥200 字，含品类专用术语） |
| `pattern_review.json` | 制版评图 score、issues、passFactoryReady |
| `BOM.csv` / `工艺单.csv` | 面辅料清单 |
| `pieces.dxf` | 多裁片 + CUT/SEAM_ALLOWANCE/NOTCH 图层（针织1cm/梭织1.5cm） |
| `pieces_aama.dxf` | AAMA-DXF minimal stub |
| `notches.json` | 刀眼坐标 + pairId 对位点（袖笼 match-armhole-fb） |
| `grade_point_rules.csv` | 放码点 ΔX/ΔY per size |
| `pipeline_steps.json` | 管道步骤审计（flat 相似度、DXF、评图等） |
| `tech_pack_summary.pdf` | 双语工艺单摘要 PDF |
| `front_annotated_pom.png` | 可选：正面 POM 标注图 |

**行业对齐说明**：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）

> [!重点]
> **Shift+F** 打开工厂 CMT 交接面板：正背面 1:1 校准、POM、缝份元数据，一键 ZIP；与 ET 管道共用 measureStore 与 QC 门禁。

> [!步骤]
> 1. **Shift+F** 或 TechPack 节点「扒版交付」→ 导入正背面图（正面必填）。
> 2. 仅正面时：运行「一键生成制版资料」→ 对比正背面候选 → **采用此背面**。
> 3. 候选不合格：点「不合格，说明原因」→ 填写评图说明 → **提交说明并重跑 AI**（最多 3 次）。
> 4. 绘制已知长度参考线完成 **1:1 比例校准**；填写款号/季节/尺码/缝份。
> 5. 「导出工厂扒版包」通过 QC 后下载；或 **Ctrl+Shift+E** 全套资料模态框。

> [!快捷键]
> Shift+F — 扒版交付面板
> Ctrl+Shift+E — 一键导出制版全套资料

> [!注意]
> 与 ET 共用 assertFactoryExportAllowed：正背面相同、passFactoryReady 为 false、款号空、POM <8 行、blocker 评图问题均**阻止下载**。

> [!提示]
> 可「上传真实背面（覆盖 AI）」跳过 AI 候选；AI 背面采用后需版师投产前复核。

### 适用场景

工厂 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. 精修工作台

> [!重点]
> **R** 打开 Refine Studio；首选 **草图精修** — 全宽圈划 + 文字说明，配合左侧通用工具栏（魔棒、画笔等）精准修改。

> [!步骤]
> 1. **R** 打开精修工作台 → 选择 **草图精修**。
> 2. 图片按面板宽度等比例放大（全宽 minus 左侧工具栏），便于圈划。
> 3. 用 K/X/M 等模式标注，或使用左侧通用工具栏的魔棒、画笔、套索、取色。
> 4. 在下方**修改说明**填写文字（与标注一并发送）→ **根据标注+文字生成**。
> 5. 前后对比滑块验收 → 进入制版（CSM 路径第 3→4 步）。

> [!快捷键]
> R — 打开精修工作台
> K — 保留（绿笔刷）
> X — 去掉（红笔刷）
> M — 改这里（蓝笔刷）
> P — 参照取色
> A — 方向箭头
> B — 轮廓线
> E — 橡皮擦

> [!提示]
> 空状态引导：「全宽显示便于圈划；可同时使用图上标注与下方文字说明。」左侧通用工具栏在草图精修打开时仍可用。

### 适用场景

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

### 步骤

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

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

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

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

| 模式 | 快捷键 | 用途 |
|------|--------|------|
| 保留 | K | 绿色笔刷，圈出必须原样保留的区域 |
| 去掉 | X | 红色笔刷，圈出要消除或替换的区域 |
| 改这里 | M | 蓝色笔刷，配合下方文字说明 |
| 参照 | P | 点击取样颜色/纹理 |
| 方向 | A | 拖拽箭头指示改动方向（下摆加长等） |
| 轮廓 | B | 沿廓形描线，提示边缘调整 |
| 橡皮 | E | 擦除标注笔迹 |

**流程**：上传或载入画布最新图 → 全宽圈划标注 → 填写修改说明 → **根据标注+文字生成** → 语义蒙版（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）

| 项目 | 内容 |
|------|------|
| 适用场景 | 礼服、日常裙、教学默认品类 |
| 步骤 | 输入「连衣裙」「dress」→ 自动搭建 → 调整 mood/廓形 → Render |
| 快捷键 | Agent 对话 |
| 相关节点 | styleMood · colorPalette · fabric · silhouette · detail · render |
| 常见问题 | 与 collection 模板冲突时说单一品类名 |

### 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** 打开场景模板面板应用（会覆盖当前画布，需确认）。

| ID | 名称 | 适用场景 | 核心节点链 |
|----|------|----------|------------|
| costing_workflow | 商业成本分析 | 报价、核价 | trend → style → render → costing → export |
| tech_pack_workflow | 打版图生成 | 效果图反推制版 | 见第 6 节 |
| retouch_workflow | 局部精修 | 改已有设计图 | render → deconstruction → retouch → export |
| fabric_dev_workflow | 面料开发 | 新面料/配色样 | trend → fabric → fabricAdvanced → pantone → render |
| collection_workflow | 下一季系列款 | 一系列多品类 | trend → 4×silhouette → 4×render → lookbook export |
| color_variants_workflow | 同款不同色 | 配色卡 | render + 5×colorPalette → 5×render → export |
| trend_workflow | 时尚趋势预测 | 调研报告 | trendForecast → promptMod → render → export |
| ecommerce_workflow | 电商产品图 | 白底/场景多图 | render → retouch → 3×backgroundReplace → export |
| pattern_dev_workflow | 印花/图案开发 | 图案提取应用 | imageRef → deconstruction → patternTransfer → export |
| proposal_workflow | 客户提案 | 完整提案 deck | trend → moodboard → style → fabric → color → render×2 → export |

---

## 19. 反向拆解与重设计

### 适用场景

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

### 步骤

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

### 快捷键

Agent 关键词触发

### 相关节点

`imageRef` · `deconstruction` · `retouch`

### 常见问题

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

---

## 20. 快捷键总表

> [!重点]
> 最常用五条：**Shift+G** ET 打版 · **Shift+F** 扒版交付 · **H** 出图 · **R** 精修 · **Ctrl+K** Agent。

> [!快捷键]
> Shift+G — 一键 ET 打版（et_pattern_full）
> Shift+F — 扒版交付 / 工厂 ZIP
> Ctrl+Shift+E — 制版全套资料导出
> H — 生成中心
> R — 精修工作台
> G — 制版工作台
> Ctrl+K — Agent 对话
> Ctrl+E — 导出面板
> ? — 使用说明

### 画布与通用

| 快捷键 | 功能 |
|--------|------|
| Ctrl+Z / Ctrl+Y | 撤销 / 重做 |
| Ctrl+C / Ctrl+V | 复制 / 粘贴节点 |
| Ctrl+D | 复制选中节点 |
| Ctrl+A | 全选 |
| Delete | 删除选中 |
| Ctrl+S | 保存工作流到本地 |
| Ctrl+E | 导出面板 |
| Ctrl+, | 设置 |
| Ctrl+K | Agent 对话 |
| Ctrl+P / / | 命令面板 |
| Tab | 快速添加节点 |
| ? | 使用说明 |
| Ctrl+0 | 适应视图 |
| Ctrl+\\ | 切换左侧面板 |
| Ctrl+] | 切换右侧面板 |
| F2 / R | 重命名选中节点 |

### 垂直工具栏

| 快捷键 | 功能 |
|--------|------|
| V | 选择 |
| Space | 平移画布 |
| H | 生成中心 |
| R | 精修工作台 |
| G | 制版工作台 |
| Shift+G | 一键 ET 打版（et_pattern_full） |
| Shift+F | 扒版交付 |
| Ctrl+Shift+E | 一键导出制版全套资料（ET Master Export） |
| U | 测量工具 |
| T | 场景模板 |
| N | 切换左侧面板 |
| K | Agent |
| L | 套索选择 |
| I | 同色/取色 |
| E | 橡皮擦 |
| W | 魔术橡皮擦 |
| S | 印花贴合 |
| O | 光影调整 |
| M | 素材库 |
| Shift+M | 素材库（全局） |
| Ctrl+Shift+G | 制版工作台（备用） |

### 精修与草图标注（规划）

| 快捷键 | 功能 |
|--------|------|
| K | 保留标注（视觉标注精修，规划中） |
| X | 去掉标注（规划中） |
| C | 改这里（规划中） |
| P | 参照取色（规划中） |
| A | 方向箭头（规划中） |
| B | 轮廓线（规划中） |

---

## 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」）。移动端可长按查看。

### 本地存储策略

| 存储 | 内容 |
|------|------|
| localStorage（瘦身 persist） | 节点结构、位置、短 http(s) URL、POM/款号/测量元数据；剥离 data:/blob: 大图与 promptHistory 等重字段 |
| IndexedDB `fns-image-cache` | 画布节点与图库的大图 data URL，按 nodeId:field 键恢复 |
| 配额保护 | 超限时结构-only 降级 + toast；图库 prune 最旧条目 |

用户可见影响：换浏览器或清站点数据后需重新上传图片；工作流拓扑与 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 节点）

| 身份 | 默认出图 | 一键入口 |
|------|----------|----------|
| 电商设计师 | 白底 **1:1** · standard | 生成中心「电商白底主图一键搭流」 |
| 跨境贸易 | 1:1 主图 · EN 导出提示 | `ecommerce_workflow` |
| 独立品牌 | 3:4 + 品牌色板 | 小单 Lookbook 模板 |
| 高级时装 | **Premium 4K** · 2:3 editorial | 生成中心高定 tier 提示 |
| 学生 | **draft 档** · 积分说明 | SimpleMode 默认 CTA |
| 作品集 | premium · 3:4 | 画廊「作品集导出 · 项目名」 |
| 针织制版师 | Fabric knit 筛选提示 | 快速出图 + 素材库 |
| 运动/机能 | 9:16 · batch 矩阵 | Batch 默认开启 |

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

| 身份 | 推荐模板 | 空画布 |
|------|----------|--------|
| 电商 | `ecommerce_workflow` | 电商主图 + 批量 SKU |
| 独立品牌 | `indie_lookbook_workflow` | 小单 Lookbook + Mood Board |
| 学生 | `csm_standard` | 快速出图 + CSM 入门 |
| 作品集 | `collection_workflow` | 画廊 + PDF Lookbook |
| 未设置身份 | 通用 CSM / 电商 / 制版入口 | 新手导览 + 空画布主路径 |

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

### 制版师（按款式专长）

| 身份 | 推荐路径 | 快捷键 |
|------|----------|--------|
| 针织 T 恤/卫衣 | G → 点「针织 T 恤/卫衣」预载 POM → U 测量 | G, U |
| 西装/外套 | 评图 → 描摹 → Shift+F 扒版 | G, Shift+F |
| 连衣裙/半裙 | G → 资料库 + 专长筛选 → 打版向导 | G |
| 牛仔/工装 | 素材库 → 测量 → 工厂包 | M, U, Shift+F |
| 运动/机能 | 一键 ET → 批量 SKU | Shift+G, Batch |

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

### 使用场景

| 身份 | 空画布快捷 | 重点功能 |
|------|------------|----------|
| 电商设计师 | 电商主图 / 批量 SKU / 生成中心 | Batch SKU + 白底 1:1 Hub |
| 跨境贸易 | 测量 in/cm / 双语导出 / 扒版 | BOM 中英列 + HS 编码占位 |
| 独立品牌 | 小单 Lookbook / Mood Board / CSM | `indie_lookbook_workflow` |
| 高级时装 | Editorial 出图 / 精修 / 评图 | Premium tier + proposal 流程 |
| 工厂 QC | 评图 / 扒版 / 全套导出 | passFactoryReady gate |
| 学生 | **快速出图** / 打版向导 / CSM | Render 术语表 + draft 档 |
| 作品集 | 高清出图 / 画廊 4K bundle | 画布 Tab 名写入导出文件名 |

### 测量工具（跨境 / 学生）

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

### 内部参考

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

---

## 25. 色彩与视觉规范

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

### 品牌色角色

| Token | 用途 | 示例 |
|-------|------|------|
| `--color-accent-primary` (#b4f72a) | 主 CTA、工具栏 active、生成按钮 | 仅用于「当前操作」 |
| `--color-accent-secondary` (#9b8ec4) | 焦点环、链接、节点选中连线 | 交互辅助，非主按钮 |
| `--color-editorial-warm` (#c8a087) | 重点 callout、lookbook 标题感 | 时尚编辑风 |
| `--color-export-paper` (#f7f5f2) | Mood Board / Share Card 纸色 | 导出模板背景 |

### 语义色

| 类型 | Token | 场景 |
|------|-------|------|
| 成功 | `--color-semantic-success` | 完成、通过 QC |
| 注意 | `--color-semantic-warning` | 扒版警告、工厂拦截 |
| 错误 | `--color-semantic-error` | 导出 blocker、评图驳回 |
| 提示 | `--color-semantic-info` | 底部 status bar 信息 |

### 文本与对比

- 正文 `--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`。

### 设计原则

| 维度 | 规范 |
|------|------|
| 字体 | SF Pro 系统栈；大标题 28–34px、标题 20–22px、正文 15px、说明 12–13px（避免 10px 拥挤文案） |
| 间距 | 8pt 网格：8 / 16 / 24 / 32 / 48；面板内边距 20–24px |
| 主操作 | 每视图 **一个** 填充主按钮（lime 胶囊 `.apple-btn-primary` / `.btn-primary-cta`） |
| 次操作 | 描边或幽灵 `.apple-btn-secondary` / `.apple-btn-ghost` |
| 切换 | 分段控件 `.apple-segmented`（如性别 F/M/U、制版 Tab、AI Quick/Node） |
| 表面 | 毛玻璃 `backdrop-blur` + 白 8% 描边；卡片用 `.apple-card`，少用霓虹外发光 |
| 动效 | 200–300ms `cubic-bezier(0.25, 0.1, 0.25, 1)`；尊重 `prefers-reduced-motion` |

### 色彩纪律

- **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（新手导览）*