Files
tamabox/.workbuddy/memory/2026-10-22.md
T
tamakyi c9f22cb81b 修窄屏装饰层压不住作用域块(手机上一直显示桌面版樱花)
@media 不提升特异性:作用域块 html[data-theme-style][data-page-scope="box"] 是 (0,2,1),
媒体查询里写的 html[data-theme-style] 只有 (0,1,1),于是「窄屏装饰层全置 none」这行
从来没生效 —— 手机上照样铺开桌面的花枝与花朵。深色作用域块是 (0,3,1),更压不住。

- 媒体查询里补三条同特异性的通配规则(作用域 0,2,1 / 深色基础 0,2,1 / 深色+作用域 0,3,1),
  媒体块在文件更后,同特异性即胜出。
- 新增 TestNarrowMediaOverridesScopedDeco:外层每处非 none 的 --tb-deco,都要求窄屏里有
  同属性名、属性数不少于它的声明。变异验证过(删掉深层那条立即 FAIL)。
  它同时报出 shiroko 的 900px 块只覆盖浅色 —— 但深色块本就是 none,不算缺陷,故跳过。
- 窄屏改由加强版底纹承担樱花(透明度 ×1.9、格子 180px):桌面那套 0.18~0.34 的透明度
  在 390px 上实测接近纯粉。顶栏与卡片之间那条 35px 带子试过放小花,question/admin 页卡片
  从 y=110 起会切掉一半,最终不放装饰层。
2026-10-22 11:18:29 +08:00

4.4 KiB
Raw Blame History

2026-10-22

new-sakura 主题:纯 CSS 樱花

用户要求「用编辑器生成 new-sakura,CSS 做樱花、每页位置不同、上传到已配好的 S3」。

  • 结论:生成器做不了这个 —— 它的装饰层只支持图片素材(导出打 zip / 传对象存储), 没有内联 SVG 图层。所以改成手写主题 CSS(结构完全遵循生成器输出:令牌 + 10 槽 deco + scope 覆盖),生成器只用来做视觉验证。
  • 实现:dev/theme-tools/gen_new_sakura.py 生成 static/css/themes/new-sakura.css。 花/瓣/枝/底纹都是内联 SVG 的 data URI(quote(svq, safe="") 全编码,避免 URI 里的 逗号被 TestDecoSlotCount 当成分层符)。CSS 50KB(gzip ≈12KB)。
  • 六个 scope 各一套 --tb-deco 位置;窄屏(≤640px)装饰全关、底纹缩到 200px; 深色换亮粉 + 关底纹(浅粉压深底=噪点)。
  • 调参踩到的:①花枝 auto 390px 放右上角时可见部分只剩一团花 → 缩到 300px 并内移; ②枝上 5 朵 scale≈1 的花是一串糖葫芦 → 改成 8 朵 0.4~0.62; ③底纹 260px 双花双瓣读成「包装纸」→ 改成 300px 一朵花 + 两片瓣、各自错位。
  • 对比度:primary 候选 #c14a72 只有 4.39:1,压深到 #b8436a(4.87);muted #77626a(5.27); 深色 #ff93b4(8.17)/#ab9099(5.82)。
  • i18n 四份词典加 theme.name.new-sakura(插在 shiroko 之后,gofmt_keep_crlf 后每份只 +1 行); conf/app.sample.ini 的 available 登记。
  • ⚠️ 本机 Chrome/Edge 的 localStorage 里没有生成器的 S3 配置记录,项目也没有 conf/app.ini → 「已预先配置好的 S3」在本机取不到,上传这一步需要用户给凭据。 纯 CSS 主题本身零素材,严格来说 S3 无事可做(已向用户确认)。

R2 自定义域可用 + 素材包一键上传(接上一条)

  • r2.337845818.best 实测公开可读(7 个对象全部 200、Content-Type 正确);桶的 S3 endpoint 仍 403。
  • 樱花位图从 gen_new_sakura.py 的同一份 SVG 导出(export_assets.py 直接 import 它,不另画), --upload 一次传 CSS + 5 张 webp + 生成的 INSTALL.txt(域名/体积写实数)。
  • serve.upload_files 支持逐文件 cacheControl:原来硬编码 immutable,而 INSTALL.txt / 镜像 CSS 的键不带版本 → 改了看不到。现在位图 1 天、CSS 5 分钟、README 60 秒。
  • ⚠️ CF 边缘缓存不会因为重传而失效:第一版以 immutable 传过,cf-cache-status: HIT、Age>800, 重传后拿到的仍是旧副本(带 ?cb= 才是新内容)。清缓存只能去控制台按 URL 清。
  • ⚠️ gzip 纠错:服务端 internal/route/gzip.go 会压 CSS,内联版 51KB 实际传输 3.9KB, 位图版 2.7KB + 5 张图 48.9KB ≈ 51.6KB。所以"换位图省 CSS 体积"是错的 —— 位图唯一的理由是素材要给非 CSS 场景复用。文档与 INSTALL.txt 都已改。
  • image_bucket_cdn_host 沿用 app.ini 同名键(只写主机名),export_assets.py 据此拼公开地址。

6) 窄屏覆盖被作用域块压死(真 bug,已修)

  • 现象:@media (max-width:640px) 里把 --tb-deco 全写 none,手机上却照样是桌面装饰层。
  • 根因:媒体查询不提升特异性。作用域块 html[data-theme-style][data-page-scope="box"] 是 (0,2,1),媒体里写的 html[data-theme-style] 只有 (0,1,1) → 压不住;深色作用域块 (0,3,1) 更难。
  • 修法:媒体查询里按「作用域通配 [data-page-scope](0,2,1)」+「深色基础(0,2,1)」+ 「深色+作用域(0,3,1)」各写一条,靠文件更晚取胜。shiroko 的 900px 块只对浅色有效, 但它的深色块本来就是 none,所以不算坏。
  • 守门:新增 internal/theme/narrow_test.go::TestNarrowMediaOverridesScopedDeco ——外层每处非 none 的 --tb-deco,媒体查询里必须有「同属性名、属性数不少于它」的选择器; 变异验证过(删掉深色基础那条立刻 FAIL)。
  • 手机端最终决定不放装饰层:试过顶栏与卡片之间那条 35px 带子,box 页 OK、question/admin 页卡片从 y=110 起就切半个 → 变成黏在卡片边的粉色碎块。改用加强版底纹(透明度 ×1.9、格子 180px)。
  • 埋点:gofmt -l internal/theme 会报 slots_test.go(它是 CRLF),新增文件是 LF,别顺手格式化它。