@nywqs/scada-engine 1.1.28 → 1.1.30

package/README.md

@@ -1,25 +1,33 @@
-# @nywqs/scada-engine
 
-[![npm version](https://img.shields.io/npm/v/@nywqs/scada-engine.svg)](https://www.npmjs.com/package/@nywqs/scada-engine)
-[![license](https://img.shields.io/npm/l/@nywqs/scada-engine.svg)](https://github.com/leoncheng2030/scada-engine/blob/main/LICENSE)
 
-基于 AntV X6 + Vue 3 的自研 SCADA 组态引擎
+# @nywqs/scada-engine
+
+基于 AntV X6 + Vue 3 的自研 SCADA 组态引擎。旨在为工业物联网（IIoT）提供高性能、可扩展的可视化组态解决方案，支持拖拽式界面设计、实时数据绑定及复杂的流程编排。
 
 ## 特性
 
-- ✅ **可视化编辑器**：拖拽式组态界面设计
-- 🎭 **丰富组件库**：内置基础图形、IoT组件、图表等
-- 🔗 **数据绑定**：支持设备数据点绑定和实时更新
-- ⚡ **事件系统**：灵活的事件配置和交互响应
-- 📝 **TypeScript**：完整的类型定义支持
-- 🔄 **响应式**：基于 Vue 3 Composition API
-- 🎨 **动画引擎**：支持节点和连线动画效果
-- 👀 **预览模式**：支持编辑模式和预览模式切换
-- 📡 **数据集成**：支持多种数据源集成方式
-- 📱 **自适应**：画布自动适配不同屏幕尺寸
+- 🛠 **可视化编辑器**：基于 AntV X6 构建的专业级图形编辑能力，支持节点拖拽、连线编排、框选复制等操作。
+- 📦 **丰富组件库**：
+  - **基础组件**：矩形、圆形、文本等基础矢量图形。
+  - **IoT 组件**：支持 ECharts 图表（仪表盘、折线图）、3D 设备模型（电机、管道、阀门、储罐等）、指示灯、开关等工业控件。
+- 🔗 **多源数据集成**：内置服务层，支持 WebSocket、MQTT、HTTP 请求及 SSE（Server-Sent Events）等多种实时数据接入方式。
+- 🎨 **动画引擎**：内置独立的动画调度器（AnimationScheduler）与动画引擎（AnimationEngine），支持脉冲、闪烁、旋转等节点特效。
+- ⚙️ **流程编排**：内置可视化工作流编辑器（Workflow Editor），支持通过逻辑节点（条件判断、定时器、HTTP 请求、自定义代码）编排复杂业务流程。
+- 🔐 **授权与安全**：基于 ECDSA P-256 + SHA-256 的数字签名授权机制，保障软件使用安全。
+- 🚀 **性能优化**：支持视口裁剪（Viewport Culling）技术，在保证视觉效果的同时优化大数据量场景下的渲染性能。
 
 ## 安装
 
+### 环境要求
+
+确保你的项目中已安装以下依赖：
+
+```bash
+npm install vue@^3.4.0 vue-router@^4.6.0 @antv/x6@^2.18.0 echarts@^5.5.0 pinia@^2.1.0
+```
+
+### 安装引擎
+
 ```bash
 npm install @nywqs/scada-engine
 # 或
@@ -28,654 +36,158 @@ pnpm add @nywqs/scada-engine
 yarn add @nywqs/scada-engine
 ```
 
-### Peer Dependencies
-
-请确保已安装以下依赖：
-
-```bash
-npm install vue@^3.4.0 vue-router@^4.6.0 @antv/x6@^2.18.0 echarts@^5.5.0 pinia@^2.1.0
-```
-
 ## 快速开始
 
-### 安装
+### 1. 全局注册
 
-```bash
-npm install @nywqs/scada-engine@latest
-```
-
-### 全局注册
+在你的应用入口文件（如 `main.ts`）中引入并注册组件：
 
 ```typescript
 import { createApp } from 'vue'
 import ScadaEngine from '@nywqs/scada-engine'
-import '@nywqs/scada-engine/dist/scada-engine.css'
+import '@nywqs/scada-engine/dist/scada-engine.css' // 引入样式
+import App from './App.vue'
 
 const app = createApp(App)
 app.use(ScadaEngine)
 app.mount('#app')
 ```
 
-### 按需引入
+### 2. 在组件中使用
+
+最核心的组件是 `ScadaCanvas`，它承载了画布编辑器和预览功能。
 
 ```vue
 <template>
-  <div class="app-container">
+  <div class="scada-container">
     <ScadaCanvas 
+      ref="canvasRef"
+      :auth-code="authCode"
       @node-click="handleNodeClick"
-      @node-update="handleNodeUpdate"
     />
   </div>
 </template>
 
-<script setup lang="ts">
-import { ScadaCanvas } from '@nywqs/scada-engine'
-import '@nywqs/scada-engine/dist/scada-engine.css'
-
-const handleNodeClick = (node: any) => {
-  console.log('Node clicked:', node)
-}
-
-const handleNodeUpdate = (data: any) => {
-  console.log('Node updated:', data)
-}
-</script>
-```
-
-## 组件列表
-
-### 核心组件
-
-- `ScadaCanvas`：画布组件（核心），支持编辑和预览模式
-- `PropertyPanel`：属性面板，配置节点和连线属性
-- `ComponentLibrary`：组件库面板，拖拽添加组件
-- `CanvasConfigPanel`：画布配置面板
-- `Header`：顶部工具栏
-
-### 辅助组件
-
-- `BindingCard`：数据绑定卡片，配置设备数据点绑定
-- `EventCard`：事件配置卡片，配置交互事件
-- `BasicPropertiesTab`：基础属性标签页
-- `DataPropertiesTab`：数据属性标签页
-- `EdgePropertiesTab`：连线属性标签页
-- `AttributeConfigDialog`：属性配置对话框
-- `CustomCodeDialog`：自定义代码对话框
-- `DevicePointSelector`：设备数据点选择器
-- `MappingConfigurator`：映射配置器
-- `WorkflowSelectorDialog`：流程选择对话框
-
-### 内置组件库
-
-#### 基础组件（basic）
-- 矩形（rect）
-- 圆形（circle）
-- 文本（text）
-
-#### IoT组件（iot）
-- 仪表盘（gauge）：支持ECharts仪表盘展示
-- 指示灯（light）：支持开关状态指示
-- 开关（switch）：支持设备控制
-
-#### 画布配置
-- 画布尺寸：支持多种预设尺寸（1920x1080、1366x768等）和自定义尺寸
-- 背景设置：支持颜色、图片背景
-- 网格配置：支持网格显示、类型、大小设置
-- 缩放控制：支持画布缩放和自适应屏幕
-- 参考线：支持对齐参考线
-- 磁吸功能：支持节点磁吸对齐
-
-## API
-
-### ScadaCanvas 组件 API
-
-`ScadaCanvas` 组件通过 `defineExpose` 暴露了一系列核心方法，供外部编程调用：
-
-```vue
-<template>
-  <ScadaCanvas ref="canvasRef" />
-</template>
-
 <script setup lang="ts">
 import { ref } from 'vue'
 import { ScadaCanvas } from '@nywqs/scada-engine'
 
 const canvasRef = ref()
+const authCode = '你的授权码' // 商业版本需要
 
-// 使用暴露的方法
-const handleCustomSave = () => {
-  canvasRef.value?.save()
-}
-
-const handleCustomExport = () => {
-  canvasRef.value?.export()
-}
-
-const handleCustomImport = () => {
-  canvasRef.value?.import()
-}
-
-const handleGetData = () => {
-  const data = canvasRef.value?.getCanvasData()
-  console.log('画布数据:', data)
-}
-
-const handleLoadData = (jsonData: any) => {
-  const success = canvasRef.value?.loadCanvasData(jsonData)
-  if (success) {
-    console.log('加载成功')
-  }
+const handleNodeClick = (node) => {
+  console.log('点击了节点:', node.id)
 }
 </script>
 ```
 
-#### 暴露的方法列表
-
-| 方法名 | 参数 | 返回值 | 说明 |
-|--------|------|--------|------|
-| `save()` | - | `void` | 保存画布数据到 localStorage |
-| `import()` | - | `void` | 触发文件选择，导入 JSON 数据 |
-| `export()` | - | `void` | 导出画布数据为 JSON 文件 |
-| `preview()` | - | `void` | 跳转到预览页面 |
-| `workflow()` | - | `void` | 打开流程编排弹窗 |
-| `zoomIn()` | - | `void` | 放大画布 |
-| `zoomOut()` | - | `void` | 缩小画布 |
-| `clearAll()` | - | `void` | 清空画布所有元素 |
-| `getGraph()` | - | `Graph \| null` | 获取 X6 Graph 实例 |
-| `getCanvasData()` | - | `object \| null` | 获取画布完整数据 |
-| `loadCanvasData(data)` | `data: any` | `boolean` | 加载画布数据 |
+## 目录结构
 
-#### getCanvasData() 返回数据结构
+项目采用了清晰的模块划分：
 
-```typescript
-{
-  version: string         // 版本号
-  timestamp: string       // 时间戳
-  config: object          // 画布配置
-  cells: array            // X6 画布元素
-  nodes: array            // 节点数据
-  edges: array            // 连线数据
-}
 ```
-
-#### 完整示例：自定义工具栏
-
-```vue
-<template>
-  <div class="custom-editor">
-    <!-- 自定义工具栏 -->
-    <div class="custom-toolbar">
-      <button @click="handleSave">保存</button>
-      <button @click="handleExport">导出</button>
-      <button @click="handleImport">导入</button>
-      <button @click="handleGetData">获取数据</button>
-      <button @click="handleZoomIn">放大</button>
-      <button @click="handleZoomOut">缩小</button>
-    </div>
-    
-    <!-- 画布组件 -->
-    <ScadaCanvas ref="canvasRef" />
-  </div>
-</template>
-
-<script setup lang="ts">
-import { ref } from 'vue'
-import { ScadaCanvas } from '@nywqs/scada-engine'
-
-const canvasRef = ref()
-
-const handleSave = () => {
-  canvasRef.value?.save()
-  console.log('已保存')
-}
-
-const handleExport = () => {
-  canvasRef.value?.export()
-}
-
-const handleImport = () => {
-  canvasRef.value?.import()
-}
-
-const handleGetData = () => {
-  const data = canvasRef.value?.getCanvasData()
-  console.log('画布数据:', data)
-  
-  // 可以将数据发送到服务器
-  // await api.saveCanvas(data)
-}
-
-const handleZoomIn = () => {
-  canvasRef.value?.zoomIn()
-}
-
-const handleZoomOut = () => {
-  canvasRef.value?.zoomOut()
-}
-</script>
+src/
+├── components/          # 核心 UI 组件
+│   ├── Header.vue       # 顶部工具栏
+│   ├── Footer.vue       # 底部版权栏
+│   ├── ScadaCanvas.vue  # 核心画布组件
+│   └── ...
+├── scada-components/    # 业务组件库
+│   ├── basic/           # 基础图形组件 (rect, circle, text)
+│   ├── iot/             # IoT 设备组件 (gauge, motor, tank...)
+│   ├── canvas/          # 画布配置管理
+│   └── registry.ts      # 组件注册表
+├── views/workflow/      # 流程编排模块
+├── services/            # 数据服务层
+│   ├── websocketService.ts
+│   ├── mqttService.ts
+│   └── ...
+├── utils/               # 工具函数与引擎核心
+│   ├── animationEngine.ts   # 动画引擎
+│   ├── authCrypto.ts        # 授权加密模块
+│   └── viewportCulling.ts   # 视口优化
+└── styles/              # 样式文件
 ```
 
-### 组件注册系统
+## 核心概念
 
-```typescript
-import { componentRegistry } from '@nywqs/scada-engine'
+### 画布 (ScadaCanvas)
 
-// 获取所有组件
-const components = componentRegistry.getAllComponents()
+画布是整个系统的核心，提供以下能力：
+- **编辑模式**：用于设计组态画面。
+- **预览模式**：用于运行展示，隐藏编辑 UI。
+- **数据绑定**：支持将设备点位（Point）绑定到组件属性，实时更新显示。
 
-// 按分类获取组件
-const basicComponents = componentRegistry.getComponentsByCategory('basic')
-```
+### 组件注册系统 (ComponentRegistry)
 
-### 画布配置
+引擎使用了懒加载注册机制来优化性能。
+- 支持按分类（`basic`, `iot`）获取组件列表。
+- 支持动态注册新组件。
 
-```typescript
-import { canvasConfigManager } from '@nywqs/scada-engine'
+### 数据服务 (Data Services)
 
-// 获取画布配置
-const config = canvasConfigManager.getConfig()
+引擎不强制绑定特定后端，提供了灵活的数据接入适配器：
+- **WebSocket**：适用于高频实时数据。
+- **MQTT**：适用于物联网消息订阅。
+- **HTTP**：适用于请求-响应式查询。
+- **SSE**：适用于服务器推送事件。
 
-// 更新画布大小
-canvasConfigManager.updateSize({ width: 1920, height: 1080 })
-```
+### 流程引擎 (Workflow Engine)
 
-### 类型定义
+内置的可视化脚本系统，允许用户在画布上通过图形化节点编写逻辑，无需编写大量代码即可实现：
+- 定时触发任务
+- 条件判断分支
+- HTTP 外部请求
+- 自定义 JavaScript 代码执行
 
-```typescript
-import type { 
-  EventConfig, 
-  BindingConfig,
-  ComponentConfig,
-  ComponentCategory,
-  Device,
-  DevicePoint,
-  DeviceList,
-  PointDataType,
-  PointAccessMode
-} from '@nywqs/scada-engine'
-
-// 设备点位相关枚举
-import {
-  DeviceStatus,
-  DeviceType,
-  PointDataType,
-  PointAccessMode
-} from '@nywqs/scada-engine'
-```
+## API 参考
 
-## 数据集成
+### ScadaCanvas 方法
 
-SCADA引擎支持多种方式集成设备数据，实现数据绑定和实时更新。
+通过 `ref` 可以直接调用画布的操作方法：
 
-### 1. 通过组件属性传递数据
+| 方法 | 说明 |
+|------|------|
+| `save()` | 保存当前画布数据到 LocalStorage |
+| `export()` | 导出当前画布为 JSON 文件 |
+| `import()` | 触发文件选择器导入 JSON |
+| `getCanvasData()` | 获取画布完整数据对象（包含节点、连线和配置） |
+| `zoomIn()` / `zoomOut()` | 放大/缩小画布 |
+| `clearAll()` | 清空画布 |
 
-```vue
-<template>
-  <ScadaCanvas 
-    :device-data="deviceData"
-    :data-source="dataConfig"
-  />
-</template>
+### 数据结构示例
 
-<script setup lang="ts">
-import { ScadaCanvas } from '@nywqs/scada-engine'
+`getCanvasData()` 返回的结构大致如下：
 
-// 设备数据
-const deviceData = {
-  devices: [
+```json
+{
+  "version": "1.0",
+  "config": {
+    "width": 1920,
+    "height": 1080,
+    "grid": true
+  },
+  "cells": [
     {
-      id: 'device_001',
-      name: '1号温控设备',
-      status: 'online',
-      points: [
-        {
-          id: 'point_001_01',
-          name: '当前温度',
-          value: 25.5,
-          dataType: 'number',
-          unit: '°C'
-        }
-      ]
+      "id": "node-1",
+      "type": "rect",
+      "x": 100,
+      "y": 100,
+      "label": "电机",
+      "data": { "binding": "device_01_status" }
     }
   ]
 }
-
-// 数据源配置
-const dataConfig = {
-  type: 'websocket', // 或 'mqtt', 'http', 'sse'
-  url: 'ws://localhost:8080/device-data',
-  interval: 1000 // 更新间隔(毫秒)
-}
-</script>
 ```
 
-### 2. 通过暴露的方法更新数据
+## 许可证
 
-```vue
-<template>
-  <ScadaCanvas ref="scadaRef" />
-</template>
-
-<script setup lang="ts">
-import { ref, onMounted } from 'vue'
-import { ScadaCanvas } from '@nywqs/scada-engine'
-
-const scadaRef = ref()
-
-// 获取设备数据并更新到画布
-const updateDeviceData = async () => {
-  // 从主应用的API获取设备数据
-  const deviceData = await fetchDeviceDataFromAPI()
-  
-  // 通过暴露的方法更新到画布组件
-  scadaRef.value?.updateDeviceData(deviceData)
-}
-
-onMounted(() => {
-  // 定时更新设备数据
-  setInterval(updateDeviceData, 1000)
-})
-</script>
-```
+本项目采用 MIT 许可证。内置的组件库和引擎功能可以免费用于学习和非商业项目。
 
-### 3. 使用事件绑定方式
-
-```vue
-<template>
-  <ScadaCanvas 
-    @data-request="handleDataRequest"
-    @data-update="handleDataUpdate"
-  />
-</template>
-
-<script setup lang="ts">
-import { ScadaCanvas } from '@nywqs/scada-engine'
-
-// 当画布需要数据时触发
-const handleDataRequest = (requestData: any) => {
-  // 根据请求参数获取对应设备数据
-  const deviceData = getDeviceData(requestData.deviceIds)
-  
-  // 返回数据给画布
-  return deviceData
-}
-
-// 当画布数据更新时触发
-const handleDataUpdate = (updatedData: any) => {
-  // 将更新的数据发送到主应用的设备系统
-  updateDeviceValues(updatedData)
-}
-</script>
-```
-
-### 4. 数据格式要求
-
-设备数据应遵循以下格式：
-
-```typescript
-interface DeviceData {
-  devices: Array<{
-    id: string        // 设备唯一标识
-    name: string      // 设备名称
-    status: 'online' | 'offline' | 'error' | 'maintenance'
-    points: Array<{
-      id: string      // 点位唯一标识
-      name: string    // 点位名称
-      value: any      // 点位值
-      dataType: 'number' | 'boolean' | 'string'
-      unit?: string   // 单位
-      quality: 'good' | 'bad' | 'uncertain' // 数据质量
-      updateTime: string // 更新时间
-    }>
-  }>
-}
-```
-
-推荐使用事件绑定方式或数据绑定配置，这两种方式可以实现主应用与SCADA引擎的双向数据同步，既灵活又高效。
-
-## 使用示例
-
-### 完整编辑器应用
-
-```vue
-<template>
-  <div class="scada-editor">
-    <Header 
-      @save="handleSave"
-      @export="handleExport"
-      @preview="handlePreview"
-    />
-    
-    <div class="editor-body">
-      <ComponentLibrary />
-      
-      <ScadaCanvas 
-        ref="canvasRef"
-        @node-select="handleNodeSelect"
-      />
-      
-      <PropertyPanel 
-        v-if="selectedNode"
-        :selected-node="selectedNode"
-        @update-node="handleUpdateNode"
-      />
-    </div>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { ref } from 'vue'
-import { 
-  Header, 
-  ComponentLibrary, 
-  ScadaCanvas, 
-  PropertyPanel 
-} from '@nywqs/scada-engine'
-import '@nywqs/scada-engine/dist/scada-engine.css'
-
-const canvasRef = ref()
-const selectedNode = ref(null)
-
-const handleNodeSelect = (node: any) => {
-  selectedNode.value = node
-}
-
-const handleUpdateNode = (data: any) => {
-  // 更新节点数据
-}
-
-const handleSave = () => {
-  // 保存逻辑
-}
-
-const handleExport = () => {
-  // 导出逻辑
-}
-
-const handlePreview = () => {
-  // 预览逻辑
-}
-</script>
-```
-
-### 软件授权使用
-
-本软件默认在底部显示版权信息。如需隐藏或修改版权信息，必须使用有效的数字签名令牌与公钥。
-
-#### 获取授权
-
-请联系作者获取：
-1. **授权令牌 (Token)**：包含公司名、有效期等信息的签名串。
-2. **公钥 (Public Key)**：用于验证签名的 `public.pem` 文件内容。
-
-- 邮箱：nywqs@outlook.com
-- 电话：18637762001
-
-#### 使用方式
-
-在使用 `ScadaCanvas` 组件时，需同时传入 `auth-code`（令牌）与 `public-key-pem`（公钥内容）。
-
-```vue
-<template>
-  <ScadaCanvas 
-    :auth-code="licenseToken"
-    :public-key-pem="publicKey"
-    :custom-footer="{
-      copyright: '© 2025 您的公司',
-      license: '商业授权使用',
-      contact: '联系方式: support@yourcompany.com'
-    }"
-  />
-</template>
-
-<script setup lang="ts">
-// 填入从授权方获取的 Token 字符串
-const licenseToken = 'eyJh...<完整Token字符串>'
-
-// 填入 public.pem 的完整内容
-const publicKey = `-----BEGIN PUBLIC KEY-----
-MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAExxxxxxxxxxxxxxxxxxxxxxxxxxxx
-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-xxxxxxxx==
------END PUBLIC KEY-----`
-</script>
-```
-
-**授权模式说明**
-- 未提供有效 Token 或 公钥验证失败：显示默认版权信息
-- 验证通过 + 无 customFooter：隐藏 Footer
-- 验证通过 + customFooter：显示自定义 Footer
-
-**授权验证机制**
-采用 ECDSA P-256 + SHA-256 数字签名技术。前端仅持有公钥进行验签，无法伪造授权。
-
-控制台会输出授权验证信息：
-```javascript
-✅ 授权验证成功
-🏛️ 授权公司: ACME Corp
-📅 有效期至: 2026-12-31
-```
-
-## 预览模式
-
-ScadaCanvas 组件支持预览模式，用于在运行时展示组态画面：
-
-```vue
-<template>
-  <ScadaCanvas 
-    :preview-mode="true"
-    :auth-code="authCode"
-  />
-</template>
-
-<script setup lang="ts">
-import { ref, onMounted } from 'vue'
-import { ScadaCanvas } from '@nywqs/scada-engine'
-
-const authCode = ref('your-auth-code')
-
-// 预览模式特性：
-// 1. 隐藏编辑工具栏和组件库
-// 2. 禁止节点移动和编辑
-// 3. 仅显示画布和组件
-// 4. 支持动画自动播放
-// 5. 支持实时数据更新
-</script>
-```
-
-## 开发
-
-```bash
-# 克隆项目
-git clone https://github.com/yourusername/scada-engine.git
-
-# 安装依赖
-npm install
-
-# 启动开发服务器
-npm run dev
-
-# 构建库
-npm run build:lib
-```
-
-## 发布到 npm
-
-```bash
-# 1. 登录 npm
-npm login
-
-# 2. 构建库
-npm run build:lib
-
-# 3. 发布（首次发布公开包）
-npm publish --access public
-
-# 4. 后续版本更新
-npm version patch  # 补丁版本 1.0.0 -> 1.0.1
-npm version minor  # 次版本 1.0.0 -> 1.1.0
-npm version major  # 主版本 1.0.0 -> 2.0.0
-npm publish
-```
-
-## 版本管理建议
-
-- patch (1.0.x)：Bug 修复、小改进
-- minor (1.x.0)：新功能、向后兼容
-- major (x.0.0)：破坏性更新、重大重构
-
-## 版本历史
-
-完整的版本更新记录请查看 [CHANGELOG.md](./CHANGELOG.md)
-
-### 1.1.27 (2025-01-16)
-- 修复 `ScadaCanvas.vue` 中 `calculateContainerSize` 函数的 TypeScript 类型声明
-- 为函数添加明确的返回类型注解，消除 TS6133 警告
-
-### 1.1.26 (2025-01-16)
-- 创建版本更新历史记录文档 CHANGELOG.md
-- 建立版本发布规范和记录模板
-
-### 1.1.20 (2026-01-06)
-- 画布自适应缩放：支持不同分辨率设备自动适配显示
-- 组件库折叠展开：基础组件和IoT组件分组可收缩
-- 组件库三列布局：优化组件展示，更紧凑的空间利用
-- 画布自定义尺寸：支持800-7680px宽度，600-4320px高度
-- 设备点位类型导出：完整的Device、DevicePoint等类型定义
-
-### 1.1.11 (2025-12-30)
-- 修复预览按钮事件触发问题
-- 优化路由跳转逻辑
-- 添加详细调试日志
-
-### 1.1.10 (2025-12-30)
-- 添加预览事件支持
-- 优化事件触发机制
-
-### 1.0.0
-- 初始版本发布
-- 基础组态编辑功能
-- 支持基础组件和IoT组件
-
-## 贡献
-
-欢迎提交 Issue 和 Pull Request！
-
-## 许可协议
-
-本项目采用 **MIT 许可协议**，详见 [LICENSE](LICENSE) 文件。
-
-- 允许商业使用、修改、分发
-- 需保留版权声明与许可文本
-- 软件按“原样”提供，无任何担保
-
-如需商业授权，请联系作者。
+**商业授权**：如需将本引擎用于商业产品并隐藏底部版权标识，请联系作者获取数字签名授权。
 
 ## 作者
 
-**leoncheng**
-
-- 📧 邮箱：nywqs@outlook.com
-- 📱 电话：18637762001
+- **nywqs**
 
-如有任何问题或商业合作需求，欢迎联系。
+如有问题或建议，欢迎提交 Issue 或联系作者。