mirror of
https://gitee.com/xmz7891/ykxmz.git
synced 2026-10-18 10:10:43 +00:00
xmz7891
3f18e6bb40
按用户定的规矩，这一轮有新功能，升第二位：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 个阶段全部通过。
219 lines
8.7 KiB
Python
219 lines
8.7 KiB
Python
# -*- coding: utf-8 -*-
|
||
r'''补上 add_rescue_section.py 漏掉/插错的三处。
|
||
|
||
前一个补丁的问题：
|
||
1. _rescue_rows() 只在补丁脚本里定义，**没插进 admin.py** ——
|
||
后台一渲染就 NameError（页面直接 500）
|
||
2. /rescue/ 路由被插进了 **do_HEAD**，而且用了 `self.wfile.write(body)` ——
|
||
HEAD 本来就不该有 body。而且 do_GET 那边一条都没加，
|
||
等于浏览器点下载根本走不到。
|
||
（锚点 "/download/" 出现两次：do_HEAD 和 do_GET 各一份，
|
||
replace(...,1) 只命中了前面那个。这就是那个 "! 锚点 2 处" 警告。）
|
||
|
||
这个脚本按 do_HEAD 自己的 ok()/no() 风格把两处都写对。
|
||
'''
|
||
from __future__ import annotations
|
||
|
||
import re
|
||
import sys
|
||
from pathlib import Path
|
||
|
||
ROOT = Path(__file__).resolve().parent.parent
|
||
RELAY = ROOT / "relay" / "relay.py"
|
||
ADMIN = ROOT / "relay" / "admin.py"
|
||
|
||
|
||
def load(p: Path):
|
||
raw = p.read_bytes()
|
||
return raw, raw.startswith(b"\xef\xbb\xbf"), raw.decode("utf-8-sig")
|
||
|
||
|
||
def save(p: Path, text: str, bom: bool):
|
||
p.write_bytes((b"\xef\xbb\xbf" if bom else b"") + text.encode("utf-8"))
|
||
|
||
|
||
# ===========================================================================
|
||
# 1. do_HEAD：换成 ok()/no() 风格（不能有 body）
|
||
# ===========================================================================
|
||
BAD_HEAD = ''' if path.startswith("/rescue/"):
|
||
# 抢救报告下载。单独一条路由，**不发缓存头** ——
|
||
# 内容会变，而且不该让 Cloudflare 边缘留着。
|
||
wanted = urllib.parse.unquote(path[len("/rescue/"):])
|
||
safe = _safe_rescue_name(wanted)
|
||
if not safe:
|
||
self._json(400, {"ok": False, "error": "文件名不合法"})
|
||
return
|
||
target = RESCUE_DIR / safe
|
||
if not target.is_file():
|
||
self._json(404, {"ok": False, "error": "没有这份报告"})
|
||
return
|
||
try:
|
||
body = target.read_bytes()
|
||
except OSError as exc:
|
||
self._json(500, {"ok": False, "error": f"读不到: {exc}"})
|
||
return
|
||
self.send_response(200)
|
||
self.send_header("Content-Type", "text/plain; charset=utf-8")
|
||
self.send_header("Content-Length", str(len(body)))
|
||
quoted = urllib.parse.quote(safe)
|
||
self.send_header(
|
||
"Content-Disposition",
|
||
f"attachment; filename*=UTF-8''{quoted}")
|
||
self.send_header("Cache-Control", "no-store")
|
||
self.end_headers()
|
||
self.wfile.write(body)
|
||
return
|
||
|
||
'''
|
||
|
||
GOOD_HEAD = ''' if path.startswith("/rescue/"):
|
||
# 抢救报告。HEAD 只回长度和类型，**不写 body** ——
|
||
# 这条路由同时存在于 do_GET（真正下载）和 do_HEAD（探测）。
|
||
wanted = urllib.parse.unquote(path[len("/rescue/"):])
|
||
safe = _safe_rescue_name(wanted)
|
||
if not safe:
|
||
return no()
|
||
target = RESCUE_DIR / safe
|
||
if not target.is_file():
|
||
return no()
|
||
quoted = urllib.parse.quote(safe)
|
||
headers = {"Content-Disposition":
|
||
"attachment; filename*=UTF-8''%s" % quoted,
|
||
"Cache-Control": "no-store"}
|
||
return ok("text/plain; charset=utf-8", target.stat().st_size,
|
||
headers)
|
||
|
||
'''
|
||
|
||
# ===========================================================================
|
||
# 2. do_GET：加同一条路由（这里才真正回 body）
|
||
# ===========================================================================
|
||
GET_ANCHOR = ''' if path.startswith("/download/"):
|
||
wanted = urllib.parse.unquote(path[len("/download/"):])
|
||
safe = _safe_download_name(wanted)
|
||
if not safe:
|
||
self._json(400, {"ok": False, "error": "文件名不合法"})
|
||
return'''
|
||
|
||
GET_NEW = ''' if path.startswith("/rescue/"):
|
||
# 抢救报告下载。**单独一条路由，不发缓存头** ——
|
||
# 内容会变，而且不该让 Cloudflare 边缘留着。
|
||
# （和 /download/ 分成两套是有意的：那个是给用户的安装包，
|
||
# 文件名带版本号、内容永不改变，所以敢发 604800 长缓存。）
|
||
wanted = urllib.parse.unquote(path[len("/rescue/"):])
|
||
safe = _safe_rescue_name(wanted)
|
||
if not safe:
|
||
self._json(400, {"ok": False, "error": "文件名不合法"})
|
||
return
|
||
target = RESCUE_DIR / safe
|
||
if not target.is_file():
|
||
self._json(404, {"ok": False, "error": "没有这份报告"})
|
||
return
|
||
try:
|
||
body = target.read_bytes()
|
||
except OSError as exc:
|
||
self._json(500, {"ok": False, "error": f"读不到: {exc}"})
|
||
return
|
||
self.send_response(200)
|
||
self.send_header("Content-Type", "text/plain; charset=utf-8")
|
||
self.send_header("Content-Length", str(len(body)))
|
||
quoted = urllib.parse.quote(safe)
|
||
self.send_header(
|
||
"Content-Disposition",
|
||
f"attachment; filename*=UTF-8''{quoted}")
|
||
self.send_header("Cache-Control", "no-store")
|
||
self.end_headers()
|
||
self.wfile.write(body)
|
||
return
|
||
|
||
''' + GET_ANCHOR
|
||
|
||
# ===========================================================================
|
||
# 3. admin.py：把 _rescue_rows 真正定义进去
|
||
# ===========================================================================
|
||
RESCUE_FN = '''def _rescue_rows(items: list) -> str:
|
||
"""抢救报告列表的 HTML。
|
||
|
||
照 dl_rows 的风格：在服务端直接拼好塞进模板，不用 JS 去拉 ——
|
||
这台机器只有 460MB 内存，多个接口就多份开销，而且后台页
|
||
本来就只是一次性的展示。
|
||
|
||
没有报告时给一句正面的话（"一直没出过问题"），
|
||
而不是干巴巴的"暂无数据"—— 没报告是好事。
|
||
"""
|
||
if not items:
|
||
return ('<div class="out">还没有报告 —— 说明网站一直没出过'
|
||
'「自动救不回来」的问题。</div>')
|
||
import time as _t
|
||
import urllib.parse as _up
|
||
rows = []
|
||
for it in items:
|
||
when = _t.strftime("%m-%d %H:%M", _t.localtime(it["mtime"]))
|
||
size = it["size"] / 1024
|
||
size_s = ("%.1f KB" % size) if size >= 1 else ("%d B" % it["size"])
|
||
summary = _esc(it.get("summary") or "（没有结论行）")
|
||
href = "/rescue/" + _up.quote(it["name"])
|
||
rows.append(
|
||
'<div class="dlrow"><span class="nm">'
|
||
'<a href="%s" style="color:#0a84ff">%s</a>'
|
||
'<span style="color:#6b7280;font-size:12px;margin-left:8px">'
|
||
'%s</span></span>'
|
||
'<span class="sz" style="max-width:46%%;text-align:right">'
|
||
'%s</span></div>'
|
||
% (href, when, size_s, summary))
|
||
return "".join(rows)
|
||
|
||
|
||
def render_admin('''
|
||
|
||
|
||
def main() -> int:
|
||
ok = True
|
||
|
||
# ---- relay.py ----
|
||
raw, bom, text = load(RELAY)
|
||
if BAD_HEAD in text:
|
||
text = text.replace(BAD_HEAD, GOOD_HEAD, 1)
|
||
print(" ✓ do_HEAD 里的 /rescue/ 换成 ok()/no() 风格（不再写 body）")
|
||
elif GOOD_HEAD in text:
|
||
print(" · do_HEAD 已经是对的")
|
||
else:
|
||
print(" ✗ do_HEAD 里找不到那段 /rescue/")
|
||
ok = False
|
||
|
||
if 'if path.startswith("/rescue/")' in text.split("def do_GET")[1]:
|
||
print(" · do_GET 里已经有了")
|
||
else:
|
||
if GET_ANCHOR in text:
|
||
# 只替换 do_GET 里那一处（do_HEAD 那处已经在上面被换掉了，
|
||
# 所以现在全文只剩一处）
|
||
n = text.count(GET_ANCHOR)
|
||
if n != 1:
|
||
print(" ! do_GET 锚点还有 %d 处" % n)
|
||
text = text.replace(GET_ANCHOR, GET_NEW, 1)
|
||
print(" ✓ do_GET 加了 /rescue/ 路由（真正回 body 的那条）")
|
||
else:
|
||
print(" ✗ do_GET 里找不到 /download/ 锚点")
|
||
ok = False
|
||
save(RELAY, text, bom)
|
||
|
||
# ---- admin.py ----
|
||
raw, bom, text = load(ADMIN)
|
||
if "def _rescue_rows(" in text:
|
||
print(" · admin.py 里已经定义了 _rescue_rows")
|
||
else:
|
||
if "def render_admin(" not in text:
|
||
print(" ✗ admin.py 里找不到 render_admin")
|
||
ok = False
|
||
else:
|
||
text = text.replace("def render_admin(", RESCUE_FN, 1)
|
||
save(ADMIN, text, bom)
|
||
print(" ✓ admin.py 里补上了 _rescue_rows 的定义")
|
||
ok = ok and True
|
||
|
||
return 0 if ok else 1
|
||
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(main())
|