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。
2026-10-18 12:30:44 +00:00 · 2026-10-09 22:12:09 +08:00
parent 31a2360031
commit 4d97e40280
169 changed files with 2820 additions and 39 deletions
@@ -3,7 +3,7 @@
 ========================================================

 软件名称：ykxmz（远程管理工具）
-版本：2.1.5
+版本：2.1.6
 作者：小麦子
 生效日期：2026 年 10 月 5 日

@@ -16,7 +16,7 @@
 > 都不许拿去做下面第三条那些事。**
 >
 > （早先这版文件写的是"软件许可协议"，里面有一条"不得修改"——
->   那和 AGPL 冲突，所以 2.1.5 起拆开了：代码授权归 LICENSE，
+>   那和 AGPL 冲突，所以 2.1.6 起拆开了：代码授权归 LICENSE，
 >   使用约束归这份文件。）


@@ -160,7 +160,7 @@

 --------------------------------------------------------
  作者：小麦子
-  软件：ykxmz 2.1.5
+  软件：ykxmz 2.1.6

  如果你不同意本条款的任何一条，请不要安装或使用本软件。
  代码授权条款见仓库根目录 LICENSE（GNU AGPL-3.0）。
@@ -173,7 +173,7 @@
 ========================================================

 软件名称：ykxmz
-版本：2.1.5
+版本：2.1.6
 作者：小麦子

 请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
@@ -334,7 +334,7 @@ ykxmz 是一套自己搭建的远程管理工具，由三部分组成：

 --------------------------------------------------------
  作者：小麦子
-  软件：ykxmz 2.1.5
+  软件：ykxmz 2.1.6
  继续安装，即表示你已阅读并同意《许可协议》。
 --------------------------------------------------------

@@ -345,7 +345,7 @@ ykxmz 是一套自己搭建的远程管理工具，由三部分组成：
 ========================================================

 软件名称：ykxmz
-版本：2.1.5
+版本：2.1.6
 作者：小麦子

 装好之后看这一页：怎么确认它在跑、怎么改设置、
@@ -539,7 +539,7 @@ ykxmz 是一套自己搭建的远程管理工具，由三部分组成：
 八、版本记录
 --------------------------------------------------------

-  2.1.5
+  2.1.6
    * 下载改走 Cloudflare 边缘缓存 —— 安装包和 APK 快了几十倍
    * 跨网络更稳：隧道**两种协议同时跑**（QUIC + HTTP/2，
      合计 10 条连接），一种协议犯病另一种还在服务
@@ -560,6 +560,6 @@ ykxmz 是一套自己搭建的远程管理工具，由三部分组成：

 --------------------------------------------------------
  作者：小麦子
-  软件：ykxmz 2.1.5
+  软件：ykxmz 2.1.6
  许可条款见《许可协议》（LICENSE.txt）
 --------------------------------------------------------