Files
tamabox/.workbuddy/memory/topics/builder.md
T
tamakyi 27856dd4a2 字号阶梯收尾 + 主色补到 WCAG AA(新增 --tb-on-primary)
一号事项(剩余令牌化):
- templates/user/profile.html 20 处、base.css 9 处 font-size 全部落到 --tb-fs-*
- base.css 导航四档(0.95/0.88/0.82/0.78)合并成「桌面 md → ≤1000 xs」;logo 三档统一 lg
- 有理由保留的:.tb-pin-flag / .md-body code 的 0.9em(相对父级)、验证码 1.4/1.2rem(等宽字形)、
  chat 关闭按钮 40px、password 页 3em、mail/*(邮件客户端不保证 var());行内 12px/0.75rem 等值顺手换掉

二号事项(主色对比度):
- base/default #1e87f0(3.42) → #0e6fd0(4.70);shiroko #4a7fc1(3.69) → #3b6dac(4.74);
  sakura #e5678f(2.80) → #ba3e66(4.70,饱和度压到 .5 保持柔和)。同色相只压亮度,目标 4.7 留余量
- 深色块 muted 之前只对 --tb-bg 算(4.7 以为过了),对压平后的卡片其实 4.31/4.17 → 提到 #a18790 / #7f8ea1
- 新增 --tb-on-primary(亮 #ffffff / 暗 #0b1016):深色模式主色偏亮,白字只有 2.2~3.1:1,
  用同一个令牌兼顾「链接色要深」和「按钮底要深」是矛盾的。.uk-button-primary 与
  .uk-label:not(语义色) 改吃它 → 深色按钮变成浅底深字(6.10 / 8.65 / 7.27)
- 顺手封掉几处主色泄漏:header 验证码 focus、profile .feat-day.is-on、explore 随机投票的 JS outline、
  vote-results 行内色,全部改成令牌(否则换主题时不跟着变)

生成器同步:paletteVars 导出 --tb-on-primary(白字/深字择优);?dump=palette 增加
onPrimaryCr / onPrimaryPickedBest / warnings —— 主色卡中间调时只警告不判失败;
配色面板给橙色提示。_scaffold 令牌 29 → 30。StaticVersion → 20261021c。

验证:TestSwatch 断言同步为 #ba3e66;8 种组合(base 亮暗 + 三主题亮暗)对比度全部 ≥4.5;
go test internal/{theme,templates,conf,i18n} 全绿;生成器 validate/fit/quality/palette/layers/fx/fxpipe 全过。
2026-10-21 18:39:08 +08:00

4.4 KiB
Raw Blame History

主题生成器 dev/theme-builder/(长版明细)

主题生成器 dev/theme-builder/

  • serve.py 起静态服务(8777),iframe 加载 outputs/preview-*.html。file:// 下父页读不到 iframe DOM,必须走 HTTP。 8777 常由用户自己起着,改完直接刷新。
  • 单文件 index.html(约 2900 行)。图片处理非破坏:orig 存原始字节 + fx 存参数,每次从 orig 重算; 参数没变则跳过重编码。画质(S.export.quality/maxSide)同理 —— 改完 rebakeAll() 从 orig 重来,不叠加压缩。
  • 尺寸单位 4 档:fit(按视口高,人物)/ fitw(按视口宽,横幅)/ px / vh。 layerSize() 出 CSS、unitGeom() 出预览框,两处必须共用同一函数,否则「框没超、图已裁」。 ⚠️ 下拉的 value 用 l.unit,不能用 unitOf(l)(后者把 fit 归一成 vh → 选了 fit 却显示 vh)。
  • 溢出检测 layerMetrics(l, a, VW, VH):算 left/top/overL/R/T/B,编辑器里显示「显示 131×420,完整可见」或 「⚠ 左右各 88px 越界」,并给「按当前视口修好」按钮(切 px + 算刚好放下的尺寸)。导出前 overflowReport() 再扫一遍。
  • 视口预设带高度(1512×900 / 1280×800 / 1024×768 / 820×1180 / 390×844):裁切几乎全由高度决定, 只改宽度模拟不出来。fitStage() 按预设高渲染 iframe。
  • 窄屏:全局 hideDeco(急停)> 每层 mob(inherit/scale/hide)> 尺寸单位(fit/fitw 自己就缩)。 ⚠️ hideDeco 会把 @media 里 10 槽全写 none —— 桌面完全正常、手机上素材全没了, 这是「素材在窄屏消失」的头号来源(test01 就是这么中招的)。UI 已在勾选时给橙色警告、 图层行标「窄屏隐藏」、加层/导出再提醒;?narrow=hide 可一键复现。 ⚠️ @media 里每个独立配置的 scope 都要写一条 [data-page-scope="x"]:页面覆盖块特异性 (0,2,1), 只写 html[data-theme-style](0,1,1) 的话独立配置页在手机上完全不生效。 ⚠️ 竖版图只替换本来有背景图的页面(cfg.bg 非空),否则等于给纯色页塞了张图。
  • ⚠️ 派生文字色必须走对比度下限,不能按固定比例混:paletteVars 里 text-secondary = mixToContrast(text, backdrops, 5.5)、text-muted = 4.5(WCAG AA)。 旧的 mix(text,bg,0.55) 在浅底只有 2.9:1 —— 每导一次主题就把 base.css 的 AA 修复覆盖回去。
    • 半透明卡片(--tb-surface: rgba(255,255,255,0.86))必须 flatten() 压到底色再算,否则按纯白算偏低;
    • 参考背景取「页面底色 + 压平后的卡片」两者更不利的那个;
    • 手填正文本身不达标时原样返回(宁可不够淡,不能产出看不见的字)。
    • 配色面板有读数(正文/次要/淡文字/主色),<4.5 变橙;默认 primary 已压到 #3d6fac(4.63)。
    • 还要导出 --tb-on-primary(白字 #ffffff / 深字 #0b1016 里挑对比度更高的): 深色模式主色偏亮,白字只有 2.2~3.1:1。主色卡中间调时两种字都不够 → 面板橙色提示 + ?dump=palette 的 warnings,不判失败(是主色要调,不是工具挑错)。
  • 自检钩子:?dump=css|zip|validate|install|fx|fxpipe|fxkey|layers|fit|quality|palette,?demo=1&fresh=1&rows=N&scope=&loadurl= (?demo=1 已含 fit 层 + 竖版背景,@media 才会生成)。用法: chrome --headless=old --virtual-time-budget=12000 --dump-dom "http://127.0.0.1:8777/dev/theme-builder/index.html?demo=1&fresh=1&dump=fit" 抓 <pre id="dump">(正则要带属性:<pre id="dump"[^>]*>)。
  • ⚠️ canvas toDataURL('image/webp', 1) 不能用:Skia 在 q=1 切无损,输出反常(噪声图 q=1 只 52KB, q=0.95 是 440KB)。canvasAsset 夹到 0.95,滑块上限也是 0.95。
  • ⚠️ 平涂/线稿降 q 可能变大(有损引入噪点)。压体积先砍长边,再降 q。缩小走 imageSmoothingQuality='high'。
  • ⚠️ 面板只有 ~240px:input[type=range] 有固有宽度,必须 flex:1 1 0;width:0;min-width:0, 且数值放进 label 里(第三个小 flex 项会被顶出可视区)。
  • ?dump=css 的产物要过 Go 侧校验:临时存成 static/css/themes/<非下划线名>.css 再 go test ./internal/theme, 跑完删掉。