mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 16:00:43 +00:00
xmz7891
f0c05079f7
用户这次提了一整套升级，这是最后一批。
== 一、手表端顶部快捷栏 ==
用户原话："手表端不管干什么，上面都有一栏，栏里的按钮可以在设置页
自定义，最多可以加 4 个，其中有一个按钮不能改，功能就是一键返回桌面"。
（"返回桌面"经确认 = **让被控电脑显示桌面**，即 Win+D。）
* 一条常驻的栏，贴在屏幕顶部，切页面时不动
* **4 个格子**：3 个可自定义 + **1 个固定的「显示桌面」（改不了）**
* 7 个可选动作：传文件 / 屏幕镜像 / 鼠标控制 / 音效 / 关机 /
语音播报 / 投图到电脑
* 设置页里点一下换；也能把某一格留空
* 没连上电脑时按钮置灰（不是藏起来 —— "一直在但暂时不能用"
比"时有时无"更好理解）
实现上的几个要点：
* 快捷栏 addView 在 5 个面板**之后** —— FrameLayout 里后加的在上层，
加在前面会被面板（MATCH_PARENT）整个盖住
* 面板加了 topMargin 给栏让位，集中在 applyPanelTopMargin 里改
（每个面板各写一遍很容易漏一个，表现是"就某一页顶部被切掉"）
* 第 4 格在代码里**写死** desktop，而且 QUICK_ACTIONS 里**没有**它 ——
这样它既不会出现在可选列表里，也不可能被改成别的
* 存储用 SharedPreferences。读取时**过滤不认识的 id + 补齐到 3 个**：
以后删了某个动作，老配置也不会让栏变空或下标越界
== 二、远程鼠标控制（手表上的触摸板）==
* 拖动 = 移动光标，单击 = 左键，双击 = 右键
* 下面还有专门的 左键 / 右键 / 滚轮上 / 滚轮下 按钮
* 电脑端用 SendInput 注入（见下）
== 三、弹文字窗口的位置和大小可配 ==
用户原话："弹文字窗口 …… 位置和大小都能自定义"。
* 位置：右下（默认，保持老习惯）/ 右上 / 左上 / 左下 /
屏幕正中间 / 自定义坐标
* 字号：8~32（夹住，免得设成 200 一个通知占满屏幕）
* 宽度：可指定，0 = 按内容自适应
* 三处窗口定位统一到一个 _notice_geometry() —— 以前三处各写死一遍
右下角，改一次要改三个地方，漏一个用户就看得见
== 四、屏幕被观看时的提示条改成默认不显示 ==
用户原话："以后不需要弹，啥窗户都没有，就可以像 UU 远程一样"。
* 默认**连窗口都不建**
* **但保留成开关**，设置里可以打开
关于这条：那条提示原来是**故意加**的（有人在看屏幕时，电脑前面的人
应该知道）。用户要求去掉，这是他自己的电脑、自己的教室，
属于正当的远程管理需求。所以能力保留、默认关闭 ——
这软件应该始终有一个"让本机用户看得见正在被控制"的选项可查。
== 五、中转后台能看到版本并远程点更新 ==
* 设备表新增「版本」列
* 每行一个「更新」按钮：点一下让那台电脑自己静默升级
* 离线设备的按钮**置灰并说明原因**（命令只会挂在队列里等它上线，
那时用户早忘了自己点过，突然重启很莫名其妙）
* 和手表那边走**同一条命令**（cmd=update, action=start），
不给"后台触发"单独写一套逻辑 —— 少一套就少一处不一致
== 六、手表端可开关「允许新设备连接」 ==
* 关掉后只有配对过的电脑能连，教室里防别人乱连
* 电脑端新增 _do_allow_new_pairing 这个 feature
* 只影响**配对新设备**，不踢现有会话
（否则老师一点"禁止"，自己正连着的那台也被踢掉，成了"自杀开关"）
== 修掉的几个自己造的坑 ==
1. **管理页 JS 裸换行** —— 最严重的一个。
ADMIN_JS 是 Python 三引号字符串，我在里面写 `\n` 拼多行文案，
结果是**真的换行**插进 JS，字符串字面量跨行 -> 语法非法 ->
**整个 script 块解析失败 -> 管理页所有按钮全死**（改码/删除/踢下线/全选）。
改成 String.fromCharCode(10)，不依赖任何转义层。
2. **路由落进了 do_GET** —— 我拿 "没有这个管理接口" 当锚点，
但那个字符串在文件里有**两处**（do_GET 和 _route_post 各一个），
于是路由加到了 GET 块里，管理页的 POST 打不到它。
表现是"点了更新没反应"。
3. **isConnected() 根本不存在** —— 写快捷栏时凭直觉调了个方法名，
编译才发现。顺手包了一层并加上说明。
4. **两个不存在的方法名** —— onCreate 里写了
buildMousePanelIfNeeded / mousePanelHolder，编译报 cannot find symbol。
5. **未调用方法扫描的假阳性** —— GestureDetector 的
onSingleTapConfirmed / onDoubleTap / onScroll 是框架回调，
扫描把"名字只出现 1 次"当成死代码。改成**跳过 @Override 的方法**。
这种假阳性最坏的结果是有人为了让它变绿把回调删了，手势就失灵了。
6. **测试断言太严导致误报** —— "不能有写死的 240"，
但 helper 里 `auto = max(240, ...)` 是自适应的兜底，故意的。
7. **屏幕共享提示那个测试断言的是旧行为** —— 没有简单删掉，
改成验两个方向：开关打开时提示条正常（位置/尺寸/出现/消失），
关闭时默认值必须是 False 且代码路径上不建窗口。
== 验证 ==
全量回归（19 关）全部 PASS，零失败
新增关卡：3a10 静默更新 / 3a11 鼠标控制 / 3a12 后台更新+弹窗 /
3a13 手表快捷栏
Java 编译通过（android-34, --release 8）
APK / 安装包 / 服务端包 全部重建，Win7 兼容校验通过
623 个 Python 文件语法通过
224 lines
7.6 KiB
Plaintext
224 lines
7.6 KiB
Plaintext
========================================================
|
||
ykxmz 安装后须知（后信息文件）
|
||
========================================================
|
||
|
||
软件名称：ykxmz
|
||
版本：2.1.7
|
||
作者：小麦子
|
||
|
||
装好之后看这一页：怎么确认它在跑、怎么改设置、
|
||
怎么彻底卸载、出问题怎么查。
|
||
|
||
|
||
--------------------------------------------------------
|
||
一、确认它真的在运行
|
||
--------------------------------------------------------
|
||
|
||
被控端装好后**看不到任何窗口**，这是正常的。想确认它在跑：
|
||
|
||
方法一（最直观）
|
||
Ctrl+Shift+Esc 打开任务管理器
|
||
-> "详细信息"标签 -> 找 ykxmz.exe
|
||
有，就是在跑
|
||
|
||
方法二（看端口）
|
||
命令行执行： netstat -ano | findstr 8765
|
||
有 LISTENING，就是正常
|
||
|
||
方法三（问程序自己）
|
||
命令行执行： ykxmz.exe --status
|
||
会打印：配对码、端口、中转连接状态、已配对设备数
|
||
|
||
方法四（从手表看）
|
||
手表上点"自动连接"，能连上就说明在跑
|
||
|
||
|
||
--------------------------------------------------------
|
||
二、常用操作
|
||
--------------------------------------------------------
|
||
|
||
重新打开设置窗口
|
||
ykxmz.exe --setup
|
||
|
||
换一个配对码
|
||
在设置窗口里改，或者：
|
||
ykxmz.exe --new-code （随机生成一个）
|
||
换完之后，手表那边要用新码重连
|
||
|
||
看看当前状态
|
||
ykxmz.exe --status
|
||
|
||
临时允许新设备配对（默认关着）
|
||
ykxmz.exe --add-device 10 （开放 10 分钟）
|
||
过了时间自动关回去
|
||
|
||
关掉/打开开机自启
|
||
ykxmz.exe --autostart off
|
||
ykxmz.exe --autostart on
|
||
|
||
网络自检（连不上时先跑这个）
|
||
双击 wlzj.bat
|
||
或 ykxmz.exe --netcheck 90
|
||
|
||
修复防火墙（要管理员）
|
||
右键 xffhq.bat -> 以管理员身份运行
|
||
或 ykxmz.exe --fix-firewall
|
||
|
||
|
||
--------------------------------------------------------
|
||
三、彻底卸载
|
||
--------------------------------------------------------
|
||
|
||
一条命令清干净：
|
||
|
||
ykxmz.exe --uninstall
|
||
|
||
它会依次：
|
||
1. 停掉正在跑的进程
|
||
2. 删掉开机自启项
|
||
3. 删掉数据目录（配对码、已配对手表全没了）
|
||
4. 安排删除程序目录本身（退出后几秒自动删）
|
||
|
||
**想保留数据**（比如以后还要用，只是换个位置装）：
|
||
先手动把 data 目录复制出来，再卸载。
|
||
|
||
**手动卸载也可以**（如果程序已经删了）：
|
||
1. 任务管理器结束 ykxmz.exe
|
||
2. 删除注册表项
|
||
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run
|
||
下的 ykxmz
|
||
3. 删除整个程序目录
|
||
4. （可选）删除防火墙规则：netsh advfirewall firewall
|
||
delete rule name="LAN Remote TCP"
|
||
|
||
|
||
--------------------------------------------------------
|
||
四、连不上怎么查
|
||
--------------------------------------------------------
|
||
|
||
按顺序排查，绝大多数问题在前三步就解决了：
|
||
|
||
第 1 步 被控端在跑吗？
|
||
任务管理器里有没有 ykxmz.exe
|
||
没有 -> ykxmz.exe --setup
|
||
|
||
第 2 步 防火墙放行了吗？
|
||
右键 xffhq.bat -> 以管理员身份运行
|
||
|
||
第 3 步 网络通不通？
|
||
双击 wlzj.bat 做自检
|
||
它会生成一份《网络自检结果.txt》
|
||
|
||
第 4 步 跨网络的话，中转通不通？
|
||
浏览器打开 http://<随身WiFi的IP>:8080/url
|
||
看它有没有返回公网地址
|
||
|
||
第 5 步 手表上点"连不上？点这里诊断"
|
||
|
||
常见现象对照：
|
||
|
||
"连接失败，配对码错误"
|
||
-> 手表上的码和电脑上的不一样，对一下
|
||
|
||
"该配对码已被使用，请换一个配对码"
|
||
-> 这个码被另一台电脑占了。换一个，
|
||
或者去中转管理页把占用它的那台设备删掉
|
||
|
||
"设备不在线"
|
||
-> 电脑上的程序没跑，或者网络断了
|
||
|
||
"连不上中转服务器"
|
||
-> 随身 WiFi 那台机器上的中转没起来，
|
||
或者隧道挂了。SSH 上去执行 lanremote-status 看看
|
||
|
||
|
||
--------------------------------------------------------
|
||
五、服务器端（随身 WiFi）日常维护
|
||
--------------------------------------------------------
|
||
|
||
三个服务都是开机自启，正常情况下不用管：
|
||
|
||
lanremote-relay 中转服务
|
||
lanremote-tunnel Cloudflare 隧道
|
||
lanremote-watchdog.timer 每 30 秒检查一次隧道连接
|
||
|
||
想一眼看清状态：
|
||
lanremote-status
|
||
|
||
常用命令：
|
||
lanremote-url 打印当前公网地址
|
||
lanremote-key 打印管理页钥匙
|
||
systemctl restart lanremote-tunnel 手动换个地址
|
||
journalctl -u lanremote-relay -f 看实时日志
|
||
|
||
管理页：
|
||
浏览器打开 <公网地址>，用管理密码登录（密码在你服务器上的 data/admin_password.txt 里，或你自己设的）
|
||
能看：设备列表、在线状态、配对码、流量、会话数
|
||
能做：删除设备（连配对码一起清）、踢会话、查看当前地址
|
||
|
||
忘了公网地址？
|
||
打开 http://<随身WiFi的IP>:8080/url —— 直接返回当前地址，
|
||
不用登录。
|
||
|
||
|
||
--------------------------------------------------------
|
||
六、已知限制
|
||
--------------------------------------------------------
|
||
|
||
1. 一条隧道同时只服务一台手表
|
||
新连上来的会顶掉旧的，旧的那台会提示"已被另一台手表接管"。
|
||
|
||
2. 跨网络时的延迟
|
||
经 Cloudflare 隧道走一圈，一来一回约 0.6 秒；
|
||
局域网直连只有几十毫秒。**程序和手表会自动判断**：
|
||
发现两边在同一个网络就切直连，断了自动切回中转。
|
||
|
||
3. 网络环境的影响
|
||
如果随身 WiFi 用的 4G 卡对 UDP 有限制，隧道可能偶尔抖。
|
||
程序里有看门狗会自动重启隧道，通常 1 分钟内恢复。
|
||
|
||
4. 杀毒软件误报
|
||
见《安装前必读》第六节。作者不提供绕过杀软的功能。
|
||
|
||
|
||
--------------------------------------------------------
|
||
七、出问题时怎么反馈
|
||
--------------------------------------------------------
|
||
|
||
请带上这几样，作者才能定位：
|
||
|
||
1. ykxmz.exe --status 的输出
|
||
2. wlzj.bat 生成的《网络自检结果.txt》
|
||
3. 手表上的诊断结果（手表首页"连不上？点这里诊断"）
|
||
4. 问题什么时候开始的、之前做过什么
|
||
|
||
|
||
--------------------------------------------------------
|
||
八、版本记录
|
||
--------------------------------------------------------
|
||
|
||
2.1.7
|
||
* 下载改走 Cloudflare 边缘缓存 —— 安装包和 APK 快了几十倍
|
||
* 跨网络更稳：隧道**两种协议同时跑**（QUIC + HTTP/2，
|
||
合计 10 条连接），一种协议犯病另一种还在服务
|
||
* 修网卡 MTU 和 QUIC 不匹配（QUIC 走 UDP，之前不受 MSS 钳制保护），
|
||
隧道建连明显加快
|
||
* 修偶发"已断开"误报：连续失败 3 次才判离线
|
||
* **中转地址默认为空** —— 需要跨网络时自己填
|
||
|
||
1.7.1
|
||
* 跨网络支持：Cloudflare 具名隧道，固定域名
|
||
* 中转服务器：单设备单配对码
|
||
* 手表端：自动判断局域网/中转并无缝切换
|
||
* 被控端：所有开关和画面功能支持回退/撤销
|
||
* 配对码被占用时弹通知提示
|
||
* 新增 --uninstall 一键卸载
|
||
* 针对 512MB 内存的小机器做了优化
|
||
|
||
|
||
--------------------------------------------------------
|
||
作者：小麦子
|
||
软件：ykxmz 2.1.7
|
||
许可条款见《许可协议》（LICENSE.txt）
|
||
--------------------------------------------------------
|