mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 17:10:43 +00:00
xmz7891
3f18e6bb40
按用户定的规矩，这一轮有新功能，升第二位：2.0.0 -> 2.1.0。
== 一、网站挂了会自己救 ==
用户原话：「网站还是容易挂，建议继续增加隧道稳定性，并在后台设立
检测单元，实时检测网站状态，一旦检测到网站挂了，立即启动紧急预案」。
新增 relay/monitor.sh + lanremote-monitor.timer：
每 60 秒从**公网**查一次 /v1/health（不是查 127.0.0.1）
为什么不查本机：本机 200 只说明中转进程活着，用户真正关心的是
经过 Cloudflare 边缘 + 隧道 + 本机三段之后能不能打开。实测过
隧道两条实例都掉了、本机 curl 照样 200，只有从公网测才发现 502。
连续 3 次不通才动手（这条 4G 线路本来就有 2~4% 偶发失败），
救完 10 分钟内不再动手（否则预案刚重启完隧道还没连上，
下一次检查又救一遍，来回重启反而永远连不上）。
新增 relay/rescue.sh：五级阶梯，每级做完立刻复验，好了就停
1 重启隧道 不动中转，在线设备不掉线
2 重启中转服务 设备要重连，但很快
3 重新施加网络调优 MSS / MTU 跑偏时用
4 重启无线网卡 4G / WiFi 卡死时用
5 重启整机 最后的底牌，**默认不开**（要 RESCUE_REBOOT=1）
理由：如果问题出在供电或上游线路，重启只会让恢复更慢；
而且半夜自动重启一台没人管的机器风险太大。
== 二、抢救报告 + 后台分区 ==
用户原话：「如果紧急预案未能解决，则将问题打包成 .txt，然后在
中转站设置里面加一个分区专门放还有下载这个 txt。解决后将解决问题
的方法加入紧急预案」。
* 五级都没救回来 -> 把现场（内存/进程/隧道连接数/路由和 MTU、
三份日志尾部、内核异常）整理成 rescue_reports/<时间戳>.txt
* 后台新增「抢救报告」分区，列出报告（带结论摘要），点一下下载
* 下载走单独的 /rescue/<名字>，**不发缓存头**（内容会变，
也不该让 Cloudflare 边缘留着）。和 /download/ 分开是有意的：
那个是给用户的安装包，文件名带版本号、内容永不改变，
所以敢发 604800 长缓存
* **要登录才能下** —— 报告里有内网 IP、进程表、日志尾部，
是运维信息。第一版把这条路由插在 _admin_gate() 之前，
等于匿名可下，自己查出来补上了
* 每次自动抢救成功，把「第几级奏效」写进 rescue_knowledge.md；
监测单元读它，下次同类症状优先试历史上管用的那一级
（这就是用户说的"解决后将解决问题的方法加入紧急预案"）
== 三、网络热门音效 ==
用户原话：「再加上近期网络热门音效，什么冰冰冰，啊哈哈哈哈，
各种老牧师音效，可以直接远程播放」。
**版权说明**：网上那些「冰冰冰」「啊哈哈哈」是**有版权的真实录音**
（影视片段 / 别人的作品），不能下载打包进安装包 —— 那既侵权，
也会让这个项目在 Gitee 那边直接踩线（这个仓库已经被判过一次
"内容可能含有违规信息"）。
所以：
* 内置 8 个**程序合成**的音效（正弦/方波现场算，零版权风险、
不占安装包体积）：冰冰冰 / 啊哈哈哈 / 老牧师 / 叮 / 当当当 /
警报 / 鼓点 / 弹簧。名字对着感觉来，但不是那些录音本身
* 做「自己放进来」的目录：mp3/wav 丢进 data/sfx/ 就自动出现在
列表里，照样能远程播。目录里放了一份说明
* 手表首页新增「音效」按钮，点开选一个，电脑就响
（复用现成的 showChooser，不新建面板）
协议加 sfx_list / sfx_play 两条命令。
== 四、修「安卓设置页一片空白」 ==
用户报的。根因：设置页**建好了但忘了 root.addView()** ——
showOnly() 让它 VISIBLE 也没用，它根本不在视图树里。
这类"漏挂"编译完全不报，只在运行时表现为空白。已加断言
_tests/test_watch_panels_wired.py 盯着：每个面板都必须挂到 root、
并且纳入 showOnly()。
== 五、全量测试改成后台静默 ==
用户原话：「把全量测试改为在后台静默运行不要打开任何窗口或锁屏」。
会开窗口的 6 个阶段（含开**全屏**那个）现在跑在独立的 Windows
隐藏桌面上（_tests/hidden_desktop.py）。窗口是**真的** —— 全屏、
可见、几何、Win32 枚举都真实，测试有效性一点没损失 ——
只是不在用户眼前，全屏也不会锁屏。
顺带修了一个一直在骗人的检测：判断"锁屏"时只看 OpenInputDesktop
成不成功是不对的 —— **锁屏时它同样成功**（那时输入桌面是 Winlogon）。
于是截屏类测试在锁屏时被记成 FAIL 而不是 SKIP，把真问题淹掉了
（用户电脑锁了一夜，我就是被这个误导过）。改成看输入桌面的**名字**。
现在锁屏也能跑全量：该 SKIP 的 SKIP，该跑的照跑。
== 六、顺手修的真 bug ==
* windows/lanremote/server.py 的 sfx_play 分支用了不存在的变量名 body
（应该是 msg）-> **一调就 NameError**。pyflakes 那关抓出来的，
说明"未定义名"这条检查有用。
* _build/package_remote.py 的文件白名单只有 .py/.sh/.ico，
**.service/.timer 收不进服务端 zip** -> 新机器上监测根本不启动，
而且不报错、只是静默不跑。已加。
* protocol.py 被我补丁插入了 LF 行到 CRLF 文件里 -> 行尾混用，编码审计红。
* deploy.sh 的 watchdog 块被我改锚点时吃掉了 start/say 两行
（bash -n 通过、只是少两条执行语句）—— 改完读回来核对才发现。
* _build/CHANGELOG.md 的 2.1.0 说明里写了"管理后台"，
触发对外材料清洁度检查。改成不提管理页（用户定的规矩：
对外只能提官网）。
全量回归 46 个阶段全部通过。
170 lines
6.7 KiB
Plaintext
170 lines
6.7 KiB
Plaintext
========================================================
|
||
ykxmz 安装前必读（前信息文件）
|
||
========================================================
|
||
|
||
软件名称：ykxmz
|
||
版本：2.1.0
|
||
作者：小麦子
|
||
|
||
请你**在安装之前**花三分钟读完这一页。里面有几条很要紧的
|
||
提醒，尤其是第三节和第五节。
|
||
|
||
|
||
--------------------------------------------------------
|
||
一、这是什么
|
||
--------------------------------------------------------
|
||
|
||
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.0
|
||
继续安装，即表示你已阅读并同意《许可协议》。
|
||
--------------------------------------------------------
|