ms-vite-plugin 1.4.35 → 1.4.37

package/docs/api/device.md

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

package/docs/api/pip.md

@@ -4,7 +4,7 @@
 
 ## 功能特性
 
-- **显示模式**：支持日志、保活和自定义三种显示模式
+- **显示模式**：支持日志、保活和自定义三种显示模式；首次安装默认保活
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
 - **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化

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/api/thread.md

@@ -12,7 +12,8 @@
 
 - **独立的执行环境**: 线程函数在独立的 JavaScript 环境中运行，无法访问主线程或其他作用域中的变量、函数或对象。
 - **闭包限制**: 即使线程函数是闭包形式，它也无法捕获外部变量。传递给 `thread.run` 的函数会被转换并在新的上下文中执行。
-- **数据通信**: 如果需要与主线程通信或使用外部数据，请使用 `sharedState` 全局对象。
+- **启动参数**: 主线程可以向 `thread.run` 传入一个 Object，子线程通过全局变量 `__threadParams__` 读取。
+- **数据通信**: 线程启动后的双向数据通信请使用 `sharedState` 全局对象。
 - **文件名限制**:执行的线程 js 文件名称必须以 `_thread.js` 结尾，例如 `worker_thread.js`。
 
 ## API 参考
@@ -24,14 +25,15 @@
 启动一个新的线程来执行指定的 JS 文件。
 
 ```typescript
-function run(threadJsFileName: string): Thread;
+function run(threadJsFileName: string, params?: Record<string, any>): Thread;
 ```
 
 **参数:**
 
-| 参数名             | 类型     | 描述             |
-| ------------------ | -------- | ---------------- |
-| `threadJsFileName` | `string` | 线程 js 文件路径 |
+| 参数名             | 类型                  | 描述                                               |
+| ------------------ | --------------------- | -------------------------------------------------- |
+| `threadJsFileName` | `string`              | 线程 js 文件路径                                   |
+| `params`           | `Record<string, any>` | 可选启动参数，只能传 Object；子线程通过 `__threadParams__` 读取 |
 
 **返回值:**
 
@@ -42,8 +44,13 @@ function run(threadJsFileName: string): Thread;
 **示例:**
 
 ```javascript
-// 启动一个简单的线程
-const t = thread.run("test_thread.js");
+// 主线程传入启动参数
+const t = thread.run("test_thread.js", { taskId: 1, title: "同步任务" });
+```
+
+```javascript
+// test_thread.js
+logi(`任务 ${__threadParams__.taskId}: ${__threadParams__.title}`);
 ```
 
 #### thread.stopAll - 停止所有线程

package/docs/apicn/device.md

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

package/docs/apicn/pip.md

@@ -4,7 +4,7 @@
 
 ## 功能特性
 
-- **显示模式**：支持日志、保活和自定义三种显示模式
+- **显示模式**：支持日志、保活和自定义三种显示模式；首次安装默认保活
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
 - **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化

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/apicn/thread.md

@@ -12,7 +12,8 @@
 
 - **独立的执行环境**: 线程函数在独立的 JavaScript 环境中运行，无法访问主线程或其他作用域中的变量、函数或对象。
 - **闭包限制**: 即使线程函数是闭包形式，它也无法捕获外部变量。传递给 `$线程.运行` 的函数会被转换并在新的上下文中执行。
-- **数据通信**: 如果需要与主线程通信或使用外部数据，请使用 `$共享状态` 全局对象。
+- **启动参数**: 主线程可以向 `$线程.运行` 传入一个 Object，子线程通过全局变量 `$线程参数` 读取。
+- **数据通信**: 线程启动后的双向数据通信请使用 `$共享状态` 全局对象。
 - **文件名限制**:执行的线程 js 文件名称必须以 `_thread.js` 结尾，例如 `worker_thread.js`。
 
 ## API 参考
@@ -21,17 +22,18 @@
 
 #### $线程.运行 - 异步执行代码
 
-启动一个新的线程来执行指定的函数。
+启动一个新的线程来执行指定的 JS 文件。
 
 ```typescript
-function 运行(线程函数: () => 无返回值): 线程;
+function 运行(线程js文件名: 字符串, 启动参数?: 字典<任意类型>): 线程;
 ```
 
 **参数:**
 
-| 参数名     | 类型             | 描述                   |
-| ---------- | ---------------- | ---------------------- |
-| `线程函数` | `() => 无返回值` | 要在子线程中执行的函数 |
+| 参数名           | 类型             | 描述                                           |
+| ---------------- | ---------------- | ---------------------------------------------- |
+| `线程js文件名`   | `字符串`         | 线程 js 文件路径                               |
+| `启动参数`       | `字典<任意类型>` | 可选启动参数，只能传 Object；子线程通过 `$线程参数` 读取 |
 
 **返回值:**
 
@@ -42,8 +44,13 @@ function 运行(线程函数: () => 无返回值): 线程;
 **示例:**
 
 ```javascript
-// 启动一个简单的线程
-const t = $线程.运行("test_thread.js");
+// 主线程传入启动参数
+const t = $线程.运行("test_thread.js", { 任务编号: 1, 标题: "同步任务" });
+```
+
+```javascript
+// test_thread.js
+$打印信息日志(`任务 ${$线程参数.任务编号}: ${$线程参数.标题}`);
 ```
 
 #### $线程.停止所有 - 停止所有线程

package/docs/apipython/device.md

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

package/docs/apipython/pip.md

@@ -4,7 +4,7 @@
 
 ## 功能特性
 
-- **显示模式**：支持日志、保活和自定义三种显示模式
+- **显示模式**：支持日志、保活和自定义三种显示模式；首次安装默认保活
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
 - **尺寸设置**：日志模式和自定义模式支持设置内容宽高，并按模式分别持久化

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,6 +513,74 @@ 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
@@ -908,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
@@ -1634,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
@@ -2147,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.35",
+  "version": "1.4.37",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {