mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 19:30:42 +00:00
xmz7891
4d97e40280
用户这次提了一整套升级。这个提交先落地三块（其余几块在做）。
== 一、静默自动更新 ==
用户原话："手表端点击一个更新按钮，电脑端就可以自动进行静默更新，
其他什么设置都不变 …… 不弹任何窗口出来"。
链路：
手表点按钮 -> 被控端问中转"最新是哪版"
-> 下载到 %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。
170 lines
6.7 KiB
Plaintext
170 lines
6.7 KiB
Plaintext
========================================================
|
||
ykxmz 安装前必读（前信息文件）
|
||
========================================================
|
||
|
||
软件名称：ykxmz
|
||
版本：2.1.6
|
||
作者：小麦子
|
||
|
||
请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
|
||
提醒，尤其是第三节和第五节。
|
||
|
||
|
||
--------------------------------------------------------
|
||
一、这是什么
|
||
--------------------------------------------------------
|
||
|
||
ykxmz 是一套自己搭建的远程管理工具，由三部分组成：
|
||
|
||
1-agent（被控端） 装在你**要管理**的电脑上（Windows）
|
||
2-server（服务器端）装在一台能上外网的 Linux 小机器上
|
||
（随身 WiFi、树莓派、VPS 都行）
|
||
3-watch（控制端） 装在你的安卓手表上
|
||
|
||
装好之后，你在手表上就能看到并操作那台电脑：屏幕、文件、
|
||
音量、电源、剪贴板……共两百多个功能。
|
||
|
||
**关键点：所有数据都走你自己搭的那台服务器，
|
||
作者碰不到你的任何内容。** 详见《许可协议》第五条。
|
||
|
||
**再强调一次：软件里不带任何中转地址，作者也不对外提供中转服务。**
|
||
只在同一个 WiFi 下用的话，压根不需要中转站，装完就能连；
|
||
要跨网络就必须自己部署一台（看下面第四节的第 1 步）。
|
||
|
||
|
||
--------------------------------------------------------
|
||
二、装机前对照检查
|
||
--------------------------------------------------------
|
||
|
||
请先确认：
|
||
|
||
[ ] 这台电脑是**你自己的**，或者设备主人明确同意你远程管理
|
||
[ ] 电脑是 Windows 10 / 11（64 位）
|
||
[ ] 手表是安卓 7.0（API 24）或更高版本
|
||
[ ] 服务器端那台机器是 Linux（Debian 12 实测通过），
|
||
能上外网，内存 512MB 够用
|
||
[ ] 你有一个 Cloudflare 账号和一个域名（跨网络才需要）
|
||
|
||
**不需要**装 Python、不需要 root、不需要 ADB。
|
||
|
||
|
||
--------------------------------------------------------
|
||
三、【重要】三条必须知道的事
|
||
--------------------------------------------------------
|
||
|
||
① 被控端默认是"静默"运行的
|
||
|
||
装完之后**没有窗口、没有托盘图标、没有终端**，
|
||
任务管理器里能看到一个叫 ykxmz.exe 的进程，
|
||
开机自启项里也显示 ykxmz。
|
||
|
||
这么做是为了不打扰用电脑的人，**不是**为了藏起来。
|
||
如果你要在这台电脑上装给别人用，你有义务告诉对方：
|
||
|
||
怎么查看（任务管理器 -> 详细信息 -> ykxmz.exe）
|
||
怎么关闭（任务管理器 -> 结束任务）
|
||
怎么卸载（ykxmz.exe --uninstall）
|
||
|
||
② 配对码是唯一的口令，请设一个别人猜不到的
|
||
|
||
配对码是 6 位数字，**它就是你电脑的钥匙**。
|
||
不要用 123456、000000、生日、手机号后六位这类。
|
||
|
||
一个配对码同时只能绑定一台电脑。如果别人先用了你想要的码，
|
||
后装的这台会被拒绝，并在屏幕上弹出提示：
|
||
「该配对码已被使用，请换一个配对码」
|
||
换个没人用的码就行。
|
||
|
||
③ 连接时屏幕上有提示
|
||
|
||
只要手表或控制端连上来，被控端会在屏幕右下角弹一个提示。
|
||
这是**故意保留**的功能，请不要关掉它——
|
||
它保证了设备使用者知道"现在有人在看这台电脑"。
|
||
|
||
|
||
--------------------------------------------------------
|
||
四、安装顺序
|
||
--------------------------------------------------------
|
||
|
||
按这个顺序来，别跳：
|
||
|
||
第 1 步 架服务器端（只做一次，**跨网络才需要**）
|
||
如果只在同一个 WiFi 下用（手表和电脑连同一个路由器），
|
||
这一步可以跳过。
|
||
要跨网络的话，把 2-server 整个目录拷到那台 Linux 小机器上：
|
||
bash deploy.sh
|
||
它会把中转服务、网络调优、Cloudflare 隧道一次装好，
|
||
最后打印一个**属于你自己的公网地址**。记住它。
|
||
|
||
第 2 步 装被控端（每台要管理的电脑做一次）
|
||
双击安装包 -> 输 6 位配对码 -> 勾上开机自启和
|
||
放行防火墙 -> 确定。会弹一次管理员确认。
|
||
|
||
第 3 步 装控制端
|
||
把 3-watch 里的 APK 装到手表上。
|
||
|
||
第 4 步 跨网络的话，把中转地址填上
|
||
**注意：软件里没有内置任何中转地址。**
|
||
同一个 WiFi 下用不用填；跨网络的话必须填你自己第 1 步
|
||
装出来的那个地址：
|
||
电脑： ykxmz.exe --relay https://你的域名
|
||
手表： 首页点「中转设置」，填同一个地址
|
||
|
||
|
||
--------------------------------------------------------
|
||
五、会改你系统的哪些东西
|
||
--------------------------------------------------------
|
||
|
||
安装和使用过程中，被控端会做这些改动，**请你知情**：
|
||
|
||
1. 写一条开机自启项
|
||
位置：HKEY_CURRENT_USER\...\CurrentVersion\Run
|
||
名称：ykxmz
|
||
内容："...\ykxmz.exe" --silent
|
||
|
||
2. 添加 Windows 防火墙放行规则
|
||
规则名：LAN Remote TCP / LAN Remote UDP / LAN Remote App TCP
|
||
/ LAN Remote App UDP
|
||
作用：允许 8765（TCP）和 8766（UDP）端口通信
|
||
|
||
3. 在程序目录下建一个 data 子目录
|
||
里面存：配对码、已配对设备、设置
|
||
卸载时会一并删除
|
||
|
||
4. 说明：部分功能（关机、改注册表、隐藏任务栏等）
|
||
需要管理员权限，会弹 UAC 确认，**不会**偷偷提权。
|
||
|
||
**以上全部可撤销**：卸载时自启项和防火墙规则会一起清掉。
|
||
|
||
|
||
--------------------------------------------------------
|
||
六、杀毒软件可能报警
|
||
--------------------------------------------------------
|
||
|
||
本软件没有购买代码签名证书（那是要花钱的），
|
||
加上它确实具备"远程控制 + 开机自启"这类能力，
|
||
所以**部分杀毒软件可能会报可疑**。
|
||
|
||
这是误报。你可以：
|
||
1. 在杀毒软件里把 ykxmz 整个目录加入信任/排除项；
|
||
2. 或者先看完《许可协议》，确认用途正当后再决定是否放行。
|
||
|
||
**作者不会、也没有办法让本软件绕过杀毒软件。**
|
||
如果你需要"绝对不被杀软发现"，那本软件不适合你。
|
||
|
||
|
||
--------------------------------------------------------
|
||
七、接下来看什么
|
||
--------------------------------------------------------
|
||
|
||
装完之后请看《安装后须知》（AFTER-INSTALL.txt），
|
||
里面有：怎么确认它在正常运行、怎么换配对码、
|
||
怎么彻底卸载、连不上怎么排查。
|
||
|
||
|
||
--------------------------------------------------------
|
||
作者：小麦子
|
||
软件：ykxmz 2.1.6
|
||
继续安装，即表示你已阅读并同意《许可协议》。
|
||
--------------------------------------------------------
|