liuzhuohua
ed5eb4428b
## 性能：瓶颈在传输，不在代码
先量后改。helper 冷启动 0.44s（编译 22173 行）看着像瓶颈，但
drouter-helpd 是常驻守护，请求走 Unix socket，正常路径根本不 fork；
实测各 API 已是毫秒级。app.js 语法编译 18ms、顶层执行 18ms
（393 个顶层函数 / 13401 行）—— JS 执行不是瓶颈。
真瓶颈是 app.js 690,482 字节每次重传。**决定不拆包**：JS 执行只 18ms，
拆包引入首屏 waterfall 的风险大于收益。改走三条：
1. 缓存策略按「有没有指纹」区分（不是按扩展名）
- 带 ?v=<mtime> → public, max-age=31536000, immutable
- 没指纹 → 仍 no-cache（否则部署后用户拿到旧文件）
- index.html → 永远 no-store（每次都要重新注入）
2. 编码协商 br > gzip > 原文，**逐级降级**
3. 压缩结果按 (path, mtime, size, enc) 缓存
真机实测：首次 690,482 → 200,137 字节，第二次打开 0 字节（304）。
## 逐级降级不是可选项
目标机**没装 python3-brotli**（只有 C 库 libbrotli1）。最初写的
_brotli_cached 在模块缺失时 `return data, None`，而 None 是 encoding，
调用方理解为「压不动，原样输出」—— 于是 583KB 裸传，**比优化前更慢**。
改成 (None, None) 明确表示「这条路不通」，由 _encode_body 继续试 gzip。
同时修：Accept-Encoding 探测必须认 q=0（br;q=0 是「明确不要」，
子串匹配会正好发给解不开的客户端 → 满屏乱码）；编码必须进缓存键
（共用键会互相覆盖）；brotli 固定 q5（q11 只省 10KB 却要 1.5-3s）。
## 宽 except 把 bug 装成了特性
兜底只接 ImportError 这类**真·预期**的缺失，不接 TypeError/ValueError
（「str 传给要 bytes 的接口」也是 TypeError，接了等于没接）。
早先的 `except Exception` 吞掉了一个 NameError（漏注入 _comp_lock），
表现是压缩功能完好但从不生效，页面照常能开、只看响应头的判据完全发现不了。
## 版本号：建立单一真源 packaging/VERSION
原来版本号在 4 个构建脚本各写死一个默认值 + openapi 里硬编码。
漏改一处就产出「文件名 1.0.9、control 里 1.0.8」的包 —— apt 按
control 认版本，dpkg -l 永远显示旧版且升不上去。
index.html 的 ETag 并入版本号：它发出去的是注入后的内容，
ETag 却按原文件算，只改 VERSION 文件时 ETag 不变，客户端换到 304
继续用旧副本，页面版本号永远停在旧版。
## logo 回概述
用 <a> 而不是 <div onclick>：Tab 能聚焦、Enter 能触发、读屏会念「链接」。
已在 dash 页时不重复 go()（go 会 stopPageTimers + 重拉数据）。
CSS 显式去 text-decoration/color（UA 样式表不声明仍生效），
:focus-visible 焦点环保留（纯键盘用户唯一的路标）。
## 顺带修掉一个已发布版本的真 bug
_vpn_env 里 os.path.join('/lib/modules', ...) 被留成了 '/nonexistent'
（反向验证脚本被 SIGTERM 打断，finally 没执行，注入留在源码里），
于是 mod_file 永远为空、**need_module 整个状态从四态里消失** ——
这正是 v1.0.8 release notes 声称修好的那个 bug（PVE 的 KVM 虚机内核
明明有 wireguard.ko.xz 却报 unsupported，前端配一句写死的
「通常说明跑在精简容器里」把排查方向带偏）。
新增 _dev/t-worktree-clean.py 扫注入哨兵，放在 sync.sh 所有判据之前 ——
基线被污染时，后面每一条红都不可信。
## 判据
新增 t-static-perf.py（42 项静态）、t-encoding-runtime.py（26 项**真跑**，
覆盖 9 种 Accept-Encoding 组合、brotli 缺失降级、两种编码不互相覆盖、
压不动直出、内部错误不被吞）、t-worktree-clean.py。
三个都做了反向验证，注入后确实变红。
反向验证本身也踩了坑：判据里 len(body) 在 body 为 None 时先崩 ——
退出码非 0 但没有 FAIL 行，看着像「跑了」，实际没人知道它验出了什么。
取长度一律过 _sz() 包一层。
全量回归 54 个判据 0 失败；真机验收 22 项全通过；
前端三查 47 视图 0 异常、26 项移动端适配全过。
92 lines
3.4 KiB
Python
92 lines
3.4 KiB
Python
#!/usr/bin/env python3
|
|
# -*- coding: utf-8 -*-
|
|
"""入口页资源版本号注入（破浏览器缓存）的纯逻辑测试。
|
|
|
|
从 drouter-web.py 抽出 _ASSET_RE / _inject_asset_version 两个片段，
|
|
在隔离命名空间里执行，不导入整个后端（那会连数据库、读证书）。
|
|
"""
|
|
import ast
|
|
import os
|
|
import re
|
|
import sys
|
|
import tempfile
|
|
|
|
SRC = os.path.join(os.path.dirname(__file__), '..', 'backend', 'drouter-web.py')
|
|
code = open(SRC, encoding='utf-8').read()
|
|
tree = ast.parse(code)
|
|
|
|
want = {'_ASSET_RE', '_inject_asset_version'}
|
|
picked = []
|
|
for node in tree.body:
|
|
if isinstance(node, ast.Assign):
|
|
for t in node.targets:
|
|
if isinstance(t, ast.Name) and t.id in want:
|
|
picked.append(node)
|
|
break
|
|
elif isinstance(node, ast.FunctionDef) and node.name in want:
|
|
picked.append(node)
|
|
|
|
found = set()
|
|
for node in picked:
|
|
if isinstance(node, ast.Assign):
|
|
for t in node.targets:
|
|
if isinstance(t, ast.Name):
|
|
found.add(t.id)
|
|
else:
|
|
found.add(node.name)
|
|
|
|
missing = want - found
|
|
assert not missing, '未能从源码抽取：%s' % ', '.join(sorted(missing))
|
|
|
|
# 建一个假 WEB_DIR，里面放两个已知 mtime 的文件
|
|
tmp = tempfile.mkdtemp()
|
|
for name in ('app.js', 'app.css'):
|
|
p = os.path.join(tmp, name)
|
|
open(p, 'w', encoding='utf-8').write('/* %s */' % name)
|
|
os.utime(p, (1_700_000_000, 1_700_000_000))
|
|
|
|
ns = {'os': os, 're': re, 'WEB_DIR': tmp}
|
|
# _inject_asset_version 从 1.0.9 起还会替换页脚版本号占位符，
|
|
# 所以要提供 app_version()。**漏了会 NameError** —— 而这个判据只
|
|
# 抽了单个函数、不是整个模块，模块级定义一个都带不过来。
|
|
# 凡是改了被抽函数的签名或新引用的模块级符号，替身必须同步补。
|
|
ns['app_version'] = lambda: '9.9.9'
|
|
exec(compile(ast.Module(body=picked, type_ignores=[]), SRC, 'exec'), ns)
|
|
inject = ns['_inject_asset_version']
|
|
|
|
HTML = ('<!doctype html>\n'
|
|
'<link rel="icon" href="/logo.svg" type="image/svg+xml">\n'
|
|
'<link rel="stylesheet" href="/app.css">\n'
|
|
'<link rel="stylesheet" href="/theme.css?v=123">\n'
|
|
'<span id="app-ver">v__APP_VERSION__</span>\n'
|
|
'<script src="/app.js"></script>\n')
|
|
|
|
out = inject(HTML.encode('utf-8')).decode('utf-8')
|
|
|
|
fails = []
|
|
|
|
|
|
def ck(name, cond, extra=''):
|
|
print(' %-42s %s %s' % (name, 'OK ' if cond else 'FAIL', extra))
|
|
if not cond:
|
|
fails.append(name)
|
|
|
|
|
|
print('资源版本号注入：')
|
|
ck('app.css 追加了 ?v=', '/app.css?v=1700000000' in out)
|
|
ck('app.js 追加了 ?v=', '/app.js?v=1700000000' in out)
|
|
ck('已带查询串的 theme.css 不被改动', '/theme.css?v=123' in out and '/theme.css?v=123?v=' not in out)
|
|
ck('非 js/css 的 logo.svg 不动', '/logo.svg' in out and '/logo.svg?v=' not in out)
|
|
ck('不会重复追加（幂等）',
|
|
inject(out.encode('utf-8')).decode('utf-8').count('/app.js?v=') == 1)
|
|
ck('输出仍是合法 utf-8 且保留 doctype', out.startswith('<!doctype html>'))
|
|
ck('单引号属性也能处理',
|
|
"/app.css?v=" in inject(b"<link href='/app.css'>").decode('utf-8'))
|
|
# 1.0.9：页脚版本号占位符也要被替换掉。
|
|
# 漏了不会报错，只是页面底下一直显示 v__APP_VERSION__ 字面量。
|
|
ck('页脚 __APP_VERSION__ 被替换成真实版本号',
|
|
'__APP_VERSION__' not in out and 'v9.9.9' in out)
|
|
|
|
print('\n结果：%d 项，失败 %d 项' % (8, len(fails)))
|
|
raise SystemExit(1 if fails else 0)
|