mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 13:40:45 +00:00
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
@@ -0,0 +1,256 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
r'''在**隐藏的 Windows 桌面**上跑命令，用户屏幕不受打扰。
|
||||
|
||||
== 为什么需要 ==
|
||||
|
||||
用户原话：「把全量测试改为在后台静默运行不要打开任何窗口或锁屏」。
|
||||
|
||||
有几个测试必须开**真实的窗口**才测得出东西，不能改成假的：
|
||||
|
||||
test_image_modes 投图窗口的三种显示方式（含**全屏**）
|
||||
test_indicator_visible 屏幕共享提示条 + Win32 窗口枚举
|
||||
fuzz_features 功能模糊测试
|
||||
test_first_run_setup 首次设置窗口
|
||||
|
||||
问题是它们跑的时候会在用户屏幕上一通闪，**全屏那个还会把屏幕锁住**，
|
||||
用户根本没法用电脑。
|
||||
|
||||
== 解法 ==
|
||||
|
||||
Windows 支持多个"桌面"（Desktop）—— 同一个登录会话里可以有若干个，
|
||||
但**只有一个是当前显示给用户的**（叫 Default）。
|
||||
我们新建一个桌面，把测试进程放上去：
|
||||
|
||||
CreateDesktopW("ykxmz-test", ...) 建一个不显示的桌面
|
||||
CreateProcessW(..., lpDesktop=那个名字) 把子进程放上去
|
||||
子进程里所有窗口都创建在那个桌面上 -> 用户完全看不到
|
||||
跑完 CloseDesktop
|
||||
|
||||
这样窗口是**真的**（窗口句柄、几何、可见性、Win32 枚举全都真实），
|
||||
只是不在用户眼前 —— 测试有效性一点没损失。
|
||||
|
||||
== 为什么不用别的方法 ==
|
||||
|
||||
* "把窗口设成透明/最小化" —— 那就测不出全屏了，而且还是会闪
|
||||
* "跳过这些测试" —— 投图和提示条是核心功能，不能因为烦就不测
|
||||
* "用无头模式" —— 那测的就不是真实窗口了
|
||||
|
||||
== 用法 ==
|
||||
|
||||
命令行：
|
||||
python _tests/hidden_desktop.py -- <要跑的命令...>
|
||||
|
||||
代码里：
|
||||
from hidden_desktop import run_hidden
|
||||
code, out = run_hidden(["python", "test_image_modes.py"], timeout=300)
|
||||
'''
|
||||
from __future__ import annotations
|
||||
|
||||
import ctypes
|
||||
import ctypes.wintypes as wt
|
||||
import os
|
||||
import subprocess
|
||||
import sys
|
||||
import tempfile
|
||||
import time
|
||||
import uuid
|
||||
from pathlib import Path
|
||||
|
||||
IS_WINDOWS = os.name == "nt"
|
||||
|
||||
# ---- Win32 常量和结构 ----
|
||||
|
||||
# 桌面权限：给足，否则 CreateProcess 放上去之后子进程建不了窗口
|
||||
DESKTOP_ALL_ACCESS = 0x000F01FF
|
||||
GENERIC_ALL = 0x10000000
|
||||
|
||||
CREATE_NEW_CONSOLE = 0x00000010
|
||||
CREATE_UNICODE_ENVIRONMENT = 0x00000400
|
||||
WAIT_TIMEOUT = 0x00000102
|
||||
INFINITE = 0xFFFFFFFF
|
||||
|
||||
|
||||
class STARTUPINFOW(ctypes.Structure):
|
||||
_fields_ = [
|
||||
("cb", wt.DWORD),
|
||||
("lpReserved", wt.LPWSTR),
|
||||
("lpDesktop", wt.LPWSTR),
|
||||
("lpTitle", wt.LPWSTR),
|
||||
("dwX", wt.DWORD),
|
||||
("dwY", wt.DWORD),
|
||||
("dwXSize", wt.DWORD),
|
||||
("dwYSize", wt.DWORD),
|
||||
("dwXCountChars", wt.DWORD),
|
||||
("dwYCountChars", wt.DWORD),
|
||||
("dwFillAttribute", wt.DWORD),
|
||||
("dwFlags", wt.DWORD),
|
||||
("wShowWindow", wt.WORD),
|
||||
("cbReserved2", wt.WORD),
|
||||
("lpReserved2", ctypes.POINTER(ctypes.c_byte)),
|
||||
("hStdInput", wt.HANDLE),
|
||||
("hStdOutput", wt.HANDLE),
|
||||
("hStdError", wt.HANDLE),
|
||||
]
|
||||
|
||||
|
||||
class PROCESS_INFORMATION(ctypes.Structure):
|
||||
_fields_ = [
|
||||
("hProcess", wt.HANDLE),
|
||||
("hThread", wt.HANDLE),
|
||||
("dwProcessId", wt.DWORD),
|
||||
("dwThreadId", wt.DWORD),
|
||||
]
|
||||
|
||||
|
||||
def _api():
|
||||
user32 = ctypes.WinDLL("user32", use_last_error=True)
|
||||
kernel32 = ctypes.WinDLL("kernel32", use_last_error=True)
|
||||
|
||||
user32.CreateDesktopW.argtypes = [
|
||||
wt.LPCWSTR, wt.LPCWSTR, ctypes.c_void_p, wt.DWORD,
|
||||
wt.DWORD, ctypes.c_void_p]
|
||||
user32.CreateDesktopW.restype = wt.HANDLE
|
||||
|
||||
user32.CloseDesktop.argtypes = [wt.HANDLE]
|
||||
user32.CloseDesktop.restype = wt.BOOL
|
||||
|
||||
kernel32.CreateProcessW.argtypes = [
|
||||
wt.LPCWSTR, wt.LPWSTR, ctypes.c_void_p, ctypes.c_void_p, wt.BOOL,
|
||||
wt.DWORD, ctypes.c_void_p, wt.LPCWSTR,
|
||||
ctypes.POINTER(STARTUPINFOW), ctypes.POINTER(PROCESS_INFORMATION)]
|
||||
kernel32.CreateProcessW.restype = wt.BOOL
|
||||
|
||||
kernel32.WaitForSingleObject.argtypes = [wt.HANDLE, wt.DWORD]
|
||||
kernel32.WaitForSingleObject.restype = wt.DWORD
|
||||
|
||||
kernel32.GetExitCodeProcess.argtypes = [wt.HANDLE,
|
||||
ctypes.POINTER(wt.DWORD)]
|
||||
kernel32.GetExitCodeProcess.restype = wt.BOOL
|
||||
|
||||
kernel32.TerminateProcess.argtypes = [wt.HANDLE, wt.UINT]
|
||||
kernel32.CloseHandle.argtypes = [wt.HANDLE]
|
||||
return user32, kernel32
|
||||
|
||||
|
||||
def run_hidden(command, timeout: float = 600.0, cwd: str | None = None,
|
||||
log_path: Path | None = None) -> tuple:
|
||||
"""在隐藏桌面上跑命令。
|
||||
|
||||
返回 (退出码, 输出文本)。退出码 -1 表示建桌面失败（会自动退回
|
||||
直接在普通桌面跑，并说明原因 —— 宁可闪一下也不能让测试跑不了）。
|
||||
"""
|
||||
if not IS_WINDOWS:
|
||||
# 非 Windows 直接跑
|
||||
r = subprocess.run(command, cwd=cwd, capture_output=True, text=True,
|
||||
encoding="utf-8", errors="replace",
|
||||
timeout=timeout)
|
||||
return r.returncode, (r.stdout or "") + (r.stderr or "")
|
||||
|
||||
if log_path is None:
|
||||
log_path = Path(tempfile.gettempdir()) / (
|
||||
"ykxmz_hidden_%s.log" % uuid.uuid4().hex[:8])
|
||||
|
||||
user32, kernel32 = _api()
|
||||
name = "ykxmz-test-%s" % uuid.uuid4().hex[:8]
|
||||
|
||||
desk = user32.CreateDesktopW(name, None, None, 0,
|
||||
DESKTOP_ALL_ACCESS | GENERIC_ALL, None)
|
||||
if not desk:
|
||||
err = ctypes.get_last_error()
|
||||
# 建不了桌面（少见，通常是权限）—— 退回普通方式，但要说清楚
|
||||
r = subprocess.run(command, cwd=cwd, capture_output=True, text=True,
|
||||
encoding="utf-8", errors="replace",
|
||||
timeout=timeout)
|
||||
msg = (" [警告] 建隐藏桌面失败（Win32 错误 %d），"
|
||||
"这次只能在普通桌面上跑 —— 屏幕上可能会闪窗口。\n" % err)
|
||||
return r.returncode, msg + (r.stdout or "") + (r.stderr or "")
|
||||
|
||||
try:
|
||||
# 让子进程自己把输出重定向到文件 —— 走 CreateProcess 时
|
||||
# 管道不好接管，重定向到文件最简单可靠。
|
||||
# 用 cmd /c 是为了让 > 生效。
|
||||
quoted = subprocess.list2cmdline([str(c) for c in command])
|
||||
full = 'cmd.exe /c %s > "%s" 2>&1' % (quoted, log_path)
|
||||
# cmd /c 后面整串要作为一个参数传
|
||||
cmdline = ctypes.create_unicode_buffer(full)
|
||||
|
||||
si = STARTUPINFOW()
|
||||
si.cb = ctypes.sizeof(STARTUPINFOW)
|
||||
si.lpDesktop = name # <<< 关键：把子进程放到隐藏桌面
|
||||
pi = PROCESS_INFORMATION()
|
||||
|
||||
ok = kernel32.CreateProcessW(
|
||||
None, cmdline, None, None, False,
|
||||
CREATE_NEW_CONSOLE | CREATE_UNICODE_ENVIRONMENT,
|
||||
None, cwd, ctypes.byref(si), ctypes.byref(pi))
|
||||
if not ok:
|
||||
err = ctypes.get_last_error()
|
||||
r = subprocess.run(command, cwd=cwd, capture_output=True,
|
||||
text=True, encoding="utf-8",
|
||||
errors="replace", timeout=timeout)
|
||||
return r.returncode, (" [警告] 在隐藏桌面上启动失败"
|
||||
"（Win32 错误 %d）\n" % err
|
||||
) + (r.stdout or "") + (r.stderr or "")
|
||||
|
||||
try:
|
||||
waited = kernel32.WaitForSingleObject(pi.hProcess,
|
||||
int(timeout * 1000))
|
||||
if waited == WAIT_TIMEOUT:
|
||||
kernel32.TerminateProcess(pi.hProcess, 124)
|
||||
code = 124
|
||||
else:
|
||||
code = wt.DWORD()
|
||||
kernel32.GetExitCodeProcess(pi.hProcess, ctypes.byref(code))
|
||||
code = code.value
|
||||
finally:
|
||||
kernel32.CloseHandle(pi.hThread)
|
||||
kernel32.CloseHandle(pi.hProcess)
|
||||
|
||||
# 给文件一点时间落盘
|
||||
for _ in range(40):
|
||||
if log_path.is_file() and log_path.stat().st_size > 0:
|
||||
break
|
||||
time.sleep(0.05)
|
||||
try:
|
||||
out = log_path.read_text(encoding="utf-8", errors="replace")
|
||||
except OSError:
|
||||
out = ""
|
||||
return code, out
|
||||
finally:
|
||||
user32.CloseDesktop(desk)
|
||||
try:
|
||||
log_path.unlink()
|
||||
except OSError:
|
||||
pass
|
||||
|
||||
|
||||
def main() -> int:
|
||||
if not IS_WINDOWS:
|
||||
print(" 这个工具只在 Windows 上有意义")
|
||||
return 1
|
||||
args = sys.argv[1:]
|
||||
if args and args[0] == "--":
|
||||
args = args[1:]
|
||||
if not args:
|
||||
print(__doc__)
|
||||
return 1
|
||||
|
||||
print(" 在隐藏桌面上运行：%s" % " ".join(args))
|
||||
started = time.time()
|
||||
code, out = run_hidden(args, timeout=900)
|
||||
took = time.time() - started
|
||||
# 原样把输出打出来（套件靠它判断）
|
||||
sys.stdout.write(out)
|
||||
if not out.endswith("\n"):
|
||||
sys.stdout.write("\n")
|
||||
# ⚠ 总结这行**只在终端里打**。
|
||||
# 套件是用 `*> 日志文件` 接输出的，再 `Select-Object -Last 2/3`
|
||||
# 取摘要 —— 如果这里多打一行，就会把真正的摘要顶掉，
|
||||
# 汇总表上显示的是"隐藏桌面运行结束"而不是测试结果。
|
||||
if sys.stdout.isatty():
|
||||
print(" —— 隐藏桌面运行结束：退出码 %d，用时 %.1f 秒" % (code, took))
|
||||
return code
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
Reference in New Issue
Block a user