ms-vite-plugin 1.4.34 → 1.4.36

package/docs/api/cloud.md

@@ -5,7 +5,6 @@
 ## 注意事项
 
 - `cloud` 只在主脚本上下文注册，不支持在线程脚本里调用。
-- 授权卡密模式不可用。
 - 服务器事件只有一个主脚本监听槽位，多次调用 `onEvent` 会覆盖旧监听。
 
 ## 协议

package/docs/api/device.md

@@ -305,8 +305,8 @@ function setScreenBrightness(brightness: number): boolean;
 
 **返回值：**
 
-| 类型      | 描述                     |
-| --------- | ------------------------ |
+| 类型      | 描述         |
+| --------- | ------------ |
 | `boolean` | 是否设置成功 |
 
 **示例：**

package/docs/api/pip.md

@@ -4,8 +4,7 @@
 
 ## 功能特性
 
-- **显示模式**：支持日志、保活和自定义三种显示模式
-- **关闭控制**：支持主动关闭悬浮窗
+- **显示模式**：支持日志、保活和自定义三种显示模式；默认保活，不可关闭
 - **状态查询**：判断悬浮窗是否正在显示
 - **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化
 - **日志显示**：日志模式支持设置日志文字大小
@@ -103,25 +102,6 @@ pip.setCustomTextColor("#34c759");
 pip.setCustomTextSize(18);
 ```
 
-### closeWindow - 关闭悬浮窗
-
-```typescript
-function closeWindow(): boolean;
-```
-
-关闭悬浮窗。
-
-**返回值：**
-
-| 类型      | 描述                   |
-| --------- | ---------------------- |
-| `boolean` | `true` 代表已提交请求 |
-
-**示例：**
-
-```typescript
-const success = pip.closeWindow();
-```
 
 ### setContentSize - 设置内容尺寸
 
@@ -129,7 +109,7 @@ const success = pip.closeWindow();
 function setContentSize(width: number, height: number): boolean;
 ```
 
-设置日志模式或自定义模式的悬浮窗内容尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
+设置日志模式或自定义模式的悬浮窗内容尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；保活模式不会生效。
 
 **参数：**
 
@@ -308,7 +288,7 @@ pip.setContentSize(120, 180);
 
 ## 注意事项
 
-1. **前台限制**：首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式或关闭悬浮窗
+1. **前台限制**：首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式。悬浮窗不可关闭，App 回到前台时若窗口不在会自动重建
 2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
 3. **系统限制**：悬浮窗位置和实际显示尺寸由 iOS 管理
 4. **尺寸持久化**：日志模式和自定义模式分别保存尺寸，互不共用；保活模式不接受脚本尺寸

package/docs/api/system.md

@@ -13,6 +13,12 @@
 - **CPU 管理**: 获取 CPU 使用率
 - **Agent 服务**: 启动 快点 Agent 服务
 
+## 常见问题
+
+1、获取剪切板每次都会弹窗
+
+从设置找到快点JS点进去->把从其他 App 粘贴设置为允许
+
 ## API 参考
 
 ### 应用管理
@@ -206,8 +212,8 @@ function recent(): boolean;
 
 **返回值:**
 
-| 类型      | 描述                   |
-| --------- | ---------------------- |
+| 类型      | 描述                    |
+| --------- | ----------------------- |
 | `boolean` | 是否成功打开 App 切换器 |
 
 **示例:**
@@ -435,13 +441,13 @@ function getMemoryInfo(): {
 
 **返回值:**
 
-| 类型              | 描述                         |
-| ----------------- | ---------------------------- |
-| `used`            | 当前应用占用（单位：MB）     |
-| `available`       | 系统可用内存（单位：MB）     |
-| `total`           | 系统总内存（单位：MB）       |
-| `systemUsed`      | 系统已用内存（单位：MB）     |
-| `usagePercentage` | 系统内存占用率（百分比）     |
+| 类型              | 描述                     |
+| ----------------- | ------------------------ |
+| `used`            | 当前应用占用（单位：MB） |
+| `available`       | 系统可用内存（单位：MB） |
+| `total`           | 系统总内存（单位：MB）   |
+| `systemUsed`      | 系统已用内存（单位：MB） |
+| `usagePercentage` | 系统内存占用率（百分比） |
 
 **说明:**
 
@@ -559,8 +565,8 @@ function getSystemUsedMemory(): number;
 
 **返回值:**
 
-| 类型     | 描述                       |
-| -------- | -------------------------- |
+| 类型     | 描述                         |
+| -------- | ---------------------------- |
 | `number` | 系统已用内存大小（单位：MB） |
 
 **说明:**
@@ -589,8 +595,8 @@ function getCpuUsage(): number;
 
 **返回值:**
 
-| 类型     | 描述                         |
-| -------- | ---------------------------- |
+| 类型     | 描述                          |
+| -------- | ----------------------------- |
 | `number` | 当前应用 CPU 使用率（百分比） |
 
 **示例:**

package/docs/apicn/cloud.md

@@ -5,7 +5,6 @@
 ## 注意事项
 
 - `$云控` 只在主脚本上下文注册，不支持在线程脚本里调用。
-- 授权卡密模式不可用。
 - 服务器事件只有一个主脚本监听槽位，多次调用 `监听事件回调` 会覆盖旧监听。
 
 ## 协议

package/docs/apicn/device.md

@@ -319,8 +319,8 @@ function 设置屏幕亮度(亮度: 数字): 布尔值;
 
 **返回值：**
 
-| 类型   | 描述                     |
-| ------ | ------------------------ |
+| 类型   | 描述         |
+| ------ | ------------ |
 | 布尔值 | 是否设置成功 |
 
 **示例：**

package/docs/apicn/pip.md

@@ -4,8 +4,7 @@
 
 ## 功能特性
 
-- **显示模式**：支持日志、保活和自定义三种显示模式
-- **关闭控制**：支持主动关闭悬浮窗
+- **显示模式**：支持日志、保活和自定义三种显示模式；默认保活，不可关闭
 - **状态查询**：判断悬浮窗是否正在显示
 - **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化
 - **日志显示**：日志模式支持设置日志文字大小
@@ -103,25 +102,6 @@ $悬浮窗.设置自定义文字颜色("#34c759");
 $悬浮窗.设置自定义文字大小(18);
 ```
 
-### 关闭悬浮窗
-
-```typescript
-function 关闭悬浮窗(): 布尔值;
-```
-
-关闭悬浮窗。
-
-**返回值：**
-
-| 类型     | 描述                   |
-| -------- | ---------------------- |
-| `布尔值` | `true` 代表已提交请求 |
-
-**示例：**
-
-```typescript
-const 是否成功 = $悬浮窗.关闭悬浮窗();
-```
 
 ### 设置内容尺寸
 
@@ -129,7 +109,7 @@ const 是否成功 = $悬浮窗.关闭悬浮窗();
 function 设置内容尺寸(宽度: 数字, 高度: 数字): 布尔值;
 ```
 
-设置日志模式或自定义模式的悬浮窗内容尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
+设置日志模式或自定义模式的悬浮窗内容尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；保活模式不会生效。
 
 **参数：**
 
@@ -308,7 +288,7 @@ $悬浮窗.设置内容尺寸(120, 180);
 
 ## 注意事项
 
-1. **前台限制**：首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式或关闭悬浮窗
+1. **前台限制**：首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式。悬浮窗不可关闭，App 回到前台时若窗口不在会自动重建
 2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
 3. **系统限制**：悬浮窗位置和实际显示尺寸由 iOS 管理
 4. **尺寸持久化**：日志模式和自定义模式分别保存尺寸，互不共用；保活模式不接受脚本尺寸

package/docs/apicn/system.md

@@ -13,6 +13,12 @@
 - **CPU 管理**: 获取 CPU 使用率
 - **快点 Agent 服务**: 启动 Agent 服务
 
+## 常见问题
+
+1、获取剪切板每次都会弹窗
+
+从设置找到快点JS点进去->把从其他 App 粘贴设置为允许
+
 ## API 参考
 
 ### 应用管理
@@ -194,7 +200,9 @@ function 获取安装的应用列表(): {
 ```javascript
 const apps = $系统.获取安装的应用列表();
 for (const app of apps) {
-  $打印信息日志(`${app.appName}: ${app.bundleIdentifier} (${app.bundleVersion})`);
+  $打印信息日志(
+    `${app.appName}: ${app.bundleIdentifier} (${app.bundleVersion})`,
+  );
 }
 ```
 
@@ -206,8 +214,8 @@ function 最近应用(): 布尔值;
 
 **返回值:**
 
-| 类型     | 描述                   |
-| -------- | ---------------------- |
+| 类型     | 描述                    |
+| -------- | ----------------------- |
 | `布尔值` | 是否成功打开 App 切换器 |
 
 **示例:**
@@ -435,13 +443,13 @@ function 获取内存使用信息(): {
 
 **返回值:**
 
-| 参数名            | 类型 | 描述                         |
-| ----------------- | ---- | ---------------------------- |
-| `used`            | 数字 | 当前应用占用（单位：MB）     |
-| `available`       | 数字 | 系统可用内存（单位：MB）     |
-| `total`           | 数字 | 系统总内存（单位：MB）       |
-| `systemUsed`      | 数字 | 系统已用内存（单位：MB）     |
-| `usagePercentage` | 数字 | 系统内存占用率（百分比）     |
+| 参数名            | 类型 | 描述                     |
+| ----------------- | ---- | ------------------------ |
+| `used`            | 数字 | 当前应用占用（单位：MB） |
+| `available`       | 数字 | 系统可用内存（单位：MB） |
+| `total`           | 数字 | 系统总内存（单位：MB）   |
+| `systemUsed`      | 数字 | 系统已用内存（单位：MB） |
+| `usagePercentage` | 数字 | 系统内存占用率（百分比） |
 
 **说明:**
 
@@ -561,8 +569,8 @@ function 获取系统已用内存(): 数字;
 
 **返回值:**
 
-| 参数名       | 类型 | 描述                       |
-| ------------ | ---- | -------------------------- |
+| 参数名       | 类型 | 描述                         |
+| ------------ | ---- | ---------------------------- |
 | `systemUsed` | 数字 | 系统已用内存大小（单位：MB） |
 
 **说明:**
@@ -593,8 +601,8 @@ function 获取CPU使用率(): 数字;
 
 **返回值:**
 
-| 类型   | 描述                         |
-| ------ | ---------------------------- |
+| 类型   | 描述                          |
+| ------ | ----------------------------- |
 | `数字` | 当前应用 CPU 使用率（百分比） |
 
 **示例:**

package/docs/apipython/cloud.md

@@ -6,7 +6,6 @@
 
 - Python 云控模块只支持英文方法，不提供中文方法。
 - `cloud` 只能在主脚本中调用，不支持在线程脚本里调用。
-- 授权卡密模式不可用。
 - 服务器事件只有一个主脚本监听槽位，多次调用 `onEvent` 会覆盖旧监听。
 
 ## 协议

package/docs/apipython/device.md

@@ -303,8 +303,8 @@ def setScreenBrightness(brightness: float) -> bool
 
 **返回值：**
 
-| 类型   | 描述                     |
-| ------ | ------------------------ |
+| 类型   | 描述         |
+| ------ | ------------ |
 | `bool` | 是否设置成功 |
 
 **示例:**

package/docs/apipython/pip.md

@@ -4,8 +4,7 @@
 
 ## 功能特性
 
-- **显示模式**：支持日志、保活和自定义三种显示模式
-- **关闭控制**：支持主动关闭悬浮窗
+- **显示模式**：支持日志、保活和自定义三种显示模式；默认保活，不可关闭
 - **状态查询**：判断悬浮窗是否正在显示
 - **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化
 - **日志显示**：日志模式支持设置日志文字大小
@@ -109,31 +108,10 @@ pip.setCustomTextColor("#34c759")
 pip.setCustomTextSize(18)
 ```
 
-### closeWindow - 关闭悬浮窗
-
-关闭悬浮窗。
-
-```python
-def closeWindow() -> bool
-```
-
-**返回值：**
-
-| 类型   | 描述                  |
-| ------ | --------------------- |
-| `bool` | `True` 代表已提交请求 |
-
-**示例：**
-
-```python
-from kuaijs import pip
-
-success = pip.closeWindow()
-```
 
 ### setContentSize - 设置内容尺寸
 
-设置日志模式或自定义模式的悬浮窗内容尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
+设置日志模式或自定义模式的悬浮窗内容尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；保活模式不会生效。
 
 ```python
 def setContentSize(width: float, height: float) -> bool
@@ -330,7 +308,7 @@ pip.setContentSize(120, 180)
 
 ## 注意事项
 
-1. **前台限制**：首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式或关闭悬浮窗
+1. **前台限制**：首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式。悬浮窗不可关闭，App 回到前台时若窗口不在会自动重建
 2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
 3. **系统限制**：悬浮窗位置和实际显示尺寸由 iOS 管理
 4. **尺寸持久化**：日志模式和自定义模式分别保存尺寸，互不共用；保活模式不接受脚本尺寸

package/docs/apipython/system.md

@@ -13,6 +13,12 @@
 - **CPU 管理**: 获取 CPU 使用率
 - **快点 Agent 服务**: 启动 快点 Agent 服务
 
+## 常见问题
+
+1、获取剪切板每次都会弹窗
+
+从设置找到快点JS点进去->把从其他 App 粘贴设置为允许
+
 ## 类型定义
 
 ### ActivateAppInfo
@@ -225,8 +231,8 @@ def recent() -> bool
 
 **返回值:**
 
-| 类型   | 描述                   |
-| ------ | ---------------------- |
+| 类型   | 描述                    |
+| ------ | ----------------------- |
 | `bool` | 是否成功打开 App 切换器 |
 
 **示例：**

package/docs/httpapi/api.md

@@ -513,10 +513,80 @@ GET /api/setVolume
 | --------- | ------- | ---- | ---- | -------- | ---- |
 | » success | boolean | true | none | 是否成功 | none |
 
+## GET 获取系统剪切板
+
+GET /api/getClipboard
+
+该接口读取系统文本剪切板，不要求 API 键盘处于弹出状态。剪切板为空、内容不是文本或读取失败时，`data` 为 `""`。
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true,
+  "data": "示例文本"
+}
+```
+
+### 返回结果
+
+| 状态码 | 状态码含义                                              | 说明 | 数据模型 |
+| ------ | ------------------------------------------------------- | ---- | -------- |
+| 200    | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline   |
+
+### 返回数据结构
+
+状态码 **200**
+
+| 名称      | 类型    | 必选 | 约束 | 中文名     | 说明                       |
+| --------- | ------- | ---- | ---- | ---------- | -------------------------- |
+| » success | boolean | true | none | 是否成功   | none                       |
+| » data    | string  | true | none | 剪切板内容 | 空内容或读取失败时为 `""` |
+
+## GET 设置系统剪切板
+
+GET /api/setClipboard
+
+该接口设置系统文本剪切板，不要求 API 键盘处于弹出状态。`text` 参数必须存在；传入空字符串可以清空文本剪切板。
+
+### 请求参数
+
+| 名称 | 位置  | 类型   | 必选 | 中文名     | 说明                                 |
+| ---- | ----- | ------ | ---- | ---------- | ------------------------------------ |
+| text | query | string | 是   | 剪切板内容 | 需要 URL 编码；空字符串表示清空剪切板 |
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+| 状态码 | 状态码含义                                              | 说明 | 数据模型 |
+| ------ | ------------------------------------------------------- | ---- | -------- |
+| 200    | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline   |
+
+### 返回数据结构
+
+状态码 **200**
+
+| 名称      | 类型    | 必选 | 约束 | 中文名   | 说明 |
+| --------- | ------- | ---- | ---- | -------- | ---- |
+| » success | boolean | true | none | 是否成功 | none |
+
 ## POST 登录接口
 
 POST /api/login
 
+用户授权模式下，该接口会使用账号密码执行登录。授权卡密模式下，该接口是兼容旧控制端的空操作，会直接返回成功，不读取请求体字段，不切换服务器类型，也不执行账号登录。
+
 > Body 请求参数
 
 ```json
@@ -532,9 +602,9 @@ POST /api/login
 | 名称         | 位置 | 类型   | 必选 | 中文名     | 说明 |
 | ------------ | ---- | ------ | ---- | ---------- | ---- |
 | body         | body | object | 是   |            | none |
-| » serverType | body | string | 是   | 服务器类型 | none |
-| » username   | body | string | 是   | 用户名     | none |
-| » password   | body | string | 是   | 密码       | none |
+| » serverType | body | string | 是   | 服务器类型 | 用户授权模式下使用；授权卡密模式下忽略 |
+| » username   | body | string | 是   | 用户名     | 用户授权模式下使用；授权卡密模式下忽略 |
+| » password   | body | string | 是   | 密码       | 用户授权模式下使用；授权卡密模式下忽略 |
 
 #### 枚举值
 
@@ -906,23 +976,6 @@ GET /mirror/flv
 
 响应类型为 `video/x-flv`，服务端持续输出 FLV 容器内的 H.264 视频 tag。
 
-## WHEP 实时屏幕画面流
-
-POST /mirror/whep
-
-### 请求参数
-
-| 名称          | 位置  | 类型    | 必选 | 中文名 | 说明                                |
-| ------------- | ----- | ------- | ---- | ------ | ----------------------------------- |
-| fps           | query | integer | 否   |        | 帧率，默认 10，范围 1-60            |
-| quality       | query | number  | 否   |        | JPEG 源质量，默认 0.25，范围 0.1-1.0 |
-| scalingFactor | query | number  | 否   |        | 缩放比例，默认 1.0，范围 0.1-1.0    |
-| bitrate       | query | number  | 否   |        | WebRTC 发送码率，单位 Mbps，默认 4   |
-
-### 返回数据
-
-请求 body 为 `application/sdp` 的 WebRTC offer；响应类型为 `application/sdp`，内容为 WebRTC answer。
-
 ## POST 执行脚本（仅支持JS脚本）
 
 POST /api/runScript
@@ -1632,6 +1685,51 @@ GET /api/control/pressButton
 | --------- | ------- | ---- | ---- | -------- | ---- |
 | » success | boolean | true | none | 是否成功 | none |
 
+## POST 发送键盘按键或组合键
+
+POST /api/control/sendKey
+
+`keys` 支持整数或字符串元素。通用控制接口可能切换 Agent 与 HID 链路，跨链路使用时建议优先传键名或单个 ASCII 字符；整数编码需要与当前控制链路一致。
+
+> Body 请求参数
+
+```json
+{
+  "keys": ["COMMAND", "c"]
+}
+```
+
+### 请求参数
+
+| 名称   | 位置 | 类型   | 必选 | 中文名 | 说明                         |
+| ------ | ---- | ------ | ---- | ------ | ---------------------------- |
+| body   | body | object | 是   |        | none                         |
+| » keys | body | array  | 是   | 按键   | 元素支持整数、键名或单个字符 |
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+| 状态码 | 状态码含义                                              | 说明 | 数据模型 |
+| ------ | ------------------------------------------------------- | ---- | -------- |
+| 200    | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline   |
+
+### 返回数据结构
+
+状态码 **200**
+
+| 名称      | 类型    | 必选 | 约束 | 中文名   | 说明 |
+| --------- | ------- | ---- | ---- | -------- | ---- |
+| » success | boolean | true | none | 是否成功 | none |
+
 ## GET (仅键盘弹出可用)输入文字
 
 GET /api/control/input
@@ -2145,6 +2243,51 @@ GET /api/hid/pressButton
 | --------- | ------- | ---- | ---- | -------- | ---- |
 | » success | boolean | true | none | 是否成功 | none |
 
+## POST 发送 HID 键盘按键或组合键
+
+POST /api/hid/sendKey
+
+`keys` 支持整数或字符串元素。字符串可使用 HID 键名或单个 ASCII 字符；整数使用 HID 模块的按键编码。
+
+> Body 请求参数
+
+```json
+{
+  "keys": ["COMMAND", "c"]
+}
+```
+
+### 请求参数
+
+| 名称   | 位置 | 类型   | 必选 | 中文名 | 说明                         |
+| ------ | ---- | ------ | ---- | ------ | ---------------------------- |
+| body   | body | object | 是   |        | none                         |
+| » keys | body | array  | 是   | 按键   | 元素支持整数、键名或单个字符 |
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+| 状态码 | 状态码含义                                              | 说明 | 数据模型 |
+| ------ | ------------------------------------------------------- | ---- | -------- |
+| 200    | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | none | Inline   |
+
+### 返回数据结构
+
+状态码 **200**
+
+| 名称      | 类型    | 必选 | 约束 | 中文名   | 说明 |
+| --------- | ------- | ---- | ---- | -------- | ---- |
+| » success | boolean | true | none | 是否成功 | none |
+
 ## GET 快捷指令截图
 
 GET /api/hid/shortcutScreenshot

package/package.json

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