2.1.6:静默自动更新 + 远程鼠标控制 + 一键显示桌面

用户这次提了一整套升级。这个提交先落地三块(其余几块在做)。

== 一、静默自动更新 ==

用户原话:"手表端点击一个更新按钮,电脑端就可以自动进行静默更新,
其他什么设置都不变 …… 不弹任何窗口出来"。

链路:

    手表点按钮 -> 被控端问中转"最新是哪版"
               -> 下载到 %TEMP%\ykxmz-update\
               -> 校验 sha256
               -> 起一个**分离的 .cmd 帮手**
               -> 自己退出
               -> 帮手等它退出 -> 静默跑安装器 -> 重新拉起

关键设计说明:

  * **为什么要有那个 .cmd 帮手**:Windows 上正在运行的 exe 是锁着的,
    安装器覆盖不了,所以必须"先退出、再装、再起来",而这三步
    不能由被控端自己做(它一退出就没人执行后面的了)。
    用 DETACHED_PROCESS 起的助手不受父进程退出影响。

  * **配置为什么不会丢**:配置在 %ProgramData%\ykxmz\data\,
    **不在程序目录里**。安装器升级只替换 {app} 下的文件,
    不碰 ProgramData —— 中转地址、配对码、各种开关原样保留。
    这是这个功能能做的前提。

  * **更新源是用户自己的中转站**,不是作者的服务器,也不是任何
    写死的公网地址。被控端问的是它自己配置的那个地址。
    中转没有这个接口(老版本服务端)时会明确提示"先手动升级一次服务端"。

  * **sha256 必须校验**:自更新最大的风险是下到一半断了或被换了,
    装上去是个坏程序、而且它还会自己再更新 —— 螺旋下去很难救。
    对不上就**放弃这一轮**,保持现状(现状至少能用)。

中转新增:GET /v1/update/latest?platform=windows
返回 version / name / url / size / sha256。版本比较按**数字段**
(不能按字符串,否则 "1.9.0" > "2.1.4")。sha256 按
(文件名,大小,mtime) 缓存,避免每次重算 9MB。

手表端:"电脑端版本:点这里查看" 按钮,查完显示
"电脑端 2.1.4 → 2.1.5(点这里更新)",确认后才真的更新。

== 二、远程鼠标控制 ==

新增 windows/lanremote/input.py,用 SendInput 模拟鼠标键盘。

  * **为什么用 SendInput 而不是 mouse_event**:后者是 Win95 时代的
    API,会被 UIPI 拦,而且没有 dwExtraInfo(多个注入源会互相干扰)。
    SendInput 还能一次打包多个事件,按下+抬起之间不会插进别的输入。

  * **坐标是 0..65535 归一化**,而且**必须除以 (屏幕宽-1)**。
    少了那个 -1,最右边和最下边几像素点不到 —— 表现为
    "鼠标到不了屏幕边缘",任务栏在底下的机器上尤其明显。

  * **INPUT 结构在 32/64 位下大小不同**(28 / 40),
    ctypes 里按进程位数算,不能写死。

  * 权限说明:目标窗口如果是管理员权限的(UAC 提升过的),
    普通权限的注入会被 UIPI 拦掉。这不是 bug,是 Windows 的设计。
    被控端以管理员运行就都能点。

== 三、一键显示桌面 ==

用户要求快捷栏里那个"不能改"的按钮就是这个功能,等于 Win+D。
和鼠标控制共用 input.py。

== 顺手修的一个自己造的坑 ==

往 server.py 插方法时,**两次**把 dispatch 的兜底
`return {"ok": False, "error": f"未知命令: {cmd}"}` 一起卷进了新方法里:

  * pyflakes 报 "undefined name 'cmd'"
  * 而且 dispatch 丢了兜底分支(未知命令会返回 None)

第一次靠 pyflakes 抓到,第二次也是。为了以后不再犯,
`_tests/test_update_flow.py` 里加了**结构断言**:
兜底必须在带 CMD_UPDATE 的那个方法体里,而各新方法里不能出现它。

(那条断言第一版写得太死 —— 要求"紧跟 CMD_UPDATE 分支",
 后来往 dispatch 里插了新分支就误报了。改成验结构真相。)

== 验证 ==

    全量回归(含新增的 3a10 / 3a11 两关)全部 PASS
    静默自动更新:协议 + updater 15 项 + 服务端结构 8 项
    远程鼠标:坐标归一化 / 滚轮夹取 / Win+D 事件顺序 / 非法参数 22 项
    610 个 Python 文件语法通过
    实际注入鼠标成功(move / click / scroll / show_desktop)

== 还没做的(下一批) ==

    手表顶部快捷栏(可自定义最多 4 个,1 个固定"显示桌面")
    屏幕镜像去掉提示条、去掉所有弹窗
    托盘图标改成设置项
    「允许新设备连接」开关(中转后台 + 安卓端)
    弹文字窗口位置/大小可自定义
    中转后台设备列表显示版本 + 远程点更新

== 顺手清理 ==

_tests/out_app/ 下面那堆 .class 是 Java 编译检查的产物,
以前误提交进仓库了(152 个文件)。这次从索引里移除并加进 .gitignore。
This commit is contained in:
xmz7891
2026-10-09 22:12:09 +08:00
parent 31a2360031
commit 4d97e40280
169 changed files with 2820 additions and 39 deletions
+103 -1
View File
@@ -44,6 +44,7 @@
from __future__ import annotations
import hashlib
import json
import os
import re
@@ -59,7 +60,7 @@ from collections import deque
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from pathlib import Path
VERSION = "2.1.5"
VERSION = "2.1.6"
# ---------------- 参数(都能用环境变量覆盖)----------------
@@ -283,6 +284,92 @@ def _list_downloads() -> list:
items.sort(key=lambda item: item["mtime"], reverse=True)
return items
# 最新安装包的信息缓存。键 = (文件名, 大小, 修改时间)。
_PKG_CACHE: dict = {}
def _sha256_of(path: Path) -> str:
"""算文件的 sha256(分块读,别把 9MB 全塞内存)。"""
h = hashlib.sha256()
with path.open("rb") as f:
for chunk in iter(lambda: f.read(256 * 1024), b""):
h.update(chunk)
return h.hexdigest()
def _latest_package(platform: str = "windows") -> dict:
"""找 downloads/ 里最新的安装包,给被控端自更新用。
`platform` 现在只有 windows;留着参数是为了以后加别的平台
(手表/服务端不通过这个接口自更新,它们各有各的更新方式)。
返回 {} 表示"还没有可用的包"。
"""
# 各平台的成品名前缀
prefix = {
"windows": "ykxmz-setup-",
}.get(platform)
if not prefix:
return {}
best = None # (版本元组, 路径)
try:
if not DOWNLOADS_DIR.is_dir():
return {}
for entry in DOWNLOADS_DIR.iterdir():
if not entry.is_file():
continue
name = entry.name
if not name.startswith(prefix) or not name.endswith(".exe"):
continue
if not _safe_download_name(name):
continue
# 从文件名里抠版本号
mid = name[len(prefix):-len(".exe")]
parts = mid.split(".")
if len(parts) != 3 or not all(p.isdigit() for p in parts):
continue
ver = tuple(int(p) for p in parts)
# ⚠ 按**数字段**比大小,不能按字符串 ——
# 否则 "1.9.0" > "2.1.4"(字符 '9' > '1')。
if best is None or ver > best[0]:
best = (ver, entry)
except OSError:
return {}
if best is None:
return {}
ver, path = best
try:
st = path.stat()
except OSError:
return {}
key = (path.name, st.st_size, int(st.st_mtime))
cached = _PKG_CACHE.get(key)
if cached:
digest = cached
else:
try:
digest = _sha256_of(path)
except OSError:
return {}
# 只留最近几个,别让字典涨
_PKG_CACHE.clear()
_PKG_CACHE[key] = digest
return {
"platform": platform,
"version": ".".join(str(p) for p in ver),
"name": path.name,
"url": "/download/" + quote(path.name),
"size": st.st_size,
"sha256": digest,
"mtime": st.st_mtime,
}
ADMIN_SESSIONS: dict = {}
ADMIN_SESSION_SECONDS = 12 * 3600
@@ -1524,6 +1611,21 @@ class Handler(BaseHTTPRequestHandler):
return
# ---- 成品下载(挂在管理页上给人下 APK / 整包)----
if path == "/v1/update/latest":
# 被控端自更新用:最新版是哪版、在哪下、校验和多少。
# 公开接口 —— 文件名和哈希本来就在下载页上人人可见,
# 不含任何敏感信息。
platform = (urllib.parse.parse_qs(
urllib.parse.urlparse(self.path).query)
.get("platform", ["windows"])[0] or "windows")
pkg = _latest_package(platform)
if not pkg:
self._json(200, {"ok": False,
"error": "还没有可用的安装包"})
else:
self._json(200, dict(pkg, ok=True))
return
if path == "/v1/downloads":
self._json(200, {"ok": True, "files": _list_downloads()})
return