ms-vite-plugin 1.1.23 → 1.2.1

package/docs/api/action.md

@@ -533,6 +533,48 @@ for (let i = 0; i < 5; i++) {
 }
 ```
 
+## W3C Actions
+
+### w3cActions - 执行 W3C Actions JSON
+
+直接提交 W3C Actions 请求体，适合执行多指、多阶段或自定义指针动作。
+
+```typescript
+function w3cActions(json: { actions: Record<string, any>[]; [key: string]: any }): boolean;
+```
+
+**参数说明：**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述                              |
+| ------ | ------ | -------- | ------ | --------------------------------- |
+| `json` | object | 是       | -      | W3C Actions 请求体，例如 `{ actions: [...] }` |
+
+**返回值：**
+
+| 类型      | 描述         |
+| --------- | ------------ |
+| `boolean` | 执行是否成功 |
+
+**示例：**
+
+```typescript
+const success = action.w3cActions({
+  actions: [
+    {
+      type: "pointer",
+      id: "finger1",
+      parameters: { pointerType: "touch" },
+      actions: [
+        { type: "pointerMove", duration: 0, x: 100, y: 200 },
+        { type: "pointerDown", button: 0 },
+        { type: "pause", duration: 20 },
+        { type: "pointerUp", button: 0 },
+      ],
+    },
+  ],
+});
+```
+
 ## 动作构建器
 
 ActionBuilder 提供了更高级的多点触控操作能力，支持链式调用构建复杂的手势动作。

package/docs/api/system.md

@@ -4,7 +4,7 @@
 
 ## 功能概览
 
-- **应用管理**: 启动、停止、激活应用，获取前台应用信息
+- **应用管理**: 启动、停止、激活应用，获取前台/后台应用信息和已安装应用列表
 - **锁屏控制**: 检查锁屏状态、锁屏和解锁操作
 - **剪贴板**: 读取和设置系统剪贴板内容
 - **URL 操作**: 打开网页链接或应用 URL Scheme
@@ -130,10 +130,93 @@ if (appInfo) {
   logi(`当前前台应用: ${appInfo.name}`);
   logi(`Bundle ID: ${appInfo.bundleId}`);
   logi(`进程 ID: ${appInfo.pid}`);
+} else {
   logi("无法获取前台应用信息");
 }
 ```
 
+#### backgroundAppInfos - 获取后台运行的应用列表。
+
+```typescript
+function backgroundAppInfos(): {
+  bundleId: string;
+  name: string;
+  pid: number;
+}[];
+```
+
+**返回值:**
+
+| 字段名     | 类型     | 描述                     |
+| ---------- | -------- | ------------------------ |
+| `bundleId` | `string` | 应用 Bundle ID           |
+| `name`     | `string` | 应用名称（不一定能取到） |
+| `pid`      | `number` | 进程 ID                  |
+
+**说明:**
+
+该方法返回当前后台运行的应用信息列表，可用于查询仍在运行但不在前台显示的应用。
+
+**示例:**
+
+```javascript
+const apps = system.backgroundAppInfos();
+for (const app of apps) {
+  logi(`${app.name}: ${app.bundleId} (${app.pid})`);
+}
+```
+
+#### getInstalledAppList - 获取已安装的应用列表。
+
+```typescript
+function getInstalledAppList(): {
+  bundleVersion: string;
+  appName: string;
+  bundleIdentifier: string;
+}[];
+```
+
+**返回值:**
+
+| 字段名             | 类型     | 描述           |
+| ------------------ | -------- | -------------- |
+| `bundleVersion`    | `string` | 应用版本号     |
+| `appName`          | `string` | 应用显示名称   |
+| `bundleIdentifier` | `string` | 应用 Bundle ID |
+
+**说明:**
+
+该方法返回设备上已安装应用的信息列表，可用于查询应用名称、Bundle ID 和版本号，便于后续调用 `startApp`、`stopApp`、`activateApp` 等应用管理方法。
+
+**示例:**
+
+```javascript
+const apps = system.getInstalledAppList();
+for (const app of apps) {
+  logi(`${app.appName}: ${app.bundleIdentifier} (${app.bundleVersion})`);
+}
+```
+
+#### recent - 打开 App 切换器。
+
+```typescript
+function recent(): boolean;
+```
+
+**返回值:**
+
+| 类型      | 描述                   |
+| --------- | ---------------------- |
+| `boolean` | 是否成功打开 App 切换器 |
+
+**示例:**
+
+```javascript
+if (system.recent()) {
+  logi("已打开 App 切换器");
+}
+```
+
 ### 锁屏控制
 
 **注意事项:**

package/docs/apicn/action.md

@@ -527,6 +527,48 @@ for (let i = 0; i < 5; i++) {
 }
 ```
 
+## W3C Actions
+
+### 执行W3C动作 - 执行 W3C Actions JSON
+
+直接提交 W3C Actions 请求体，适合执行多指、多阶段或自定义指针动作。
+
+```typescript
+function 执行W3C动作(json: { actions: 字典<任意类型>[]; [key: 字符串]: 任意类型 }): 布尔值;
+```
+
+**参数说明：**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述                              |
+| ------ | ---- | -------- | ------ | --------------------------------- |
+| `json` | 对象 | 是       | -      | W3C Actions 请求体，例如 `{ actions: [...] }` |
+
+**返回值：**
+
+| 类型     | 描述         |
+| -------- | ------------ |
+| `布尔值` | 执行是否成功 |
+
+**示例：**
+
+```typescript
+const 是否成功 = $动作.执行W3C动作({
+  actions: [
+    {
+      type: "pointer",
+      id: "finger1",
+      parameters: { pointerType: "touch" },
+      actions: [
+        { type: "pointerMove", duration: 0, x: 100, y: 200 },
+        { type: "pointerDown", button: 0 },
+        { type: "pause", duration: 20 },
+        { type: "pointerUp", button: 0 },
+      ],
+    },
+  ],
+});
+```
+
 ## 动作构建器
 
 动作构建器 提供了更高级的多点触控操作能力，支持链式调用构建复杂的手势动作。

package/docs/apicn/system.md

@@ -4,7 +4,7 @@
 
 ## 功能概览
 
-- **应用管理**: 启动、停止、激活应用，获取前台应用信息
+- **应用管理**: 启动、停止、激活应用，获取前台/后台应用信息和已安装应用列表
 - **锁屏控制**: 检查锁屏状态、锁屏和解锁操作
 - **剪贴板**: 读取和设置系统剪贴板内容
 - **URL 操作**: 打开网页链接或应用 URL Scheme
@@ -135,6 +135,88 @@ if (appInfo) {
 }
 ```
 
+#### 获取后台运行的应用列表
+
+```typescript
+function 获取后台运行的应用列表(): {
+  bundleId: 字符串;
+  name: 字符串;
+  pid: 数字;
+}[];
+```
+
+**返回值:**
+
+| 字段名     | 类型   | 描述                     |
+| ---------- | ------ | ------------------------ |
+| `bundleId` | 字符串 | 应用 Bundle ID           |
+| `name`     | 字符串 | 应用名称（不一定能取到） |
+| `pid`      | 数字   | 进程 ID                  |
+
+**说明:**
+
+该方法返回当前后台运行的应用信息列表，可用于查询仍在运行但不在前台显示的应用。
+
+**示例:**
+
+```javascript
+const apps = $系统.获取后台运行的应用列表();
+for (const app of apps) {
+  $打印信息日志(`${app.name}: ${app.bundleId} (${app.pid})`);
+}
+```
+
+#### 获取安装的应用列表
+
+```typescript
+function 获取安装的应用列表(): {
+  bundleVersion: 字符串;
+  appName: 字符串;
+  bundleIdentifier: 字符串;
+}[];
+```
+
+**返回值:**
+
+| 字段名             | 类型   | 描述           |
+| ------------------ | ------ | -------------- |
+| `bundleVersion`    | 字符串 | 应用版本号     |
+| `appName`          | 字符串 | 应用显示名称   |
+| `bundleIdentifier` | 字符串 | 应用 Bundle ID |
+
+**说明:**
+
+该方法返回设备上已安装应用的信息列表，可用于查询应用名称、Bundle ID 和版本号，便于后续调用 `启动应用`、`停止应用`、`把应用切入前台` 等应用管理方法。
+
+**示例:**
+
+```javascript
+const apps = $系统.获取安装的应用列表();
+for (const app of apps) {
+  $打印信息日志(`${app.appName}: ${app.bundleIdentifier} (${app.bundleVersion})`);
+}
+```
+
+#### 最近应用 - 打开 App 切换器。
+
+```typescript
+function 最近应用(): 布尔值;
+```
+
+**返回值:**
+
+| 类型     | 描述                   |
+| -------- | ---------------------- |
+| `布尔值` | 是否成功打开 App 切换器 |
+
+**示例:**
+
+```javascript
+if ($系统.最近应用()) {
+  $打印信息日志("已打开 App 切换器");
+}
+```
+
 ### 锁屏控制
 
 **注意事项:**

package/docs/apipython/action.md

@@ -10,11 +10,14 @@
 ## 类型定义
 
 ```python
-from typing import TypedDict, List, Literal, Optional
+from typing import Any, Dict, TypedDict, List, Literal, Optional
 
 class TapPoint(TypedDict):
     x: int
     y: int
+
+class W3CActionsJson(TypedDict):
+    actions: List[Dict[str, Any]]
 ```
 
 ## 抖动值
@@ -500,6 +503,50 @@ for i in range(5):
     action.pressButton("volumeup")
 ```
 
+## W3C Actions
+
+### w3cActions - 执行 W3C Actions JSON
+
+直接提交 W3C Actions 请求体，适合执行多指、多阶段或自定义指针动作。
+
+```python
+def w3cActions(json: dict) -> bool
+```
+
+**参数说明：**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述                              |
+| ------ | ---- | -------- | ------ | --------------------------------- |
+| `json` | dict | 是       | -      | W3C Actions 请求体，例如 `{ "actions": [...] }` |
+
+**返回值：**
+
+| 类型   | 描述         |
+| ------ | ------------ |
+| `bool` | 执行是否成功 |
+
+**示例：**
+
+```python
+from kuaijs import action
+
+success = action.w3cActions({
+    "actions": [
+        {
+            "type": "pointer",
+            "id": "finger1",
+            "parameters": { "pointerType": "touch" },
+            "actions": [
+                { "type": "pointerMove", "duration": 0, "x": 100, "y": 200 },
+                { "type": "pointerDown", "button": 0 },
+                { "type": "pause", "duration": 20 },
+                { "type": "pointerUp", "button": 0 },
+            ],
+        },
+    ],
+})
+```
+
 ## 动作构建器
 
 ActionBuilder 提供了更高级的多点触控操作能力，支持链式调用构建复杂的手势动作。

package/docs/apipython/system.md

@@ -4,7 +4,7 @@
 
 ## 功能概览
 
-- **应用管理**: 启动、停止、激活应用，获取前台应用信息
+- **应用管理**: 启动、停止、激活应用，获取前台/后台应用信息和已安装应用列表
 - **锁屏控制**: 检查锁屏状态、锁屏和解锁操作
 - **剪贴板**: 读取和设置系统剪贴板内容
 - **URL 操作**: 打开网页链接或应用 URL Scheme
@@ -25,6 +25,17 @@ class ActivateAppInfo(TypedDict):
     pid: int
 ```
 
+### InstalledAppInfo
+
+已安装应用信息结构。
+
+```python
+class InstalledAppInfo(TypedDict):
+    bundleVersion: str
+    appName: str
+    bundleIdentifier: str
+```
+
 ### MemoryInfo
 
 内存信息结构。
@@ -142,6 +153,83 @@ if info:
     print(info.name, info.bundleId, info.pid)
 ```
 
+#### backgroundAppInfos - 获取后台运行的应用列表。
+
+```python
+def backgroundAppInfos() -> List[ActivateAppInfo]
+```
+
+**返回值：**
+
+| 字段名     | 类型 | 描述                     |
+| ---------- | ---- | ------------------------ |
+| `bundleId` | str  | 应用 Bundle ID           |
+| `name`     | str  | 应用名称（不一定能取到） |
+| `pid`      | int  | 进程 ID                  |
+
+**说明：**
+
+该方法返回当前后台运行的应用信息列表，可用于查询仍在运行但不在前台显示的应用。
+
+**示例：**
+
+```python
+from kuaijs import system
+
+apps = system.backgroundAppInfos()
+for app in apps:
+    print(app.name, app.bundleId, app.pid)
+```
+
+#### getInstalledAppList - 获取已安装的应用列表。
+
+```python
+def getInstalledAppList() -> List[InstalledAppInfo]
+```
+
+**返回值：**
+
+| 字段名             | 类型 | 描述           |
+| ------------------ | ---- | -------------- |
+| `bundleVersion`    | str  | 应用版本号     |
+| `appName`          | str  | 应用显示名称   |
+| `bundleIdentifier` | str  | 应用 Bundle ID |
+
+**说明：**
+
+该方法返回设备上已安装应用的信息列表，可用于查询应用名称、Bundle ID 和版本号，便于后续调用 `startApp`、`stopApp`、`activateApp` 等应用管理方法。
+
+**示例：**
+
+```python
+from kuaijs import system
+
+apps = system.getInstalledAppList()
+for app in apps:
+    print(f"{app['appName']}: {app['bundleIdentifier']} ({app['bundleVersion']})")
+```
+
+#### recent - 打开 App 切换器。
+
+```python
+def recent() -> bool
+```
+
+**返回值:**
+
+| 类型   | 描述                   |
+| ------ | ---------------------- |
+| `bool` | 是否成功打开 App 切换器 |
+
+**示例：**
+
+```python
+from kuaijs import system
+
+if system.recent():
+    print("已打开 App 切换器")
+```
+
 ### 锁屏控制
 
 **注意事项:**

package/package.json

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