ms-vite-plugin 1.5.9 → 1.5.10

package/docs/apipython/jbdylib.md

@@ -0,0 +1,215 @@
+# 动态库模块 (JBDylib)
+
+仅越狱包可用。免越狱包没有 `jbdylib`。
+
+把动态库放到脚本项目的 `res` 目录，用相对路径 `open`，再用 `define` / `defineAll` 绑定签名，之后按符号名调用。同一进程重复打开同一路径会复用已加载的库。未 `define` 的符号不能调用。C 符号名不能与 `define` / `defineAll` / `call` / `symbol` 重名。
+
+## 类型
+
+`retType` / `argTypes` 使用下面的类型名：
+
+| 类型 | 说明 |
+| ---- | ---- |
+| `void` | 无返回值；调用成功时返回 `True` |
+| `bool` | 布尔 |
+| `int` | 32 位整数 |
+| `uint` | 32 位无符号整数 |
+| `int64` | 64 位整数 |
+| `uint64` | 64 位无符号整数 |
+| `float` | 32 位浮点 |
+| `double` | 64 位浮点 |
+| `string` | C 字符串 |
+| `pointer` | 指针 |
+
+只支持常见 C 标量类型。整数、指针、字符串参数合计最多 8 个，浮点参数最多 8 个。不支持结构体、C++ 方法和可变参数。指针用 `"0x..."` 字符串。
+
+`defineAll` / `open` 第二参数里，每个函数可以写成：
+
+| 写法 | 含义 |
+| ---- | ---- |
+| `"void"` 或 `["void"]` | 返回 `void`，无参数 |
+| `["int", ["int", "int"]]` | 返回 `int`，两个 `int` 参数 |
+| `["int", "int", "int"]` | 同上，参数类型也可以扁平写在返回类型后面 |
+
+## API 参考
+
+### open - 从 `res` 加载动态库，返回库对象。
+
+```python
+def open(name: str, defs: Optional[Dict[str, Any]] = None) -> Optional[JbDylibLib]
+```
+
+**参数:**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述                                                         |
+| ------ | ---- | -------- | ------ | ------------------------------------------------------------ |
+| `name` | str  | 是       | -      | 相对 `res` 的动态库路径，例如 `"mylib.dylib"` 或 `"libs/mylib.dylib"` |
+| `defs` | dict | 否       | `None` | 打开后立刻批量绑定的函数表 |
+
+**返回值:**
+
+| 类型                    | 描述                               |
+| ----------------------- | ---------------------------------- |
+| `JbDylibLib \| None`    | 加载成功返回库对象，失败返回 `None` |
+
+**示例:**
+
+```python
+from kuaijs import jbdylib
+
+lib = jbdylib.open("mylib.dylib", {
+    "mylib_add": ["int", ["int", "int"]],
+    "mylib_get_name": ["string"],
+    "mylib_touch": "void",
+})
+if lib:
+    print(lib.mylib_add(1, 2))
+```
+
+### isLoaded - 查询动态库是否已加载。
+
+```python
+def isLoaded(name: str) -> bool
+```
+
+**参数:**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述                     |
+| ------ | ---- | -------- | ------ | ------------------------ |
+| `name` | str  | 是       | -      | 相对 `res` 的动态库路径 |
+
+**返回值:**
+
+| 类型   | 描述                         |
+| ------ | ---------------------------- |
+| `bool` | 已加载为 `True`，否则 `False` |
+
+**示例:**
+
+```python
+if not jbdylib.isLoaded("mylib.dylib"):
+    jbdylib.open("mylib.dylib")
+```
+
+## 库对象
+
+`open` 返回的库对象。先定义签名，再按符号名调用。
+
+```python
+from kuaijs._types import KuaiJSNamespace
+
+class JbDylibLib(KuaiJSNamespace):
+    def define(self, symbol: str, retType: str, argTypes: Optional[List[str]] = None) -> bool: ...
+    def defineAll(self, specs: Dict[str, Any]) -> bool: ...
+    def call(self, symbol: str, *args: Any) -> Any: ...
+    def symbol(self, name: str) -> Optional[str]: ...
+```
+
+### define - 绑定一个导出函数的签名。
+
+```python
+def define(self, symbol: str, retType: str, argTypes: Optional[List[str]] = None) -> bool
+```
+
+**参数:**
+
+| 参数名     | 类型                | 是否必填 | 默认值 | 描述                           |
+| ---------- | ------------------- | -------- | ------ | ------------------------------ |
+| `symbol`   | str                 | 是       | -      | 导出符号名，例如 `"mylib_add"` |
+| `retType`  | str                 | 是       | -      | 返回类型                       |
+| `argTypes` | `List[str] \| None` | 否       | `None` | 每个参数的类型，无参数时可省略 |
+
+**返回值:**
+
+| 类型   | 描述                                     |
+| ------ | ---------------------------------------- |
+| `bool` | 签名合法且符号存在为 `True`，否则 `False` |
+
+**示例:**
+
+```python
+lib = jbdylib.open("mylib.dylib")
+lib.define("mylib_add", "int", ["int", "int"])
+print(lib.mylib_add(1, 2))
+```
+
+### defineAll - 批量绑定导出函数。
+
+```python
+def defineAll(self, specs: Dict[str, Any]) -> bool
+```
+
+**参数:**
+
+| 参数名  | 类型 | 是否必填 | 默认值 | 描述                     |
+| ------- | ---- | -------- | ------ | ------------------------ |
+| `specs` | dict | 是       | -      | 键为符号名，值为函数定义 |
+
+**返回值:**
+
+| 类型   | 描述                                           |
+| ------ | ---------------------------------------------- |
+| `bool` | 全部成功为 `True`；失败项会跳过，其余仍会绑定 |
+
+**示例:**
+
+```python
+lib.defineAll({
+    "mylib_add": ["int", ["int", "int"]],
+    "mylib_touch": "void",
+})
+```
+
+### call - 按已绑定签名调用导出函数。
+
+```python
+def call(self, symbol: str, *args: Any) -> Any
+```
+
+**参数:**
+
+| 参数名   | 类型 | 是否必填 | 默认值 | 描述                       |
+| -------- | ---- | -------- | ------ | -------------------------- |
+| `symbol` | str  | 是       | -      | 已绑定的导出符号名         |
+| `args`   | Any  | 否       | -      | 与定义时参数类型对应的实参 |
+
+**返回值:**
+
+| 类型  | 描述                                                 |
+| ----- | ---------------------------------------------------- |
+| `Any` | 调用成功返回结果；`void` 成功返回 `True`；失败返回 `None` |
+
+**示例:**
+
+```python
+sum = lib.call("mylib_add", 1, 2)
+print(sum)
+
+lib.define("mylib_touch", "void")
+lib.call("mylib_touch")
+```
+
+### symbol - 解析导出符号地址。
+
+```python
+def symbol(self, name: str) -> Optional[str]
+```
+
+**参数:**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述       |
+| ------ | ---- | -------- | ------ | ---------- |
+| `name` | str  | 是       | -      | 导出符号名 |
+
+**返回值:**
+
+| 类型          | 描述                                     |
+| ------------- | ---------------------------------------- |
+| `str \| None` | 成功返回 `"0x..."` 地址，失败返回 `None` |
+
+**示例:**
+
+```python
+addr = lib.symbol("mylib_add")
+print(addr)
+```

package/docs/apipython/jbshell.md

@@ -0,0 +1,61 @@
+# 终端模块 (JBShell)
+
+仅越狱包可用。免越狱包没有 `jbshell`。
+
+用 `exec` 执行一条 shell 命令，同步等到结束或超时，返回 `code`、`stdout`、`stderr`。命令走 `sh -c`。`stdout` / `stderr` 各最多 8MB。
+
+## 类型
+
+```python
+from kuaijs._types import KuaiJSNamespace
+
+class JbShellResult(KuaiJSNamespace):
+    code: int
+    stdout: str
+    stderr: str
+```
+
+| 字段     | 类型 | 描述                                         |
+| -------- | ---- | -------------------------------------------- |
+| `code`   | int  | 退出码；超时为 `-1`；被信号结束后为 `128 + 信号` |
+| `stdout` | str  | 标准输出文本                                 |
+| `stderr` | str  | 标准错误文本                                 |
+
+## API 参考
+
+### exec - 执行一条 shell 命令，等到结束或超时。
+
+```python
+def exec(command: str, timeoutMs: Optional[int] = None) -> Optional[JbShellResult]
+```
+
+**参数:**
+
+| 参数名      | 类型 | 是否必填 | 默认值  | 描述                                           |
+| ----------- | ---- | -------- | ------- | ---------------------------------------------- |
+| `command`   | str  | 是       | -       | 交给 `sh -c` 的命令                       |
+| `timeoutMs` | int  | 否       | `30000` | 等待上限毫秒；`<= 0` 时用默认值，最长 `3600000` |
+
+**返回值:**
+
+| 类型                        | 描述                                                         |
+| --------------------------- | ------------------------------------------------------------ |
+| `JbShellResult \| None`     | 启动成功返回结果；空命令或启动失败返回 `None`。超时仍返回已捕获输出，`code` 为 `-1` |
+
+**示例:**
+
+```python
+from kuaijs import jbshell
+
+r = jbshell.exec("printf hello")
+if r:
+    print(r.code)
+    print(r.stdout)
+
+failed = jbshell.exec("printf boom 1>&2; exit 7")
+print(failed.code)
+print(failed.stderr)
+
+timed = jbshell.exec("sleep 5", 300)
+print(timed.code)
+```

package/docs/apipython/jbsystem.md

@@ -0,0 +1,216 @@
+# 系统模块 (JBSystem)
+
+仅越狱包可用。免越狱包没有 `jbsystem`。
+
+`respring` 重启 SpringBoard。`reboot` 重启用户空间，不是重启整机。这两项调用后当前 App 和脚本通常会被系统结束。`restartSelf` 重启当前 App 进程，调用后当前脚本会结束，App 随后会被重新拉起。
+
+还可读写「允许 App 请求跟踪」「个性化广告」和定位服务总开关。不同 iOS 版本中，这些设置项的名称或位置可能略有不同。
+
+## API 参考
+
+### respring - 重启 SpringBoard（Respring）。
+
+```python
+def respring() -> bool
+```
+
+**返回值:**
+
+| 类型   | 描述                            |
+| ------ | ------------------------------- |
+| `bool` | 成功为 `True`         |
+
+**示例:**
+
+```python
+from kuaijs import jbsystem
+
+jbsystem.respring()
+```
+
+### reboot - 重启用户空间。
+
+不是重启整机。
+
+```python
+def reboot() -> bool
+```
+
+**返回值:**
+
+| 类型   | 描述                            |
+| ------ | ------------------------------- |
+| `bool` | 成功为 `True`         |
+
+**示例:**
+
+```python
+from kuaijs import jbsystem
+
+jbsystem.reboot()
+```
+
+### restartSelf - 重启当前 App 进程。
+
+调用后当前脚本会结束，App 随后会被重新拉起。
+
+```python
+def restartSelf() -> bool
+```
+
+**返回值:**
+
+| 类型   | 描述                    |
+| ------ | ----------------------- |
+| `bool` | 成功为 `True`           |
+
+**示例:**
+
+```python
+from kuaijs import jbsystem
+
+jbsystem.restartSelf()
+```
+
+### getUserTracking - 读取「允许 App 请求跟踪」总开关。
+
+对应 `设置 > 隐私与安全性 > 跟踪 > 允许 App 请求跟踪`。
+
+```python
+def getUserTracking() -> bool | None:
+```
+
+**返回值:**
+
+| 类型            | 描述                            |
+| --------------- | ------------------------------- |
+| `bool \| None`  | 当前是否允许；读失败返回 `None` |
+
+**示例:**
+
+```python
+from kuaijs import jbsystem
+
+allow = jbsystem.getUserTracking()
+if isinstance(allow, bool):
+    jbsystem.setUserTracking(False)
+    jbsystem.setUserTracking(allow)
+```
+
+### setUserTracking - 设置「允许 App 请求跟踪」总开关。
+
+```python
+def setUserTracking(enabled: bool) -> bool:
+```
+
+**参数:**
+
+| 参数名    | 类型 | 是否必填 | 默认值 | 描述                                     |
+| --------- | ---- | -------- | ------ | ---------------------------------------- |
+| `enabled` | bool | 是       | -      | `True` 允许 App 弹跟踪请求，`False` 不允许 |
+
+**返回值:**
+
+| 类型   | 描述                    |
+| ------ | ----------------------- |
+| `bool` | 成功为 `True` |
+
+**示例:**
+
+```python
+jbsystem.setUserTracking(False)
+```
+
+### getPersonalizedAdvertising - 读取「个性化广告」开关。
+
+对应 `设置 > 隐私与安全性 > Apple 广告 > 个性化广告`。
+
+```python
+def getPersonalizedAdvertising() -> bool | None:
+```
+
+**返回值:**
+
+| 类型            | 描述                            |
+| --------------- | ------------------------------- |
+| `bool \| None`  | 当前是否允许；读失败返回 `None` |
+
+**示例:**
+
+```python
+allow = jbsystem.getPersonalizedAdvertising()
+if isinstance(allow, bool):
+    jbsystem.setPersonalizedAdvertising(False)
+    jbsystem.setPersonalizedAdvertising(allow)
+```
+
+### setPersonalizedAdvertising - 设置「个性化广告」开关。
+
+```python
+def setPersonalizedAdvertising(enabled: bool) -> bool:
+```
+
+**参数:**
+
+| 参数名    | 类型 | 是否必填 | 默认值 | 描述                               |
+| --------- | ---- | -------- | ------ | ---------------------------------- |
+| `enabled` | bool | 是       | -      | `True` 允许个性化广告，`False` 不允许 |
+
+**返回值:**
+
+| 类型   | 描述                    |
+| ------ | ----------------------- |
+| `bool` | 成功为 `True` |
+
+**示例:**
+
+```python
+jbsystem.setPersonalizedAdvertising(False)
+```
+
+### getLocationServices - 读取定位服务总开关。
+
+对应 `设置 > 隐私与安全性 > 定位服务` 总开关。
+
+```python
+def getLocationServices() -> bool | None:
+```
+
+**返回值:**
+
+| 类型            | 描述                            |
+| --------------- | ------------------------------- |
+| `bool \| None`  | 当前是否开启；读失败返回 `None` |
+
+**示例:**
+
+```python
+enabled = jbsystem.getLocationServices()
+if isinstance(enabled, bool):
+    jbsystem.setLocationServices(False)
+    jbsystem.setLocationServices(enabled)
+```
+
+### setLocationServices - 设置定位服务总开关。
+
+```python
+def setLocationServices(enabled: bool) -> bool:
+```
+
+**参数:**
+
+| 参数名    | 类型 | 是否必填 | 默认值 | 描述                           |
+| --------- | ---- | -------- | ------ | ------------------------------ |
+| `enabled` | bool | 是       | -      | `True` 开启定位服务，`False` 关闭 |
+
+**返回值:**
+
+| 类型   | 描述                    |
+| ------ | ----------------------- |
+| `bool` | 成功为 `True` |
+
+**示例:**
+
+```python
+jbsystem.setLocationServices(False)
+```

package/docs/apipython/jbvpn.md

@@ -0,0 +1,231 @@
+# VPN 模块 (JBVPN)
+
+仅越狱包可用。免越狱包没有 `jbvpn`。
+
+管理系统 VPN 配置：创建、列出、读取当前选中、选中、删除、连接、断开，以及读取当前选中配置的状态。类型支持 `L2TP`、`IPSec`、`IKEv2`。
+
+`create` 必填显示名、类型和服务器。`select` / `remove` / `connect` 可传显示名，或 `list` 返回的 `id`。多条配置同名时不保证操作哪一条，精确操作请用 `id`。
+
+`connect` / `disconnect` 返回 `True` 只表示已经开始，不表示已经连上或已经断开。用 `status` 看 `connected`。没有选中配置时，`connect()`、`disconnect()`、`status()` 失败。
+
+## API 参考
+
+### create - 创建一条系统 VPN 配置。
+
+```python
+def create(config: dict) -> bool
+```
+
+**参数:**
+
+| 参数名   | 类型   | 是否必填 | 默认值 | 描述                                  |
+| -------- | ------ | -------- | ------ | ------------------------------------- |
+| `config` | `dict` | 是       | -      | 配置表。必填 `name`、`type`、`server` |
+
+`config` 字段：
+
+| 字段名            | 类型   | 是否必填 | 默认值   | 描述                            |
+| ----------------- | ------ | -------- | -------- | ------------------------------- |
+| `name`            | `str`  | 是       | -        | 显示名                          |
+| `type`            | `str`  | 是       | -        | `L2TP` / `IPSec` / `IKEv2`      |
+| `server`          | `str`  | 是       | -        | 服务器地址                      |
+| `account`         | `str`  | 否       | `""`     | 账号                            |
+| `password`        | `str`  | 否       | `""`     | 密码                            |
+| `secret`          | `str`  | 否       | `""`     | 共享密钥。L2TP / IPSec 常用     |
+| `group`           | `str`  | 否       | `""`     | 群组名称                        |
+| `sendAllTraffic`  | `bool` | 否       | `True`   | 是否发送所有流量                |
+| `encryptionLevel` | `int`  | 否       | `1`      | 加密级别                        |
+| `localId`         | `str`  | 否       | `""`     | 本端标识。IKEv2 可用            |
+| `remoteId`        | `str`  | 否       | `""`     | 对端标识。IKEv2 可用            |
+
+**返回值:**
+
+| 类型   | 描述            |
+| ------ | --------------- |
+| `bool` | 成功为 `True`   |
+
+**示例:**
+
+```python
+from kuaijs import jbvpn
+
+ok = jbvpn.create({
+    "name": "Demo",
+    "type": "L2TP",
+    "server": "vpn.example.com",
+    "account": "user",
+    "password": "pass",
+    "secret": "psk",
+})
+```
+
+### list - 列出当前系统 VPN 配置。
+
+```python
+def list() -> list | None
+```
+
+**返回值:**
+
+| 类型          | 描述                        |
+| ------------- | --------------------------- |
+| `list \| None` | 配置列表；读失败返回 `None` |
+
+没有配置时是空列表。每项含 `name`、`id`。
+
+**示例:**
+
+```python
+from kuaijs import jbvpn
+
+items = jbvpn.list()
+if items:
+    for item in items:
+        print(item.name, item.id)
+```
+
+### current - 读取当前选中的 VPN 配置。
+
+没有选中配置返回 `None`。
+
+```python
+def current() -> VpnItem | None
+```
+
+**返回值:**
+
+| 类型               | 描述                                      |
+| ------------------ | ----------------------------------------- |
+| `VpnItem \| None`  | 含 `name`、`id`；没有选中配置返回 `None` |
+
+**示例:**
+
+```python
+from kuaijs import jbvpn
+
+item = jbvpn.current()
+if item:
+    print(item.name, item.id)
+```
+
+### select - 选中一条 VPN 配置。
+
+```python
+def select(nameOrId: str) -> bool
+```
+
+**参数:**
+
+| 参数名      | 类型  | 是否必填 | 默认值 | 描述                    |
+| ----------- | ----- | -------- | ------ | ----------------------- |
+| `nameOrId`  | `str` | 是       | -      | 显示名或 `list` 的 `id` |
+
+**返回值:**
+
+| 类型   | 描述                  |
+| ------ | --------------------- |
+| `bool` | 找到并选中为 `True`   |
+
+**示例:**
+
+```python
+from kuaijs import jbvpn
+
+jbvpn.select("Demo")
+```
+
+### remove - 删除一条 VPN 配置。
+
+```python
+def remove(nameOrId: str) -> bool
+```
+
+**参数:**
+
+| 参数名      | 类型  | 是否必填 | 默认值 | 描述                    |
+| ----------- | ----- | -------- | ------ | ----------------------- |
+| `nameOrId`  | `str` | 是       | -      | 显示名或 `list` 的 `id` |
+
+**返回值:**
+
+| 类型   | 描述                  |
+| ------ | --------------------- |
+| `bool` | 找到并删除为 `True`   |
+
+**示例:**
+
+```python
+from kuaijs import jbvpn
+
+jbvpn.remove("Demo")
+```
+
+### connect - 连接 VPN。
+
+传入显示名或 `id` 时先选中再连接；省略则连接当前选中的配置。
+
+```python
+def connect(nameOrId: str | None = None) -> bool
+```
+
+**参数:**
+
+| 参数名      | 类型          | 是否必填 | 默认值 | 描述                          |
+| ----------- | ------------- | -------- | ------ | ----------------------------- |
+| `nameOrId`  | `str \| None` | 否       | -      | 显示名或 `id`；省略用当前选中 |
+
+**返回值:**
+
+| 类型   | 描述                              |
+| ------ | --------------------------------- |
+| `bool` | 开始连接为 `True`，不是已经连上   |
+
+**示例:**
+
+```python
+from kuaijs import jbvpn
+
+jbvpn.connect("Demo")
+```
+
+### disconnect - 断开当前 VPN 连接。
+
+```python
+def disconnect() -> bool
+```
+
+**返回值:**
+
+| 类型   | 描述                              |
+| ------ | --------------------------------- |
+| `bool` | 开始断开为 `True`，不是已经断开   |
+
+**示例:**
+
+```python
+from kuaijs import jbvpn
+
+jbvpn.disconnect()
+```
+
+### status - 读取当前选中 VPN 的状态。
+
+```python
+def status() -> VpnStatus | None
+```
+
+**返回值:**
+
+| 类型               | 描述                                          |
+| ------------------ | --------------------------------------------- |
+| `VpnStatus \| None` | 含 `text`、`connected`；没有选中配置返回 `None` |
+
+**示例:**
+
+```python
+from kuaijs import jbvpn
+
+st = jbvpn.status()
+if st and st.connected:
+    print(st.text)
+```