@jnrs/lingshu-smart 2.2.28 → 2.2.29

package/AGENTS.md

@@ -74,7 +74,7 @@ const handleExit = () => {
 import { ref, computed, onMounted } from 'vue'
 import type { ICase, ILayer, ILayerOperating, InteractiveUi } from '@/types'
 import { EnumModel } from '@/types'
-import { transRuntimeToPixel } from '@/utils'
+import { transRuntimeToPixel, transPercentToPixel } from '@/utils'
 import LingshuSmartPreview from '@/components/preview/index.vue'
 
 const lingshuSmartPreviewRef = ref()
@@ -305,7 +305,7 @@ operating({
     color: payload.status === 2 ? 'green' : '#424242',
     blinking: payload.status === 2
   },
-  x: transRuntimeToPixel(payload.x, 1, 'width') // 沿轨道移动时需转换
+  x: transPercentToPixel(payload.x, 2, 'width') // 沿轨道移动时需转换
 })
 ```
 
@@ -320,7 +320,7 @@ operating({
     color: payload.status === 2 ? 'green' : '#424242',
     blinking: payload.status === 2
   },
-  x: transRuntimeToPixel(payload.x, 1, 'width'),
+  x: transPercentToPixel(payload.x, 2, 'width'),
   j1: payload.j1, // 一级关节角度（度）
   currentFixture: payload.currentFixture // EnumResourceType.PALLET | TOOL
 })
@@ -337,7 +337,7 @@ operating({
     color: payload.status === 0 ? '#f30' : '#424242'
   },
   currentFixture: payload.currentFixture,
-  x: transRuntimeToPixel(payload.x, 1, 'width'),
+  x: transPercentToPixel(payload.x, 2, 'width'),
   j1: payload.j1,
   j2: payload.j2
 })
@@ -392,10 +392,10 @@ operating({
   id: payload.id,
   rawData: payload,
   light: { color: payload.lightColor, blinking: payload.blinking },
-  x: transRuntimeToPixel(payload.x, 1, 'width'),
+  x: transPercentToPixel(payload.x, 2, 'width'),
   j1: payload.j1, // 旋转角度
-  forkXY: payload.forkXY, // 货叉横向移动比例 0~1
-  forkZ: payload.forkZ // 货叉升降比例 0~1
+  forkXY: payload.forkXY, // 货叉进出移动比例 [−1,1]
+  forkZ: payload.forkZ // 货叉升降比例 [0,1]
 })
 ```
 
@@ -423,6 +423,18 @@ const pixelX = transRuntimeToPixel(payload.x, 1, 'width')
 const pixelY = transRuntimeToPixel(payload.y, 1, 'height')
 ```
 
+### 百分比转换为像素数值
+
+后端推送的 `x` / `y` 通常为**百分比数值**（范围通常为[-1,1]），画布使用**像素坐标**。转换公式：
+
+```typescript
+import { transPercentToPixel } from '@jnrs/lingshu-smart'
+
+// 宽方向：pixel = percentVal * scene.width
+const pixelX = transPercentToPixel(payload.x, 2, 'width')
+const pixelY = transPercentToPixel(payload.y, 1, 'height')
+```
+
 **前提：** 方案 `IScene` 中需配置 `runtime_width` / `runtime_height`。该函数读取 `useEditorStore().scene`，预览页需确保场景数据已加载。
 
 ### WebSocket 接入示例
@@ -559,14 +571,14 @@ type ILayerOperating =
 
 #### IRGVOperating
 
-| 属性       | 类型                 | 说明                 |
-| ---------- | -------------------- | -------------------- |
-| `light`    | `ILightOperating`    | 双灯同步更新         |
-| `x`        | `number`             | 沿轨道位移（像素）   |
-| `j1`       | `number`             | 车体旋转角度（度）   |
-| `forkXY`   | `number`             | 货叉横向移动比例 0~1 |
-| `forkZ`    | `number`             | 货叉升降比例 0~1     |
-| `resource` | `IResourceOperating` | 托盘/刀具工位槽      |
+| 属性       | 类型                 | 说明                      |
+| ---------- | -------------------- | ------------------------- |
+| `light`    | `ILightOperating`    | 双灯同步更新              |
+| `x`        | `number`             | 沿轨道位移（像素）[0,1]   |
+| `j1`       | `number`             | 车体旋转角度（度）[0,360] |
+| `forkXY`   | `number`             | 货叉进出移动比例 [−1,1]   |
+| `forkZ`    | `number`             | 货叉升降比例 [0,1]        |
+| `resource` | `IResourceOperating` | 托盘/刀具工位槽           |
 
 #### IRailOperating
 
@@ -666,6 +678,7 @@ type ILayerOperating =
 | `transPercentAndPixel(val, size, precision?, getPercent?)` | 百分比 ↔ 像素                                       |
 | `transFraction(val, size)`                                 | 百分比转小数                                         |
 | `transRuntimeToPixel(val, precision?, type?)`              | 运行时坐标 → 像素（依赖 scene.runtime_width/height） |
+| `transPercentToPixel(val, precision?, type?)`              | 百分比数值 → 像素（依赖 scene.width/height）         |
 
 ---
 
@@ -673,7 +686,7 @@ type ILayerOperating =
 
 1. **编辑器 vs 预览：** 编辑模式配置 `EditorActions`；预览模式配置 `PreviewActions` + `onMessage` → `operating`
 2. **ID 匹配：** `operating` 的 `id` 必须与方案图层 `rawData.id` 一致，否则静默失败（在前端层面该值即为编辑器组件中业务数据配置中必填项 id 的值，需根据后端预先提供的设备 id 在编辑器中进行配置）
-3. **坐标系：** 轨道类设备的 `x` 通常需 `transRuntimeToPixel` 转换；`IRailOperating.x` 直接使用像素
+3. **坐标系：** 轨道类设备的 `x` 通常需 `transPercentToPixel` 转换；`IRailOperating.x` 直接使用像素
 4. **资源消息：** `Resource` 类型不对应独立图层，通过目标设备的 `resource` 字段操作工位槽
 5. **引擎生命周期：** 组件卸载时自动 `destroyContainer`；手动集成需自行销毁
 6. **类型安全：** 所有 API 均导出 TypeScript 类型，推荐 `import type { ILayerOperating, EnumModel } from '@jnrs/lingshu-smart'`

package/README.md

@@ -24,4 +24,4 @@ import type { ILayerOperating } from '@jnrs/lingshu-smart'
 import { LingshuSmartPreview, LingshuSmartEditor } from '@jnrs/lingshu-smart/components'
 ```
 
-详细文档请查看 `AGENTS.md`
+详细文档请查看 [AGENTS.md](./AGENTS.md)

package/dist/components/index.js

@@ -2,7 +2,7 @@
 import { defineComponent as W, ref as oe, createElementBlock as z, openBlock as R, createElementVNode as n, createVNode as r, withDirectives as pe, unref as e, withCtx as k, vModelText as _t, Fragment as re, renderList as ke, toDisplayString as de, vShow as _e, normalizeClass as we, withModifiers as De, watch as Me, createCommentVNode as ye, createTextVNode as J, createBlock as Se, normalizeStyle as it, computed as be, onMounted as Qe, onUnmounted as vt, nextTick as ut, createStaticVNode as wt } from "vue";
 import { ElIcon as le, ElMessage as Ue, ElSelect as ge, ElOption as H, ElColorPicker as dt, ElInputNumber as ce, ElButton as $e, ElInput as Z, ElPopover as bt, ElInputTag as Vt, ElDialog as Ze, ElSwitch as Ce, ElForm as xt, ElFormItem as Ae, ElTable as kt, ElTableColumn as he, ElTag as $t, ElRadioGroup as St, ElRadioButton as ft, ElDropdown as et, ElDropdownMenu as tt, ElDropdownItem as Be, ElMessageBox as je, vLoading as mt } from "element-plus";
 import { storeToRefs as ee } from "pinia";
-import { u as Re, m as ae, L as Et, D as Ct, M as It, o as Ut, p as Bt, W as Lt, t as Fe, q as Ie, d as xe, h as qe, e as He, i as We, f as Xe, a as Dt, g as Le, r as nt, E as Oe, s as Tt } from "../index-tpebqVjC.js";
+import { u as Re, o as ae, L as Et, D as Ct, M as It, p as Ut, q as Bt, W as Lt, t as Fe, r as Ie, d as xe, h as qe, e as He, i as We, f as Xe, a as Dt, g as Le, s as nt, E as Oe, v as Tt } from "../index-xyCXB0RY.js";
 import { Search as At, WarnTriangleFilled as Ye, View as gt, Hide as Ot, Delete as Pe, QuestionFilled as Mt, Select as Rt, ArrowDown as ot, Plus as Nt, Connection as zt, Refresh as jt, Finished as Ft, Back as Pt, Right as Yt, SwitchButton as Gt } from "@element-plus/icons-vue";
 import { clipboard as yt, formatDateTime as Jt } from "@jnrs/shared";
 const qt = { class: "menu" }, Ht = { class: "menu_input" }, Wt = { class: "menu_container tinyScrollbar" }, Xt = { class: "menu_group_title" }, Kt = ["onClick"], Qt = { class: "menu_group_noItem" }, Zt = { class: "noData" }, en = /* @__PURE__ */ W({