@jnrs/lingshu-smart

✨ 介绍

巨能（JNRS）前端 2D 数字孪生库，灵枢智造。基于 LeaferJS 引擎构建，提供完整的 2D 数字孪生解决方案。

核心功能

| 功能 | 说明 | | ---------- | ----------------------------------------------------------------------------------------------------- | | 编辑器模式 | LingshuSmartEditor — 方案可视化编辑，支持拖拽布局、设备配置、图层管理、方案保存/预览 | | 运行看板 | LingshuSmartPreview — 方案运行看板，支持 WebSocket 实时驱动设备动画、交互事件（点击/拖拽/右键菜单） | | 设备模型 | 机床、机器人（单关节/双关节）、RGV、装载站、打标机、清洗机、轨道拖链、资源库等 | | 设备运转 | 灯光、进度条、入口动画、工位槽资源增删、坐标/角度/货叉控制 | | 坐标转换 | transRuntimeToPixel / transPercentToPixel — 物理坐标与像素坐标互转 |

💻 技术栈

TypeScript、Vue3 生态、LeaferJS

🧩 安装教程

pnpm add @jnrs/lingshu-smart

🔍 使用示例

import type { ILayerOperating, ILayer, ICase } from '@jnrs/lingshu-smart'
import { LingshuSmartPreview, LingshuSmartEditor } from '@jnrs/lingshu-smart/components'
import { transRuntimeToPixel, transPercentToPixel } from '@jnrs/lingshu-smart'

编辑器模式

<LingshuSmartEditor :actions="{ loadCases, saveCases, handlePreview, handleExit }" />

运行看板模式

<LingshuSmartPreview
  ref="previewRef"
  :case-uuid="currentCaseId"
  :actions="{ loadCases, onTap, onMenuTap, onDragEnd }"
/>

详细文档请查看 AGENTS.md