xmz7891/ykxmz
1
0
Fork 0
mirror of https://gitee.com/xmz7891/ykxmz.git synced 2026-10-19 13:00:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

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

Browse Source 
按用户定的规矩，这一轮有新功能，升第二位：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
Download Patch File Download Diff File Expand all files Collapse all files
_tests/test_sfx.py
+163
View File
@@ -0,0 +1,163 @@
# -*- coding: utf-8 -*-
"""网络热门音效 —— 生成 / 列表 / 播放 / 自己放素材。
用户要求：「再加上近期网络热门音效，什么冰冰冰，啊哈哈哈哈，各种
老牧师音效，可以直接远程播放」。
⚠ 版权说明（这个测试也在钉这件事）：
「冰冰冰」「啊哈哈哈」「老牧师」是**网上流行的真实录音**，有版权。
安装包里内置的是**程序合成**的版本（正弦/方波现场算），
名字对着感觉来，但不是那些录音本身、也不冒充。
用户想用一模一样的一手素材，丢进 data/sfx/ 就行 —— 这一条也要测。
"""
from __future__ import annotations
import struct
import sys
import tempfile
import time
import wave
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
sys.path.insert(0, str(ROOT / "windows"))
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 main() -> int:
print("=" * 62)
print(" 网络热门音效（可远程播放）")
print("=" * 62)
from lanremote.sfx import Sfx, BUILTIN_SPECS, SfxError, USER_EXTS
work = Path(tempfile.mkdtemp(prefix="sfx_"))
# ---------------------------------------------------------------- 一
print(" ---- 一、用户点名的三个必须在 ----")
s = Sfx(work / "data")
t0 = time.time()
made = s.ensure_builtin()
took = time.time() - t0
check("首次运行能生成内置音效", made >= 3, "只生成了 %d 个" % made)
check("生成够快（< 3 秒）", took < 3.0, "用了 %.2f 秒" % took)
names = [it["name"] for it in s.list_sfx()]
print(" 生成的：%s" % "、".join(names))
for wanted in ("冰冰冰", "啊哈哈哈", "老牧师"):
check("有「%s」" % wanted, wanted in names, "列表里没有")
# ---------------------------------------------------------------- 二
print(" ---- 二、生成的是合法 WAV（真的能放）----")
for it in s.list_sfx():
p = s.dir / it["file"]
try:
with wave.open(str(p)) as w:
ch = w.getnchannels()
sr = w.getframerate()
n = w.getnframes()
frames = w.readframes(min(n, 2000))
ok = (ch == 1 and sr == 16000 and n > 1000 and len(frames) > 0)
check("%s 是合法 WAV（%d Hz, %.2f 秒）" % (it["name"], sr, n / sr),
ok, "ch=%s sr=%s n=%s" % (ch, sr, n))
except Exception as exc: # noqa: BLE001
check("%s 是合法 WAV" % it["name"], False,
"%s: %s" % (type(exc).__name__, exc))
# ---------------------------------------------------------------- 三
print(" ---- 三、有声音（不是一片静音）----")
p = s.dir / "冰冰冰.wav"
with wave.open(str(p)) as w:
raw = w.readframes(w.getnframes())
vals = struct.unpack("<%dh" % (len(raw) // 2), raw[: (len(raw) // 2) * 2])
peak = max(abs(v) for v in vals)
nonzero = sum(1 for v in vals if abs(v) > 50)
check("峰值够大（有声）", peak > 8000, "峰值只有 %d" % peak)
check("不是全静音", nonzero > len(vals) * 0.2,
"只有 %.0f%% 的采样有声音" % (100.0 * nonzero / max(1, len(vals))))
check("没有削顶爆音（峰值不超过 int16 上限）", peak <= 32767)
# ---------------------------------------------------------------- 四
print(" ---- 四、用户自己放素材 ----")
# 造一个假的 mp3（内容不重要，只看"能不能被列出来/能不能被解析到"）
fake = s.dir / "我自己的素材.mp3"
fake.write_bytes(b"\xff\xfb\x90\x00" + b"\x00" * 500)
names2 = [it["name"] for it in s.list_sfx()]
check("用户放的素材出现在列表里", "我自己的素材" in names2,
"列表：%s" % names2)
check("用户素材标记为非内置",
any(it["name"] == "我自己的素材" and not it["builtin"]
for it in s.list_sfx()))
check("内置的仍在", "冰冰冰" in names2)
check("能解析到用户素材的路径",
s.resolve("我自己的素材").name == "我自己的素材.mp3")
check("能按带后缀的名字解析",
s.resolve("我自己的素材.mp3").name == "我自己的素材.mp3")
# ---------------------------------------------------------------- 五
print(" ---- 五、播放（用假播放器，别真出声）----")
played = []
s2 = Sfx(work / "data", player=lambda path: (played.append(path),
"正在播放")[1])
msg = s2.play("冰冰冰")
check("play() 调用了播放器", len(played) == 1, "调用 %d 次" % len(played))
check("传给播放器的是生成的 WAV", played and played[0].endswith("冰冰冰.wav"),
played[0] if played else "没调用")
check("返回了提示文字", "播放" in msg, repr(msg))
# ---------------------------------------------------------------- 六
print(" ---- 六、出错路径 ----")
for bad in ("", "根本没有这个音效", "../../etc/passwd", None):
try:
s2.resolve(bad or "")
check("拒绝 %r" % (bad,), False, "居然解析成功了")
except SfxError:
check("拒绝 %r" % (bad,), True)
except Exception as exc: # noqa: BLE001
check("拒绝 %r" % (bad,), False,
"抛了别的异常 %s" % type(exc).__name__)
# ---------------------------------------------------------------- 七
print(" ---- 七、目录里有说明文件（用户能找到去哪放素材）----")
# ⚠ 别用 glob("*.txt") 取第一个 —— 目录里还有 .builtin.txt
# （生成清单），它的排序可能排在说明文件前面，
# 于是读到的是清单内容、断言全红。按名字精确取。
readme_path = s.dir / "放这里.txt"
check("sfx 目录里有说明文件", readme_path.is_file(),
"没有说明文件 -> 用户不知道往哪放素材")
if readme_path.is_file():
body = readme_path.read_text(encoding="utf-8", errors="replace")
check("说明里写了「放进来就能用」",
"放" in body and ("mp3" in body or "wav" in body))
check("说明里讲清了内置的是合成的（版权说明）",
"合成" in body or "版权" in body)
# ---------------------------------------------------------------- 八
print(" ---- 八、删掉内置音效后不会又被生成回来 ----")
target = s.dir / "叮.wav"
if target.is_file():
target.unlink()
s.ensure_builtin()
check("删掉的内置音效不会自动重生", not target.is_file(),
"又被生成回来了 -> 用户删不掉")
print()
print("=" * 62)
print(" 通过 %d 项，失败 %d 项" % (passed, failed))
return 0 if failed == 0 else 1
if __name__ == "__main__":
sys.exit(main())