xmz7891/ykxmz
1
0
Fork 0
mirror of https://gitee.com/xmz7891/ykxmz.git synced 2026-10-19 08:20: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
windows/lanremote/protocol.py
+181 -179
View File
@@ -1,179 +1,181 @@
# -*- coding: utf-8 -*-
"""通信协议常量与编解码。
设计目标：双端零外部依赖。
* Windows 端：Python 标准库 socket + json
* 安卓端：java.net.Socket + 系统自带 org.json
传输格式：TCP 长连接，每条消息一行 UTF-8 JSON，以 \\n 结尾。
二进制负载（图片/音频/文件）用 base64 分块传输。
"""
from __future__ import annotations
import base64
import json
DEFAULT_PORT = 8765
PROTOCOL_VERSION = 1
MAX_LINE_BYTES = 8 * 1024 * 1024 # 单行上限 8MB（约 6MB 原始数据）
CHUNK_SIZE = 256 * 1024
# 单次传输（文件 / 图片 / 音频）的总体积上限
MAX_TOTAL_BYTES = 256 * 1024 * 1024 # 分块大小 256KB
# ---- 客户端 -> 服务端 命令 ----
CMD_PAIR = "pair"
CMD_AUTH = "auth"
CMD_PING = "ping"
CMD_IMAGE = "image"
CMD_AUDIO = "audio"
CMD_MEDIA = "media"
CMD_CLIP_SET = "clip_set"
CMD_CLIP_GET = "clip_get"
CMD_POWER = "power"
CMD_RUN = "run"
CMD_SAY = "say"
CMD_VOICE_LIST = "voice_list"
CMD_SET_VOICE = "set_voice"
CMD_AUDIO_LIST = "audio_list"
CMD_PLAY_LOCAL = "play_local"
CMD_SHUTDOWN_TIMER = "shutdown_timer" # 定时关机 / 取消
CMD_MONITOR = "monitor" # 关闭 / 打开显示器
CMD_OPEN_URL = "open_url" # 在电脑浏览器打开网址
CMD_QUICK = "quick" # 快捷启动程序
CMD_OPEN_FOLDER = "open_folder" # 打开常用文件夹
CMD_PROC_LIST = "proc_list" # 进程列表
CMD_PROC_KILL = "proc_kill" # 结束进程
CMD_BATTERY = "battery" # 电量
CMD_DISK = "disk" # 磁盘占用
CMD_PERF = "perf" # CPU / 内存占用
CMD_CLIP_HISTORY = "clip_history" # 剪贴板历史
CMD_SET_WALLPAPER = "set_wallpaper" # 把收到的图设为壁纸
CMD_SAY_CLIP = "say_clip" # 朗读剪贴板
CMD_FEATURE_LIST = "feature_list" # 电脑端能做哪些功能
CMD_FEATURE_RUN = "feature_run" # 执行某个功能
CMD_AUDIO_PAUSE = "audio_pause" # 暂停电脑正在播的音频
CMD_AUDIO_RESUME = "audio_resume" # 继续播放
CMD_AUDIO_STATUS = "audio_status" # 当前播放状态
CMD_NOTIFY = "notify"
CMD_FILE_PUSH = "file_push"
CMD_FILE_LIST = "file_list"
CMD_FILE_PULL = "file_pull"
CMD_INFO = "info"
CMD_SCREEN_START = "screen_start"
CMD_SCREEN_STOP = "screen_stop"
CMD_SCREENSHOT = "screenshot"
# ---- 服务端 -> 客户端 事件 ----
EVT_FILE = "file"
EVT_CLIP = "clip"
EVT_STATUS = "status"
EVT_LOG = "log"
EVT_FRAME = "frame"
EVT_SCREEN_STOPPED = "screen_stopped"
MEDIA_ACTIONS = {
"playpause": 0xB3,
"next": 0xB0,
"prev": 0xB1,
"stop": 0xB2,
"volup": 0xAF,
"voldown": 0xAE,
"mute": 0xAD,
}
POWER_ACTIONS = {"shutdown", "restart", "lock", "sleep", "abort"}
# 手表端会用到的中文动作名（便于 UI 直接显示）
MEDIA_LABELS = {
"playpause": "播放/暂停",
"next": "下一曲",
"prev": "上一曲",
"stop": "停止",
"volup": "音量+",
"voldown": "音量-",
"mute": "静音",
}
POWER_LABELS = {
"shutdown": "关机",
"restart": "重启",
"lock": "锁屏",
"sleep": "睡眠",
"abort": "取消关机",
}
def dumps(obj: dict) -> bytes:
"""编码成一行 JSON（UTF-8 + 换行）。"""
return (json.dumps(obj, ensure_ascii=False, separators=(",", ":")) + "\n").encode("utf-8")
def loads(line: bytes) -> dict:
"""解析一行 JSON。"""
return json.loads(line.decode("utf-8", errors="replace").strip())
def b64encode(data: bytes) -> str:
return base64.b64encode(data).decode("ascii")
def b64decode(text: str) -> bytes:
return base64.b64decode(text.encode("ascii"))
def chunk_bytes(data: bytes, size: int = CHUNK_SIZE):
"""把字节流切成若干块，产出 (seq, is_last, chunk)。"""
if not data:
yield 0, True, b""
return
total = (len(data) + size - 1) // size
for index in range(total):
piece = data[index * size:(index + 1) * size]
yield index, index == total - 1, piece
class ChunkTooLarge(Exception):
"""分块累积超过上限，或顺序不对。"""
class ChunkAssembler:
"""接收端：按 seq 收集分块，拼回完整数据。
MAX_LINE_BYTES 只管单行，累积体积必须另外设上限 ——
否则已配对设备可以一直发 chunk 把内存吃干（最后 bytes() 还要再翻一倍）。
"""
def __init__(self, limit: int = MAX_TOTAL_BYTES):
self._buf = bytearray()
self._expected = 0
self._limit = int(limit)
def feed(self, seq: int, is_last: bool, data: bytes) -> bytes | None:
"""返回完整数据（当收到最后一块时），否则 None。
顺序不对或超限时抛 ChunkTooLarge，不静默拼出坏文件。
"""
if seq == 0:
self._buf = bytearray()
self._expected = 0
if seq != self._expected:
self._buf = bytearray()
self._expected = 0
raise ChunkTooLarge(
f"分块顺序不对（收到 {seq}，应为 {self._expected}）")
if len(self._buf) + len(data) > self._limit:
self._buf = bytearray()
self._expected = 0
raise ChunkTooLarge(f"文件超过上限（{self._limit // 1048576} MB）")
self._buf.extend(data)
self._expected = seq + 1
if is_last:
result = bytes(self._buf)
self._buf = bytearray()
self._expected = 0
return result
return None
def reset(self) -> None:
self._buf = bytearray()
self._expected = 0
# -*- coding: utf-8 -*-
"""通信协议常量与编解码。
设计目标：双端零外部依赖。
* Windows 端：Python 标准库 socket + json
* 安卓端：java.net.Socket + 系统自带 org.json
传输格式：TCP 长连接，每条消息一行 UTF-8 JSON，以 \\n 结尾。
二进制负载（图片/音频/文件）用 base64 分块传输。
"""
from __future__ import annotations
import base64
import json
DEFAULT_PORT = 8765
PROTOCOL_VERSION = 1
MAX_LINE_BYTES = 8 * 1024 * 1024 # 单行上限 8MB（约 6MB 原始数据）
CHUNK_SIZE = 256 * 1024
# 单次传输（文件 / 图片 / 音频）的总体积上限
MAX_TOTAL_BYTES = 256 * 1024 * 1024 # 分块大小 256KB
# ---- 客户端 -> 服务端 命令 ----
CMD_PAIR = "pair"
CMD_AUTH = "auth"
CMD_PING = "ping"
CMD_IMAGE = "image"
CMD_AUDIO = "audio"
CMD_MEDIA = "media"
CMD_CLIP_SET = "clip_set"
CMD_CLIP_GET = "clip_get"
CMD_POWER = "power"
CMD_RUN = "run"
CMD_SAY = "say"
CMD_VOICE_LIST = "voice_list"
CMD_SET_VOICE = "set_voice"
CMD_AUDIO_LIST = "audio_list"
CMD_SFX_LIST = "sfx_list" # 列出可用音效（内置 + 用户自己放的）
CMD_SFX_PLAY = "sfx_play" # 播放某个音效
CMD_PLAY_LOCAL = "play_local"
CMD_SHUTDOWN_TIMER = "shutdown_timer" # 定时关机 / 取消
CMD_MONITOR = "monitor" # 关闭 / 打开显示器
CMD_OPEN_URL = "open_url" # 在电脑浏览器打开网址
CMD_QUICK = "quick" # 快捷启动程序
CMD_OPEN_FOLDER = "open_folder" # 打开常用文件夹
CMD_PROC_LIST = "proc_list" # 进程列表
CMD_PROC_KILL = "proc_kill" # 结束进程
CMD_BATTERY = "battery" # 电量
CMD_DISK = "disk" # 磁盘占用
CMD_PERF = "perf" # CPU / 内存占用
CMD_CLIP_HISTORY = "clip_history" # 剪贴板历史
CMD_SET_WALLPAPER = "set_wallpaper" # 把收到的图设为壁纸
CMD_SAY_CLIP = "say_clip" # 朗读剪贴板
CMD_FEATURE_LIST = "feature_list" # 电脑端能做哪些功能
CMD_FEATURE_RUN = "feature_run" # 执行某个功能
CMD_AUDIO_PAUSE = "audio_pause" # 暂停电脑正在播的音频
CMD_AUDIO_RESUME = "audio_resume" # 继续播放
CMD_AUDIO_STATUS = "audio_status" # 当前播放状态
CMD_NOTIFY = "notify"
CMD_FILE_PUSH = "file_push"
CMD_FILE_LIST = "file_list"
CMD_FILE_PULL = "file_pull"
CMD_INFO = "info"
CMD_SCREEN_START = "screen_start"
CMD_SCREEN_STOP = "screen_stop"
CMD_SCREENSHOT = "screenshot"
# ---- 服务端 -> 客户端 事件 ----
EVT_FILE = "file"
EVT_CLIP = "clip"
EVT_STATUS = "status"
EVT_LOG = "log"
EVT_FRAME = "frame"
EVT_SCREEN_STOPPED = "screen_stopped"
MEDIA_ACTIONS = {
"playpause": 0xB3,
"next": 0xB0,
"prev": 0xB1,
"stop": 0xB2,
"volup": 0xAF,
"voldown": 0xAE,
"mute": 0xAD,
}
POWER_ACTIONS = {"shutdown", "restart", "lock", "sleep", "abort"}
# 手表端会用到的中文动作名（便于 UI 直接显示）
MEDIA_LABELS = {
"playpause": "播放/暂停",
"next": "下一曲",
"prev": "上一曲",
"stop": "停止",
"volup": "音量+",
"voldown": "音量-",
"mute": "静音",
}
POWER_LABELS = {
"shutdown": "关机",
"restart": "重启",
"lock": "锁屏",
"sleep": "睡眠",
"abort": "取消关机",
}
def dumps(obj: dict) -> bytes:
"""编码成一行 JSON（UTF-8 + 换行）。"""
return (json.dumps(obj, ensure_ascii=False, separators=(",", ":")) + "\n").encode("utf-8")
def loads(line: bytes) -> dict:
"""解析一行 JSON。"""
return json.loads(line.decode("utf-8", errors="replace").strip())
def b64encode(data: bytes) -> str:
return base64.b64encode(data).decode("ascii")
def b64decode(text: str) -> bytes:
return base64.b64decode(text.encode("ascii"))
def chunk_bytes(data: bytes, size: int = CHUNK_SIZE):
"""把字节流切成若干块，产出 (seq, is_last, chunk)。"""
if not data:
yield 0, True, b""
return
total = (len(data) + size - 1) // size
for index in range(total):
piece = data[index * size:(index + 1) * size]
yield index, index == total - 1, piece
class ChunkTooLarge(Exception):
"""分块累积超过上限，或顺序不对。"""
class ChunkAssembler:
"""接收端：按 seq 收集分块，拼回完整数据。
MAX_LINE_BYTES 只管单行，累积体积必须另外设上限 ——
否则已配对设备可以一直发 chunk 把内存吃干（最后 bytes() 还要再翻一倍）。
"""
def __init__(self, limit: int = MAX_TOTAL_BYTES):
self._buf = bytearray()
self._expected = 0
self._limit = int(limit)
def feed(self, seq: int, is_last: bool, data: bytes) -> bytes | None:
"""返回完整数据（当收到最后一块时），否则 None。
顺序不对或超限时抛 ChunkTooLarge，不静默拼出坏文件。
"""
if seq == 0:
self._buf = bytearray()
self._expected = 0
if seq != self._expected:
self._buf = bytearray()
self._expected = 0
raise ChunkTooLarge(
f"分块顺序不对（收到 {seq}，应为 {self._expected}）")
if len(self._buf) + len(data) > self._limit:
self._buf = bytearray()
self._expected = 0
raise ChunkTooLarge(f"文件超过上限（{self._limit // 1048576} MB）")
self._buf.extend(data)
self._expected = seq + 1
if is_last:
result = bytes(self._buf)
self._buf = bytearray()
self._expected = 0
return result
return None
def reset(self) -> None:
self._buf = bytearray()
self._expected = 0