kuaijs-ios 0.2.11__py3-none-any.whl

kuaijs/hid.pyi

@@ -0,0 +1,218 @@
+from typing import Any, List, Optional, Literal, Protocol
+
+class AppInfo(Protocol):
+    name: str
+    bundleId: str
+
+class HIDKey(Protocol):
+    COMMAND: int
+    LEFT_CTRL: int
+    LEFT_SHIFT: int
+    LEFT_ALT: int
+    RIGHT_CTRL: int
+    RIGHT_SHIFT: int
+    RIGHT_ALT: int
+    UP_ARROW: int
+    DOWN_ARROW: int
+    LEFT_ARROW: int
+    RIGHT_ARROW: int
+    SPACE: int
+    BACKSPACE: int
+    TAB: int
+    RETURN: int
+    ESC: int
+    INSERT: int
+    DELETE: int
+    PAGE_UP: int
+    PAGE_DOWN: int
+    HOME: int
+    END: int
+    CAPS_LOCK: int
+    F1: int
+    F2: int
+    F3: int
+    F4: int
+    F5: int
+    F6: int
+    F7: int
+    F8: int
+    F9: int
+    F10: int
+    F11: int
+    F12: int
+
+hidKey: HIDKey
+"""HID 按键常量映射。
+
+用于组合键发送：可通过 hidKey.COMMAND、hidKey.LEFT_CTRL 等取得修饰键代码，
+也支持字典访问 hidKey["COMMAND"] 与直接传入字符串名称（如 "COMMAND"）。
+示例：
+    from kuaijs import hid
+    hid.send_key([hid.hidKey.COMMAND, "c"])    # 复制（点属性）
+    hid.send_key([hid.hidKey["COMMAND"], "c"])  # 复制（字典）
+    hid.send_key(["COMMAND", "v"])             # 粘贴（字符串键名）
+"""
+
+# 设置动作抖动值（像素，随屏幕 scale 适配）
+def set_jitter_value(value: int) -> None: ...
+
+# 重置坐标系方向（如 "portrait" | "landscape"）
+def reset_position(orientation: Literal["PORTRAIT", "LANDSCAPE"] = ...) -> None:
+    """重置坐标系方向
+
+    参数:
+      orientation: 屏幕方向（PORTRAIT/LANDSCAPE）
+    """
+    ...
+
+# 点击
+# 参数：x/y 坐标；duration 持续时间（ms）；jitter 是否启用抖动
+def click(x: int, y: int, duration: int = ..., jitter: bool = ...) -> bool:
+    """点击指定坐标
+
+    参数:
+      x/y: 坐标
+      duration: 按下时长（毫秒，默认 10ms）
+      jitter: 是否启用抖动（默认 False）
+    返回:
+      bool: 是否成功
+    """
+    ...
+
+# 随机点击指定矩形区域
+def click_random(x1: int, y1: int, x2: int, y2: int, duration: int = ...) -> bool:
+    """随机点击指定矩形区域
+
+    参数:
+      x1/y1/x2/y2: 矩形区域坐标
+      duration: 按下时长（毫秒，默认 20ms）
+    返回:
+      bool: 是否成功
+    """
+    ...
+
+# 双击
+# 参数：duration 持续时间；interval 间隔时间（ms）；jitter 是否抖动
+def double_click(
+    x: int, y: int, duration: int = ..., interval: int = ..., jitter: bool = ...
+) -> bool:
+    """双击指定坐标
+
+    参数:
+      duration: 每次按下时长（毫秒，默认 20ms）
+      interval: 两次点击间隔（毫秒，默认 20ms）
+      jitter: 是否启用抖动（默认 False）
+    """
+    ...
+
+# 随机双击指定区域
+def double_click_random(
+    x1: int, y1: int, x2: int, y2: int, duration: int = ..., interval: int = ...
+) -> bool:
+    """随机双击矩形区域"""
+    ...
+
+# 直线滑动
+# 参数：起点 x/y；终点 ex/ey；jitter 抖动；steps 轨迹点数
+def swipe(
+    x: int, y: int, ex: int, ey: int, jitter: bool = ..., steps: int = ...
+) -> bool:
+    """直线滑动
+
+    参数:
+      jitter: 是否启用抖动（默认 False）
+      steps: 轨迹点数量（默认 6）
+    """
+    ...
+
+# 3 点曲线滑动（先快后慢）
+def swipe_curve(
+    startX: int, startY: int, midX: int, midY: int, endX: int, endY: int
+) -> bool:
+    """3 点曲线滑动"""
+    ...
+
+# 回主页（Command+H）
+def home_screen() -> bool:
+    """回主页（Command+H）"""
+    ...
+
+# 输入简单键盘数据（仅英文与可输入键；不支持中文）
+def input_simple(data: str) -> bool:
+    """输入简单文本（英文及可输入键）"""
+    ...
+
+# 空格/删除/回车
+def space() -> bool:
+    """空格键"""
+    ...
+
+def backspace() -> bool:
+    """删除键"""
+    ...
+
+def enter() -> bool:
+    """回车键"""
+    ...
+
+# 发送组合按键（支持 Int 或字符）
+def send_key(keys: List[Any]) -> bool:
+    """发送组合按键（支持数字或字符）"""
+    ...
+
+# 复制/粘贴/返回/最近应用/锁屏/解锁
+def copy_text() -> bool:
+    """复制文本（Command+C）"""
+    ...
+
+def paste_text() -> bool:
+    """粘贴文本（Command+V）"""
+    ...
+
+def back() -> bool:
+    """返回（Tab+B）"""
+    ...
+
+def recent() -> bool:
+    """APP 切换器"""
+    ...
+
+def lock() -> bool:
+    """锁屏"""
+    ...
+
+def unlock() -> bool:
+    """解锁"""
+    ...
+
+# 打开 URL / App；切到前台
+def open_url(url: str) -> bool:
+    """打开 URL"""
+    ...
+
+def open_app(name: str) -> bool:
+    """打开 App"""
+    ...
+
+def take_me_to_front() -> bool:
+    """切到前台"""
+    ...
+
+# 当前应用信息（仅 IOS18+）
+def current_app_info() -> Optional[AppInfo]:
+    """当前应用信息（仅 iOS18+）"""
+    ...
+
+# 剪切板读写
+def set_clipboard(text: str) -> bool:
+    """设置剪贴板"""
+    ...
+
+def get_clipboard() -> str:
+    """获取剪贴板"""
+    ...
+
+# 执行自定义按钮（1-11）
+def custom_button(button: int) -> bool:
+    """执行自定义按钮（1-11）"""
+    ...

kuaijs/hotupdate.pyi

@@ -0,0 +1,45 @@
+from typing import Optional, Protocol
+
+# 检查更新（options: url/timeout/version），返回 {needUpdate,data?,error?}
+class HotUpdateResponse(Protocol):
+    download_url: str
+    version: int
+    download_timeout: int
+    dialog: bool
+    msg: str
+    force: bool
+    md5: Optional[str]
+
+class HotUpdateResult(Protocol):
+    need_update: bool
+    error: Optional[str]
+    data: Optional[HotUpdateResponse]
+
+class HotUpdateOptions(Protocol):
+    url: Optional[str]
+    version: Optional[int]
+    timeout: Optional[int]
+
+# 下载并安装（返回 {updated,error?}）
+class InstallResult(Protocol):
+    updated: bool
+    error: Optional[str]
+
+def check_update(options: Optional[HotUpdateOptions] = ...) -> HotUpdateResult:
+    """检查更新
+
+    参数:
+      options: 检查参数（url/version/timeout）
+    返回:
+      HotUpdateResult: needUpdate/data/error
+    """
+    ...
+
+def download_and_install() -> InstallResult:
+    """下载并安装更新（执行成功会自动重启脚本）"""
+    ...
+
+# 获取当前应用版本号（整数）
+def get_current_version() -> int:
+    """获取当前应用版本号（数字）"""
+    ...

kuaijs/image.pyi

@@ -0,0 +1,177 @@
+from typing import List, Optional, Protocol
+
+class Size(Protocol):
+    width: int
+    height: int
+
+# 单点找色（返回点坐标列表）
+class Point(Protocol):
+    x: int
+    y: int
+
+# 找图（返回矩形列表）
+class Rect(Protocol):
+    x: int
+    y: int
+    width: int
+    height: int
+    confidence: float
+    centerX: int
+    centerY: int
+    ex: int
+    ey: int
+
+# 截取全屏并返回图片ID
+def capture_full_screen() -> Optional[str]:
+    """截取全屏并返回图片ID（失败返回 None）"""
+    ...
+
+# 截取屏幕区域并返回图片ID
+# 参数：x/y 左上角；ex/ey 右下角
+def capture_rect(x: int, y: int, ex: int, ey: int) -> Optional[str]:
+    """截取屏幕区域并返回图片ID（x/y 左上角；ex/ey 右下角）"""
+    ...
+
+# 读取图片文件为图片ID
+def read_image(path: str) -> Optional[str]:
+    """读取图片文件为图片ID"""
+    ...
+
+# 裁剪图片并返回新的图片ID
+def clip(id: str, x: int, y: int, ex: int, ey: int) -> Optional[str]:
+    """裁剪图片并返回新的图片ID"""
+    ...
+
+# 获取图片尺寸信息 {width,height}
+def get_size(id: str) -> Optional[Size]:
+    """获取图片尺寸信息 {width,height}"""
+    ...
+
+# 图片转 base64（format: jpg|png；q: 质量1-100，仅jpg）
+def to_base64_format(id: str, format: str, q: int) -> Optional[str]:
+    """图片转 base64（format: jpg|png；q: 质量1-100，仅jpg）"""
+    ...
+
+# base64 转图片ID
+def base64_to_image(base64data: str) -> Optional[str]:
+    """base64 转图片ID"""
+    ...
+
+# 图片是否被释放
+def is_release(id: str) -> bool:
+    """图片是否已被释放"""
+    ...
+
+# 释放图片/全部图片
+def release(id: str) -> None:
+    """释放图片"""
+    ...
+
+def release_all() -> None:
+    """释放全部图片"""
+    ...
+
+# 保存图片到路径
+def save_to(id: str, path: str) -> bool:
+    """保存图片到路径"""
+    ...
+
+# 旋转图片（degree: 90 | -90 | 180）返回新ID
+def rotate_image(id: str, degree: int) -> Optional[str]:
+    """旋转图片（degree: 90 | -90 | 180），返回新ID"""
+    ...
+
+# 多点比色（points: "x|y|主色-偏色,..."；threshold: 0.0-1.0；区域 x/y/ex/ey）
+def cmp_color(
+    id: str, points: str, threshold: float, x: int, y: int, ex: int, ey: int
+) -> bool:
+    """多点比色
+
+    参数:
+      points: "x|y|主色-偏色,..."
+      threshold: 0.0-1.0
+      x/y/ex/ey: 区域坐标
+    返回:
+      bool: 是否相同
+    """
+    ...
+
+def find_color(
+    id: str,
+    color: str,
+    threshold: float,
+    x: int,
+    y: int,
+    ex: int,
+    ey: int,
+    limit: int,
+    orz: int,
+) -> List[Point]:
+    """单点找色（返回点坐标列表）"""
+    ...
+
+# 多点找色（返回点坐标列表）
+def find_multi_color(
+    id: str,
+    firstColor: str,
+    threshold: float,
+    points: str,
+    x: int,
+    y: int,
+    ex: int,
+    ey: int,
+    limit: int,
+    orz: int,
+) -> List[Point]:
+    """多点找色（返回点坐标列表）"""
+    ...
+
+def find_image(
+    id: str,
+    templateImageId: str,
+    x: int,
+    y: int,
+    ex: int,
+    ey: int,
+    threshold: float,
+    limit: int,
+    method: int,
+    rgb: bool = ...,
+) -> List[Rect]:
+    """找图（返回矩形列表）
+
+    参数默认值:
+      rgb: False
+    """
+    ...
+
+# 获取像素颜色（返回整数RGB）
+def pixel(id: str, x: int, y: int) -> int:
+    """获取像素颜色（整数 RGB）"""
+    ...
+
+# 颜色值转16进制字符串（#RRGGBB）
+def argb(color: int) -> str:
+    """颜色值转 16 进制字符串（#RRGGBB）"""
+    ...
+
+# 二值化/灰度化图片（返回新ID）
+def binaryzation(id: str, threshold: float) -> Optional[str]:
+    """二值化图片（返回新ID）"""
+    ...
+
+def gray(id: str) -> Optional[str]:
+    """灰度化图片（返回新ID）"""
+    ...
+
+# 扫描条码/二维码（返回识别文本）
+def scan_code(id: str) -> Optional[str]:
+    """扫描条码/二维码（返回识别文本）"""
+    ...
+
+# 在图片上绘制矩形（直接修改原图）
+def draw_rect(
+    id: str, x: int, y: int, ex: int, ey: int, color: str, thickness: int
+) -> bool:
+    """在图片上绘制矩形（直接修改原图）"""
+    ...

kuaijs/ime.pyi

@@ -0,0 +1,49 @@
+# 输入法是否可用
+def is_ok() -> bool:
+    """输入法是否可用（键盘是否已弹出）"""
+    ...
+
+# 获取/清空输入框文本
+def get_text() -> str:
+    """获取当前输入框文本"""
+    ...
+
+def clear_text() -> bool:
+    """清空输入框文本"""
+    ...
+
+# 输入/粘贴文本（content为空时使用剪切板）
+def input(content: str) -> str:
+    """输入文本（content 为空时使用剪贴板）"""
+    ...
+
+def paste(content: str = ...) -> str:
+    """粘贴文本（content 为空时使用剪贴板）"""
+    ...
+
+# 删除一个字符/回车/隐藏键盘
+def press_del() -> str:
+    """删除一个字符（返回剩余文本；空表示无数据）"""
+    ...
+
+def press_enter() -> bool:
+    """回车键"""
+    ...
+
+def dismiss() -> bool:
+    """隐藏键盘"""
+    ...
+
+# 剪切板读写
+def get_clipboard() -> str:
+    """获取剪贴板"""
+    ...
+
+def set_clipboard(content: str) -> bool:
+    """设置剪贴板（键盘显示时）"""
+    ...
+
+# 切换输入法
+def switch_keyboard() -> bool:
+    """切换输入法"""
+    ...

kuaijs/logger.pyi

@@ -0,0 +1,47 @@
+def set_logger_level(level: str) -> bool:
+    """设置日志级别
+
+    参数:
+      level: 日志级别（error|warn|info|debug|off）
+    返回:
+      bool: 是否设置成功
+    """
+    ...
+
+def set_log_to_file(enabled: bool) -> bool:
+    """设置是否输出到日志文件
+
+    参数:
+      enabled: True 启用文件输出；False 关闭文件输出
+    返回:
+      bool: 是否设置成功
+    """
+    ...
+
+def set_max_log_file_count(count: int) -> bool:
+    """设置最大日志文件数量（默认 10 个）"""
+    ...
+
+def set_max_log_file_size(size: int) -> bool:
+    """设置最大日志文件大小（单位 MB，默认 10MB）"""
+    ...
+
+def reset_log_file() -> bool:
+    """重置日志文件（创建新文件并开始写入）"""
+    ...
+
+def debug(*args: object) -> bool:
+    """输出调试日志（将参数按空格拼接为字符串）"""
+    ...
+
+def info(*args: object) -> bool:
+    """输出信息日志（将参数按空格拼接为字符串）"""
+    ...
+
+def warn(*args: object) -> bool:
+    """输出警告日志（将参数按空格拼接为字符串）"""
+    ...
+
+def error(*args: object) -> bool:
+    """输出错误日志（将参数按空格拼接为字符串）"""
+    ...

kuaijs/media.pyi

@@ -0,0 +1,32 @@
+"""媒体管理：相册与音频"""
+
+# 保存图片/视频到相册
+def save_image_to_album(imageId: str) -> bool:
+    """保存图像到相册"""
+    ...
+
+def save_video_to_album_path(path: str) -> bool:
+    """保存视频路径到相册"""
+    ...
+
+# 清空相册图片/视频
+def delete_all_photos() -> bool:
+    """清空相册中的图片"""
+    ...
+
+def delete_all_videos() -> bool:
+    """清空相册中的视频"""
+    ...
+
+# 播放/停止MP3；同步播放（等待结束）
+def play_mp3(path: str, loop: bool) -> bool:
+    """播放 MP3（异步）"""
+    ...
+
+def stop_mp3() -> bool:
+    """停止播放 MP3"""
+    ...
+
+def play_mp3_wait_end(path: str, loop: bool) -> bool:
+    """同步播放 MP3（等待结束）"""
+    ...

kuaijs/mysql.pyi

@@ -0,0 +1,51 @@
+from typing import Any, List, Dict, Optional, Protocol
+
+# 连接配置：host/port/username/password/database/charset
+class MySQLConfig(Protocol):
+    host: str
+    port: Optional[int]
+    username: str
+    password: str
+    database: str
+    charset: Optional[str]
+
+# 查询/执行，返回对象：rows/affectedRows/insertId/success/error
+class MySQLResult(Protocol):
+    rows: List[Dict[str, Any]]
+    affectedRows: int
+    success: bool
+    insertId: Optional[int]
+    error: Optional[str]
+
+def connect(config: MySQLConfig) -> bool:
+    """连接到数据库"""
+    ...
+
+def disconnect() -> None:
+    """断开数据库连接"""
+    ...
+
+def is_connected() -> bool:
+    """检查连接状态"""
+    ...
+
+def query(sql: str, params: List[Any] = ...) -> MySQLResult:
+    """执行查询（SELECT）"""
+    ...
+
+def execute(sql: str, params: List[Any] = ...) -> MySQLResult:
+    """执行更新（INSERT/UPDATE/DELETE）"""
+    ...
+
+# 事务控制
+def begin_transaction() -> bool:
+    """开始事务"""
+    ...
+
+def commit() -> bool:
+    """提交事务"""
+    ...
+
+def rollback() -> bool:
+    """回滚事务"""
+    ...

kuaijs/netcard.pyi

@@ -0,0 +1,30 @@
+from typing import Optional, Protocol
+
+class CardInfo(Protocol):
+    cardNo: str
+    batchCard: str
+    remark: str
+    activeTime: str
+    expireTime: str
+
+# 验证卡密；获取卡密信息；设置备注
+def verify(cardNo: str) -> bool:
+    """验证卡密"""
+    ...
+
+def get_card_info() -> Optional[CardInfo]:
+    """获取卡密信息（验证通过后可用）"""
+    ...
+
+def set_card_remark(remark: str) -> bool:
+    """设置卡密备注"""
+    ...
+
+# KV 存取
+def set_value(key: str, value: str) -> str:
+    """设置值（成功返回设置的 value）"""
+    ...
+
+def get_value(key: str) -> str:
+    """获取值（失败返回空字符串）"""
+    ...