Files
ykxmz/_tests/test_apk_contents.py
T
xmz7891 49fdec1da8 1.8.0:隧道稳定性大修 + 中转管理后台重做
版本号 1.7.1 -> 1.8.0(8 个文件,13 处)。
写了个 bump_180.py 统一处理 —— 版本号散落在
Python / Java manifest / PowerShell / Inno Setup / 测试里,
手动改必漏;而且 .ps1 必须保留 UTF-8 BOM。

==================== 一、隧道稳定性(用户撞上 1033/502/530)====================

1) 4G 链路会**静默断开 TCP 连接**(不发 FIN/RST,双方都以为还活着),
   Linux 默认要 2 小时才发现 -> 改成 keepalive 30 秒 + 每 10 秒探测。
   实测 60 秒内发现并重连。

2) 隧道连接数 2 -> 4。只剩 1 条连接时跨机房回源会失败
   (实测可用率 0/12,提到 4 条后 12/12)。

3) 掉电重启后恢复慢:原来开机 2 分 10 秒公网才可用。
   根因是 systemd-networkd-wait-online 等一个不归它管的网络
   (wlan0 是 NetworkManager 管的),干等 2 分钟超时失败,
   把 network-online.target 一起拖住。
   mask 掉它之后:启动 17.3 秒,掉电重启 24 秒公网可用。

4) 看门狗两次翻车都是我造成的,都修了:
   a) 我先加了"确认故障立刻重启",但隧道重建 4 条连接要 30~60 秒,
      MIN_RESTART_GAP=45 导致**还没建齐就被下一次重启打断**,
      死循环,每 50 秒重启一次 -> 加 150 秒宽限期
   b) 宽限期又带来"链路持续差时什么都不做"的问题
      -> 增加"本次重启后建齐过吗"的判断:
         建齐过又垮 = 真故障,立刻重启
         从没建齐 = 还在努力,继续等

5) 顺手修:看门狗状态文件里的变量在函数定义前被引用,
   set -u 下报 "BUILT: 未绑定的变量"。

==================== 二、中转管理后台重做 ====================

原来的管理页是几百行内联在 relay.py 的 f-string 里,
改一处样式要在一堆转义花括号里翻。拆成独立模块 relay/admin.py。

新设计(对齐官网那套白色简洁):
  吸顶顶栏 -> 公网地址(最大权重,这是用户最需要复制的)
  -> 四个数字卡 -> 设备表 -> 工具卡(体检 + 下载)
  空状态给图标+引导文案;窄屏表格自动变卡片。
  relay.py 从 2089 行缩到 1500 行左右。

修了三个我自己引入的 bug:
  a) 响应头类型写错,浏览器把整页 HTML 当纯文本显示
     (用户看到的是"一屏源码")。教训:200 不等于页面能看,
     当时只验了状态码和字节数。
  b) 顶栏用了固定 height:62px,装不下"标题+副标题+版本信息"两行,
     内容被顶出容器 -> 标题看不见、徽章压在字上。
  c) do_HEAD 没处理 /download/ 路径,HEAD 一个 APK 返回
     Content-Length: 0 + text/plain,下载器会误判成空文件。
     同时发现 _head_info 里对 bytes 调 .encode() —— 加 _as_bytes() 兜住。

==================== 三、其它 ====================

* 设备记录只增不减:实测一天攒 75 条僵尸,/v1/health 从几 KB 涨到 20KB。
  加 DEVICE_TTL(6 小时)自动清,占用的配对码一起释放
  (管理页曾显示"配对码占用 131"但一台设备都没有)。
* HEAD 请求支持(原来一律 501)。
* 官网新增产品展示:手表界面预览(颜色/布局与真实手表一致)、
  电脑端真实截图、两种连接方式对比图。
* 加了一份 docs/免费托管方案.md(含一个纠错:上一版推荐的
  ClawCloud Run 已在 2026-05-11 关停)。

==================== 验收 ====================

全量回归            33 个阶段全部通过
安装包完整周期      20/20(静默装入 7 秒、卸载 0.6 秒、无残留)
网页响应头          12/12
公网可用率          26/30 = 86%(底层 4G 丢包 30%,是这个上限)
发布产物            安装包 14.37MB / 服务端 0.20MB / 手表 0.19MB
2026-10-07 11:47:12 +08:00

148 lines
5.3 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- coding: utf-8 -*-
"""检查手表 APK 是否真的把「遥控诊断」合并进去了。
合并前是两个 APK(手表端 + 独立的遥控诊断 App)。
合并后只需要一个:主程序里有「设备诊断」按钮。
这里从 APK 的 dex 和清单里核实,而不是只信源码。
"""
from __future__ import annotations
import re
import subprocess
import sys
import tempfile
import zipfile
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
# 别写死版本号 —— 一升级就坏(这坑踩过好几回了)。
# 直接扫 dist 里最新的手表 APK。
def _latest_apk() -> Path:
candidates = sorted(
(ROOT / "dist").glob("*watch*.apk"),
key=lambda p: p.stat().st_mtime, reverse=True)
return candidates[0] if candidates else \
ROOT / "dist" / "ykxmz-watch-1.8.0.apk"
APK = _latest_apk()
DIAG_APK = ROOT / "dist" / "LanRemote-Diag-1.1.0.apk"
AAPT = (Path(r"C:\Users\shu\Desktop\deepseekagent\starklink\toolchain")
/ "android-sdk" / "build-tools" / "34.0.0" / "aapt.exe")
PASSED = 0
FAILED = 0
def check(name: str, ok: bool, detail: str = "") -> None:
global PASSED, FAILED
if ok:
PASSED += 1
print(f" [PASS] {name}")
else:
FAILED += 1
print(f" [FAIL] {name} {detail}")
def main() -> int:
print("=" * 68)
print("一、手表 APK 里有没有内置诊断")
print("=" * 68)
if not APK.is_file():
print(f" 找不到 {APK}")
print(" 请先运行 android\\build_apk.ps1")
return 1
with zipfile.ZipFile(APK) as archive:
dex = archive.read("classes.dex")
names = {item.decode() for item in
re.findall(rb"Lcom/lanremote/[A-Za-z0-9_/]+;", dex)}
print(f" dex 中的类: {len(names)} 个")
check("APK 里有 Diagnostics 类(诊断逻辑已内置)",
"Lcom/lanremote/watch/Diagnostics;" in names,
str(sorted(names)))
check("APK 里有 DiscoveryCore(诊断与主程序共用同一份发现实现)",
"Lcom/lanremote/watch/DiscoveryCore;" in names)
check("APK 里有 MainActivity", "Lcom/lanremote/watch/MainActivity;" in names)
# 注意:不能用 "diag" 做子串判断 —— Diagnostics 里也含 diag。
# 要查的是旧的独立包名 com/lanremote/diag/。
legacy = [n for n in names if n.startswith("Lcom/lanremote/diag/")]
check("不含旧的独立诊断包 com.lanremote.diag",
not legacy, str(legacy))
print()
print("=" * 68)
print("二、清单权限(诊断读 WiFi 名称需要定位权限)")
print("=" * 68)
# aapt 不认中文路径,先拷到纯 ASCII 路径
with tempfile.TemporaryDirectory() as tmp:
simple = Path(tmp) / "watch.apk"
simple.write_bytes(APK.read_bytes())
try:
proc = subprocess.run(
[str(AAPT), "dump", "badging", str(simple)],
capture_output=True, timeout=60)
badging = proc.stdout.decode("utf-8", errors="replace")
except Exception as exc: # noqa: BLE001
badging = ""
print(f" aapt 调用失败: {exc}")
if badging:
for permission, why in (
("android.permission.ACCESS_FINE_LOCATION", "读 WiFi 名称"),
("android.permission.INTERNET", "网络通信"),
("android.permission.CHANGE_WIFI_MULTICAST_STATE", "UDP 广播"),
):
check(f"声明了 {permission.split('.')[-1]}({why})",
permission in badging)
check("没有申请定位以外的敏感权限",
"READ_CONTACTS" not in badging
and "READ_SMS" not in badging
and "CAMERA" not in badging
and "RECORD_AUDIO" not in badging)
else:
check("能读取 APK 清单", False, "aapt 没有输出")
print()
print("=" * 68)
print("三、构建脚本不再依赖独立诊断 APK")
print("=" * 68)
package = (ROOT / "_build" / "package.py").read_text(encoding="utf-8")
check("package.py 不再要求 Diag APK",
"DIAG_APK" not in package, "仍引用 DIAG_APK")
check("package.py 说明里写明诊断已合并",
"合并" in package)
src = (ROOT / "android" / "src" / "com" / "lanremote" / "watch"
/ "MainActivity.java").read_text(encoding="utf-8")
# 用户要求:"安卓端中转设置下面,把那个设备诊断给删了,
# 换成输入配对码,输入对应配对码就可以连接对应电脑"
# 所以这里反过来断言:不该再有设备诊断入口,而是配对码输入。
import re as _re
code = _re.sub(r"//[^\n]*", "", src)
check("主界面不再有「设备诊断」入口", "设备诊断" not in code)
check("主界面不再调用 Diagnostics.build",
"Diagnostics.build(" not in code)
check("主界面不再调用 Diagnostics.manualTest",
"Diagnostics.manualTest(" not in code)
check("换成了「输入配对码连接」入口",
'bigButton("输入配对码连接"' in code)
check("配对码连接走中转(connectByCode)",
"private void connectByCode(" in code)
print()
print("=" * 68)
print(f"通过 {PASSED} 项,失败 {FAILED} 项")
print("=" * 68)
return 1 if FAILED else 0
if __name__ == "__main__":
sys.exit(main())