ms-vite-plugin 1.1.18 → 1.1.20

package/docs/api/device.md

@@ -111,9 +111,6 @@ logi(`服务器设备ID: ${serverDeviceId}`);
 
 ### getECID - 获取设备 ECID。
 
-**注意事项：**
-
-- 这个 ID 只有自激活一次后才能获取
 
 ```typescript
 function getECID(): string;
@@ -135,9 +132,6 @@ logi(`ECID: ${ecid}`);
 
 ### getUDID - 获取设备 UDID。
 
-**注意事项：**
-
-- 这个 ID 只有自激活一次后才能获取
 
 ```typescript
 function getUDID(): string;

package/docs/api/hid.md

@@ -147,6 +147,46 @@ const mac = hid.getDeviceMac();
 logi(mac);
 ```
 
+### getDeviceModel - 获取设备型号
+
+获取当前 HID 设备型号。
+
+```typescript
+function getDeviceModel(): string;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| string | 设备型号 |
+
+**示例:**
+
+```javascript
+const model = hid.getDeviceModel();
+logi(model);
+```
+
+### getDeviceVersion - 获取设备版本
+
+获取当前 HID 设备版本。
+
+```typescript
+function getDeviceVersion(): string;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| string | 设备版本 |
+
+**示例:**
+
+```javascript
+const version = hid.getDeviceVersion();
+logi(version);
+```
+
 ### resetPosition - 复位坐标
 
 将鼠标坐标复位到左上角（仅相对鼠标模式需要）。
@@ -249,32 +289,6 @@ function setJitterValue(value: number): void;
 hid.setJitterValue(5);
 ```
 
-### move - 移动坐标
-
-将光标移动到指定坐标。
-
-```typescript
-function move(x: number, y: number): boolean;
-```
-
-**参数:**
-| 参数 | 类型 | 必需 | 默认值 | 描述 |
-| ---- | ---- | ---- | ------ | ---- |
-| `x` | number | 是 | - | 目标 X 坐标 |
-| `y` | number | 是 | - | 目标 Y 坐标 |
-
-**返回值:**
-| 类型 | 描述 |
-| ---- | ---- |
-| boolean | 操作是否成功 |
-
-**示例:**
-
-```javascript
-// 移动到 (100, 200)
-hid.move(100, 200);
-```
-
 ## 基础触摸操作
 
 ### click - 点击操作
@@ -348,6 +362,72 @@ function clickRandom(
 hid.clickRandom(100, 100, 200, 200, 20);
 ```
 
+### move - 移动坐标
+
+将光标移动到指定坐标。
+
+```typescript
+function move(x: number, y: number): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x` | number | 是 | - | 目标 X 坐标 |
+| `y` | number | 是 | - | 目标 Y 坐标 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 移动到 (100, 200)
+hid.move(100, 200);
+```
+
+### mouseDown - 鼠标按下
+
+按下鼠标左键，但不自动抬起。适合和 `move`、`mouseUp` 组合使用，实现拖拽、长按等场景。
+
+```typescript
+function mouseDown(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 按下鼠标左键
+hid.mouseDown();
+```
+
+### mouseUp - 鼠标抬起
+
+抬起当前按住的鼠标左键。通常和 `mouseDown` 配合使用，用于结束拖拽或长按。
+
+```typescript
+function mouseUp(): boolean;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| boolean | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 抬起鼠标左键
+hid.mouseUp();
+```
+
 ### doubleClick - 双击
 
 在指定坐标执行双击操作。

package/docs/apicn/device.md

@@ -111,9 +111,6 @@ $打印信息日志(`服务器设备ID: ${serverDeviceId}`);
 
 ### 获取 ECID
 
-**注意事项：**
-
-- 这个 ID 只有自激活一次后才能获取
 
 ```typescript
 function 获取ECID(): 字符串;
@@ -135,9 +132,6 @@ $打印信息日志(`ECID: ${ecid}`);
 
 ### 获取 UDID
 
-**注意事项：**
-
-- 这个 ID 只有自激活一次后才能获取
 
 ```typescript
 function 获取UDID(): 字符串;

package/docs/apicn/hid.md

@@ -147,6 +147,46 @@ const mac = $HID.获取设备Mac();
 $打印信息日志(mac);
 ```
 
+### 获取设备型号
+
+获取当前 HID 设备型号。
+
+```typescript
+function 获取设备型号(): 字符串;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 字符串 | 设备型号 |
+
+**示例:**
+
+```javascript
+const model = $HID.获取设备型号();
+$打印信息日志(model);
+```
+
+### 获取设备版本
+
+获取当前 HID 设备版本。
+
+```typescript
+function 获取设备版本(): 字符串;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 字符串 | 设备版本 |
+
+**示例:**
+
+```javascript
+const version = $HID.获取设备版本();
+$打印信息日志(version);
+```
+
 ### 复位坐标
 
 将鼠标坐标复位到左上角（仅相对鼠标模式需要）。
@@ -249,32 +289,6 @@ function 设置抖动值(抖动值: 数字): 无返回值;
 $HID.设置抖动值(5);
 ```
 
-### 移动
-
-将光标移动到指定坐标。
-
-```typescript
-function 移动(x: 数字, y: 数字): 布尔值;
-```
-
-**参数:**
-| 参数 | 类型 | 必需 | 默认值 | 描述 |
-| ---- | ---- | ---- | ------ | ---- |
-| `x` | 数字 | 是 | - | 目标 X 坐标 |
-| `y` | 数字 | 是 | - | 目标 Y 坐标 |
-
-**返回值:**
-| 类型 | 描述 |
-| ---- | ---- |
-| 布尔值 | 操作是否成功 |
-
-**示例:**
-
-```javascript
-// 移动到 (100, 200)
-$HID.移动(100, 200);
-```
-
 ## 基础触摸操作
 
 ### 点击
@@ -348,6 +362,72 @@ function 点击随机范围(
 $HID.点击随机范围(100, 100, 200, 200, 20);
 ```
 
+### 移动
+
+将光标移动到指定坐标。
+
+```typescript
+function 移动(x: 数字, y: 数字): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x` | 数字 | 是 | - | 目标 X 坐标 |
+| `y` | 数字 | 是 | - | 目标 Y 坐标 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 移动到 (100, 200)
+$HID.移动(100, 200);
+```
+
+### 鼠标按下
+
+按下鼠标左键，但不自动抬起。适合和 `移动`、`鼠标抬起` 组合使用，实现拖拽、长按等场景。
+
+```typescript
+function 鼠标按下(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 按下鼠标左键
+$HID.鼠标按下();
+```
+
+### 鼠标抬起
+
+抬起当前按住的鼠标左键。通常和 `鼠标按下` 配合使用，用于结束拖拽或长按。
+
+```typescript
+function 鼠标抬起(): 布尔值;
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| 布尔值 | 操作是否成功 |
+
+**示例:**
+
+```javascript
+// 抬起鼠标左键
+$HID.鼠标抬起();
+```
+
 ### 双击
 
 在指定坐标执行双击操作。

package/docs/apipython/device.md

@@ -115,9 +115,6 @@ print(device.getServerDeviceId())
 
 ### getECID - 获取设备 ECID。
 
-**注意事项：**
-
-- 这个 ID 只有自激活一次后才能获取
 
 ```python
 def getECID() -> str
@@ -138,9 +135,6 @@ print(device.getECID())
 
 ### getUDID - 获取设备 UDID。
 
-**注意事项：**
-
-- 这个 ID 只有自激活一次后才能获取
 
 ```python
 def getUDID() -> str

package/docs/apipython/hid.md

@@ -149,6 +149,48 @@ mac = hid.getDeviceMac()
 print(mac)
 ```
 
+### getDeviceModel - 获取设备型号
+
+获取当前 HID 设备型号。
+
+```python
+def getDeviceModel() -> str:
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| str | 设备型号 |
+
+**示例:**
+
+```python
+from kuaijs import hid
+model = hid.getDeviceModel()
+print(model)
+```
+
+### getDeviceVersion - 获取设备版本
+
+获取当前 HID 设备版本。
+
+```python
+def getDeviceVersion() -> str:
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| str | 设备版本 |
+
+**示例:**
+
+```python
+from kuaijs import hid
+version = hid.getDeviceVersion()
+print(version)
+```
+
 ### resetPosition - 复位坐标
 
 将鼠标坐标复位到左上角（仅相对鼠标模式需要）。
@@ -256,33 +298,6 @@ from kuaijs import hid
 hid.setJitterValue(5)
 ```
 
-### move - 移动坐标
-
-将光标移动到指定坐标。
-
-```python
-def move(x: int, y: int) -> bool
-```
-
-**参数:**
-| 参数 | 类型 | 必需 | 默认值 | 描述 |
-| ---- | ---- | ---- | ------ | ---- |
-| `x` | int | 是 | - | 目标 X 坐标 |
-| `y` | int | 是 | - | 目标 Y 坐标 |
-
-**返回值:**
-| 类型 | 描述 |
-| ---- | ---- |
-| bool | 操作是否成功 |
-
-**示例:**
-
-```python
-from kuaijs import hid
-# 移动到 (100, 200)
-hid.move(100, 200)
-```
-
 ## 基础触摸操作
 
 ### click - 点击操作
@@ -358,6 +373,75 @@ from kuaijs import hid
 hid.clickRandom(100, 100, 200, 200, 20)
 ```
 
+### move - 移动坐标
+
+将光标移动到指定坐标。
+
+```python
+def move(x: int, y: int) -> bool
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `x` | int | 是 | - | 目标 X 坐标 |
+| `y` | int | 是 | - | 目标 Y 坐标 |
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| bool | 操作是否成功 |
+
+**示例:**
+
+```python
+from kuaijs import hid
+# 移动到 (100, 200)
+hid.move(100, 200)
+```
+
+### mouseDown - 鼠标按下
+
+按下鼠标左键，但不自动抬起。适合和 `move`、`mouseUp` 组合使用，实现拖拽、长按等场景。
+
+```python
+def mouseDown() -> bool
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| bool | 操作是否成功 |
+
+**示例:**
+
+```python
+from kuaijs import hid
+# 按下鼠标左键
+hid.mouseDown()
+```
+
+### mouseUp - 鼠标抬起
+
+抬起当前按住的鼠标左键。通常和 `mouseDown` 配合使用，用于结束拖拽或长按。
+
+```python
+def mouseUp() -> bool
+```
+
+**返回值:**
+| 类型 | 描述 |
+| ---- | ---- |
+| bool | 操作是否成功 |
+
+**示例:**
+
+```python
+from kuaijs import hid
+# 抬起鼠标左键
+hid.mouseUp()
+```
+
 ### doubleClick - 双击
 
 在指定坐标执行双击操作。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-vite-plugin",
-  "version": "1.1.18",
+  "version": "1.1.20",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {