@jnrs/lingshu-smart 3.0.0 → 3.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md CHANGED
@@ -346,12 +346,12 @@ lingshuSmartPreviewRef.value?.setSocketHandlers({
346
346
 
347
347
  ### 坐标与数值约定
348
348
 
349
- | 约定项 | 说明 |
350
- | -------- | ----------------------------------------------------------------------------- |
351
- | 序号体系 | 工位 `device_station` 与层 `device_layer` 均 **1-based** |
352
- | 比例值 | 进度、货叉位移、设备位移 `position.x/y/z` 使用比例值 \[0,1],画布自动换算像素 |
353
- | 角度值 | 关节/旋转角度 `position.j1/j2` 单位为 **度** |
354
- | 时间格式 | `envelope.timestamp` 用 ISO 8601;payload 内业务时间戳用 Unix **秒** |
349
+ | 约定项 | 说明 |
350
+ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
351
+ | 序号体系 | 工位 `device_station` 与层 `device_layer` 均 **1-based** |
352
+ | 比例值 | 进度、货叉位移、设备位移 `position.x/y/z` 使用比例值 \[0,1],画布自动换算像素(值 > 1 视为代理已换算的像素值,原样使用);设备绑定轨道(`linkRailId`)时 `position.x` 改为**沿轨距离**(≤1 为轨道长度比例、>1 为沿轨像素距离) |
353
+ | 角度值 | 关节/旋转角度 `position.j1/j2` 单位为 **度** |
354
+ | 时间格式 | `envelope.timestamp` 用 ISO 8601;payload 内业务时间戳用 Unix **秒** |
355
355
 
356
356
  ### 心跳与重连
357
357
 
@@ -383,12 +383,13 @@ onMounted(() => {
383
383
 
384
384
  ### 基类 IModelOperating
385
385
 
386
- | 属性 | 类型 | 必填 | 说明 |
387
- | ----------- | -------------------- | ---- | ----------------------------------- |
388
- | `id` | `string` | ✓ | 业务设备 ID,对应图层 `rawData.id` |
389
- | `className` | `EnumModel` | ✓ | 设备类型枚举,用于 businessMap 匹配 |
390
- | `rawData` | `IRowData` | ✓ | 原始业务数据,建议传入完整 payload |
391
- | `resource` | `IResourceOperating` | — | 工位槽资源增删(多设备共用) |
386
+ | 属性 | 类型 | 必填 | 说明 |
387
+ | ----------- | -------------------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
388
+ | `id` | `string` | ✓ | 业务设备 ID,对应图层 `rawData.id` |
389
+ | `className` | `EnumModel` | ✓ | 设备类型枚举,用于 businessMap 匹配 |
390
+ | `raw_data` | `IRowData` | ✓ | 原始业务数据,建议传入完整 payload |
391
+ | `resource` | `IResourceOperating` | — | 工位槽资源增删(多设备共用) |
392
+ | `nameplate` | `string` | — | 铭牌文本(全部设备通用):替换画布铭牌文字并按文字长度重算宽度与螺钉孔;仅影响画布 UI,`scene_reset` 后回到配置里的初始文本,动态文本需复位后重新下发 |
392
393
 
393
394
  ### 联合类型 ILayerOperating
394
395
 
@@ -487,37 +488,37 @@ type ILayerOperating =
487
488
 
488
489
  #### ISingleJointRobotOperating
489
490
 
490
- | 属性 | 类型 | 说明 |
491
- | ---------------- | -------------------- | --------------------------- |
492
- | `light` | `ILightOperating` | 双灯同步更新 |
493
- | `x` | `number` | 沿轨道水平位移(像素) |
494
- | `y` | `number` | 垂直位移(像素) |
495
- | `j1` | `number` | 一级关节角度(度) |
496
- | `currentFixture` | `EnumResourceType` | 当前夹具:`Pallet` / `Tool` |
497
- | `resource` | `IResourceOperating` | 托盘/刀具工位槽 |
491
+ | 属性 | 类型 | 说明 |
492
+ | ---------------- | -------------------- | ------------------------------------------------------------------- |
493
+ | `light` | `ILightOperating` | 双灯同步更新 |
494
+ | `x` | `number` | 位移(像素);绑定轨道时按沿轨距离定位(≤1 比例 / >1 沿轨像素距离) |
495
+ | `y` | `number` | 垂直位移(像素) |
496
+ | `j1` | `number` | 一级关节角度(度) |
497
+ | `currentFixture` | `EnumResourceType` | 当前夹具:`Pallet` / `Tool` |
498
+ | `resource` | `IResourceOperating` | 托盘/刀具工位槽 |
498
499
 
499
500
  #### IDoubleJointRobotOperating
500
501
 
501
- | 属性 | 类型 | 说明 |
502
- | ---------------- | -------------------- | ---------------------- |
503
- | `light` | `ILightOperating` | 双灯同步更新 |
504
- | `x` | `number` | 沿轨道水平位移(像素) |
505
- | `y` | `number` | 垂直位移(像素) |
506
- | `j1` | `number` | 一级关节角度(度) |
507
- | `j2` | `number` | 二级关节角度(度) |
508
- | `currentFixture` | `EnumResourceType` | 当前夹具类型 |
509
- | `resource` | `IResourceOperating` | 托盘/刀具工位槽 |
502
+ | 属性 | 类型 | 说明 |
503
+ | ---------------- | -------------------- | ------------------------------------------------------------------- |
504
+ | `light` | `ILightOperating` | 双灯同步更新 |
505
+ | `x` | `number` | 位移(像素);绑定轨道时按沿轨距离定位(≤1 比例 / >1 沿轨像素距离) |
506
+ | `y` | `number` | 垂直位移(像素) |
507
+ | `j1` | `number` | 一级关节角度(度) |
508
+ | `j2` | `number` | 二级关节角度(度) |
509
+ | `currentFixture` | `EnumResourceType` | 当前夹具类型 |
510
+ | `resource` | `IResourceOperating` | 托盘/刀具工位槽 |
510
511
 
511
512
  #### IRGVOperating
512
513
 
513
- | 属性 | 类型 | 说明 |
514
- | ---------- | -------------------- | -------------------------- |
515
- | `light` | `ILightOperating` | 双灯同步更新 |
516
- | `x` | `number` | 沿轨道位移(像素)\[0,1] |
517
- | `j1` | `number` | 车体旋转角度(度)\[0,360] |
518
- | `forkXY` | `number` | 货叉进出移动比例 \[−1,1] |
519
- | `forkZ` | `number` | 货叉升降比例 \[0,1] |
520
- | `resource` | `IResourceOperating` | 托盘/刀具工位槽 |
514
+ | 属性 | 类型 | 说明 |
515
+ | ---------- | -------------------- | ------------------------------------------------------------------- |
516
+ | `light` | `ILightOperating` | 双灯同步更新 |
517
+ | `x` | `number` | 位移(像素);绑定轨道时按沿轨距离定位(≤1 比例 / >1 沿轨像素距离) |
518
+ | `j1` | `number` | 车体旋转角度(度)\[0,360] |
519
+ | `forkXY` | `number` | 货叉进出移动比例 \[−1,1] |
520
+ | `forkZ` | `number` | 货叉升降比例 \[0,1] |
521
+ | `resource` | `IResourceOperating` | 托盘/刀具工位槽 |
521
522
 
522
523
  #### IRailOperating
523
524