ms-vite-plugin 1.5.8 → 1.5.10

package/docs/api/pip.md

@@ -1,13 +1,14 @@
 # 悬浮窗模块 (PIP)
 
-悬浮窗模块提供 iOS 画中画（Picture in Picture）悬浮窗能力，可用于显示脚本日志、保活提示或脚本自定义文本。
+悬浮窗模块提供 iOS 悬浮窗能力。免越狱包使用系统画中画（Picture in Picture），可用于显示脚本日志、保活提示或脚本自定义文本。越狱包使用同一套 `pip` API 控制全局悬浮球：保活只显示图标，日志显示图标和日志窗口，自定义显示图标和自定义文本窗口。
 
 ## 功能特性
 
-- **显示模式**：支持日志、保活和自定义三种显示模式；首次安装默认保活
+- **显示模式**：支持日志、保活和自定义三种显示模式；首次安装默认关闭
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
-- **尺寸设置**：日志模式和自定义模式支持设置内容宽高比（实际显示尺寸由系统决定），并按模式分别持久化
+- **尺寸设置**：日志模式和自定义模式支持设置尺寸并分别持久化。系统画中画为宽高比（实际显示尺寸由系统决定）；越狱包为窗口宽高（像素）
+- **位置设置**：越狱包可用 `setPosition` 设置日志窗口和自定义文本窗口位置；保活模式不接受；系统画中画位置由 iOS 管理
 - **日志显示**：日志模式支持设置日志文字大小
 - **自定义文本**：自定义模式支持文本、换行、文字颜色、背景色和文字大小
 
@@ -42,7 +43,7 @@ if (isActive) {
 function switchToLogMode(): boolean;
 ```
 
-切换到日志模式并尝试显示悬浮窗日志窗口。首次显示悬浮窗时 App 必须在前台。日志模式会恢复最近一次保存的日志窗口尺寸。
+切换到日志模式并尝试显示悬浮窗日志窗口。首次显示系统画中画时 App 必须在前台。日志模式会恢复最近一次保存的日志窗口尺寸。越狱包显示悬浮球图标和日志窗口。
 
 **返回值：**
 
@@ -64,7 +65,7 @@ pip.setLogFontSize(10);
 function switchToKeepAliveMode(): boolean;
 ```
 
-切换到保活模式并尝试显示极小高度悬浮窗。首次显示悬浮窗时 App 必须在前台。保活模式不接受脚本尺寸设置。
+切换到保活模式并尝试显示极小高度悬浮窗。首次显示系统画中画时 App 必须在前台。保活模式不接受脚本尺寸设置。越狱包只显示悬浮球图标。
 
 **返回值：**
 
@@ -85,7 +86,7 @@ const success = pip.switchToKeepAliveMode();
 function switchToCustomMode(): boolean;
 ```
 
-切换到自定义模式并显示脚本设置的自定义文本。首次显示悬浮窗时 App 必须在前台。自定义模式会恢复最近一次保存的自定义窗口尺寸。
+切换到自定义模式并显示脚本设置的自定义文本。首次显示系统画中画时 App 必须在前台。自定义模式会恢复最近一次保存的自定义窗口尺寸。越狱包显示悬浮球图标和自定义文本窗口。
 
 **返回值：**
 
@@ -129,14 +130,14 @@ const success = pip.closeWindow();
 function setContentSize(width: number, height: number): boolean;
 ```
 
-设置日志模式或自定义模式的悬浮窗内容尺寸。传入的宽高表示宽高比，不是最终像素尺寸；悬浮窗实际显示的宽高由系统决定。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
+设置日志模式或自定义模式的悬浮窗内容尺寸。系统画中画传入的宽高表示宽高比，不是最终像素尺寸，实际显示宽高由系统决定。越狱包传入的宽高是对应窗口的像素尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；关闭状态和保活模式不会生效。
 
 **参数：**
 
 | 参数     | 类型             | 必填 | 描述                                           |
 | -------- | ---------------- | ---- | ---------------------------------------------- |
-| `width`  | `number` | 是   | 宽度方向比例值（与 `height` 共同决定宽高比，不是像素） |
-| `height` | `number` | 是   | 高度方向比例值（与 `width` 共同决定宽高比，不是像素） |
+| `width`  | `number` | 是   | 宽度。系统画中画为比例值；越狱包为窗口宽度（像素） |
+| `height` | `number` | 是   | 高度。系统画中画为比例值；越狱包为窗口高度（像素） |
 
 **返回值：**
 
@@ -154,6 +155,34 @@ pip.switchToCustomMode();
 pip.setContentSize(120, 180);
 ```
 
+### setPosition - 设置位置
+
+```typescript
+function setPosition(x: number, y: number): boolean;
+```
+
+设置悬浮窗位置。仅越狱包生效；系统画中画由 iOS 管理位置，调用返回 `false`。只对日志窗口和自定义文本窗口生效；保活模式不接受设置位置。
+
+**参数：**
+
+| 参数 | 类型     | 必填 | 描述               |
+| ---- | -------- | ---- | ------------------ |
+| `x`  | `number` | 是   | 窗口左上角逻辑 X   |
+| `y`  | `number` | 是   | 窗口左上角逻辑 Y   |
+
+**返回值：**
+
+| 类型      | 描述                                                       |
+| --------- | ---------------------------------------------------------- |
+| `boolean` | `true` 代表位置已提交；`false` 代表当前不能设置位置        |
+
+**示例：**
+
+```typescript
+pip.switchToLogMode();
+pip.setPosition(24, 120);
+```
+
 ### setLogFontSize - 设置日志文字大小
 
 ```typescript
@@ -308,9 +337,9 @@ pip.setContentSize(120, 180);
 
 ## 注意事项
 
-1. **前台限制**：首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式或关闭悬浮窗
-2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
-3. **系统限制**：悬浮窗位置和实际显示尺寸由 iOS 管理
+1. **前台限制**：系统画中画首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式或关闭悬浮窗
+2. **设备兼容性**：系统画中画仅支持 iOS 15+ 且具备画中画功能的设备；越狱包全局悬浮球不依赖系统画中画
+3. **位置**：系统画中画位置由 iOS 管理；越狱包日志/自定义窗口可用 `setPosition`，保活模式不接受
 4. **尺寸持久化**：日志模式和自定义模式分别保存尺寸，互不共用；保活模式不接受脚本尺寸
 5. **日志字号**：日志字号只影响日志模式，保活模式和自定义模式不受影响
 6. **竖向文本**：自定义窗口高度大于宽度时，文本会按逐字符换行方式竖向显示
@@ -319,11 +348,17 @@ pip.setContentSize(120, 180);
 
 ### 悬浮窗无法显示
 
-- 确认设备支持悬浮窗功能
-- 检查悬浮窗权限是否已开启
-- 确认应用当前在前台
+- 确认当前已切换到日志、保活或自定义模式，且不是关闭状态
+- 系统画中画：确认设备支持悬浮窗功能，并检查悬浮窗权限是否已开启
+- 系统画中画：确认应用当前在前台
 
 ### setContentSize 返回 false
 
 - 确认当前模式是日志模式或自定义模式
 - 确认宽度和高度都传入了有效数字
+
+### setPosition 返回 false
+
+- 确认当前是越狱包，且已切换到日志或自定义模式，对应窗口已打开
+- 保活模式不支持设置位置
+- 确认 x、y 都传入了有效数字

package/docs/api/plist.md

@@ -0,0 +1,137 @@
+# 属性列表模块 (Plist)
+
+路径必须是绝对路径。
+
+## API 参考
+
+### read - 读取整个 plist。
+
+```typescript
+function read(path: string): any | null;
+```
+
+**参数:**
+
+| 参数名 | 类型     | 是否必填 | 默认值 | 描述         |
+| ------ | -------- | -------- | ------ | ------------ |
+| `path` | `string` | 是       | -      | 文件绝对路径 |
+
+**返回值:**
+
+| 类型            | 描述   |
+| --------------- | ------ |
+| `any` \| `null` | 根对象 |
+
+**示例:**
+
+```javascript
+const path = file.getInternalDir("documents") + "/info.plist";
+const info = plist.read(path);
+```
+
+### write - 写成 plist。
+
+```typescript
+function write(path: string, value: any, format?: "xml" | "binary"): boolean;
+```
+
+**参数:**
+
+| 参数名   | 类型                  | 是否必填 | 默认值  | 描述                           |
+| -------- | --------------------- | -------- | ------- | ------------------------------ |
+| `path`   | `string`              | 是       | -       | 文件绝对路径                   |
+| `value`  | `any`                 | 是       | -       | 字典、数组、字符串、数字或布尔 |
+| `format` | `"xml"` \| `"binary"` | 否       | `"xml"` | 写入格式                       |
+
+**返回值:**
+
+| 类型      | 描述              |
+| --------- | ----------------- |
+| `boolean` | 写入成功为 `true` |
+
+**示例:**
+
+```javascript
+const path = file.getInternalDir("documents") + "/info.plist";
+plist.write(path, { name: "kuaijs", count: 1 });
+plist.write(path, { name: "kuaijs" }, "binary");
+```
+
+### get - 按键读取。
+
+```typescript
+function get(path: string, key: string | string[]): any | null;
+```
+
+**参数:**
+
+| 参数名 | 类型                   | 是否必填 | 默认值 | 描述             |
+| ------ | ---------------------- | -------- | ------ | ---------------- |
+| `path` | `string`               | 是       | -      | 文件绝对路径     |
+| `key`  | `string` \| `string[]` | 是       | -      | 键，或嵌套键数组 |
+
+**返回值:**
+
+| 类型            | 描述     |
+| --------------- | -------- |
+| `any` \| `null` | 该键的值 |
+
+**示例:**
+
+```javascript
+plist.get(path, "name");
+plist.get(path, ["a", "b"]);
+```
+
+### set - 按键写入。
+
+```typescript
+function set(path: string, key: string | string[], value: any): boolean;
+```
+
+**参数:**
+
+| 参数名  | 类型                   | 是否必填 | 默认值 | 描述             |
+| ------- | ---------------------- | -------- | ------ | ---------------- |
+| `path`  | `string`               | 是       | -      | 文件绝对路径     |
+| `key`   | `string` \| `string[]` | 是       | -      | 键，或嵌套键数组 |
+| `value` | `any`                  | 是       | -      | 要写入的值       |
+
+**返回值:**
+
+| 类型      | 描述              |
+| --------- | ----------------- |
+| `boolean` | 写入成功为 `true` |
+
+**示例:**
+
+```javascript
+plist.set(path, "name", "kuaijs");
+plist.set(path, ["a", "b"], 1);
+```
+
+### remove - 按键删除。
+
+```typescript
+function remove(path: string, key: string | string[]): boolean;
+```
+
+**参数:**
+
+| 参数名 | 类型                   | 是否必填 | 默认值 | 描述             |
+| ------ | ---------------------- | -------- | ------ | ---------------- |
+| `path` | `string`               | 是       | -      | 文件绝对路径     |
+| `key`  | `string` \| `string[]` | 是       | -      | 键，或嵌套键数组 |
+
+**返回值:**
+
+| 类型      | 描述              |
+| --------- | ----------------- |
+| `boolean` | 删除成功为 `true` |
+
+**示例:**
+
+```javascript
+plist.remove(path, "name");
+plist.remove(path, ["a", "b"]);
+```

package/docs/api/ui.md

@@ -119,6 +119,47 @@ ui.call("loadData", {
 });
 ```
 
+### callFloatingWindow - 调用越狱悬浮窗网页中的 JavaScript 函数
+
+```typescript
+function callFloatingWindow(key: string, data: Record<string, any>): void;
+```
+
+调用悬浮窗网页里 `registerUIFunc` 注册的函数。主界面 WebView 不受影响。没有悬浮窗网页时无效果。
+
+**参数：**
+
+| 参数名 | 类型                | 是否必填 | 默认值 | 描述                     |
+| ------ | ------------------- | -------- | ------ | ------------------------ |
+| `key`  | string              | 是       |        | 悬浮窗页面 JavaScript 方法名 |
+| `data` | Record<string, any> | 是       |        | 传递给方法的参数         |
+
+**示例：**
+
+```typescript
+ui.callFloatingWindow("updateStatus", { status: "running", progress: 50 });
+```
+
+### evalFloatingWindow - 在越狱悬浮窗网页中执行 JavaScript
+
+```typescript
+function evalFloatingWindow(code: string): void;
+```
+
+在悬浮窗网页中执行 JavaScript。主界面 WebView 不受影响。没有悬浮窗网页时无效果。
+
+**参数：**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述                 |
+| ------ | ------ | -------- | ------ | -------------------- |
+| `code` | string | 是       |        | JavaScript 代码字符串 |
+
+**示例：**
+
+```typescript
+ui.evalFloatingWindow("console.log('float')");
+```
+
 ### showToast - 显示 Toast 提示消息
 
 ```typescript
@@ -655,6 +696,30 @@ ms.getDeviceID()
   });
 ```
 
+#### getOrientation - 获取屏幕方向
+
+```typescript
+declare function getOrientation(): Promise<"PORTRAIT" | "LANDSCAPE">;
+```
+
+**返回值：**
+
+| 类型                                        | 描述                                                         |
+| ------------------------------------------- | ------------------------------------------------------------ |
+| `Promise<"PORTRAIT" \| "LANDSCAPE">` | `"PORTRAIT"` 竖屏，`"LANDSCAPE"` 横屏 |
+
+**说明：**
+
+获取当前屏幕方向。
+
+**网页端示例：**
+
+```javascript
+ms.getOrientation().then((orientation) => {
+  console.log(orientation);
+});
+```
+
 #### getAuthCardNo - 获取缓存的授权卡密
 
 ```typescript
@@ -719,6 +784,55 @@ ms.openURL("https://www.baidu.com")
   });
 ```
 
+#### setWebWindowSize - 设置网页窗口宽高
+
+```typescript
+declare function setWebWindowSize(size: {
+  portraitWidth: number;
+  portraitHeight: number;
+  landscapeWidth: number;
+  landscapeHeight: number;
+}): Promise<boolean>;
+```
+
+**参数：**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述                     |
+| ------ | ------ | -------- | ------ | ------------------------ |
+| `size` | object | 是       |        | 横竖屏网页窗口像素尺寸   |
+
+**`size` 字段：**
+
+| 字段名            | 类型   | 是否必填 | 默认值 | 描述                   |
+| ----------------- | ------ | -------- | ------ | ---------------------- |
+| `portraitWidth`   | number | 是       |        | 竖屏窗口宽度（像素）   |
+| `portraitHeight`  | number | 是       |        | 竖屏窗口高度（像素）   |
+| `landscapeWidth`  | number | 是       |        | 横屏窗口宽度（像素）   |
+| `landscapeHeight` | number | 是       |        | 横屏窗口高度（像素）   |
+
+**返回值：**
+
+| 类型               | 描述                                  |
+| ------------------ | ------------------------------------- |
+| `Promise<boolean>` | 如果设置成功返回 true，否则返回 false |
+
+**说明：**
+
+仅越狱包可用。一次同时设置竖屏和横屏的网页窗口像素尺寸。未调用过时，横竖屏都默认使用对应朝向屏幕宽高的 60%。免越狱包调用返回 `false`。
+
+**网页端示例：**
+
+```javascript
+ms.setWebWindowSize({
+  portraitWidth: 700,
+  portraitHeight: 1200,
+  landscapeWidth: 1200,
+  landscapeHeight: 700,
+}).then((ok) => {
+  console.log(ok);
+});
+```
+
 ### 完整示例
 
 **完整的控制面板示例：**

package/docs/apicn/device.md

@@ -61,10 +61,7 @@ $打印信息日志(`剩余存储: ${存储空间.free}${存储空间.unit}`);
 
 ### 获取设备 ID
 
-**注意事项：**
-
-- 这个 ID 卸载重装 APP 后会改变。
-- 更新 APP 后，不会改变。
+越狱包返回芯片生成的固定 ID，卸载重装不变；免越狱包返回 IDFV，卸载重装会改变。
 
 ```typescript
 function 获取设备ID(): 字符串;
@@ -72,14 +69,13 @@ function 获取设备ID(): 字符串;
 
 **返回值：**
 
-| 类型     | 描述             |
-| -------- | ---------------- |
-| `字符串` | 设备的唯一标识符 |
+| 类型     | 描述    |
+| -------- | ------- |
+| `字符串` | 设备 ID |
 
 **示例：**
 
 ```typescript
-// 获取设备ID
 const uuid = $设备.获取设备ID();
 $打印信息日志(`设备ID: ${uuid}`);
 ```

package/docs/apicn/global.md

@@ -66,10 +66,10 @@ $打印信息日志(`运行状态: ${$是否运行}`);
 
 #### **$平台**
 
-平台信息，标识当前应用运行的平台，例如 "ios"、"android" 等。
+免越狱包为 `"ios"`，越狱包为 `"ios_jb"`。
 
 ```typescript
-declare const $平台: "ios" | "android";
+declare const $平台: "ios" | "ios_jb";
 ```
 
 **示例:**

package/docs/apicn/pip.md

@@ -1,13 +1,14 @@
 # 悬浮窗模块 ($悬浮窗)
 
-悬浮窗模块提供 iOS 画中画（Picture in Picture）悬浮窗能力，可用于显示脚本日志、保活提示或脚本自定义文本。
+悬浮窗模块提供 iOS 悬浮窗能力。免越狱包使用系统画中画（Picture in Picture），可用于显示脚本日志、保活提示或脚本自定义文本。越狱包使用同一套 `$悬浮窗` API 控制全局悬浮球：保活只显示图标，日志显示图标和日志窗口，自定义显示图标和自定义文本窗口。
 
 ## 功能特性
 
-- **显示模式**：支持日志、保活和自定义三种显示模式；首次安装默认保活
+- **显示模式**：支持日志、保活和自定义三种显示模式；首次安装默认关闭
 - **关闭控制**：支持主动关闭悬浮窗
 - **状态查询**：判断悬浮窗是否正在显示
-- **尺寸设置**：日志模式和自定义模式支持设置内容宽高比（实际显示尺寸由系统决定），并按模式分别持久化
+- **尺寸设置**：日志模式和自定义模式支持设置尺寸并分别持久化。系统画中画为宽高比（实际显示尺寸由系统决定）；越狱包为窗口宽高（像素）
+- **位置设置**：越狱包可用 `设置位置` 设置日志窗口和自定义文本窗口位置；保活模式不接受；系统画中画位置由 iOS 管理
 - **日志显示**：日志模式支持设置日志文字大小
 - **自定义文本**：自定义模式支持文本、换行、文字颜色、背景色和文字大小
 
@@ -42,7 +43,7 @@ if (是否显示) {
 function 切换到日志模式(): 布尔值;
 ```
 
-切换到日志模式并尝试显示悬浮窗日志窗口。首次显示悬浮窗时 App 必须在前台。日志模式会恢复最近一次保存的日志窗口尺寸。
+切换到日志模式并尝试显示悬浮窗日志窗口。首次显示系统画中画时 App 必须在前台。日志模式会恢复最近一次保存的日志窗口尺寸。越狱包显示悬浮球图标和日志窗口。
 
 **返回值：**
 
@@ -64,7 +65,7 @@ $悬浮窗.设置日志文字大小(10);
 function 切换到保活模式(): 布尔值;
 ```
 
-切换到保活模式并尝试显示极小高度悬浮窗。首次显示悬浮窗时 App 必须在前台。保活模式不接受脚本尺寸设置。
+切换到保活模式并尝试显示极小高度悬浮窗。首次显示系统画中画时 App 必须在前台。保活模式不接受脚本尺寸设置。越狱包只显示悬浮球图标。
 
 **返回值：**
 
@@ -85,7 +86,7 @@ const 是否成功 = $悬浮窗.切换到保活模式();
 function 切换到自定义模式(): 布尔值;
 ```
 
-切换到自定义模式并显示脚本设置的自定义文本。首次显示悬浮窗时 App 必须在前台。自定义模式会恢复最近一次保存的自定义窗口尺寸。
+切换到自定义模式并显示脚本设置的自定义文本。首次显示系统画中画时 App 必须在前台。自定义模式会恢复最近一次保存的自定义窗口尺寸。越狱包显示悬浮球图标和自定义文本窗口。
 
 **返回值：**
 
@@ -129,14 +130,14 @@ const 是否成功 = $悬浮窗.关闭悬浮窗();
 function 设置内容尺寸(宽度: 数字, 高度: 数字): 布尔值;
 ```
 
-设置日志模式或自定义模式的悬浮窗内容尺寸。传入的宽高表示宽高比，不是最终像素尺寸；悬浮窗实际显示的宽高由系统决定。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；悬浮窗关闭状态和保活模式不会生效。
+设置日志模式或自定义模式的悬浮窗内容尺寸。系统画中画传入的宽高表示宽高比，不是最终像素尺寸，实际显示宽高由系统决定。越狱包传入的宽高是对应窗口的像素尺寸。宽度和高度都必须传入有效数字。日志模式和自定义模式会分别保存尺寸；关闭状态和保活模式不会生效。
 
 **参数：**
 
 | 参数   | 类型          | 必填 | 描述                                           |
 | ------ | ------------- | ---- | ---------------------------------------------- |
-| `宽度` | `数字` | 是   | 宽度方向比例值（与高度共同决定宽高比，不是像素） |
-| `高度` | `数字` | 是   | 高度方向比例值（与宽度共同决定宽高比，不是像素） |
+| `宽度` | `数字` | 是   | 宽度。系统画中画为比例值；越狱包为窗口宽度（像素） |
+| `高度` | `数字` | 是   | 高度。系统画中画为比例值；越狱包为窗口高度（像素） |
 
 **返回值：**
 
@@ -154,6 +155,34 @@ $悬浮窗.切换到自定义模式();
 $悬浮窗.设置内容尺寸(120, 180);
 ```
 
+### 设置位置
+
+```typescript
+function 设置位置(横坐标: 数字, 纵坐标: 数字): 布尔值;
+```
+
+设置悬浮窗位置。仅越狱包生效；系统画中画由 iOS 管理位置，调用返回 `false`。只对日志窗口和自定义文本窗口生效；保活模式不接受设置位置。
+
+**参数：**
+
+| 参数     | 类型   | 必填 | 描述               |
+| -------- | ------ | ---- | ------------------ |
+| `横坐标` | `数字` | 是   | 窗口左上角逻辑 X   |
+| `纵坐标` | `数字` | 是   | 窗口左上角逻辑 Y   |
+
+**返回值：**
+
+| 类型     | 描述                                                |
+| -------- | --------------------------------------------------- |
+| `布尔值` | `true` 代表位置已提交；`false` 代表当前不能设置位置 |
+
+**示例：**
+
+```typescript
+$悬浮窗.切换到日志模式();
+$悬浮窗.设置位置(24, 120);
+```
+
 ### 设置日志文字大小
 
 ```typescript
@@ -308,9 +337,9 @@ $悬浮窗.设置内容尺寸(120, 180);
 
 ## 注意事项
 
-1. **前台限制**：首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式或关闭悬浮窗
-2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
-3. **系统限制**：悬浮窗位置和实际显示尺寸由 iOS 管理
+1. **前台限制**：系统画中画首次切换到日志、保活或自定义显示模式并启动悬浮窗时，App 必须在前台；悬浮窗已启动后可以继续切换显示模式或关闭悬浮窗
+2. **设备兼容性**：系统画中画仅支持 iOS 15+ 且具备画中画功能的设备；越狱包全局悬浮球不依赖系统画中画
+3. **位置**：系统画中画位置由 iOS 管理；越狱包日志/自定义窗口可用 `设置位置`，保活模式不接受
 4. **尺寸持久化**：日志模式和自定义模式分别保存尺寸，互不共用；保活模式不接受脚本尺寸
 5. **日志字号**：日志字号只影响日志模式，保活模式和自定义模式不受影响
 6. **竖向文本**：自定义窗口高度大于宽度时，文本会按逐字符换行方式竖向显示
@@ -319,11 +348,17 @@ $悬浮窗.设置内容尺寸(120, 180);
 
 ### 悬浮窗无法显示
 
-- 确认设备支持悬浮窗功能
-- 检查悬浮窗权限是否已开启
-- 确认应用当前在前台
+- 确认当前已切换到日志、保活或自定义模式，且不是关闭状态
+- 系统画中画：确认设备支持悬浮窗功能，并检查悬浮窗权限是否已开启
+- 系统画中画：确认应用当前在前台
 
 ### 设置内容尺寸返回 false
 
 - 确认当前模式是日志模式或自定义模式
 - 确认宽度和高度都传入了有效数字
+
+### 设置位置返回 false
+
+- 确认当前是越狱包，且已切换到日志或自定义模式，对应窗口已打开
+- 保活模式不支持设置位置
+- 确认横坐标、纵坐标都传入了有效数字