ms-vite-plugin 1.2.6 → 1.2.7

package/docs/api/action.md

@@ -533,6 +533,41 @@ for (let i = 0; i < 5; i++) {
 }
 ```
 
+### sendKey - 发送键盘组合键
+
+发送键盘组合键。Action 模块最终发送标准 USB HID Keyboard/Keypad usage。
+
+参数可以直接传标准 usage 数字，也可以传单个 ASCII 字符、按键名称字符串，或现有 `hidKey` 常量；`hidKey` 常量会按兼容规则转换为标准 usage。
+
+```typescript
+function sendKey(key: Array<number | string>): boolean;
+```
+
+**参数说明：**
+
+| 参数名 | 类型                   | 是否必填 | 默认值 | 描述                                                                 |
+| ------ | ---------------------- | -------- | ------ | -------------------------------------------------------------------- |
+| `key`  | Array<number \| string> | 是       | -      | 要发送的按键数组；数字表示标准 USB HID usage，字符串表示按键名或字符 |
+
+**返回值：**
+
+| 类型      | 描述         |
+| --------- | ------------ |
+| `boolean` | 发送是否成功 |
+
+**示例：**
+
+```typescript
+// 发送 Command+C。字符串名称会转换为标准 USB HID usage。
+action.sendKey(["COMMAND", "c"]);
+
+// 也可以直接传标准 USB HID usage：0xE3 = Left GUI/Command，0x06 = C。
+action.sendKey([0xe3, 0x06]);
+
+// 兼容现有 hidKey 常量，会先转换为标准 USB HID usage。
+action.sendKey([hidKey.COMMAND, "v"]);
+```
+
 ## W3C Actions
 
 ### w3cActions - 执行 W3C Actions JSON

package/docs/apicn/action.md

@@ -527,6 +527,41 @@ for (let i = 0; i < 5; i++) {
 }
 ```
 
+### 发送按键 - 发送键盘组合键
+
+发送键盘组合键。动作模块最终发送标准 USB HID Keyboard/Keypad usage。
+
+参数可以直接传标准 usage 数字，也可以传单个 ASCII 字符、按键名称字符串，或现有 `hidKey` 常量；`hidKey` 常量会按兼容规则转换为标准 usage。
+
+```typescript
+function 发送按键(按键: 数组<数字 | 字符串>): 布尔值;
+```
+
+**参数说明：**
+
+| 参数名 | 类型             | 是否必填 | 默认值 | 描述                                                                 |
+| ------ | ---------------- | -------- | ------ | -------------------------------------------------------------------- |
+| `按键` | 数组<数字 \| 字符串> | 是       | -      | 要发送的按键数组；数字表示标准 USB HID usage，字符串表示按键名或字符 |
+
+**返回值：**
+
+| 类型     | 描述         |
+| -------- | ------------ |
+| `布尔值` | 发送是否成功 |
+
+**示例：**
+
+```typescript
+// 发送 Command+C。字符串名称会转换为标准 USB HID usage。
+$动作.发送按键(["COMMAND", "c"]);
+
+// 也可以直接传标准 USB HID usage：0xE3 = Left GUI/Command，0x06 = C。
+$动作.发送按键([0xe3, 0x06]);
+
+// 兼容现有 hidKey 常量，会先转换为标准 USB HID usage。
+$动作.发送按键([hidKey.COMMAND, "v"]);
+```
+
 ## W3C Actions
 
 ### 执行W3C动作 - 执行 W3C Actions JSON

package/docs/apipython/action.md

@@ -503,6 +503,40 @@ for i in range(5):
     action.pressButton("volumeup")
 ```
 
+### sendKey - 发送键盘组合键
+
+发送键盘组合键。Action 模块最终发送标准 USB HID Keyboard/Keypad usage。
+
+参数可以直接传标准 usage 数字，也可以传单个 ASCII 字符、按键名称字符串，或现有 `hidKey` 常量；`hidKey` 常量会按兼容规则转换为标准 usage。
+
+```python
+def sendKey(key: List[Union[int, str]]) -> bool
+```
+
+**参数说明：**
+
+| 参数名 | 类型                  | 是否必填 | 默认值 | 描述                                                                 |
+| ------ | --------------------- | -------- | ------ | -------------------------------------------------------------------- |
+| `key`  | List[Union[int, str]] | 是       | -      | 要发送的按键列表；数字表示标准 USB HID usage，字符串表示按键名或字符 |
+
+**返回值：**
+
+| 类型   | 描述         |
+| ------ | ------------ |
+| `bool` | 发送是否成功 |
+
+**示例：**
+
+```python
+from kuaijs import action
+
+# 发送 Command+C。字符串名称会转换为标准 USB HID usage。
+action.sendKey(["COMMAND", "c"])
+
+# 也可以直接传标准 USB HID usage：0xE3 = Left GUI/Command，0x06 = C。
+action.sendKey([0xE3, 0x06])
+```
+
 ## W3C Actions
 
 ### w3cActions - 执行 W3C Actions JSON

package/package.json

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