mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 13:40:45 +00:00
xmz7891
4295b482a1
按用户定的版本规矩，这一轮既有新内容又有重构，所以升第二位： 1.9.0 -> 2.0.0（最后一位清 0）。 == 一、安装时就能设中转服务器（用户要求）== 安装向导那一页现在是两个输入框：配对码 + 中转服务器。 装的时候是"第一次设置"，最该一次把地址填好，不然装完还得去 双击 exe 找设置窗口，很容易漏。 只填域名就行（自动补 https://），留空 = 只走局域网。 批量静默部署同样支持： ykxmz-setup-2.0.0.exe /VERYSILENT /CODE=246810 /RELAY=relay.你的域名 为此新增了一个 --relay-url 参数： --relay 连接一次、打印状态、然后退出（人工排查用） --relay-url 只写进配置，不连接、不退出（安装流程用） 用错那个的话，安装包的命令链会在中间就 return，后面的 --silent 根本跑不到 —— 所以必须分开。 == 二、手表端新增「设置」页（用户要求）== 用户原话："安卓端加一个设置，各种设置就在这里面调"。 以前设置散在首页（只有一个"中转设置"按钮），现在统一收进设置页： * 中转服务器（填写 / 一键清空） * 记住的配对码（显示 / 清除） * 已配对的电脑（看数量 / 清空，带二次确认） * 关于（版本号从 APK 读，不会和代码对不上） == 三、中转地址默认留空 + 一次性迁移（用户报的问题）== 用户原话："安卓端为什么还是默认填的我的中转站，以后改成手动填"。 代码里的默认值早就是空的了，但用户看到的还是那个地址 —— 因为**老版本 1.5.0 把作者的域名硬编码成了默认值**，第一次运行就 存进了 SharedPreferences。装新 APK 不会清偏好，所以那个值一直留着。 用户其实从来没"选"过这个地址，是程序硬塞的。 所以加了 migrateLegacyRelay()：存的值如果正好等于当时内置的域名， 就当成没设过、清掉。只清完全相等的，用户手填的不会动。 == 四、两个测试自身的毛病 == * test_lan_optimize 那条"没有把旧公网域名当默认值"太粗 —— 它查的是源码里任何位置，于是迁移注释里引用那行老代码就把它判红了。 改成先剥掉注释再查（断言要测的是"有没有把它当默认值"）。 * test_image_modes 偶发红：它开真实 Tk 全屏窗口，在全量套件里跑 偶尔起不来（单独跑 19/19 全过）。加了有界重试。 偶发红的测试会让"全量通过"失去意义。 == 五、新增防复发断言 == _tests/test_relay_default_blank.py（15 项，回归阶段 3a3b）： * 默认值必须是空串 * 除了迁移清单，源码里不许有写死的中转域名 * 迁移必须真的被调用（不是只定义） * 迁移必须是 remove，不能换成另一个硬编码值 * Windows 端的默认也得是空 理由：用户说过"这个中转站我就自己用，不对外" —— 值得用断言钉死。 == 六、顺手修的 == * release_all.py 崩在 Gitee 那一步：Gitee 的 GET /releases/tags/{tag} 在"标签存在、但还没发行版"时返回的是 **HTTP 200 + JSON null**（不是 404），于是 .get("id") 直接 AttributeError。发 1.9.0 时踩到，已改成容忍 None。 * installer/build_installer.py 里 license-combined.txt 是从 docs/ 三份文档重新生成的，所以光改生成物没用（下次构建又变回去）。 改成在 build_license() 里统一注入当前版本。 * ExE 文件属性里的版本（version_info.txt）从 1.7.1 起就一直没跟上。 全量回归 43 个阶段全部通过。
180 lines
10 KiB
Markdown
180 lines
10 KiB
Markdown
## 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` 命令处理完不返回
|