生成器新增「顶栏」面板：实色 / 半透明磨砂 / 全透明（仅预览）

以前顶栏只能在配色里填一个颜色字符串：写 rgba 拿不到模糊，档位和颜色又分在两处，
改了一处就忘了另一处。现在三档一个面板说话。

- S.navbar = {mode, alpha, blur}，基色仍取「配色 → 顶栏」，navbarValue() 统一计算：
  solid 先 flatten 压平（旧工程里可能自带 alpha）、glass 加 alpha、clear 出 transparent。
  半透明档额外写 .uk-navbar-container{backdrop-filter:blur(N)} —— 令牌只能给颜色，
  模糊必须落成规则；选择器不带 data-theme，深浅两套共用一条。
- 全透明**只给预览**：validate() 拦导出，与 internal/theme 的 TestNavbarNotFullyTransparent
  同一条规矩，面板上直接写明原因。
- 面板带「导航文字 x.x:1」读数，按压平后的顶栏算（半透明时是顶栏压在底色上的结果），
  低于 4.5 变橙。
- 旧工程迁移：配色里塞过 rgba(...,0.52) 的，按 alpha 反推档位（1→实色 / 0→全透明 / 其余→半透明），
  打开旧工程不会突然变实色。
- 自检 ?dump=navbar（10 项：三档产出、blur 有无、全透明被拦、alpha 0.2/0.95 边界）。
- 滑杆步长 0.02 → 0.01：0.55 会被吸附成 0.54/0.56，手感像坏了。

dev/theme-builder/README.md

@@ -169,6 +169,23 @@ python dev/theme-builder/serve.py --host 127.0.0.1   # 只给本机用（公共
 顺带：这套字号阶梯（`--tb-fs-xs…hero`）来自 `base.css`，生成器**不碰字号** ——
 主题的职责是配色与背景，改字号会连带挤坏所有页面排版。
 
+**顶栏** —— 三档，只管「配色 → 顶栏」那个基色怎么用：
+
+| 档位 | 输出 | 适用 |
+| --- | --- | --- |
+| 实色 | `--tb-navbar: rgb(...)` | 页面没有装饰层穿过顶栏；最简单 |
+| 半透明 | `--tb-navbar: rgba(...,0.72)` + `backdrop-filter: blur(12px)` | 装饰层从角落长出来、会经过顶栏时（推荐） |
+| 全透明 | `--tb-navbar: transparent` | **只能预览**，导出会被拦 |
+
+- 半透明档的两个滑杆：不透明度 0.2~0.95、背景模糊 0~24px。令牌只能是颜色值，
+  模糊另外写成 `.uk-navbar-container:not(.uk-navbar-transparent)` 规则（深浅两套共用一条）。
+- 面板底部有 `导航文字 6.0:1` 的读数，按**压平后的顶栏**算（半透明时是「顶栏压在底色上」的结果，
+  不是顶栏色本身）。低于 4.5 变橙 —— 装饰层从顶栏后面穿过时还会更低，取最不利情况定透明度。
+- ⚠️ **全透明不给导出**：顶栏一透明导航就失去依托、文字直接压在花纹上，比"被裁一段"更糟。
+  这一档留着的唯一用途是**预览对比**；`validate()` 会拦，仓库的 `TestNavbarNotFullyTransparent`
+  也会拦（两处同一条规矩，生成器里绕过也没用）。
+- 旧工程（配色里直接塞 `rgba(...,0.52)`）打开时按 alpha 反推档位：1 → 实色、0 → 全透明、其余 → 半透明。
+
 **图片池** —— 上传任意张，浏览器本地转 WebP。导出时只打包实际用到的图。
 每张图左上角有 `fx` 按钮，进处理面板（处理过的会高亮）。
 
@@ -362,6 +379,7 @@ INSTALL-<slug>.txt
 ?dump=fit          尺寸自适应回归（五档视口占用、溢出检测、fitw、旧工程兼容、@media 覆盖各作用域）
 ?dump=quality      画质回归（q 单调性、q=1 被夹到 0.95、长边上限真的压像素）
 ?dump=palette      派生文字色的对比度回归（四种配色下 ≥AA、层级不倒挂、手填低对比不继续变淡）
+?dump=navbar       顶栏三档回归（实色无 blur、半透明带 alpha+blur、全透明被 validate 拦、alpha 边界）
 ?dump=fxkey        端到端去白底：载入白底图，统计透明像素比例
 ?loadurl=/static/images/x.webp&fx=x
                    直接把项目里的图当素材载入（不必先下载再上传），fx= 打开处理面板