ms-vite-plugin 1.2.6 → 1.2.8

package/docs/api/action.md

@@ -406,6 +406,36 @@ if (success) {
 }
 ```
 
+### inputSimple - 基础文本输入
+
+不使用剪切板或 IME，而是把文本字符数组一次性传给 Action 模块的 `sendKey`。仅支持可映射为 USB HID Keyboard/Keypad usage 的 ASCII 字符，不支持中文。
+
+```typescript
+function inputSimple(text: string): boolean;
+```
+
+**参数说明：**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述             |
+| ------ | ------ | -------- | ------ | ---------------- |
+| `text` | string | 是       | -      | 要输入的文本内容 |
+
+**返回值：**
+
+| 类型      | 描述         |
+| --------- | ------------ |
+| `boolean` | 输入是否成功 |
+
+**示例：**
+
+```typescript
+// 一次性发送基础文本按键数组
+const success = action.inputSimple("hello_123");
+if (success) {
+  logi("成功输入基础文本");
+}
+```
+
 ### backspace - 删除文本
 
 ```typescript
@@ -533,6 +563,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

@@ -397,6 +397,36 @@ if (是否成功) {
 }
 ```
 
+### 输入简易文本
+
+不使用剪切板或 IME，而是把文本字符数组一次性传给动作模块的 `发送按键`。仅支持可映射为 USB HID Keyboard/Keypad usage 的 ASCII 字符，不支持中文。
+
+```typescript
+function 输入简易文本(文本: 字符串): 布尔值;
+```
+
+**参数说明：**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述             |
+| ------ | ------ | -------- | ------ | ---------------- |
+| `文本` | 字符串 | 是       | -      | 要输入的文本内容 |
+
+**返回值：**
+
+| 类型     | 描述         |
+| -------- | ------------ |
+| `布尔值` | 输入是否成功 |
+
+**示例：**
+
+```typescript
+// 一次性发送基础文本按键数组
+const 是否成功 = $动作.输入简易文本("hello_123");
+if (是否成功) {
+  $打印信息日志("成功输入基础文本");
+}
+```
+
 ### 删除文本
 
 ```typescript
@@ -527,6 +557,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

@@ -380,6 +380,35 @@ if action.input("hello 快点JS"):
     print("成功输入文本")
 ```
 
+### inputSimple - 基础文本输入
+
+不使用剪切板或 IME，而是把文本字符列表一次性传给 Action 模块的 `sendKey`。仅支持可映射为 USB HID Keyboard/Keypad usage 的 ASCII 字符，不支持中文。
+
+```python
+def inputSimple(text: str) -> bool
+```
+
+**参数说明：**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述             |
+| ------ | ---- | -------- | ------ | ---------------- |
+| `text` | str  | 是       | -      | 要输入的文本内容 |
+
+**返回值：**
+
+| 类型   | 描述         |
+| ------ | ------------ |
+| `bool` | 输入是否成功 |
+
+**示例：**
+
+```python
+from kuaijs import action
+
+if action.inputSimple("hello_123"):
+    print("成功输入基础文本")
+```
+
 ### backspace - 删除文本
 
 ```python
@@ -503,6 +532,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.8",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {