修 shiroko 单车/步枪素材「白色没抠」：白上白只能全白转透明

根因不是抠图参数：素材是白底+白车架，车架涂装与背景白是同一个值（都是 #f9f9f9），
颜色上无法分离。四角 floodfill 只吃掉外圈，轮圈内、车架三角、车筐、枪与车架之间的白整块留着，
量化就是不透明像素里近白(>240) 占 50%。

- 处置：min(r,g,b)≥238 软过渡 + 饱和度>14 保留彩色 → 白全透明。近白降到 0.0%，
  不透明率 19.4%，29KB；轮辐/车架/车筐成为描边，粉轮圈、蓝枪托、接触阴影保留
- 试过「按近白厚度区分白洞与白涂装」（腐蚀测厚度）→ 失败：轮辐间扇形白楔 9~13px 与车架管
  5~10px 重叠，阈值怎么调都会留白楔，比原图更难看
- 画布保持 397×259 不裁：deco-size 是 auto 259px，宽度按比例算，裁了锚点会漂
- css 图片 ?v= → 20261021a；StaticVersion 20261021c → 20261021d（css 内容变了必须换缓存键）
- docs：assets-spec 补「白上白」取舍与验收项「不透明像素近白占比≈0」，theme-shiroko 素材表同步

.workbuddy/memory/2026-10-21.md

@@ -528,3 +528,26 @@ base.css 还原成 CRLF，插入行要用同一行尾，否则变 MIXED。
   真实排版没问题 —— 移动端必须用**宽度锁定的 iframe**（生成器那套）验，别据 window-size 结论判 bug。
   shiroko 的窄屏块（≤900px）只有一条 `html[data-theme-style]`(0,1,1)，但它没有任何
   `[data-page-scope]` 块，所以不会被压住；深色块的 `--tb-page-image` 覆盖窄屏属预期（深色不用实景照）。
+
+## 19:2x shiroko 单车/步枪「白色没抠」→ 白上白，只能全白转透明
+
+**根因不是抠图参数**：素材是「白底 + 白车架」。采样确认车架涂装与背景白是同一个值
+（都在 `#f9f9f9`，差 0~3 级），颜色上完全分不开；四角 floodfill 只吃掉外圈，
+轮圈内、车架三角、车筐、枪与车架之间的白整块留着 → 看着像没抠。
+量化：修复前**不透明像素里近白(>240) 占 50%**，全透明只有 43%。
+
+试过三种程序化方案（都写了脚本）：
+1. 只按「近白厚度」区分白洞/白涂装（腐蚀测厚度）→ **失败**：轮辐间的扇形白楔宽 9~13px，
+   与车架管 5~10px 重叠，阈值怎么调都会留下白色楔子（更难看）。
+2. 全白转透明（`min(r,g,b)≥238` 软过渡 + 饱和度>14 保留彩色）→ 采用。成果：
+   不透明率 19.4%、近白 0.0%、29KB；轮辐/车架/车筐全成描边，粉色轮圈 + 蓝枪托 + 阴影仍在。
+3. 手绘 SVG 替换：未做（不如现成素材真实）。
+
+**代价要记住**：车身填色一起没了，成品是**线稿风**，在 1512 整页里偏淡（远看像铅笔稿）。
+若用户要「实心车」，唯一正解是重出一张**绿幕/透明背景 + 车身用浅灰蓝等中间调**的素材
+（白车在浅场景里本来就发飘），已写进 docs/theme-shiroko-assets-spec.md 的「白上白」小节，
+验收清单也加了「不透明像素近白占比应≈0」这条。
+
+改动：`props/bike.webp`（397×259 画布不变，位置公式不用动）、css 里图片 `?v=20261020d→20261021a`、
+`StaticVersion 20261021c→20261021d`、两份 docs 同步。`go test ./internal/theme` 全绿。
+⚠️ 画布尺寸**不能裁**：裁完 `auto 259px` 的显示宽度变了，`left calc(50% - 612px)` 的锚点会跟着漂。

.workbuddy/memory/topics/theme.md

@@ -52,3 +52,9 @@
   删主题只需删文件：`build()` 读不到 css 会打 warning 并忽略，已选该主题的用户静默回退站点默认。
   `static/images/shiroko-cutout.png` 也一并删除（2026-10-21）：它从不进 embed，只是 docs 里的图生图参考图，
   仓库不存这类大图。
+- ⚠️ **白上白素材无法用颜色分开**：白底 + 白主体（如自行车）时，车身与背景是同一个白
+  （实测都 `#f9f9f9`），floodfill 只吃外圈，轮圈内/车架三角/车筐整块留下 = 看着"没抠干净"。
+  自检：`不透明像素里近白(>240) 占比`，正常应≈0（修复前 50%）。要么全部转透明（成品变线稿风），
+  要么重出绿幕/透明背景素材。细节见 `docs/theme-shiroko-assets-spec.md` 的「白上白」。
+- ⚠️ 换 `props/*.webp` 时**不要裁画布**：`--tb-deco-size` 是 `auto 259px`，宽度按原图比例算，
+  裁完锚点 `left calc(50% - 612px)` 会漂；四周透明边留着不影响观感。