 xmz7891
|
de5018bbbe
|
按用户规矩升到 1.9.0（有新内容+重构，不是只修 bug）+ 加版本号一致性检查
用户定的规矩：
只修 bug -> 最后一位 +1 1.8.2 -> 1.8.3
加新内容/重构 -> 第二位 +1，最后一位清 0 1.8.2 -> 1.9.0
这一轮既有新东西（设置窗口的中转服务器字段、允许新设备接入开关、
双击开设置窗口）又有重构（手表面板切换收成 showOnly()），
所以是 **1.9.0**，不是我之前说的 1.8.3。
== 顺手加了个「版本号一致性」检查（回归阶段 3a8）==
版本号散落在 8 个地方，靠脚本+人工替换很容易漏。实测漏了两个，
而且**漏了不报错**，只是用户看到一个对不上的版本号：
* windows/version_info.txt 写着 1.7.1
-> 用户在「文件属性 -> 详细信息」里看到的版本，错了三个版本
* docs/LICENSE.txt 写着 1.7.1
-> 安装时许可页上显示 1.7.1
第二个的根因值得记：installer/build_installer.py 会从 docs/ 里三份
文档**重新生成** license-combined.txt，所以光改生成物没用 ——
下次构建又变回去（我第一次就是这么被骗的）。改成在 build_license()
里**统一注入当前版本**，源文档写什么都不影响。
新增：
_tests/check_version_consistency.py 检查 8 处版本号一致
_build/add_verify_stage.py 给套件加阶段（不经 shell，
不会被 PowerShell 吃掉 \$ 变量）
_build/fix_license_version.py 按行精确修 license
== 另外修了两个我自己的坑 ==
1. verify_all.ps1 被 PowerShell heredoc 吃掉了 \ / \，
整个脚本语法错。**同一个坑踩了两次**（3a7 和 3a8）。
以后给 .ps1 加含 \$ 的内容一律写 Python 脚本文件再跑。
2. build_exe.ps1 被 edit 工具吃掉了 UTF-8 BOM
（PowerShell 5.1 会按 GBK 读，中文注释乱码）。
全量回归 43 个阶段全部通过。
|
2026-10-07 22:10:14 +08:00 |
|
|
xmz7891
|
fc61dad0a3
|
补两个自检失败：build_exe.ps1 丢 BOM + run_agent 用了未导入的 time
全量回归只剩这两项红，都是我这几步引入的：
1. 编码审计：build_exe.ps1 缺 UTF-8 BOM
我用 edit 工具改它时把 BOM 丢了。PowerShell 5.1 会按 GBK 读，
里面的中文注释会变乱码。
2. Python 静态检查：run_agent.py:760 undefined name 'time'
我在 _restart_background 里用了 time.sleep，但 run_agent.py
模块级没有 import time（原来只有 run_silent 里局部 import）。
补上之后顺手在注释里记一笔：pyflakes 这一关是有用的。
顺带：test_double_click_window.py 的注释里我原样写了两个
U+FFFD 替换字符当例子，被编码审计当成乱码 —— 改成用文字描述。
现在全量回归 41 个阶段全部通过。
|
2026-10-07 21:50:00 +08:00 |
|
|
xmz7891
|
b76014709e
|
修用户报的三个问题 + 揪出我自己检查工具的盲区
用户报：
1. 官网 502
2. 局域网连接：输入配对码提示连上了但没反应，得推出去点设备才能连
3. 被控端安装时要能设中转服务器；之后双击 exe 也该能改配对码 /
开关新设备 / 中转地址 —— 但现在双击没反应
────────────────────────────────────────
问题 1：502（暂态，已恢复）
────────────────────────────────────────
你截图是 21:24:56，隧道日志显示 21:22:51 和 21:26:44 各重启了一次
—— 502 就发生在那个空窗里。现在三个服务都 active、10 条连接、
本机 200(3ms)、公网 200(2.6s)。
（重启是谁触发的还没查清，watchdog 的嫌疑最大，下一轮跟进。）
────────────────────────────────────────
问题 2：局域网连上后没反应（真 bug，已修）
────────────────────────────────────────
手表上有**四个**面板，靠手工 setVisibility 切换：
connectPanel 首页
controlPanel 控制面板
mirrorPanel 投屏
lanPanel 局域网连接页 <- 后加的
而 showControlPanel() 只藏了前两个：
connectPanel.setVisibility(GONE);
controlPanel.setVisibility(VISIBLE);
if (mirrorPanel != null) mirrorPanel.setVisibility(GONE);
// lanPanel 没藏！
于是从「局域网连接」页填完码、连接成功之后：
connect() 成功 -> showControlPanel() -> 控制面板显示了
但 lanPanel 还盖在最上层 -> 用户看到的还是局域网页面
表现就是用户说的「提示连上了，但没反应，得推出去到设备列表
点击设备才能连接」—— 推出去把 lanPanel 收掉，才看到底下。
**根子在于"每处切换都手写一串 setVisibility"**，加第四个面板时
必然漏。改成统一入口：
private void showOnly(View keep) // 藏掉所有面板，只留一个
6 个切换点全部走它。以后加面板只要在 showOnly 里加一行。
────────────────────────────────────────
问题 3：双击 exe 没反应（功能缺失，已补）
────────────────────────────────────────
原来是两件事叠在一起：
**3a. 装完之后双击永远静默**（main() 最后几行）
if not store.get("setup_done", False):
return run_setup(store)
return run_silent(store, None) # <- 什么都不弹
改成：没参数 + 已设置过 -> **打开设置窗口**。
后台运行走显式 --silent（开机自启和安装包都用它，不受影响）。
**3b. 设置窗口里没有中转服务器**
SetupWindow 原来只有 配对码 / 开机自启 / 放行防火墙。
现在加了：
* 中转服务器地址（可不填；只在一个 WiFi 里用就不需要）
* 允许新设备接入（开关，只在"设置"模式给）
并且给 SetupWindow 加了 mode：
"first" 第一次设置（防火墙 + 自启 + 转静默，老行为不变）
"settings" 已装好，只改配置
**3c. 顺带修了一个会静默失败的东西**
改完发现打包出来的 exe 一跑就 ModuleNotFoundError:
No module named 'lanremote.ui' —— **PyInstaller 的 --hidden-import
里没有 ui**。它是 tkinter 那套设置窗口的实现，而静默那条路
不需要它，静态分析就找不到。源码跑得好好的，只有 exe 会崩。
已加 --hidden-import "lanremote.ui"，并写了
_tests/test_double_click_window.py 针对**打包好的 exe** 验：
✅ 进程没崩 / 窗口弹出来了 / 标题是「ykxmz · 设置」
────────────────────────────────────────
额外揪出来的：我的检查工具一直在骗我
────────────────────────────────────────
反复被同一个问题咬了三次：补丁脚本为了加 import os / import re，
把它插到了 `from __future__` 前面，整个文件语法错。
而**我前面几次说的「全仓语法检查 0 个问题」是假绿**：
ast.parse(src) -> 通过（只解析，不做编译期检查）
compile(src, ...) -> SyntaxError: from __future__ imports
must occur at the beginning of the file
`__future__` 的位置是**编译期**检查，ast.parse 根本不管。
所以改成用 compile()，并写成
_tests/check_python_syntax.py（回归阶段 3a7），
它还会专门把"ast.parse 会放过、compile 会拦"的文件标出来。
实测：全仓 533 个文件，用 compile() 扫出 1 个坏的（ui.py），
而它正是让"双击没反应"的最后一个原因。
────────────────────────────────────────
还有一个重要发现
────────────────────────────────────────
**你一直在跑的是 10-06 的旧 exe**：
C:\Users\shu\Desktop\ykxmz\ykxmz.exe 10-06 17:43 <- 你双击的这个
LanRemote\dist_exe\ykxmz\ykxmz.exe 10-07 21:5x <- 修复都在这
它的 silent.log 正在反复报：
[21:15:59] 连接断了，重开一次再试（The read operation timed out）
[21:16:42] 中转连接出问题：RelayError: 请求失败: ...
[21:18:34] 已登记到中转：配对码 111111
这就是我修的那个 126 秒长轮询问题 —— 旧版超时太短反复掉线。
新版把客户端超时改成 180 秒了。
**所以这三个修复要装上新版才生效。**
|
2026-10-07 21:38:22 +08:00 |
|
|
xmz7891
|
c97d7e8961
|
修「去密码硬编码」的第三批机械替换伤
上一轮的批量替换又留下四处伤，全都表现成"测试红了/文件坏了"，
根子都在替换脚本不看上下文。
== 1. import os 插到了 __future__ 前面 ==
fix_password_round2.py 给文件补 `import os` 时，直接插在第一个
import 之前。但那个文件是：
'''
from __future__ import annotations
import ast
被插成了 `import os` 在 `from __future__` 之前 ——
Python 要求 __future__ 必须是第一条语句，于是整个文件语法错：
SyntaxError: from __future__ imports must occur at the beginning
受影响：_build/test_response_headers.py
== 2. 把中文说明塞进了字符串字面量 ==
同一个脚本里：
t = t.replace(OLD, "（从 RELAY_ADMIN_PASSWORD 环境变量读）")
凡 `"@<老密码>"` 这种形状（@ 在引号里）都被替换成字符串：
PASS = "@（从 RELAY_ADMIN_PASSWORD 环境变量读）"
ADMIN_PASS = "@（从 RELAY_ADMIN_PASSWORD 环境变量读）"
本该是 `(os.environ.get("RELAY_ADMIN_PASSWORD") or "").strip()`。
受影响：_build/test_response_headers.py、
_build/split_site_admin2.py
== 3. 测试自己起的中转拿不到密码（第二批漏了一个文件）==
test_response_headers.py 也是自己起本地中转，然后用 PASS 登录。
PASS 从环境变量取，本地跑时是空的 -> 登录失败 -> 401
-> 表现成「登录拿到 cookie（没拿到）」，看起来像登录功能坏了。
和上一批同样的修法：没设环境变量就**生成一个本次运行专用的随机密码**，
同时通过 env 和 data/admin_password.txt 告诉那台测试中转。
== 4. 模块级调用写在函数定义之前 ==
test_relay_admin_login.py 里 `PASSWORD = _admin_password()`
在模块级第 29 行，而 `def _admin_password()` 在第 64 行 ——
执行时 NameError（pyflakes 也报 undefined name）。
把这个赋值挪到 helper 定义之后。
== 5. 顺手清掉一个语法就是坏的死脚本 ==
_build/poll60_patch.py 第 49 行有个未闭合字符串，从来跑不起来，
也没人引用 —— 它是一次性补丁，改完就该删。留着只会让静态检查
一直报错。已 git rm（历史里还能查到内容）。
== 6. verify_all.ps1 的 Show-Fails 会崩 ==
$lines | Select-Object -Last 1 | ForEach-Object {
Write-Host " $($_.Trim())"
}
子进程的 stderr 被塞进输出流时，$_ 是 ErrorRecord，没有 .Trim()
方法 -> 抛 "does not contain a method named 'Trim'"，
反而把真正的失败信息盖住了。改成先转字符串再 Trim。
== 验证 ==
网页响应头 12/12 通过
管理页设备控制 23/23 通过
管理页批删 24/24 通过
管理页按钮 10/10 通过
管理页网络体检 15/15 通过
密码随机生成 11/11 通过
全仓语法检查 0 个问题
教训再记一笔：**机械替换必须替换完就验证**，
而且兜底的 str.replace 一定要慎用 —— 它不看上下文，
"函数调用进引号" 和 "中文说明进字符串" 都是这么来的。
|
2026-10-07 21:04:59 +08:00 |
|
|
xmz7891
|
430923dd84
|
🔐 修一个严重安全问题：管理密码被硬编码进公开仓库
== 问题 ==
relay/relay.py 第 138 行：
ADMIN_PASSWORD_DEFAULT = "@REVAedu120830"
而且 _tests/ 和 _build/ 下 11 个文件里也写着明文密码。
这个仓库是要推到**公开的 Gitee / EzHub** 的，等于：
git 仓库 = 公开的
管理页路径 /zhongzhuanzhan = 公开的（就写在代码里）
公网地址 = 公开的
密码 = 也在仓库里
**= 把管理台的门钥匙挂在门上。**
而且 git 历史删不掉 —— 只是在最新提交里删掉没用，
读过仓库的人已经从历史里拿到了。
== 修法 ==
### 1. 代码里不再有任何固定密码
relay.py 的 admin_password() 改成和 admin_key 一样的做法：
环境变量 RELAY_ADMIN_PASSWORD
-> data/admin_password.txt（600 权限，不进仓库）
-> 都没有就**首次启动随机生成**，写进那个文件并打印一次
这样全新部署的密码天然是随机的、每台不同。
### 2. 11 个文件里的明文密码清掉
_tests/ acceptance.py, test_relay_admin_login.py,
test_admin_batch_delete.py, test_admin_button.py,
test_admin_device_control.py, test_admin_js.py,
test_admin_netcheck.py
_build/ check_web.sh, verify_site_admin.sh,
split_site_admin2.py, test_response_headers.py
统一改成从 RELAY_ADMIN_PASSWORD 环境变量读，
拿不到就从部署的 data/admin_password.txt 读，
再拿不到就**跳过需要登录的用例**（而不是编个假密码硬试）。
### 3. 真机上的密码已经轮换
设备上的 data/admin_password.txt 已换成用户指定的新密码，
并实测：
✓ 新密码能登录（HTTP 302 + lr_admin cookie）
✓ 老密码登不上了
✓ 新密码无换行（printf 不带 \n，免得读出来多一个字符）
顺带：重启中断了 relay-stability 的 A/B 对照 A 组（69 个样本），
分析数据时会标注这一段。
== 新增测试 ==
_tests/test_admin_password_gen.py 验证六件事：
1. 全新部署会生成随机密码（不是那个老密码）
2. 密码长度 >= 12、纯字母数字
3. 用生成的密码能登录管理页
4. **老密码登不进去**
5. 重启后密码不变（从文件读回来）
6. **两次全新部署的密码不一样**（真的是随机的）
== 还没做的（等用户决定）==
git **历史**里还有那个密码。要彻底清掉得重写历史 + 强制推送，
这是个危险操作，按用户的规矩必须他确认之后才做。
而且**光删历史不够** —— 密码已经公开过，必须换（已换）。
|
2026-10-07 20:49:33 +08:00 |
|
|
xmz7891
|
d907fdcf6e
|
🚨 修一个严重 bug：管理页所有按钮又失效了（同一个坑踩第二次）
== 症状 ==
在**真实中转**上实测管理页时，用 node --check 检查页面内嵌的 JS：
SyntaxError: Invalid or unexpected token (第 46 行)
整段 <script> 不执行 -> 改码 / 删除 / 批量删除 / 全选 全部变幽灵按键。
**这正是用户之前报过的那个 bug，加新功能时又踩了一遍。**
== 根因（讽刺到极点）==
admin.py 的 ADMIN_JS 是**普通三引号字符串**，里面写一个反斜杠+n
会被 Python 解释成**真实换行**。而 JS 的行注释 // 不能跨行 ——
一断行，后面就成了裸文本，整段脚本语法错误。
出事的是这段注释：
// ⚠ 这里必须是 \\n（反斜杠+n），不能是 \n ——
^^^^
这个 \n 被 Python 变成真换行
**注释为了举例说明「不能写 \n」，自己写了一个 \n。**
于是注释被断成两行，把整段 JS 弄坏了。
== 修法 ==
注释改成**一个转义序列都不写**，只用文字描述：
// ⚠ 下面 prompt 里的换行，必须写成「反斜杠 + n」两个字符。
// 本文件是普通三引号字符串：只写反斜杠 + n，Python 会把它
// 变成**真实换行** ... （一个转义都不出现）
并把"踩过两次"的历史写进注释，提醒后人别再来第三次。
== 新增两个测试（防止再犯）==
1. `_tests/test_admin_js_syntax.py`（已注册为回归阶段 3a6）
**本地渲染管理页**，把 <script> 抠出来喂给 `node --check`，
还检查注释行里有没有裸控制字符。
为什么原来查不出来：已有的「管理页 JS 合法性」阶段只检查
token 在不在，不查语法 —— 「23 项测试通过」和「功能能用」
是两件事。
2. `_build/scan_admin_escapes.py`
扫源文件里"注释下一行不像 JS 代码"的可疑断行。
3. `_tests/test_admin_live.py`
在**真实中转**上走 HTTP 实测两个新功能（不能进回归套件，
因为它依赖线上设备）：
一、管理页能打开（带 X-Admin 头绕开登录页）
二、页面里真的有 allowNew 和改码按钮
三、内嵌 JS 语法合法
四、关掉接入开关 -> 新设备被拒 -> 打开 -> 能注册（实测通过）
五、改配对码 -> 真的变了（实测通过）
六、不带 X-Admin 访问管理接口返回 401（实测通过）
实测结果：16/17 通过（唯一的失败就是上面那个 JS bug，
已修，本地渲染 6/6 通过）。
== 顺带纠正一个我自己的误解 ==
我一开始只带 `?key=` 访问管理页，拿到的是**登录页**，
还以为是设备上部署了旧版本。实际是管理页改成了
**账号 + 密码登录 + Cookie 会话**（用户要求），
脚本通道用 `X-Admin` 头（见 relay.py 的 _admin_gate）。
== 部署时机 ==
**故意没有立刻部署到设备上** —— 部署要重启中转服务，
会打断 relay-stability 正在跑的隧道配比 A/B 对照。
等对照跑完（约 22:00）再部署并复测。
|
2026-10-07 20:33:27 +08:00 |
|
|
xmz7891
|
e611b07fb1
|
纠正一个传出去的错误结论：不是「运营商封了 UDP」
我在给部署脚本的指示里写过：
实测这条线路上运营商对 UDP 有限制 ——
12 个 Cloudflare edge IP：TCP 12/12 通、UDP 0/12 通
它照这个把注释写进了 relay/deploy.sh。
**但这个测量是无效的。** relay-stability 后来自己纠正了：
那个 UDP 探测包是手搓的简化包，格式不对，
Cloudflare 本来就不该回应它 —— 「0/12 无回应」什么都证明不了。
用 cloudflared --loglevel debug 跑临时实例，真相是：
UDP Connectivity region1/region2 PASS QUIC connection successful
SUMMARY: Environment is healthy. cloudflared will use 'quic'
Registered tunnel connection （握手 1 秒）
**UDP 完全通。**
真因是：QUIC 建连要 6+ 个包往返，而 TCP 的 SYN 只有 3 个包、
内核还会按 1s/2s/4s 激进重传。约 5.4%/包 丢包下：
(1 - 0.054)^6 ≈ 72% <- 和实测的 72% 对得上
所以 QUIC 的弱点在「连不上」，不在「连上之后不好」；
一旦连上，它没有 TCP 的跨流队头阻塞，反而更稳。
结论的**用途**没变（还是要两条协议一起跑），但留着错误的根因注释会：
* 误导后人以为 UDP 被封 -> 可能做出「干脆别用 QUIC」的错误决定
* 掩盖真正可优化的方向（QUIC 握手对丢包敏感是链路物理属性，
只能靠 HTTP/2 兜底来绕，不是「运营商限制」）
改动：relay/deploy.sh 两处、_build/test_deploy_sh.sh 一处。
教训记一笔：**手搓协议包去探测可达性非常容易得出错误结论** ——
那个包格式不对，对方根本没义务回应。要么用官方工具的自检
（cloudflared 自己会打 UDP Connectivity PASS/FAIL），
要么别下结论。
|
2026-10-07 18:22:19 +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 |
|
|
xmz7891
|
d4f335b8f9
|
管理页新增：允许/禁止新设备接入 + 修改设备配对码
== 功能一：允许新设备接入开关 ==
关掉之后只有已经登记过的电脑能继续上线，没见过的新设备一律拒绝。
状态存在 relay_state.json 里，重启不丢。
判断新设备用的是 deviceId，不是配对码 ——
这一点很关键：管理员给老设备改过码之后，
那台设备必须仍然能进来；按码判断的话它会被自己的开关挡在外面。
测试里专门有一条 A3b 守这个行为。
被拒时回 blocked=True，让客户端能区分被管理员挡了
和配对码冲突，而不是去匹配中文错误文案（文案一改就坏）。
== 功能二：修改任意设备的配对码 ==
管理页每台设备一个「改码」按钮，填 6 位数字即生效。
要点：
* 新旧码冲突检查
* 旧码映射必须删掉，否则变成孤儿条目，
管理页配对码占用的数字会虚高
* 改码踢掉该设备当前会话（会话绑在码上）
* 立刻持久化
== 顺手修掉两个真 bug ==
1. 改码功能一上线就 500：Session 用了 __slots__，
根本没有 session_id 属性（会话是以 token 为 key 存在 dict 里的），
写 s.session_id 直接 AttributeError。
改成遍历 sessions.items() 拿 key。
2. snapshot() 里有同样的错（清理超时设备那段）：
平时 stale 列表是空的所以从没炸过，一旦真有设备超过 6 小时
没上报就会 500。这次一起修了。
== 管理页 UI ==
* 设备小节加了「允许新设备接入」勾选框
* 每行加「改码」按钮（走 prompt，不引入弹窗层）
* 改码按钮用 data-recode 而不是 data-device ——
现有单台删除按 button.danger[data-device] 绑，
带上 data-device 会被当成删除按钮，点改码变删设备。
测试 C6 专门断言这一点。
== 测试 ==
新增 _tests/test_admin_device_control.py（23 项），
已注册进 _tests/verify_all.ps1 第 3e 阶段。
|
2026-10-07 17:01:14 +08:00 |
|
|
xmz7891
|
351171e6ea
|
清理对外材料里的中转管理后台 + 把规矩变成测试
用户定的新规矩：
「你对外公开的数据里不要包含那个中转站管理的页面，你就只能提官网」
用户确认的范围：只清理「我对外的公开发言」
（发布说明 / 更新日志 / 官网 / README / 我给出的汇报），
服务端 zip 里的运维文档保留（装服务器的人需要它），
源码实现保留（路径是功能本身，藏起来没法维护）。
清掉的内容：
* CHANGELOG.md：1.8.0 条目里"管理后台重做"整段、
"管理页显示成一屏源码"、"管理页标题被切掉"；
1.7.1 条目里**直接写出的路径 /zhongzhuanzhan**、
"管理入口从官网上移除"；1.7.0 的"管理页加图标"
* RELEASE-1.8.0.md：第四节「中转管理后台完全重做」整节删掉，
改成「官网重新设计」
新增 _build/test_public_clean.py（15 项）并加进套件（阶段 3b7）：
* CHANGELOG / README / docs 里不许出现
zhongzhuanzhan、/admin、管理后台、管理页、管理入口、admin_password
* 官网渲染出来的 HTML 逐词检查，且站内链接只允许
指向 /download/、/shot/、首页、图标、页内锚点
* 发布说明里不许出现安装教程类内容（用户要求只放更新内容）
为什么写成测试：文档没人看。这一天里我因为"以为记住了"
翻了三次车，所以把规矩变成会红的断言。
新增 docs/项目规矩.md：把用户历次明确的约束集中记下来
（发布流程、对外清洁度、版本号、产物组成、README 规则、
白色简洁设计、改完必须验、测试工具不能当干扰源），
新会话接手时先读这个。
顺带修的工程问题（今天反复踩的坑）：
* 用 PowerShell 的 @"..."@ 嵌 Python 去改 .ps1 时，
PowerShell 会先把 $var 展开成空，写进去一堆反斜杠
-> verify_all.ps1 被写坏，& 语法报错
现在改 .ps1 一律用 Python 读写文件
* re.sub 的替换串会解释反斜杠转义，
`"\\test_public_clean.py"` 里的 \t 变成制表符，
路径成了 "_build<TAB>est_public_clean.py"
-> 用 lambda 替换，避开转义
验收：全量回归 34 个阶段全部通过（含新的清洁度守卫）。
|
2026-10-07 12:15:32 +08:00 |
|
|
xmz7891
|
fe3b9ada12
|
修管理页 Content-Type（浏览器显示成一屏源码）
用户截图：打开 relay.xxmxxs.top/zhongzhuanzhan 看到的**不是页面，
而是整页 HTML 源码**。
根因：_send() 的 content_type 参数默认是 application/json，
我重做管理页时调它没传 text/html —— 浏览器按 JSON/纯文本处理，
就把 HTML 原样显示了。
⚠ 更该反省的是：**我当时没发现。**
验证脚本只看了 HTTP 200 和字节数，两个都对，就以为没问题。
200 不等于页面能看 —— 响应头也得看。
顺手修的第二个问题：
HEAD 请求一律返回 501 Unsupported method（没实现 do_HEAD）。
浏览器用 GET 所以页面照开，但 Cloudflare 健康检查、
很多监控/代理探测都用 HEAD，curl -I 也是。
补了 do_HEAD：按路径算出类型和长度，只回头不回体。
新增测试 _build/test_response_headers.py（9 项）：
* HEAD 各路径不能是 501
* 官网/管理页 Content-Type 必须是 text/html，不能是 json
* favicon、产品截图必须是 image/*
并加进全量套件（阶段 3b6）。
验证：该测试 9/9 通过；全量套件 33 个阶段全部通过。
|
2026-10-07 09:53:43 +08:00 |
|
|
xmz7891
|
c7c0484a27
|
修安装包卸载卡死的真凶：attach_console 在无控制台时阻塞
排查过程（一步步排除，记录下来免得以后重踩）：
1. 现象：从控制面板卸载，进度条永远走不完。
2. 先怀疑 input()：安装器用 runhidden 调 --uninstall，没有 stdin，
input() 会一直等。加了 isatty 保护 —— **没解决**。
3. 再怀疑 Popen 没重定向 stdio：_schedule_self_delete 起的 cmd
继承了父进程句柄，capture_output 会等管道 EOF。加了
DEVNULL 重定向 —— **还是卡**。
4. 又发现 _kill_running 用 taskkill /IM ykxmz.exe 把正在卸载的
自己杀了（--uninstall 就跑在 ykxmz.exe 里），
导致后面的"删自启/删数据"没执行。改成 /FI "PID ne self" ——
自启能删了，**卸载仍然卡**。
5. 最后看进程状态才定位：卡住的 ykxmz.exe 只有 **1 个线程、
0.16 秒 CPU、19MB 内存** —— 明显停在启动早期，根本没干活。
那就是 cli_uninstall 第一行的 attach_console()：
它对 --windowed 程序调 AllocConsole()，再 open("CONIN$")。
在没有控制台的隐藏进程里，这一步**永久阻塞**。
修法：加 --quiet。安装包的卸载器用
ykxmz.exe --uninstall --keep-dir --quiet
--quiet 下完全不碰控制台（不 AllocConsole、不 input），
结果写进 uninstall.log 供排查。
实测：不带 --quiet 无限卡住；带了 **0.6 秒返回**。
顺带修的两处（也是实测发现的）：
* 安装器关不掉以管理员身份运行的旧实例 -> Inno 弹"无法关闭所有
应用程序"，静默下被压成"终止"，**整个安装回滚**。
改成 PrepareToInstall 里自己 taskkill /F。
* 测试脚本把注册表路径写成 HKCU\...（少了冒号），
PowerShell 静默返回空，"开机自启"永远误报失败。
最终实测（test_installer_cycle.py，20 项）：
静默安装 退出码 0，7.1 秒
配对码 正确写入 C:\ProgramData\ykxmz\data\settings.json
进程/端口 在跑，8765 监听
开机自启 已设置
静默卸载 1.2 秒
卸载清理 安装目录 / 数据目录 / 注册表 / 进程 / 自启 全部干净
20 项全通过
套件新增一个阶段：「安装包完整周期」。
|
2026-10-07 02:21:36 +08:00 |
|
|
xmz7891
|
1e73a789d1
|
测试套件：锁屏识别 + 退出码取法 + BOM 兜底
一、锁屏时截屏类测试误报
电脑锁屏后，test_agent_protocol 的 5 项截屏断言、以及两个
Java 端到端阶段必然失败 —— 但那是环境限制，不是代码问题。
不区分的话汇总表一片红，真正的失败反而被淹没。
现在启动时用 OpenInputDesktop 探测，锁屏时这些阶段记
SKIP(锁屏) 而不是 FAIL，并在开头黄字提示。
二、管道后读 $LASTEXITCODE 不可靠
形如
& python xxx.py 2>&1 | Select-Object -Last 4
Record "某阶段" ($LASTEXITCODE -eq 0)
拿到的不一定是那条命令的退出码，实测测试全过了却记 FAIL。
改成先把码存进变量再走管道。共修 4 处。
三、edit 工具会剥掉 .ps1 的 UTF-8 BOM
没有 BOM 的 .ps1 会被 PowerShell 按 GBK 读，中文全乱码，
接着一堆 "Unexpected token" 语法错误，脚本直接跑不了。
这个坑今天踩了两次。加了 _build/fix_ps1_bom.py 统一补 BOM，
并顺带检查 .bat 是不是 GBK。
跑出来：33 个阶段 —— 30 PASS + 3 SKIP(锁屏)，0 FAIL。
|
2026-10-07 01:57:20 +08:00 |
|
|
xmz7891
|
df8056dd16
|
修四个安装/卸载卡死的 bug（都实测复现过）
1. 卸载里 input() 在无 stdin 时永久阻塞
从控制面板卸载**永远卡住不结束**。安装包的 [UninstallRun]
用 runhidden 调用，没有 stdin，input() 就一直等。
改成只在 sys.stdin.isatty() 时才等回车。
2. Popen 没重定向子进程 stdio，导致 capture_output 等管道 EOF
_schedule_self_delete 起的 cmd 继承了父进程的 stdout/stderr 句柄，
任何用 capture_output 调 --uninstall 的地方都会一直等，
表现为"程序卡死"（实测 90 秒不返回，改后 0.2 秒）。
Popen 加 stdin/stdout/stderr=DEVNULL。
顺带把延迟从 timeout 换成 ping —— timeout 在 DETACHED_PROCESS
下没有控制台会立刻失败，等于没延迟直接删。
3. _kill_running 用 taskkill /IM ykxmz.exe 把**自己**杀了
--uninstall 本身就跑在 ykxmz.exe 里，这条命令一发，
后面的"删开机自启""删数据目录"全都没执行。
现象：卸载看着完成了，HKCU 的自启注册表项还留着。
改成 /FI "PID ne <self>" 排除自己。
4. 安装器关不掉以管理员身份运行的旧实例 -> 整个安装回滚
Inno 自带机制只会"请求"对方退出，遇上常驻的服务进程关不掉，
弹"无法自动关闭所有应用程序"，静默模式下被压成"终止"，
安装直接回滚 —— 用户看到的是"装了没反应/还是旧版本"。
改成 PrepareToInstall 里自己 taskkill /F，关掉 Inno 那套。
另外修了两个卸载残留：
* 安装目录留个空壳 -> [UninstallDelete] 加 dirifempty
* ProgramData\ykxmz 没删 -> 加进 [UninstallDelete]
还有一处 Inno 写法陷阱（踩了三次）：
注释里写 [区段名] 或 {常量} 会让编译直接失败，
因为 [Code] 解析器连注释内容也处理。
加了 _build/check_iss.py 专门扫这个，并进全量套件。
实测结果：
静默安装 5 秒内退出，退出码 0，配对码正确写入，程序自动跑起来
静默卸载 0.7 秒退出（原来无限卡住）
全量回归 29 项全通过
卸载逻辑 11 项全通过
|
2026-10-07 01:19:11 +08:00 |
|
|
xmz7891
|
566d9e384f
|
阶段1+2：恢复 HTTP/2 加速 + 重做官网
阶段1 网络加速
- 发现隧道在跑 QUIC（ExecStart 丢了 --protocol http2），
实测 QUIC 可用率 48% vs HTTP/2 80%+，是重大性能回退。
恢复后公网延迟从 4141ms 降到 690ms（快 6 倍），可用率 92%。
- 优选 IP 结论：无效。hosts 覆盖确实生效了（日志里连的就是指定 IP），
但落点仍是 lax —— 运营商把所有 Cloudflare anycast 都路由到美西。
已清掉这段无效配置。
- BBR 不可用：设备是自定义内核 6.4.0-rc4-jsbsbxjxh66，
没编 tcp_bbr 模块也没配置项。改用 cubic + 调优：
TCP 缓冲 4MB、tcp_fastopen=3、tcp_slow_start_after_idle=0
（长轮询场景关键）、tcp_tw_reuse=1。
阶段2 官网重做
- 拆出独立模块 relay/landing.py（relay.py 已两千多行，
再塞 HTML 没法看）
- 信息结构参考成熟产品站：吸顶导航 / Hero / 九宫格功能 /
三步上手 / 下载 / FAQ / 页脚
- 保持白色简洁：底白、浅灰面板、细边框、大量留白
- logo 用内联 SVG（ICO 放 img 里实测是破图）
- 管理入口从官网移除（管理不对外开放）
过程中被自己的测试抓到两个 bug：
- 模块叫 site.py 会和 Python 标准库重名，import site 拿到的是标准库
- _logo() 里把 % 格式化和字符串拼接混用，直接抛 TypeError
|
2026-10-06 23:53:19 +08:00 |
|
|
xmz7891
|
65dc2fad65
|
1.6.1：常规发布
- 版本号 1.6.1 -> 1.6.1
- 重建三端并打包
- 关键测试全过
|
2026-10-06 23:08:07 +08:00 |
|
|
xmz7891
|
8111fb6d97
|
ykxmz 1.5.0：手表端 TLS 证书兼容 + 三端分开打包 + 下载区
手表端
- 内置 GTS Root R4 / GlobalSign Root CA
修 SSLHandshakeException: Chain validation failed
- 连接错误翻译成人话：证书 / 时间 / 解析 / 超时分别给提示
- 经中转连上后用服务器报的地址刷新已配对记录
- 版本号 1.3.0 -> 1.5.0（AndroidManifest 之前漏改了）
服务器端
- 支持 chunked 请求体，修每 16 秒一次的连接错乱与大面积 502
- 网络调优 net-tune.sh（开机自动应用）
- 新增下载区，管理页加下载卡片
- 隧道改 HTTP/2 + 双连接
打包方式变更
- 从一个合并 zip 改成三个独立产物：
ykxmz-agent-*.zip 被控端
ykxmz-server-*.zip 服务器端
ykxmz-watch-*.apk 控制端
|
2026-10-06 23:08:05 +08:00 |
|
|
xmz7891
|
b62ac865ea
|
ykxmz 1.5.0：修复手表端 TLS 证书校验 + MTU 修复网络稳定性
被控端
- 修复 MTU 问题：夹 MSS + 路径 MTU 探测（公网可用率 48% -> 100%）
- 复用 HTTP 连接（免掉每次新建 TLS 的 30% 握手失败）
- 每分钟回头找局域网，自动切回快 400 倍的路径
- 画面心跳帧：静止时省流量，客户端仍知道流是活的
- 锁屏时给出可操作的提示
手表端
- 内置 GTS Root R4 / GlobalSign Root CA，修 SSLHandshakeException
- 连接错误翻译成人话（证书/时间/解析/超时分别提示）
- 经中转连上后用服务器报的地址刷新已配对记录
- 新增局域网连接页面、服务器延迟检测
服务器端
- 支持 chunked 请求体（修每 16 秒一次的连接错乱与大面积 502）
- 网络调优脚本 net-tune.sh（开机自动应用）
- 管理页：批量删除、网络体检、下载区
- 隧道改 HTTP/2 + 双连接
文档
- 许可协议 / 安装前必读 / 安装后须知（作者：小麦子）
|
2026-10-06 19:01:05 +08:00 |
|