2 Commits

Include renames

Author	SHA1	Message	Date
xmz7891	4295b482a1	2.0.0：安装时可设中转服务器 + 手表端新增设置页 + 中转默认留空 ... 按用户定的版本规矩，这一轮既有新内容又有重构，所以升第二位： 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 个阶段全部通过。	2026-10-07 23:02:44 +08:00
xmz7891	8880e7033d	修「经中转几次后永久哑掉」——「按一下没反应」的真因 ... == 现象 == 用户报： * 局域网能搜到电脑，IP/端口/配对码都对，连上后**没有任何反应** * 走中转「已配对」，但点按钮没反应 局域网那一半已经修过（preferLan）。这次抓到的是**经中转**那一半， 而且比预想的严重得多。 == 证据链（插桩复现出来的）== 被控端日志里直接抛了未捕获异常，线程当场死： Exception in thread client-relay: server.py:407 session.send(reply) relay.py:166 self._link.send_to_client(data) relay.py:357 self._post("/v1/agent/send", ...) relay.py:766 raise RelayError(f"请求失败: {last_error}") lanremote.relay.RelayError: 请求失败: Idle 之后的状态： * client-relay 线程没了 —— 电脑再也不往手表回任何东西 * relay-link 线程还活着、还在长轮询 —— 中转那边看着「设备在线」 * **手表看到的就是「连上了，但按一下毫无反应」** 写入仓库的测试 _tests/test_relay_local.py 一直是这个形状： 前面几项 PASS、跑到经中转发命令就卡死。之前没人深挖。 == 根因 1：一条 HTTP/1.1 连接被两个线程同时用 == _post() 里锁只包住「取连接」那一段： with self._http_lock: connection = self._http # 锁到这里就放了 try: connection.request("POST", ...) # 锁外发请求 于是两个线程会同时用同一条 connection： * relay-link 线程跑 /v1/agent/poll —— 长轮询，一条请求挂 180 秒 * client-relay 线程同时 POST /v1/agent/send HTTP/1.1 一条连接同一时刻只能有一个在途请求，第二个线程一进来 就撞上 http.client 状态机，抛 CannotSendRequest("Idle")。 _post 的「重试一次」也救不了：它 _drop_http() 之后，另一个线程 手里还攥着那条旧连接对象在发，照样坏。 修法： * **发命令用独立连接**（_post 加 dedicated 参数）。 长轮询那条常年被占着，发命令不该去挤它，各走各的。 * 两条连接各自一把锁**锁住整个「发请求 + 读响应」周期**， 不再只锁取连接那一下。 * 普通请求若发现缓存连接正忙（长轮询在途），临时另开一条用完即关。 * _drop_http(dedicated=) 区分清哪条；finally 里一定归还占用 （否则那条连接会被永久标记为忙）。 == 根因 2：回包失败会打死整个会话线程 == server.py 的 _client_loop 里： if reply is not None: session.send(reply) # <- 不在任何 try 里 ... except OSError: # <- 外层只捕获 OSError pass 而中转链路上 send 抛的是 RelayError，直接冒出去把线程打死。 **死一次就永久哑**，代价太大。 修法：session.send() 单独兜住所有异常，失败就断开这个会话 （让手表重连），绝不让线程消失。外层也补一个兜底 except。 == 修复效果 == 修复前：pair OK -> ping OK -> ping 卡死 -> 线程崩溃，永久哑 修复后：pair 21ms -> ping 82ms -> ping 4ms -> ping 6ms，零异常 _tests/test_relay_local.py：**之前完全卡死 -> 现在 21/21 全过** 这个测试之前一直是红的，说明「35 个阶段的回归全绿」这件事 本身就不成立过 —— 某个阶段卡住时看起来像环境问题而不是缺陷。 == 同批修掉验证阶段找到的其它问题 == 1. **TTL 清理 + 关掉接入开关 = 设备永久锁死**（严重） register() 用 `device_id in self.devices` 判断老设备，但超时清理 把设备从 devices 和 codes 都删了。电脑关机过夜（必然 > 6 小时） 第二天开机就会被自己的开关挡住，而且**重启也救不回来** （清 codes 时没落盘，重启后又当孤儿清一遍，自我维系）。 管理员在页面上还看不到这台设备，不知道该放开谁。 修法：状态文件里单独存 knownDevices 设备历史，超时清理绝不动它； register 改查这份历史；清理后补 _save()；delete_device 才真正忘记。 2. **管理页 JS 语法错误 -> 所有按钮失效**（严重） admin.py 里 ADMIN_JS 是普通三引号字符串，我在 Python 源码里写的 `\n` 被变成真实换行，拼进 JS 就是字符串里的裸换行 -> 整段 <script> 不执行 -> 改码/删除/批量删除/全选全变幽灵按键。 元凶是我加改码功能那次提交。改成 `\\n`。 3. **--relay / --relay-status 崩溃**（严重） RelayLink.start(url) 的 url 是必填参数，我把默认地址改空白时 run_agent.py 两处调用没跟着改。一处被 try 吞成「测试失败：missing 1 required positional argument」（用户以为地址填错了）， 一处直接报栈。两处都补上 url。 4. 非法 deviceId（控制字符 / 路径分隔符）现在被拒（白名单： 字母数字 + - _ . :） 5. enable_relay() 第二次调用不再谎报成功（加 RelayLink.running 属性， 返回值反映真实运行状态；不再用「对象建过没有」判断） 6. snapshot() 清孤儿码后补 _save()，磁盘和内存不再脱节 == 局域网全面优化（task-2，另一个智能体完成）== 4 个真问题： * **网段判断写死 /24** —— 在 /16 网络上 10.8.1.5 和 10.8.2.5 被判成不同网络，明明能直连却去走中转还费流量。 改成按网卡真实掩码比较。 * **广播只发一个包** —— 丢一个就整轮搜不到。改成 5 个时间点重发。 * **只探一个网段** —— 多网卡手表搜不到另一网段的电脑。改成全探。 * **走中转之后再也回不到局域网** —— 出门再回家永远挂中转。 新增定期回切（先便宜地 TCP ping，通了才动真格， 不破坏正在工作的中转连接）。 实测：局域网握手 2ms、50/50 = 100%、中位 0ms。 （跨网络那半之前拿不到数字，就是被上面那个线程崩溃挡住的 —— 现已修复。） 顺带：instance.py 单实例锁端口加 YKXMZ_LOCK_PORT 覆盖（默认不变）。 用户自己那台被控端正跑在这台机器上占着 8767/TCP + 8766/UDP， 是这次排查里好几个「测试怎么都不通」的根因。 == 服务端一键部署脚本（task-1，另一个智能体完成）== relay/deploy.sh + relay/deploy-tune.sh，随服务端 zip 发布： * 自动检查并安装 cloudflared * 部署程序、装 4 个 systemd 服务、网络调优、配隧道、自检打公网地址 * **不传 --hostname 且没有 TUNNEL_TOKEN 时明确提示要填**， 不会静默用一个写死的域名（用户明确说过这个中转站是他自己用的， 不对外开放，绝不能把私人域名烧成默认值） * 重跑 = 升级，已有数据/配对码/管理密码/凭据都不动 顺带修了发布包一直缺 site_shots/ 的老 bug （package_remote.py 用 iterdir()+is_file() 收文件，目录进不去， 新机器装完官网截图全是 404）。 == 默认中转地址改成空白 == 用户要求：软件默认不带任何中转地址，由用户自己填。 四处硬编码全部清空（server.py / MainActivity.java / run_agent.py / relay.py 的注释和文档示例），全仓已无非注释的硬编码地址。 == 文档同步（task-5，另一个智能体完成）== README / BEFORE-INSTALL / AFTER-INSTALL / 打包模板： * 新增「软件里不带任何中转地址」告示，讲清跨网络要自己部署 * 修正 Android 版本（写的是 9.0/API28，实际 API 24 / Android 7.0） * 删掉「地址已经内置好了」（现在是错的） * AGENT_README 原来把作者自己的中转地址当成「内置地址」发给用户，已重写 * RELAY_README 原来写「两条隧道同时跑会互相争抢」， 和真机/CHANGELOG 矛盾；按实测改成「两种协议同时在跑（故意的）」	2026-10-07 17:59:39 +08:00