Flamo 管道插件

Flamo 管道插件免费、无需账号，可将中心线转换成可编辑的 HMI 管道，并维护 Figma 原生图层。所有插件见 插件中心。

安装开发版

当前提供 Figma 桌面端开发版，尚未发布到 Figma Community。

1. 下载并解压 Flamo 管道插件，保留整个文件夹。
2. 打开 Figma 桌面应用和设计文件，进入 Plugins → Development → Import new plugin from manifest…。
3. 选择解压文件夹里的 manifest.json，然后从 Development 菜单运行 Flamo HMI Pipe。

安装包已包含可运行代码，无需自行编译。插件使用内置 Flamo Logo，不进行网络请求，也不要求登录。

使用流程

1. 使用 Figma Pen（P）或 Line（L）绘制一条开放、连续、无分叉的中心线。
2. 选中单个 VECTOR 或 LINE，点击“转换为管道”。
3. 在 Pipe Inspector 中配置管径、壁厚、颜色、端帽、连接方式和可选流向虚线。
4. 点击“编辑原路径”，在 Figma 画布按 Enter 编辑原钢笔路径的锚点、曲线或圆角。
5. 完成后按 Esc，再点击“按原路径重新生成”，以最新路径和属性更新管道。

选中管道或其任一子图层即可编辑全部属性。关闭流向时仍能调整颜色、线宽、Pattern、方向和速度；线宽必须不超过管道内径。未应用的修改在本次插件会话内按管道保留，切换选择不会把它们写到另一条管道；重新生成也会一起保存这些修改。关闭插件前请应用需要保留的属性。

Figma Pen / Line
  -> Convert to Pipe
  -> PipeSpecV3 / PipeRenderPlan
  -> ordinary Group + Vector/Line layers

流向 Pattern 接受 1–64 个以空格或逗号分隔的非负 px 数值，例如 8 6 或 8, 4, 2, 4；允许奇数项与零长度项，但不能全部为零。旧版 dash/gap record 会在读取时迁移到 canonical dashPattern。

循环组与运动素材

在「路径运动」选择「循环组」，可用对象、散布片段和空隙组成重复序列。对象占位长度与显示大小独立；空隙推进下一项，位置偏移只改变当前项。范围上下限相同为固定值，不同为随机值；固定种子保证随机外观在运动中不抖动。

煤块输送可选「煤块传送带」预设，设置片段长度、带宽和片段内数量，再隐藏管壁与介质，叠加在静态传送带上。车辆、箭头和粒子沿相同方式设置，朝向可跟随路径切线或保持固定。

「随机与素材」可添加内置图形、上传图片，或固定目标管道后选取 Figma 图形/组合。所选内容保存为独立 PNG 快照，保留原色；删除原素材不影响已应用的动效。图片可指定原始前向，纠正车头朝上等素材的运动朝向。

管壁和介质支持独立显示与 0–100% 透明度。需要透视内腔时生成真正空心的管壁。局部预览可播放、暂停和重播；Figma 画布只显示管壁和介质，不插入煤块、车辆、粒子或流向虚线。完成同步后，Flamo 在运行时动态创建运动对象并播放动画。

循环组最多 32 项、16 种素材，单个散布片段最多 200 个对象，路径素材节点池最多 1600。超过上限会提示调整配置。旧 v1/v2 管道会升级为 v3 并保留虚线设置。曲线拖尾、发光、单次和往返尚未开放。

加速度与落煤

循环组的加速度默认 0 m/s²，保持匀速。设为正数后，速度表示每个对象进入路径时的初速度；画布比例默认 100 px = 1 m，发射周期默认每个名义循环组 1 s。

模拟落煤：画竖直向下的路径，选择煤块预设、隐藏管壁和介质，初速度设为 0 px/s，加速度设为 9.8 m/s²。每块煤独立加速，先进入的煤更快，间距随运动拉大。可调整发射周期控制补充节奏，随机空隙也影响实际周期。预览支持按秒定位，并将当前预览位置设为运行起点。

加速模式的速度为 0 仍会运动，请使用暂停按钮。修改初速度、方向或加速度会按当前相位重新排布。加速度沿路径作用，弯曲路径是轨道加速；暂不模拟碰撞、堆积或反弹。低加速度与密集发射可能超出节点预算，可延长发射周期或减少片段内数量。

图层结构

转换结果保留原始、未锁定的中心线，并生成锁定的介质与流向派生层。group 保存版本化 authoring record；派生层可以从中心线与 PipeSpec 确定性重建，不是第二份业务事实源。“编辑原路径”期间暂停自动重建，让用户完成锚点、切线和圆角调整；点击重新生成后恢复自动更新。重新打开插件并选中管道时也会校准几何，未完成的路径会提示继续修正。

能力边界

• 只支持单个开放、无分叉、无填充区域的等宽 BASIC stroke；
• 不支持闭环、分叉、自动布管、端口吸附、variable-width、dynamic 或 brush stroke；
• Figma 主画布仅保留管壁、介质与隐藏路径/资源信息；插件面板可试播，Flamo 动态生成流体效果；
• 插件不执行网络请求、Artifact 导出、同步或发布；
• Runtime core 不新增 pipe primitive。

管道 schema、验证与 compiler 位于上层 @flamo/hmi；它把业务语义 lowering 为通用 Group/Path/Vector、stroke、motion 与 binding。这样其他工业对象可以扩展 HMI 层，而不污染 Runtime ABI。

旧版管道若已有大量煤块图层，选中管道并在新版插件中重新生成，会在成功保存后清理旧节点池。图片素材由隐藏资源引用保留，不会沿整条路径复制。