# -*- coding: utf-8 -*- """ 独立进程外更新器 (Out-of-Process Updater) 无第三方依赖(仅标准库 + 可选 ctypes 探测 PID), 打包为 mini_updater.exe 后置于安装目录,由主程序在“确认重启”后拉起。 负责:等待主进程退出 → 重命名替换 exe → 以正确 cwd 与 DETACHED_PROCESS 启动新进程。 """ import argparse import os import subprocess import sys import time # 仅标准库:PID 检测用 ctypes(Windows)或 os.kill(Unix) if sys.platform == "win32": import ctypes try: _kernel32 = ctypes.windll.kernel32 # type: ignore[attr-defined] except Exception: _kernel32 = None else: _kernel32 = None def _log_error(install_dir: str, message: str, exc: Exception = None) -> None: """将错误写入安装目录下的 logs/update_error.log,便于排查。""" try: log_dir = os.path.join(install_dir, "logs") os.makedirs(log_dir, exist_ok=True) log_path = os.path.join(log_dir, "update_error.log") with open(log_path, "a", encoding="utf-8") as f: from datetime import datetime line = "[%s] %s" % (datetime.now().isoformat(), message) if exc is not None: line += " (%s)" % exc f.write(line + "\n") except Exception: pass def is_process_alive(pid: int) -> bool: """ 跨平台判断指定 PID 是否仍存活。 Windows: ctypes 调用 OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION); Unix: os.kill(pid, 0)。 """ if sys.platform == "win32" and _kernel32 is not None: # PROCESS_QUERY_LIMITED_INFORMATION = 0x1000 handle = _kernel32.OpenProcess(0x1000, False, pid) if handle is None or handle == 0: return False try: _kernel32.CloseHandle(handle) except Exception: pass return True try: os.kill(pid, 0) return True except (OSError, ProcessLookupError, PermissionError): return False def main() -> None: parser = argparse.ArgumentParser(description="独立更新守护:等主进程退出后替换 exe 并重启") parser.add_argument("--pid", type=int, required=True, help="主程序进程 ID,必须等其完全退出") parser.add_argument("--install-dir", type=str, required=True, help="主程序安装根目录") parser.add_argument("--new-exe-path", type=str, required=True, help="已准备好的新版本 main.exe 的完整路径(通常在 TEMP)") parser.add_argument("--target-exe-name", type=str, default="main.exe", help="主程序文件名,如 main.exe") args = parser.parse_args() install_dir = os.path.abspath(args.install_dir) new_exe_path = os.path.abspath(args.new_exe_path) target_exe_name = args.target_exe_name.strip() or "main.exe" target_exe_full = os.path.join(install_dir, target_exe_name) old_exe_full = target_exe_full + ".old" # ------------------------------------------------------------------------- # 1. 死神凝视:每隔 0.5 秒检测 --pid 是否存活,必须等到进程彻底消失 # ------------------------------------------------------------------------- while is_process_alive(args.pid): time.sleep(0.5) # ------------------------------------------------------------------------- # 2. 障眼法替换 (The Swap) # ------------------------------------------------------------------------- import shutil try: os.chdir(install_dir) except Exception as e: _log_error(install_dir, "切换到安装目录失败", e) sys.exit(1) # 若存在上次遗留的 .old,先静默删除 if os.path.isfile(old_exe_full): try: os.remove(old_exe_full) except Exception as e: _log_error(install_dir, "删除旧 .old 文件失败: %s" % old_exe_full, e) # 将当前主程序重命名为 .old,腾出位置 if not os.path.isfile(target_exe_full): _log_error(install_dir, "目标 exe 不存在: %s" % target_exe_full) sys.exit(1) try: os.rename(target_exe_full, old_exe_full) except Exception as e: _log_error(install_dir, "重命名当前 exe 为 .old 失败", e) sys.exit(1) # 将新 exe 移入安装目录并命名为 target-exe-name if not os.path.isfile(new_exe_path): _log_error(install_dir, "新 exe 不存在: %s" % new_exe_path) sys.exit(1) try: shutil.move(new_exe_path, target_exe_full) except Exception as e: _log_error(install_dir, "移动新 exe 到安装目录失败", e) try: os.rename(old_exe_full, target_exe_full) except Exception: pass sys.exit(1) # ------------------------------------------------------------------------- # 3. 干净的重生:Popen 新程序,强制 cwd、close_fds、DETACHED_PROCESS # ------------------------------------------------------------------------- try: creationflags = 0 if sys.platform == "win32": # DETACHED_PROCESS = 0x00000008,不继承控制台与父进程句柄 creationflags = 0x00000008 p = subprocess.Popen( [target_exe_full], cwd=install_dir, close_fds=True, creationflags=creationflags, shell=False, ) # 不等待子进程,更新器功成身退 except Exception as e: _log_error(install_dir, "拉起新主程序失败", e) sys.exit(1) # ------------------------------------------------------------------------- # 4. 功成身退 # ------------------------------------------------------------------------- sys.exit(0) if __name__ == "__main__": main()