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 个阶段全部通过。
This commit is contained in:
xmz7891
2026-10-08 18:36:50 +08:00
parent 50f4e1fb6f
commit 3f18e6bb40
203 changed files with 6645 additions and 1996 deletions
+188
View File
@@ -0,0 +1,188 @@
# -*- coding: utf-8 -*-
"""后台「抢救报告」分区 —— 渲染 + 下载 + 不缓存。
用户要求:
「如果紧急预案未能解决,则将问题打包成 .txt,然后在后台加一个
分区专门放还有下载这个 txt」
这个测试把两侧都验一遍:
一、后台页能渲染出「抢救报告」分区(没有报告时给正面提示)
二、有报告时能列出,并带正确的下载链接
三、/rescue/<名字> 能下载到,而且**不发长缓存**(和 /download/ 不同)
四、文件名校验能挡住目录穿越
五、报告目录空 / 不存在时不能把后台页搞崩
"""
from __future__ import annotations
import importlib.util
import os
import re
import sys
import tempfile
import time
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
RELAY_DIR = ROOT / "relay"
passed = 0
failed = 0
def check(name, ok, detail=""):
global passed, failed
if ok:
passed += 1
print(" [PASS] " + name)
else:
failed += 1
print(" [FAIL] " + name + ((" —— " + str(detail)) if detail else ""))
def load(name: str, path: Path):
spec = importlib.util.spec_from_file_location(name, path)
mod = importlib.util.module_from_spec(spec)
sys.modules[name] = mod
spec.loader.exec_module(mod)
return mod
def main() -> int:
print("=" * 62)
print(" 后台「抢救报告」分区")
print("=" * 62)
sys.path.insert(0, str(RELAY_DIR))
os.chdir(RELAY_DIR)
try:
relay = load("relay_under_test", RELAY_DIR / "relay.py")
admin = load("admin_under_test", RELAY_DIR / "admin.py")
finally:
os.chdir(ROOT)
snap = {"version": "2.0.0", "uptimeSeconds": 123,
"devices": [], "allowNew": True}
# ---------------------------------------------------------------- 一
print(" ---- 一、没有报告时 ----")
try:
html = admin.render_admin(snap, "https://x", "/zhongzhuanzhan", 0,
lambda: [], rescue_fn=lambda: [])
ok = True
err = ""
except Exception as exc: # noqa: BLE001
ok = False
err = "%s: %s" % (type(exc).__name__, exc)
html = ""
check("后台页能渲染(不抛异常)", ok, err)
check("有「抢救报告」分区", "抢救报告" in html)
check("没有报告时给正面提示(不是干巴巴的暂无数据)",
"还没有报告" in html, "没找到提示语")
check("渲染出的页面有实际内容", len(html) > 2000, "%d 字符" % len(html))
# ---------------------------------------------------------------- 二
print(" ---- 二、有报告时能列出来 ----")
items = [
{"name": "20261008-173000.txt", "size": 4200,
"mtime": time.time() - 60,
"summary": "本机是好的,问题在隧道或 Cloudflare 那一侧"},
{"name": "20261007-220000.txt", "size": 900,
"mtime": time.time() - 90000, "summary": ""},
]
html2 = admin.render_admin(snap, "https://x", "/zhongzhuanzhan", 0,
lambda: [], rescue_fn=lambda: items)
check("列出了第一份报告的时间", "10-08" in html2 or "2026100" in html2
or "17:30" in html2)
check("带下载链接 /rescue/", "/rescue/20261008-173000.txt" in html2,
"没找到链接")
check("显示了结论摘要", "问题在隧道" in html2)
check("没有摘要的那份显示占位文字", "没有结论行" in html2)
check("两份都列出来了",
html2.count("/rescue/") >= 2, "只出现 %d 次" % html2.count("/rescue/"))
# ---------------------------------------------------------------- 三
print(" ---- 三、文件名校验(防目录穿越)----")
good = relay._safe_rescue_name("20261008-173000.txt")
check("正常时间戳名通过", good == "20261008-173000.txt", repr(good))
for bad in ("../etc/passwd", "a/b.txt", "..\\x.txt", "x.sh",
"x.txt/../y", "", "a" * 200 + ".txt"):
check("挡住 %r" % bad[:24], relay._safe_rescue_name(bad) == "",
"居然通过了")
# ---------------------------------------------------------------- 四
print(" ---- 四、下载路由的行为 ----")
src = (RELAY_DIR / "relay.py").read_text(encoding="utf-8")
get_part = src.split("def do_GET")[1].split("def do_POST")[0]
head_part = src.split("def do_HEAD")[1].split("def do_GET")[0]
def rescue_block(part: str) -> str:
"""取出整个 /rescue/ 分支。
⚠ 不能用 part.split("/rescue/")[1] —— "/rescue/" 在这个分支里
出现两次(startswith 和切片),split 出来的是两个之间的
短片段,什么都查不到。我第一次就是这么把测试写红的。
改成从 startswith 那句开始、到下一个 if 分支为止。
"""
key = 'if path.startswith("/rescue/")'
i = part.find(key)
if i < 0:
return ""
j = part.find('if path.startswith("', i + len(key))
return part[i:j] if j > i else part[i:i + 2000]
gb = rescue_block(get_part)
hb = rescue_block(head_part)
check("do_GET 里有 /rescue/ 路由", bool(gb))
check("do_HEAD 里有 /rescue/ 路由", bool(hb))
check("下载发 no-store(不能给边缘缓存)", "no-store" in gb,
"没看到 no-store")
check("下载设了 Content-Disposition(点了是下载不是预览)",
"Content-Disposition" in gb)
check("do_HEAD 那段不写 body", "wfile.write" not in hb,
"HEAD 里出现了 wfile.write")
# 鉴权 —— 这条是实测踩出来的安全问题:
# 报告里有内网 IP、进程表、日志尾部、MTU/路由/iptables,
# 第一版把路由插在 _admin_gate() 之前,等于匿名可下。
check("do_GET 里 /rescue/ 要求登录", "_admin_gate" in gb,
"没有鉴权 -> 任何人都能下诊断报告")
check("do_HEAD 里 /rescue/ 要求登录", "_admin_gate" in hb,
"没有鉴权")
# 顺序也要对:鉴权必须在读文件之前
if gb:
check("先鉴权再读文件",
gb.find("_admin_gate") < gb.find("read_bytes"),
"顺序反了:先读了文件才鉴权")
# ⚠ 鉴权失败必须**自己发响应**。_admin_gate() 只返回布尔值,
# 裸 return 在 BaseHTTPRequestHandler 里就是什么都不做 ——
# 连接保持、没有响应头,客户端一直等到超时(curl HTTP 000)。
# 实测踩过:/rescue/ 会挂住 8 秒,比报 401 严重得多。
# 查整个分支,别用 split("_admin_gate()") 切片 ——
# 注释里也会提到 _admin_gate(),切出来的可能是注释后面那一小段,
# 查不到真正的 _json(401。(这个测试第一次就是这么假红的。)
if gb:
check("do_GET 鉴权失败会发 401", "_json(401" in gb,
"裸 return -> 请求会挂到超时")
if hb:
check("do_HEAD 鉴权失败会发 401", "no(401)" in hb,
"裸 return 或状态码不对")
# ---------------------------------------------------------------- 五
print(" ---- 五、报告目录不存在也不能崩 ----")
try:
r = relay._list_rescue_reports()
check("_list_rescue_reports() 不抛异常", isinstance(r, list))
except Exception as exc: # noqa: BLE001
check("_list_rescue_reports() 不抛异常", False,
"%s: %s" % (type(exc).__name__, exc))
print()
print("=" * 62)
print(" 通过 %d 项,失败 %d 项" % (passed, failed))
return 0 if failed == 0 else 1
if __name__ == "__main__":
sys.exit(main())