ascript 1.3.27__py3-none-win_amd64.whl

ascript/windows/system/pip.py

@@ -0,0 +1,175 @@
+import subprocess
+import sys
+import re
+import time
+import threading
+import urllib.request
+from importlib.metadata import version, PackageNotFoundError
+
+
+class Pip:
+    """
+    Python 包管理工具类，具备自动择源功能。
+    """
+    # 备选镜像源列表
+    MIRRORS = {
+        "tsinghua": "https://pypi.tuna.tsinghua.edu.cn/simple",
+        "aliyun": "https://mirrors.aliyun.com/pypi/simple/",
+        "ustc": "https://pypi.mirrors.ustc.edu.cn/simple/",
+        "pypi": "https://pypi.org/simple",
+    }
+    # 兜底源：所有探测都失败时使用，绝不拿慢的官方源兜底
+    _FALLBACK_INDEX = "https://pypi.tuna.tsinghua.edu.cn/simple"
+
+    # 吞吐探测参数：单源最多下 1.5 秒 或 3MB 即停；连接超时 2 秒
+    _PROBE_TIME_BUDGET = 1.5
+    _PROBE_SIZE_CAP = 3 * 1024 * 1024
+    _PROBE_CONNECT_TIMEOUT = 2.0
+
+    # 进程内缓存：择源结果复用，避免每装一个包都重新测速
+    _cached_index = None
+    _cache_lock = threading.Lock()
+
+    @staticmethod
+    def _probe_throughput(url: str) -> float:
+        """限量下载该镜像的 simple 索引，返回实测吞吐量（字节/秒）。失败返回 0。
+
+        测的是真实下载速度而非连接延迟 —— 镜像源常见"连得上但限速"，
+        延迟低不代表下得快。
+        """
+        try:
+            req = urllib.request.Request(url, headers={"User-Agent": "ascript-pip-probe"})
+            start = time.time()
+            downloaded = 0
+            with urllib.request.urlopen(req, timeout=Pip._PROBE_CONNECT_TIMEOUT) as resp:
+                if resp.getcode() != 200:
+                    return 0.0
+                while True:
+                    chunk = resp.read(64 * 1024)
+                    if not chunk:
+                        break
+                    downloaded += len(chunk)
+                    if (time.time() - start) >= Pip._PROBE_TIME_BUDGET \
+                            or downloaded >= Pip._PROBE_SIZE_CAP:
+                        break
+            elapsed = time.time() - start
+            if elapsed <= 0 or downloaded == 0:
+                return 0.0
+            return downloaded / elapsed
+        except Exception:
+            return 0.0
+
+    @staticmethod
+    def get_best_index() -> str:
+        """并行测各镜像的实测下载吞吐量，返回最快的源。结果进程内缓存。"""
+        if Pip._cached_index:
+            return Pip._cached_index
+
+        with Pip._cache_lock:
+            if Pip._cached_index:  # 双重检查，避免并发安装时重复测速
+                return Pip._cached_index
+
+            # 预填所有键：worker 只更新值、不新增键，这样万一 join 超时后掉队
+            # 线程仍在写，下面 max() 遍历也不会撞上"字典大小被改"。
+            results = {name: 0.0 for name in Pip.MIRRORS}
+
+            def worker(name, url):
+                results[name] = Pip._probe_throughput(url)
+
+            threads = [
+                threading.Thread(target=worker, args=(n, u), daemon=True)
+                for n, u in Pip.MIRRORS.items()
+            ]
+            for t in threads:
+                t.start()
+            # join 超时仅作兜底（探测线程内部已有超时，正常 3.5s 内结束）；
+            # 必须长于单次探测最坏耗时 = 连接超时 + 下载预算。
+            for t in threads:
+                t.join(timeout=Pip._PROBE_CONNECT_TIMEOUT + Pip._PROBE_TIME_BUDGET + 1.0)
+
+            best = max(results, key=results.get)
+            Pip._cached_index = Pip.MIRRORS[best] if results[best] > 0 \
+                else Pip._FALLBACK_INDEX
+            return Pip._cached_index
+
+    @staticmethod
+    def is_installed(package_spec: str) -> bool:
+        """检查指定包是否已安装。
+
+        Args:
+            package_spec: 包名或带版本约束的包规范，如 "requests" 或 "requests>=2.28"。
+
+        Returns:
+            bool: 已安装返回 True，未安装返回 False。
+        """
+        package_name = re.split(r'[<>=!]', package_spec)[0].strip()
+        try:
+            version(package_name)
+            return True
+        except PackageNotFoundError:
+            return False
+
+    @staticmethod
+    def install(package_spec: str, upgrade: bool = False, index_url: str = None) -> bool:
+        """安装 Python 包。
+
+        如果未指定 index_url，则自动测速选择最快的镜像源进行安装。
+
+        Args:
+            package_spec: 包名或带版本约束的包规范，如 "requests>=2.28"。
+            upgrade: 是否升级到最新版本，默认 False。
+            index_url: 指定的 PyPI 镜像源 URL，默认 None（自动择源）。
+
+        Returns:
+            bool: 安装成功返回 True，失败返回 False。
+        """
+        # 自动择源逻辑
+        target_index = index_url if index_url else Pip.get_best_index()
+
+        command = [sys.executable, "-m", "pip", "install", package_spec]
+
+        if target_index:
+            command.extend(["-i", target_index])
+            if target_index.startswith("http://"):
+                host = target_index.split("/")[2].split(":")[0]
+                command.extend(["--trusted-host", host])
+
+        if upgrade:
+            command.append("--upgrade")
+
+        try:
+            subprocess.check_call(command)
+            return True
+        except subprocess.CalledProcessError:
+            return False
+
+    @staticmethod
+    def ensure(package_spec: str, index_url: str = None) -> bool:
+        """确保指定包已安装，未安装则自动安装。
+
+        Args:
+            package_spec: 包名或带版本约束的包规范。
+            index_url: 指定的 PyPI 镜像源 URL，默认 None（自动择源）。
+
+        Returns:
+            bool: 包已存在或安装成功返回 True，安装失败返回 False。
+        """
+        if Pip.is_installed(package_spec):
+            return True
+        return Pip.install(package_spec, index_url=index_url)
+
+    @staticmethod
+    def remove(package_name: str) -> bool:
+        """卸载指定的 Python 包。
+
+        Args:
+            package_name: 要卸载的包名。
+
+        Returns:
+            bool: 卸载成功返回 True，失败返回 False。
+        """
+        try:
+            subprocess.check_call([sys.executable, "-m", "pip", "uninstall", package_name, "-y"])
+            return True
+        except subprocess.CalledProcessError:
+            return False

ascript/windows/system/r.py

@@ -0,0 +1,165 @@
+import sys
+import os
+from pathlib import Path
+import ascript  # 必须导入你的包以定位其物理位置
+import sys
+import ctypes
+
+class R:
+    """资源路径解析器。
+
+    提供统一的资源文件路径解析能力，自动适配开发环境和打包环境
+    （支持 PyInstaller 和 Nuitka）。分为两类接口：
+    - 开发者接口（ui/img/res）：锚定工程根目录下的 res/ 文件夹。
+    - 内部接口（internal）：锚定 ascript 包的安装目录。
+
+    Attributes:
+        _BASE_DIR: 缓存的工程根目录路径。
+        _PKG_ROOT: ascript 包的物理安装根目录。
+    """
+    _BASE_DIR = None
+    # 静态定位 ascript 包的物理根目录 (site-packages/ascript)
+    _PKG_ROOT = Path(os.path.dirname(os.path.abspath(ascript.__file__))).resolve()
+
+    @classmethod
+    def get_root(cls) -> Path:
+        """获取工程根目录或打包后的解压临时目录。
+
+        自动检测运行环境：
+        - Nuitka 打包：使用 NUITKA_ONEFILE_PARENT 环境变量。
+        - PyInstaller 打包：使用 sys._MEIPASS。
+        - 开发环境：使用 main.py 所在目录。
+
+        Returns:
+            Path: 工程根目录的绝对路径。
+        """
+        if cls._BASE_DIR is not None:
+            return cls._BASE_DIR
+
+        if getattr(sys, 'frozen', False):
+            # Nuitka 优先环境变量
+            nuitka_tmp = os.environ.get('NUITKA_ONEFILE_PARENT')
+            if nuitka_tmp:
+                cls._BASE_DIR = Path(nuitka_tmp).resolve()
+            elif hasattr(sys, '_MEIPASS'):
+                cls._BASE_DIR = Path(sys._MEIPASS).resolve()
+            else:
+                cls._BASE_DIR = Path(sys.executable).resolve().parent
+        else:
+            # 开发环境：锚定 main.py 所在目录
+            main_file = sys.argv[0]
+            if main_file:
+                cls._BASE_DIR = Path(main_file).resolve().parent
+            else:
+                cls._BASE_DIR = Path.cwd().resolve()
+        return cls._BASE_DIR
+
+    @classmethod
+    def _build_path(cls, base: Path, *sub_paths) -> str:
+        """通用路径构建方法。
+
+        拼接基准目录和子路径，路径不存在时输出警告。
+
+        Args:
+            base: 基准目录路径。
+            *sub_paths: 子路径片段，依次拼接。
+
+        Returns:
+            str: 完整的文件路径字符串。
+        """
+        full_path = base.joinpath(*sub_paths)
+        if not full_path.exists():
+            # 这里的警告非常有意义，能帮开发者快速定位是缺文件还是路走错了
+            print(f"[AScript R] 找不到路径: {full_path}")
+            print(f"[AScript R] 当前基准目录为: {base}")
+        return str(full_path)
+
+    # --- 1. 开发者使用的接口 (锚定工程根目录/res) ---
+
+    @classmethod
+    def ui(cls, path: str) -> str:
+        """获取工程 res/ui/ 目录下的 UI 资源文件路径。
+
+        Args:
+            path: 相对于 res/ui/ 的文件路径。
+
+        Returns:
+            str: UI 资源文件的绝对路径。
+        """
+        return cls._build_path(cls.get_root(), "res", "ui", path)
+
+    @classmethod
+    def img(cls, path: str) -> str:
+        """获取工程 res/img/ 目录下的图片资源文件路径。
+
+        Args:
+            path: 相对于 res/img/ 的文件路径。
+
+        Returns:
+            str: 图片资源文件的绝对路径。
+        """
+        return cls._build_path(cls.get_root(), "res", "img", path)
+
+    @classmethod
+    def res(cls, path: str) -> str:
+        """获取工程 res/ 目录下的通用资源文件路径。
+
+        Args:
+            path: 相对于 res/ 的文件路径。
+
+        Returns:
+            str: 资源文件的绝对路径。
+        """
+        return cls._build_path(cls.get_root(), "res", path)
+
+    # --- 2. ascript 内部使用的接口 (双重查找逻辑) ---
+
+    @classmethod
+    def internal(cls, *sub_paths) -> str:
+        """查找 ascript 包内部资源文件路径。
+
+        打包环境下优先在临时解压目录查找，未找到或开发环境下
+        回退到包安装目录（site-packages）查找。
+
+        Args:
+            *sub_paths: 相对于 ascript 包根目录的子路径片段。
+
+        Returns:
+            str: 内部资源文件的绝对路径。
+        """
+        # A. 打包环境下的尝试 (寻找临时目录/ascript/xxx)
+        if getattr(sys, 'frozen', False):
+            # 注意：这里 sub_paths 前面通常要带上 "ascript"
+            # 因为 Nuitka 会把整个包结构解压出来
+            bundle_path = cls.get_root().joinpath("ascript", *sub_paths)
+            if bundle_path.exists():
+                return str(bundle_path)
+
+        # B. 开发环境或兜底 (寻找 site-packages/ascript/xxx)
+        return cls._build_path(cls._PKG_ROOT, *sub_paths)
+
+    @classmethod
+    def is_admin(cls):
+        """判断当前进程是否拥有管理员权限。
+
+        Returns:
+            bool: 拥有管理员权限返回 True，否则返回 False。
+        """
+        try:
+            return ctypes.windll.shell32.IsUserAnAdmin()
+        except:
+            return False
+
+    @classmethod
+    def run_as_admin(cls):
+        """以管理员权限重新启动当前程序。
+
+        如果当前进程不具有管理员权限，将通过 Windows UAC 弹窗
+        请求提升权限并重新启动程序，当前进程随即退出。
+        """
+        if not cls.is_admin():
+            # ShellExecuteEx 会触发系统 UAC 弹窗
+            ctypes.windll.shell32.ShellExecuteW(
+                None, "runas", sys.executable, " ".join(sys.argv), None, 1
+            )
+            sys.exit()

ascript/windows/system/runtime.py

@@ -0,0 +1,62 @@
+import threading
+import signal
+import sys
+
+
+class Runtime:
+    """程序运行时生命周期管理器。
+
+    提供全局事件循环机制，使主线程保持运行状态直到收到停止信号。
+    适用于需要主线程驻留的场景（如 GUI 应用、后台服务等）。
+
+    Attributes:
+        _stop_event: 线程事件对象，用于控制运行/停止状态。
+    """
+    # 静态变量，用于控制生命周期
+    _stop_event = threading.Event()
+
+    @staticmethod
+    def wait():
+        """启动全局事件循环，阻塞主线程直到收到停止信号。
+
+        主线程会停留在此方法中，直到调用 Runtime.stop() 或
+        接收到 SIGINT/SIGTERM 信号（如 Ctrl+C）才会继续向下运行。
+        支持优雅的信号处理和键盘中断。
+        """
+
+        # 优雅处理 Ctrl+C 信号
+        def _handle_signal(signum, frame):
+            Runtime.stop()
+
+        try:
+            signal.signal(signal.SIGINT, _handle_signal)
+            signal.signal(signal.SIGTERM, _handle_signal)
+        except (ValueError, AttributeError):
+            # 某些环境（如非主线程）不支持信号注册
+            pass
+
+        print("[System] Runtime 正在等待信号，程序不会退出...")
+
+        # 核心逻辑：无限等待。
+        # wait(timeout) 可以让主线程有机会处理系统中断，比 wait() 更推荐
+        try:
+            while not Runtime._stop_event.is_set():
+                Runtime._stop_event.wait(timeout=0.1)
+        except KeyboardInterrupt:
+            pass
+
+        print("[System] Runtime 已停止。")
+
+    @staticmethod
+    def stop():
+        """停止全局事件循环，解除 Runtime.wait() 的阻塞状态。
+
+        调用后主线程将从 wait() 方法返回并继续执行后续代码。
+        """
+        Runtime._stop_event.set()
+
+# --- 调用示范 ---
+# win = WebWindow("a.html")
+# win.show(block=False)  # 窗口弹出，主线程不被 block
+# ... 执行其他初始化 ...
+# Runtime.wait()         # 这里才是真正的驻留逻辑

ascript/windows/tools/__init__.py

@@ -0,0 +1,27 @@
+"""Windows developer tools.
+
+Heavy legacy modules are deliberately not imported here. Importing this package is
+now safe in environments that only use the WebView2 tools.
+"""
+
+import importlib
+
+from .tool_window import SDKToolWindow, start_colors as _start_colors, start_inspector, start_tool
+
+__all__ = [
+    "SDKToolWindow", "start_tool", "start_inspector", "start_colors",
+    "dumptool", "colors_tool", "action", "MouseCatch",
+]
+
+
+def start_colors(*args, **kwargs):
+    return _start_colors(*args, **kwargs)
+
+
+def __getattr__(name):
+    if name in {"dumptool", "colors_tool", "action"}:
+        return importlib.import_module(f"{__name__}.{name}")
+    if name == "MouseCatch":
+        from .mouse_catch import MouseCatch
+        return MouseCatch
+    raise AttributeError(name)

ascript/windows/tools/__main__.py

@@ -0,0 +1,21 @@
+import argparse
+import multiprocessing
+
+
+def main():
+    parser = argparse.ArgumentParser(description="AScript Windows SDK tools")
+    parser.add_argument("tool", choices=("inspector", "colors"))
+    parser.add_argument("--hwnd", type=int)
+    parser.add_argument("--debug", action="store_true")
+    args = parser.parse_args()
+    if args.tool == "colors":
+        from .tool_window import start_colors
+        start_colors(hwnd=args.hwnd)
+    else:
+        from .tool_window import start_tool
+        start_tool(args.tool, hwnd=args.hwnd, debug=args.debug)
+
+
+if __name__ == "__main__":
+    multiprocessing.freeze_support()
+    main()

ascript/windows/tools/action.json

@@ -0,0 +1,33 @@
+[
+    {
+        "name": "动态工具",
+        "code": null,
+        "type": "group",
+        "children": [
+            {
+                "name": "坐标捕获",
+                "code": "from ascript.windows.tools import MouseCatch;MouseCatch().run()",
+                "type": "action",
+                "children": []
+            },
+            {
+                "name": null,
+                "code": null,
+                "type": "separator",
+                "children": []
+            },
+            {
+                "name": "控件检索",
+                "code": "from ascript.windows.tools import dumptool;dumptool.start_vtree()",
+                "type": "action",
+                "children": []
+            },
+            {
+                "name": "图形处理",
+                "code": "from ascript.windows.tools import start_colors;start_colors()",
+                "type": "action",
+                "children": []
+            }
+        ]
+    }
+]

ascript/windows/tools/action.py

@@ -0,0 +1,168 @@
+import webview
+import os
+import threading
+import ctypes
+import time
+import sys
+import win32gui
+import win32con
+import win32clipboard
+from ctypes import windll, byref, sizeof
+from ctypes.wintypes import RECT, MSG
+
+# 设置 AppID 以便在任务栏独立显示（虽然在 .py 环境下图标可能仍是 Python）
+try:
+    ctypes.windll.shell32.SetCurrentProcessExplicitAppUserModelID(u'ascript.coordinate.picker.v6')
+except:
+    pass
+
+# DPI 高清适配
+try:
+    windll.shcore.SetProcessDpiAwareness(1)
+except:
+    windll.user32.SetProcessDPIAware()
+
+HTML_CODE = """
+<!DOCTYPE html>
+<html>
+<head>
+    <style>
+        body { margin: 0; padding: 12px; font-family: 'Segoe UI', sans-serif; background: #000; color: #eee; overflow: hidden; user-select: none; }
+        .box { border: 1px solid #333; border-radius: 8px; background: #111; padding: 12px; margin-top: 5px; }
+        .row { display: flex; justify-content: space-between; align-items: center; margin-bottom: 8px; }
+        .coord-val { font-size: 18px; font-weight: bold; font-family: 'Consolas'; color: #00bcd4; }
+        #history { height: 280px; overflow-y: auto; margin-top: 10px; border-top: 1px solid #222; padding-top: 5px; }
+        .item { background: #1a1a1a; padding: 8px; border-radius: 4px; margin-bottom: 5px; font-size: 12px; cursor: pointer; border-left: 2px solid #00bcd4; }
+        .item:hover { background: #222; }
+    </style>
+</head>
+<body>
+    <div style="font-size:11px; color:#555; margin-bottom:5px;">Shift + A 记录坐标</div>
+    <div class="box">
+        <div class="row">
+            <label><input type="radio" name="m" value="abs" checked> 屏幕</label>
+            <span id="a-v" class="coord-val">0, 0</span>
+        </div>
+        <div class="row">
+            <label><input type="radio" name="m" value="rel"> 窗口</label>
+            <span id="r-v" class="coord-val" style="color:#4caf50;">0, 0</span>
+        </div>
+        <div id="w-t" style="font-size:11px; color:#666; white-space:nowrap; overflow:hidden; text-overflow:ellipsis;">窗口: -</div>
+    </div>
+    <div id="history"></div>
+    <script>
+        function updateUI(a, r, w) {
+            document.getElementById('a-v').innerText = a;
+            document.getElementById('r-v').innerText = r;
+            document.getElementById('w-t').innerText = "窗口: " + w;
+        }
+        function getMode() { return document.querySelector('input[name="m"]:checked').value; }
+        function addHistory(v) {
+            const l = document.getElementById('history');
+            const d = document.createElement('div');
+            d.className = 'item'; d.innerText = "复制: " + v;
+            d.onclick = () => window.pywebview.api.copy(v);
+            l.insertBefore(d, l.firstChild);
+        }
+    </script>
+</body>
+</html>
+"""
+
+
+class ProApi:
+    """剪贴板操作代理类，提供将文本复制到系统剪贴板的功能。"""
+
+    def copy(self, text):
+        """将指定文本复制到系统剪贴板。
+
+        Args:
+            text: 要复制到剪贴板的文本内容，会自动转换为字符串。
+        """
+        try:
+            win32clipboard.OpenClipboard()
+            win32clipboard.EmptyClipboard()
+            win32clipboard.SetClipboardText(str(text))
+            win32clipboard.CloseClipboard()
+        except:
+            pass
+
+
+class AScriptApp:
+    """AScript 坐标捕获工具应用程序。
+
+    提供一个置顶小窗口，实时显示鼠标的屏幕坐标和窗口相对坐标，
+    支持通过 Shift+A 热键记录坐标并复制到剪贴板。
+    """
+
+    def __init__(self):
+        """初始化坐标捕获工具。
+
+        设置应用图标路径、窗口标题，并初始化运行状态。
+        自动适配打包环境（PyInstaller）和开发环境的资源路径。
+        """
+        # 路径逻辑 [cite: 2026-01-20]
+        base = sys._MEIPASS if getattr(sys, 'frozen', False) else os.path.dirname(os.path.abspath(__file__))
+        self.icon_path = os.path.normpath(os.path.join(base, "web", "img", "ico", "favicon.png"))
+        self.title = "AScript 坐标捕获工具"
+        self.window = None
+        self.running = True
+
+    def _worker(self):
+        """后台工作线程，持续追踪鼠标坐标并监听热键事件。
+
+        注册 Shift+A 全局热键，循环获取鼠标位置信息（屏幕坐标和窗口相对坐标），
+        实时更新前端 UI 显示。当热键触发时，根据当前模式（屏幕/窗口）将坐标
+        复制到剪贴板并添加到历史记录。
+        """
+        hotkey_id = 1
+        # --- 修改处：将 MOD_ALT 改为 MOD_SHIFT ---
+        windll.user32.RegisterHotKey(None, hotkey_id, win32con.MOD_SHIFT, ord('A'))
+
+        while self.running:
+            try:
+                x, y = win32gui.GetCursorPos()
+                raw_hwnd = win32gui.WindowFromPoint((x, y))
+                root_hwnd = win32gui.GetAncestor(raw_hwnd, win32con.GA_ROOT)
+                title = win32gui.GetWindowText(root_hwnd) or "Unknown"
+                rect = RECT()
+                windll.dwmapi.DwmGetWindowAttribute(root_hwnd, 9, byref(rect), sizeof(rect))
+                rx, ry = x - rect.left, y - rect.top
+
+                if self.window:
+                    try:
+                        self.window.evaluate_js(f"updateUI('{x}, {y}', '{rx}, {ry}', `{title}`)")
+                    except:
+                        pass
+
+                # 监听热键消息
+                msg = MSG()
+                if windll.user32.PeekMessageW(byref(msg), 0, 0x0312, 0x0312, 1):
+                    mode = self.window.evaluate_js("getMode()")
+                    res = f"{x}, {y}" if mode == "abs" else f"{rx}, {ry}"
+                    ProApi().copy(res)
+                    self.window.evaluate_js(f"addHistory('{res}')")
+            except:
+                pass
+            time.sleep(0.05)
+
+    def run(self):
+        """启动坐标捕获工具应用。
+
+        创建 webview 窗口并启动后台工作线程，使用 Edge Chromium 内核渲染界面。
+        窗口关闭后自动停止后台线程。
+        """
+        self.window = webview.create_window(
+            self.title, html=HTML_CODE, js_api=ProApi(),
+            width=340, height=520, on_top=True
+        )
+
+        threading.Thread(target=self._worker, daemon=True).start()
+
+        # 启动。注意：此时左上角可能会变，但任务栏在 .py 环境下极难改变
+        webview.start(icon=self.icon_path, gui='edgechromium')
+        self.running = False
+
+
+if __name__ == "__main__":
+    AScriptApp().run()