Files
liuzhuohua ed5eb4428b 1.0.9 静态资源传输层优化 + 页脚版本号 + logo 回概述
## 性能:瓶颈在传输,不在代码

先量后改。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 项移动端适配全过。
2026-10-04 10:27:02 +08:00

85 lines
3.7 KiB
JavaScript

// 量 app.js 的真实解析/执行成本,以及各种压缩格式的实际收益。
// 目的:优化前先有数字,别凭感觉改。
const fs = require('fs');
const zlib = require('zlib');
const path = require('path');
const ROOT = path.dirname(__dirname);
const src = fs.readFileSync(path.join(ROOT, 'web', 'app.js'), 'utf8');
function kb(n) { return (n / 1024).toFixed(0) + ' KB'; }
console.log('=== 体积 ===');
console.log(' 原始 :', kb(src.length));
console.log(' gzip -9 :', kb(zlib.gzipSync(src, { level: 9 }).length));
try {
console.log(' brotli q11 :', kb(zlib.brotliCompressSync(src, {
params: { [zlib.constants.BROTLI_PARAM_QUALITY]: 11 } }).length));
} catch (e) { console.log(' brotli : 不可用', e.message); }
// 语法编译:V8 解析 674KB 源码的真实耗时
let t = Date.now();
try {
new Function(src);
} catch (e) {
console.log(' 语法错误:', e.message);
process.exit(1);
}
console.log('=== 成本 ===');
console.log(' 语法编译 :', (Date.now() - t), 'ms');
// 顶层执行:把 DOM 打桩,量「首屏前」跑多少 JS
function stub() {
const el = () => ({
style: {}, dataset: {}, classList: { add() {}, remove() {}, toggle() {}, contains: () => false },
appendChild() {}, removeChild() {}, setAttribute() {}, getAttribute: () => null,
addEventListener() {}, removeEventListener() {}, querySelector: () => null,
querySelectorAll: () => [], insertAdjacentHTML() {}, focus() {}, click() {},
getBoundingClientRect: () => ({ top: 0, left: 0, width: 0, height: 0 }),
children: [], childNodes: [], innerHTML: '', textContent: '', value: '',
});
global.document = {
getElementById: () => null, querySelector: () => null, querySelectorAll: () => [],
createElement: el, createElementNS: el, createTextNode: () => ({}),
body: el(), head: el(), documentElement: el(),
addEventListener() {}, removeEventListener() {}, cookie: '',
createDocumentFragment: () => el(),
};
global.window = {
addEventListener() {}, removeEventListener() {},
location: { href: '', hash: '', search: '', pathname: '/', reload() {} },
localStorage: { getItem: () => null, setItem() {}, removeItem() {} },
sessionStorage: { getItem: () => null, setItem() {}, removeItem() {} },
setTimeout: () => 0, clearTimeout() {}, setInterval: () => 0, clearInterval() {},
requestAnimationFrame: () => 0, innerWidth: 1280, innerHeight: 800,
matchMedia: () => ({ matches: false, addEventListener() {}, addListener() {} }),
getComputedStyle: () => ({}), scrollTo() {}, alert() {}, confirm: () => true,
};
global.localStorage = global.window.localStorage;
global.sessionStorage = global.window.sessionStorage;
global.location = global.window.location;
global.navigator = { userAgent: 'node', language: 'zh-CN', platform: 'linux' };
global.history = { pushState() {}, replaceState() {} };
global.fetch = () => Promise.resolve({ ok: true, json: () => Promise.resolve({}) });
global.XMLHttpRequest = function () { this.open = () => {}; this.send = () => {}; };
global.alert = () => {};
global.confirm = () => true;
global.CustomEvent = function () {};
global.Event = function () {};
}
stub();
t = Date.now();
try {
(new Function('return (function(){' + src + '\n})()'))();
} catch (e) {
console.log(' 顶层执行异常:', e.message);
}
console.log(' 顶层执行 :', (Date.now() - t), 'ms');
// 全文里各「视图函数」占多少行 —— 决定要不要拆包
const funcs = [...src.matchAll(/^(?:async\s+)?function\s+(\w+)/gm)].map(m => m[1]);
console.log('=== 结构 ===');
console.log(' 顶层函数数 :', funcs.length);
console.log(' 总行数 :', src.split('\n').length);