ykxmz/_build/CHANGELOG.md at 05d2287fbf78e587d318bcdf344eb92a76bab31c

mirror of https://gitee.com/xmz7891/ykxmz.git synced 2026-10-18 12:30:44 +00:00

Files

T

xmz7891 3f18e6bb40 2.1.0：网站自动抢救 + 后台抢救报告分区 + 网络热门音效 + 全量测试后台静默

按用户定的规矩，这一轮有新功能，升第二位：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 个阶段全部通过。

2026-10-08 18:36:50 +08:00

13 KiB

Raw Blame History

2.1.0

网站挂了会自己救：中转服务器上常驻一个监测单元，每 60 秒从公网查一次（不是查本机 —— 本机通不代表用户能打开）。连续 3 次不通就按阶梯自动抢救：

级	动作	代价
1	重启隧道	不动中转，在线设备不掉线
2	重启中转服务	设备要重连，但很快
3	重新施加网络调优	MSS / MTU 跑偏时用
4	重启无线网卡	4G / WiFi 卡死时用
5	重启整机	最后的底牌，默认不开

每做完一级立刻复验，好了就停。救完 10 分钟内不再动手（防抖 —— 否则预案刚重启完隧道还没连上，下一次检查又救一遍，来回重启反而永远连不上）。

网站出问题会自动留下诊断报告：万一五级都没救回来，服务端会把现场（内存、进程、隧道连接数、路由和 MTU、三份日志尾部、内核异常）整理成一份 txt 留在服务端，需要排查时直接取来看就行。只保留最近 30 份，不会把设备塞满。

每次自动抢救成功，也会把「第几级奏效」记进知识库，下次同类问题优先试历史上管用的那一级。
网络热门音效：手表上新增「音效」按钮，点一下电脑就响。内置 8 个（冰冰冰 / 啊哈哈哈 / 老牧师 / 叮 / 当当当 / 警报 / 鼓点 / 弹簧）。

说明一下版权：网上那些「冰冰冰」「啊哈哈哈」是有版权的真实录音，不能打包进安装包。所以内置的是程序合成的版本（正弦/方波现场算），名字对着感觉来，但不是那些录音本身。想要一模一样的一手素材，把 mp3/wav 丢进电脑的 data\sfx\ 目录，点「刷新」就出现在列表里，照样能远程播。目录里放了一份说明。
修「安卓设置页一片空白」：设置页建好了但忘了挂到窗口上 （少了 root.addView），showOnly() 让它可见也没用 —— 它根本不在视图树里。已修，并加了断言盯着「每个面板都必须挂到 root、并且纳入 showOnly()」—— 这类漏挂编译不报错、只在运行时表现为空白。
全量测试改成后台静默：会开窗口的 6 个阶段（含开全屏那个）现在跑在独立的 Windows 隐藏桌面上 —— 窗口是真的（全屏、可见、几何、Win32 枚举都真实），但屏幕上什么都看不到，也不会锁你的屏。

顺带修了一个一直误判的检测：判断「锁屏」时只看 OpenInputDesktop 成不成功是不对的 —— 锁屏时它同样成功（那时输入桌面是 Winlogon）。所以截屏类测试在锁屏时被记成 FAIL 而不是 SKIP，把真问题淹掉了。改成看输入桌面的名字。现在锁屏也能跑全量：该 SKIP 的 SKIP，该跑的照跑。

2.0.0

安装时就能设中转服务器：安装向导那一页现在是两个输入框 —— 配对码和中转服务器。装的时候是"第一次设置"，那时候最该一次把地址填好，不然装完还得去双击 exe 找设置窗口，很容易漏。只填域名就行（自动补 https://），留空 = 只走局域网。批量部署同样支持：/VERYSILENT /CODE=246810 /RELAY=relay.你的域名
手表端新增「设置」页：以前设置散在首页（只有一个"中转设置"按钮），现在统一收进来，在里面调：
- 中转服务器（填写 / 一键清空）
- 记住的配对码（显示 / 清除）
- 已配对的电脑（看数量 / 清空）
- 关于（版本号 + 连接顺序说明）
中转地址改成手动填，默认留空：以前有一版把作者的服务器地址写死成默认值，第一次运行就存进了偏好设置，装新版本也不会清 —— 看起来就像"默认还是别人的中转站"。现在默认是空的，并且会做一次性迁移把那个旧的内置地址清掉（只清完全相等的，你自己填的不会动）。
修「局域网连上后要推出去点设备才能控制」：手表上有四个页面，切换时靠手工藏上一页，新加的「局域网连接」页漏藏了 —— 所以从它连上之后控制面板其实已经显示，却被盖住看不见。
修「双击 exe 没反应」：装完之后双击现在会打开设置窗口。
新增版本号一致性检查和中转地址默认值检查两道断言，防止这类"漏改一处"的问题再出现。

1.9.0

被控端终于有设置窗口了：装完之后双击 ykxmz.exe 就能打开，里面可以改 配对码、中转服务器、允许新设备接入、开机自启。以前双击是"什么都不弹"，只能靠命令行参数改配置。

顺带修了一个很隐蔽的打包问题：PyInstaller 的 --hidden-import 里漏了 lanremote.ui（设置窗口那套 tkinter 代码）。源码跑得好好的，但打包出来的 exe 一跑就崩，用户看到的还是"双击没反应"。
修「局域网连上后没反应」：手表上有四个页面，切换时靠手工藏上一页，而新加的「局域网连接」页漏藏了 —— 所以从它连上之后，控制面板其实在底下显示了，却被盖住看不见。必须"推出去点一下设备"才看到。根子是"每处切换都手写一串 setVisibility"，改成统一入口 showOnly()，以后加页面不会再漏。
修「按一下没反应」的真因：中转那条长轮询（最长 60 秒）和用户操作共用了同一个 HTTP 连接，长轮询占着连接时操作请求发不出去，线程直接死掉，之后所有操作都没反应。改成各用各的连接。
中转地址默认留空：需要跨网络时自己填。只在一个 WiFi 里用就什么都不用配，那样手表和电脑直接连，最快也不耗流量。
新增版本号一致性检查：版本号散落在 8 个地方（exe 文件属性、安装包、 APK、许可页…），靠脚本+人工替换很容易漏。实测就漏了两处： version_info.txt 和许可页都还写着 1.7.1 —— 用户在"文件属性"里看到一个错三个版本的号。现在有断言钉住。

1.8.2

下载快了几十倍：安装包和 APK 改成由 Cloudflare 的边缘节点直接发送。原来每次下载都要穿过隧道回到那台 4G 小机器上取文件，实测吞吐只有 3~67 KB/s，15 MB 的安装包根本下不动（还会中途断掉）。现在改走边缘缓存：同一个文件实测从 17 KB/s 提到 695 KB/s， APK 从 3 KB/s 提到 101 KB/s，并且不再消耗 4G 流量。
跨网络连接更稳：隧道改成两种协议同时跑，一共 10 条连接。两种协议各有各的毛病 —— 实测这条线路上运营商对 UDP 有限制，纯 QUIC 的拨号成功率只有 72%；而纯 HTTP/2 一旦丢包就容易卡住（一条 TCP 上丢一个包，所有请求一起等）。两个一起跑就是互相兜底：QUIC 拨号失败的那部分由 HTTP/2 顶着， HTTP/2 卡住的时候 QUIC 的恢复更快。实测 25 分钟连续可用率 50/50 = 100%（改之前是 96~98%），尾部延迟 P99 从 3295ms 降到 2632ms。
修网卡 MTU 和 QUIC 不匹配：之前只给 TCP 做了 MSS 钳制，而 QUIC 走 UDP 完全不受保护，包一大就被中间设备悄悄丢掉。把网卡 MTU 降到 1400 之后，QUIC 建齐 10 条连接的时间从 28 秒缩到 12 秒。
修响应头不一致：下载接口之前对 GET 和 HEAD 报的缓存信息不一样，部分下载工具（IDM、迅雷）探测时会把文件误判成不可缓存甚至空文件。
修偶尔闪一下"已断开"：原来只要有一次请求失败就立刻显示离线，而 4G 链路上本来就有 2~4% 的偶发失败、一两秒就自己恢复。现在改成连续失败 3 次才判离线 —— 真的断了仍然如实显示。

1.8.1

修局域网连接被中转劫持（重要）：只要「中转设置」里填了地址，点「局域网连接」填好 IP、端口、配对码之后，程序仍然走中转，完全无视你填的局域网地址。中转慢的时候要等 40 秒才报错，看起来就像"点了一点反应都没有"。现在改成：局域网优先直连（6 秒超时），连不上才退回中转
修已配对电脑的地址过期不提示：电脑换了网络之后（比如从 192.168.2.x 换到 192.168.10.x），列表里还是旧地址，点一下必然失败。现在会标出「⚠ 地址可能已过期」，并且跳过注定失败的直连，直接通过中转查询最新地址
长轮询从 15 秒延长到 60 秒，跨网络更稳：隧道每次请求要多花 1~2 秒（边缘路由 + 回源），而这个开销是按次数收的 —— 每次都要吃一遍。拉长到 60 秒把请求数降到 1/4，撞上丢包/重连窗口的概率也降到 1/4。 命令响应速度不变：有数据时立刻返回，不是等满 60 秒。
修局域网直连成功后打出误导性日志的问题

1.8.0

这一版主要是「修看不见的稳定性问题」。

修跨网络老断（Error 1033 / 502 / 530 的真因）： 4G 链路会静默断开 TCP 连接（不发 FIN/RST，双方都以为还活着）， Cloudflare 把请求发到这种"僵尸连接"上就报错。而 Linux 默认要 2 小时才发现连接死了 —— 中间这段时间服务一直"看着在线、实际打不开"。现在改成 30 秒探测、60 秒内发现并重连
修跨网络抖动：隧道连接数从 2 提到 4。只剩 1 条连接时跨机房回源会失败，实测可用率 0/12；提到 4 条后稳定 12/12
修掉电重启后恢复太慢：原来开机要 2 分 10 秒公网才恢复，那段时间浏览器看到的就是 Error 1033。根因是系统里 NetworkManager 和 systemd-networkd 同时在跑，后者等一个不归它管的网络，干等 2 分钟超时失败，把启动流程一起拖住了。改完 17 秒就绪，掉电重启后 24 秒公网可用
修看门狗自己制造不稳定：它每隔 50 秒重启一次隧道，但隧道重建 4 条连接要 30~60 秒 —— 每次还没建齐就被下一次打断，永远停在"只剩 1 条"的状态。现在重启后有宽限期，并且会区分"没建好过"和"建好过又垮"，后者立刻重启
官网重新设计：层次更清楚，白色简洁风格
官网新增产品展示：手表界面预览（颜色和布局与真实手表一致）、电脑端真实截图、两种连接方式对比图
清理僵尸设备记录：设备列表原来只增不减，实测一天攒了 75 条无效记录，拖慢手表和网页访问。现在超过 6 小时没上报的自动清掉，占用的配对码一起释放
修下载文件用 HEAD 探测时长度报 0（部分下载器会误判成空文件）
支持 HEAD 请求（原来一律返回 501）

1.7.1

修卸载卡死：从控制面板卸载时进度条永远走不完。根因是被控端在无控制台的隐藏进程里调 AllocConsole 和读控制台输入，会永久阻塞
修安装回滚：旧版本程序还在后台跑时，安装器关不掉它，弹「无法关闭所有应用程序」，静默安装会整个回滚 —— 用户看到的是"装了没反应"
修卸载残留：开机自启注册表项没删掉、安装目录留个空壳
修手表连上后一片白屏：分页初始化函数从没被调用过，标签栏里只剩一个孤立的指示器
修「被控端已关闭新设备配对」把重装手表的人永久挡在外面：配对码本身就是钥匙，拿着正确的码就该放行
手表端应用名改成 ykxmz
修跨网络延迟高：隧道退回了 QUIC（--protocol http2 参数丢失），可用率只有 48%；恢复 HTTP/2 后可用率 100%
网络调优持久化：TCP 缓冲 4 MB、FastOpen、空闲后不重置拥塞窗口（长轮询场景关键）
手表提示改成自诊断式：连不上时直接打出双方地址，一眼看出是网段不同还是连错了 WiFi
官网重新设计：导航 / 功能 / 三步上手 / 下载 / 常见问题
官网改成白色简洁风格

1.7.0

电脑端改成 Windows 安装包（Inno Setup），双击安装，不再需要解压 zip
安装向导里填 6 位配对码，装完手表直接连，不用再跑一次设置
安装包支持静默批量部署：ykxmz-setup-1.7.0.exe /VERYSILENT /CODE=123456
三份说明文档合并进安装向导，必须接受才能继续
修配置分裂问题：管理员装的配对码，普通用户账号看不到（数据目录改成按安装位置判断）
修装到 Program Files 后报「拒绝访问」：ProgramData 数据目录自动授权
修安装卡死：--code 命令处理完不返回

13 KiB Raw Blame History Unescape Escape