kuaijs-ios 0.2.11__py3-none-any.whl

kuaijs/__init__.py

@@ -0,0 +1,25 @@
+__all__ = [
+    "system",
+    "g",
+    "device",
+    "config",
+    "action",
+    "appleocr",
+    "file",
+    "hid",
+    "hotupdate",
+    "image",
+    "ime",
+    "media",
+    "mysql",
+    "netcard",
+    "node",
+    "paddleocr",
+    "tomatoocr",
+    "tts",
+    "ui",
+    "utils",
+    "yolo",
+    "pip",
+    "logger",
+]

kuaijs/action.pyi

@@ -0,0 +1,239 @@
+from typing import List, Literal, Protocol
+
+class TapPoint(Protocol):
+    x: int
+    y: int
+
+# 设置动作抖动值（像素，随屏幕 scale 适配）
+def set_jitter_value(value: int) -> bool:
+    """设置动作抖动值（像素，随屏幕 scale 适配）
+
+    参数:
+      value: 抖动像素值
+    返回:
+      bool: 是否设置成功
+    """
+    ...
+
+# 点击
+# 参数：x/y 坐标；duration 持续时间（ms）；jitter 是否启用抖动
+def click(x: int, y: int, duration: int = ..., jitter: bool = ...) -> bool:
+    """点击指定坐标
+
+    参数:
+      x: 坐标 X
+      y: 坐标 Y
+      duration: 按下持续时间（毫秒，默认 20ms）
+      jitter: 是否启用抖动（默认 False）
+    返回:
+      bool: 是否点击成功
+    """
+    ...
+
+# 随机点击指定矩形区域
+def click_random(x1: int, y1: int, x2: int, y2: int, duration: int = ...) -> bool:
+    """随机点击矩形区域
+
+    参数:
+      x1: 左上角 X
+      y1: 左上角 Y
+      x2: 右下角 X
+      y2: 右下角 Y
+      duration: 按下持续时间（毫秒，默认 20ms）
+    返回:
+      bool: 是否点击成功
+    """
+    ...
+
+# 双击
+# 参数：duration 持续时间；interval 间隔时间（ms）；jitter 是否抖动
+def double_click(
+    x: int, y: int, duration: int = ..., interval: int = ..., jitter: bool = ...
+) -> bool:
+    """双击
+
+    参数:
+      x: 坐标 X
+      y: 坐标 Y
+      duration: 每次按下持续时间（毫秒，默认 20ms）
+      interval: 两次点击间隔（毫秒，默认 20ms）
+      jitter: 是否启用抖动（默认 False）
+    返回:
+      bool: 是否双击成功
+    """
+    ...
+
+# 随机双击指定区域
+def double_click_random(
+    x1: int, y1: int, x2: int, y2: int, duration: int = ..., interval: int = ...
+) -> bool:
+    """随机双击矩形区域
+
+    参数:
+      x1: 左上角 X
+      y1: 左上角 Y
+      x2: 右下角 X
+      y2: 右下角 Y
+      duration: 每次按下持续时间（毫秒，默认 20ms）
+      interval: 两次点击间隔（毫秒，默认 20ms）
+    返回:
+      bool: 是否双击成功
+    """
+    ...
+
+# 直线滑动
+# 参数：起点 x/y；终点 ex/ey；duration 总时长；jitter 抖动；steps 轨迹点数
+def swipe(
+    startX: int,
+    startY: int,
+    endX: int,
+    endY: int,
+    duration: int = ...,
+    jitter: bool = ...,
+    steps: int = ...,
+) -> bool:
+    """直线滑动
+
+    参数:
+      startX: 起始 X
+      startY: 起始 Y
+      endX: 结束 X
+      endY: 结束 Y
+      duration: 总时长（毫秒，默认 100ms）
+      jitter: 是否启用抖动（默认 False）
+      steps: 轨迹点数量（默认 6）
+    返回:
+      bool: 是否滑动成功
+    """
+    ...
+
+# 长按并滑动
+# 参数：touch_* 三段时长（ms）；steps 步数
+def press_and_swipe(
+    startX: int,
+    startY: int,
+    endX: int,
+    endY: int,
+    touch_down_duration: int = ...,
+    touch_move_duration: int = ...,
+    touch_up_duration: int = ...,
+    jitter: bool = ...,
+    steps: int = ...,
+) -> bool:
+    """长按并滑动
+
+    参数:
+      touch_down_duration: 按下时长（毫秒，默认 500ms）
+      touch_move_duration: 移动时长（毫秒，默认 1000ms）
+      touch_up_duration: 抬起时长（毫秒，默认 500ms）
+      jitter: 是否启用抖动（默认 False）
+      steps: 轨迹点数量（默认 6）
+      其他坐标与滑动参数同 swipe
+    返回:
+      bool: 是否执行成功
+    """
+    ...
+
+# 3点曲线滑动（先快后慢）
+def swipe_curve(
+    startX: int, startY: int, midX: int, midY: int, endX: int, endY: int, duration: int
+) -> bool:
+    """3点曲线滑动（先快后慢）
+
+    参数:
+      startX/startY: 起点坐标
+      midX/midY: 中间控制点坐标
+      endX/endY: 终点坐标
+      duration: 总时长（毫秒，默认 1000ms）
+    返回:
+      bool: 是否执行成功
+    """
+    ...
+
+# 输入英文文本（不支持中文）
+def input(text: str) -> bool:
+    """输入英文文本（不支持中文）
+
+    参数:
+      text: 文本内容
+    返回:
+      bool: 是否输入成功
+    """
+    ...
+
+# 删除文本（count 默认 1）
+def backspace(count: int = ...) -> bool:
+    """删除文本
+
+    参数:
+      count: 删除数量（默认 1）
+    返回:
+      bool: 是否删除成功
+    """
+    ...
+
+# 回车
+def enter() -> bool:
+    """回车
+
+    返回:
+      bool: 是否成功
+    """
+    ...
+
+# 回到主屏幕
+def home_screen() -> bool:
+    """回到主屏幕
+
+    返回:
+      bool: 是否成功
+    """
+    ...
+
+# 按按钮（home/volumeup/volumedown 等）
+def press_button(button: Literal["home", "volumeup", "volumedown"]) -> bool:
+    """按按钮（home/volumeup/volumedown 等）
+
+    参数:
+      button: 按钮名称
+    返回:
+      bool: 是否成功
+    """
+    ...
+
+# 按 HID 按钮（power/snapshot 等），可指定时长
+def press_hid_button(button: str, duration: int = ...) -> bool:
+    """按 HID 按钮（power/snapshot 等），可指定时长
+
+    参数:
+      button: HID 按钮名称
+      duration: 持续时间（毫秒，默认 20ms）
+    返回:
+      bool: 是否成功
+    """
+    ...
+
+# 链式 ActionBuilder
+class Pointer:
+    def move_to(self, x: int, y: int, duration: int = ...) -> "Pointer": ...
+    def down(self) -> "Pointer": ...
+    def up(self) -> "Pointer": ...
+    def stay(self, duration: int = ...) -> "Pointer": ...
+    def tap(self, x: int, y: int, duration: int = ...) -> "Pointer": ...
+    def done(self) -> "ActionBuilder": ...
+
+class ActionBuilder:
+    def add_pointer(self, id: int) -> Pointer: ...
+    def single_tap(self, x: int, y: int, duration: int = ...) -> "ActionBuilder": ...
+    def multi_tap(
+        self, points: List[TapPoint], duration: int = ...
+    ) -> "ActionBuilder": ...
+    def execute(self) -> bool: ...
+
+def create_builder() -> ActionBuilder:
+    """创建 ActionBuilder 构建器
+
+    返回:
+      ActionBuilder: 链式构建器实例
+    """
+    ...

kuaijs/appleocr.pyi

@@ -0,0 +1,84 @@
+from typing import List, Optional, Protocol
+
+# OCR 识别（Apple Vision）
+# 参数：
+# - input: 输入源（imageId、URL字符串、文件路径或 "screen"）
+# - x: 边界框左上角 x 坐标
+# - y: 边界框左上角 y 坐标
+# - ex: 边界框右下角 x 坐标
+# - ey: 边界框右下角 y 坐标
+# - languages: 识别语言数组，例如 ["zh-Hans", "en-US"]
+class OCRResult(Protocol):
+    text: str
+    confidence: float
+    x: int
+    y: int
+    ex: int
+    ey: int
+    width: int
+    height: int
+    centerX: int
+    centerY: int
+
+def recognize(
+    input: str,
+    x: int = ...,
+    y: int = ...,
+    ex: int = ...,
+    ey: int = ...,
+    languages: Optional[List[str]] = ...,
+) -> List[OCRResult]:
+    """OCR 识别（Apple Vision）
+
+    参数默认值:
+      x/y/ex/ey: 0
+      languages: ["zh-Hans", "en-US"]
+    返回:
+      List[OCRResult]: 文本、置信度与位置信息列表
+    """
+    ...
+
+# 纯数字 OCR 识别
+# 参数：同上，过滤非数字，仅保留 0-9 . , - +
+# 返回：数字文本结果列表（含位置信息）
+def recognize_numbers(
+    input: str,
+    x: int = ...,
+    y: int = ...,
+    ex: int = ...,
+    ey: int = ...,
+) -> List[OCRResult]:
+    """仅识别数字（过滤非数字，保留 0-9 . , - +）
+
+    参数默认值:
+      x/y/ex/ey: 0
+    返回:
+      同 recognize
+    """
+    ...
+
+# 查找包含目标文本的位置
+# 参数：
+# - input: 输入源（imageId、URL字符串、文件路径或 "screen"）
+# - targetTexts: 要查找的目标文本数组
+# - x/y/ex/ey: 搜索区域边界框
+# - languages: 识别语言数组（可选）
+# 返回：匹配到的文本位置信息列表
+def find_text(
+    input: str,
+    targetTexts: List[str],
+    x: int = ...,
+    y: int = ...,
+    ex: int = ...,
+    ey: int = ...,
+    languages: Optional[List[str]] = ...,
+) -> List[OCRResult]:
+    """查找指定文本位置
+
+    参数默认值:
+      x/y/ex/ey: 0
+      languages: ["zh-Hans", "en-US"]
+    返回:
+      List[OCRResult]: 匹配文本的位置信息列表
+    """
+    ...

kuaijs/config.pyi

@@ -0,0 +1,43 @@
+from typing import Any, Dict, Optional
+
+# 读取整数配置
+def read_int(key: str) -> int:
+    """读取整数配置
+
+    参数:
+      key: 配置键
+    返回:
+      int: 配置值
+    """
+    ...
+
+# 读取浮点配置
+def read_double(key: str) -> float:
+    """读取浮点配置"""
+    ...
+
+# 读取字符串配置
+def read_string(key: str) -> Optional[str]:
+    """读取字符串配置（不存在返回 None）"""
+    ...
+
+# 读取布尔配置
+def read_bool(key: str) -> bool:
+    """读取布尔配置"""
+    ...
+
+# 获取所有配置
+def get_json() -> Dict[str, Any]:
+    """获取所有配置 JSON"""
+    ...
+
+# 更新配置
+# value 支持：str/int/float/bool
+def update_config(key: str, value: Any) -> bool:
+    """更新配置值（支持 str/int/float/bool）"""
+    ...
+
+# 删除配置
+def delete_config(key: str) -> bool:
+    """删除配置"""
+    ...

kuaijs/device.pyi

@@ -0,0 +1,80 @@
+from typing import Literal, Protocol
+
+class ScreenSize(Protocol):
+    width: float
+    height: float
+
+class BatteryInfo(Protocol):
+    level: int
+    isCharging: bool
+
+# 获取电池信息
+# 返回：{"level": 百分比int, "isCharging": 是否充电bool}
+def get_battery_info() -> BatteryInfo:
+    """获取电池信息（level/isCharging）"""
+    ...
+
+# 获取设备ID（Vendor ID）
+def get_device_id() -> str:
+    """获取设备 ID（Vendor ID）"""
+    ...
+
+# 获取服务器设备ID（自定义）
+def get_server_device_id() -> str:
+    """获取服务器设备 ID（自定义）"""
+    ...
+
+# 获取设备名称
+def get_device_name() -> str:
+    """获取设备名称"""
+    ...
+
+# 获取设备型号（硬件型号）
+def get_device_model() -> str:
+    """获取设备型号（硬件型号）"""
+    ...
+
+# 获取屏幕逻辑尺寸
+# 返回：{"width": float, "height": float}
+def get_screen_size() -> ScreenSize:
+    """获取屏幕逻辑尺寸（width/height）"""
+    ...
+
+# 获取屏幕实际尺寸
+# 返回：{"width": float, "height": float}
+def get_screen_real_size() -> ScreenSize:
+    """获取屏幕实际尺寸（width/height）"""
+    ...
+
+# 获取屏幕缩放比例
+def get_screen_scale() -> float:
+    """获取屏幕缩放比例"""
+    ...
+
+# 获取屏幕方向
+def get_orientation() -> Literal["PORTRAIT", "LANDSCAPE"]:
+    """获取屏幕方向"""
+    ...
+
+# 获取系统版本
+def get_os_version() -> str:
+    """获取系统版本（例如 16.7.11）"""
+    ...
+
+# 获取局域网IP
+def get_lan_ip() -> str:
+    """获取局域网 IP（例如 192.168.1.100）"""
+    ...
+
+# 震动
+# 参数：duration 毫秒；intensity 0.0-1.0
+def vibrate(duration: int, intensity: float) -> bool:
+    """震动
+
+    参数:
+      duration: 持续时间（毫秒）
+      intensity: 强度 0.0-1.0
+    返回:
+      bool: 是否成功
+    """
+    ...

kuaijs/file.pyi

@@ -0,0 +1,103 @@
+from typing import List, Optional, Literal
+
+# 获取内部目录
+# 参数：type = documents | library | temp | libraryCaches
+def get_internal_dir(
+    type: Literal["documents", "library", "temp", "libraryCaches"],
+) -> str:
+    """获取内部目录路径
+
+    参数:
+      type: 目录类型
+    返回:
+      str: 路径
+    """
+    ...
+
+# 获取数据目录
+def get_data_dir() -> str:
+    """获取应用数据目录路径"""
+    ...
+
+# 获取数据文件路径
+# 参数：file = 文件名
+def get_data_file(file: str) -> str:
+    """获取应用数据文件路径"""
+    ...
+
+# 创建文件
+def create(path: str) -> bool:
+    """创建文件"""
+    ...
+
+# 递归创建目录
+def mkdirs(path: str) -> bool:
+    """递归创建目录"""
+    ...
+
+# 删除文件或目录（谨慎）
+def delete_all_file(path: str) -> bool:
+    """删除文件或目录（谨慎）"""
+    ...
+
+# 读取文件内容（UTF-8）
+def read_file(path: str) -> Optional[str]:
+    """读取文件内容（UTF-8）"""
+    ...
+
+# 读取资源文件内容（UTF-8）
+def read_res_file(fileName: str) -> Optional[str]:
+    """读取资源文件内容（UTF-8）"""
+    ...
+
+# 删除指定行或包含关键字的行
+# 参数：line >=0 删除行号；line <0 且 contains 指定关键字
+def delete_line(path: str, line: int, contains: Optional[str]) -> bool:
+    """删除指定行或包含关键字的行
+
+    参数:
+      line: 行号（>=0 删除对应行；<0 时忽略行号）
+      contains: 包含关键字（当行号<0时生效）
+    """
+    ...
+
+# 列出目录文件
+# 参数：recursion 是否递归
+def list_dir(path: str, recursion: bool) -> List[str]:
+    """列出目录文件"""
+    ...
+
+# 写入文件（覆盖，UTF-8）
+def write_file(path: str, data: str) -> bool:
+    """写入文件（覆盖，UTF-8）"""
+    ...
+
+# 追加一行（UTF-8）
+def append_line(path: str, data: str) -> bool:
+    """追加一行（UTF-8）"""
+    ...
+
+# 读取指定行（0 基）
+def read_line(path: str, lineNo: int) -> Optional[str]:
+    """读取指定行（0 基）"""
+    ...
+
+# 读取所有行
+def read_all_lines(path: str) -> Optional[List[str]]:
+    """读取所有行"""
+    ...
+
+# 文件是否存在
+def exists(path: str) -> bool:
+    """文件或目录是否存在"""
+    ...
+
+# 复制文件
+def copy(src: str, dest: str) -> bool:
+    """复制文件"""
+    ...
+
+# 计算文件 MD5（十六进制字符串）
+def file_md5(path: str) -> Optional[str]:
+    """计算文件 MD5（十六进制字符串）"""
+    ...

kuaijs/g.pyi

@@ -0,0 +1,24 @@
+from typing import Final
+
+# 应用版本号（字符串），例如 "1.2.3"
+app_version: Final[str]
+
+# 应用构建号（整数），例如 123
+app_build_number: Final[int]
+
+# 应用名称，例如 "快点JS"
+app_name: Final[str]
+
+# 应用包名（Bundle ID），例如 "com.example.app"
+app_bundle_id: Final[str]
+
+# 是否处于调试模式（根据宿主环境设置）
+is_debug: Final[bool]
+
+# 应用的 package.json 内容
+package_json: Final[dict]
+
+# 将宿主应用切入前台
+def take_me_to_front() -> None:
+    """将宿主应用切入前台"""
+    ...