2 Commits

Include renames

Author	SHA1	Message	Date
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
liuzhuohua	309be8b0a5	feat(snapshot): 快照可单独上锁 + 备注事后可改，全部并入紧急救援通道页 ... 用户反馈的四件事一次做完： 1. 给快照加保护（单份上锁，自动清理一律跳过） 2. 说明「手动快照受保护不被清理」，并讲清它与上锁的区别 3. 快照备注事后可改（此前只能在创建时填，存下来就只能看不能改） 4. 列表从「配置快照与回滚」卡片搬进「紧急救援通道」，回滚入口不再弹残缺弹窗 protected 与 keep_manual 是两件事，必须分开： - keep_manual 是全局策略，按 tag.startswith('auto') 猜来源 - protected 是用户对这一份的显式意图，跨策略生效 判据只能加在删除分支上，混进 auto 算法的话，受保护的自动快照 会开始占 keep_count 配额，把别的自动快照挤掉 —— 用户设「保留 5 份」 却只剩 4 份，且没有任何提示。 上锁不等于删不掉：删受保护的那份时后端回 needs_force，前端弹二次确认 后带 force 重试。审计里标注「受保护，已强制删除」，否则事后只看得到 「删了快照」，看不出删的是用户特意保下来的那份。 meta 用 .tmp + os.replace 原子写 —— meta 是 prune 唯一的判据来源， 写到一半被打断会留下解析不了的残文件，之后那份快照既不会被清理， 也上不了锁（读不到就当没保护）。 备注消毒：控制字符一律换成空格而不是删掉。删掉会把「甲 BEL 乙」 变成「甲乙」，两个词粘成一坨，而用户看到的备注莫名其妙。 真机验收（40 项全绿）当场抓到两个本地回归漏掉的真 bug： - 备注消毒把制表符删掉而不是换空格：'a\\nb\\tc' 变成 'ab c' 本地判据只写「不含换行和制表符」，恰好放过 —— 「没有危险字符」 和「内容没被偷偷改掉」是两件事 - web 层无条件写 'protected': b.get('protected')， payload 里这个键永远在（值可能是 None），helper 的 `if 'protected' in p` 恒成立，「不传就取反」从 HTTP 路上彻底失效 两个都补了反向验证（注入后必须观察到红）。 顺带修掉一个既存缺陷：t-107.py 里的 js_code_only 一直在吃 app.js 的真代码 —— 用 re.sub 块注释优先、再剥行注释，而 app.js 8222 行有一句 讲「怎么防止 CSS 注释被提前闭合」的行注释，注释里写着块注释的起止符 字面量，于是被当成真注释开头一路吃到文件尾。 证据：块注释起始 169 次而结束 170 次，数量不等就是配对错位一格。 HEAD 版同样中招（163/164），所以不是本轮引入。 换成 _dev/jsstrip.py 的词法扫描版（正确处理模板串的插值、正则字面量、 prev 记 token 尾词而不是一个字符），并加 node 侧 V8 交叉验证。	2026-10-03 14:22:14 +08:00