diff --git a/.workbuddy/memory/2026-10-21.md b/.workbuddy/memory/2026-10-21.md
index 0af8461..148ce28 100644
--- a/.workbuddy/memory/2026-10-21.md
+++ b/.workbuddy/memory/2026-10-21.md
@@ -451,3 +451,9 @@ CLI 端到端手动验证：`honeypot hits` / `--ip` / `--show-password` 输出
 `2d13c31` 删掉 `static/css/themes/test01.css` + `static/images/themes/test01/` 两张 webp（用户 18:19 要求）。
 `go test ./internal/theme` 仍全绿（测试里的 "test01" 只作 DisplayName 回退样例，不依赖文件）。
 ⚠️ `static/images/shiroko-cutout.png` 的删除**仍未提交**（属另一件事，docs/theme-shiroko.md 还引用它）。
+
+## 18:2x 删除 shiroko-cutout.png + 清文档引用
+
+用户确认一并删。`docs/theme-shiroko.md` 三处引用改成「参考图不入库」（不再指向具体文件路径）；
+顺手修了同页一处过时说法：**「--tb-deco 保持 6 个值」→ 10 个**（槽位早就扩到 10，漏改会让人以为写 6 个就够）。
+删除后 embed 无影响（`static/fs.go` 只嵌 `images/themes`，这个文件本来就不参与打包）。
diff --git a/.workbuddy/memory/topics/theme.md b/.workbuddy/memory/topics/theme.md
index 2944c92..2ca12c6 100644
--- a/.workbuddy/memory/topics/theme.md
+++ b/.workbuddy/memory/topics/theme.md
@@ -49,4 +49,5 @@
 - 主题选择页的色块由浅色块的 `--tb-bg` + `--tb-primary` 生成（`swatchOf`），注释里别写令牌名。
 - `test01` 是用户 2026-10-21 自建又删掉的验证主题（css + 2 张 webp 已移除，未提交）。
   删主题只需删文件：`build()` 读不到 css 会打 warning 并忽略，已选该主题的用户静默回退站点默认。
-  `static/images/shiroko-cutout.png` 只是 `docs/theme-shiroko.md` 的生成参考图，不进 embed。
+  `static/images/shiroko-cutout.png` 也一并删除（2026-10-21）：它从不进 embed，只是 docs 里的图生图参考图，
+  仓库不存这类大图。
diff --git a/docs/theme-shiroko.md b/docs/theme-shiroko.md
index 630bc6a..ef50288 100644
--- a/docs/theme-shiroko.md
+++ b/docs/theme-shiroko.md
@@ -88,7 +88,7 @@ available = default,sakura,shiroko
 
 | 素材 | 来源 |
 | --- | --- |
-| `static/images/shiroko-cutout.png` | **用户自行用 AI 生成**的立绘，仅作生成参考图，不再上页面 |
+| 立绘参考图 | **用户自行用 AI 生成**，仅作 image-to-image 的 `image1`，不上页面、**不入库**（2026-10-21 移除，仓库里不存大图）|
 | `chibi/window.webp` | WorkBuddy ImageGen 生成（文生图 → image-to-image 转平涂），再抠白底 |
 | `chibi/wave.webp` 等 | WorkBuddy ImageGen **以用户立绘为参考图**（image-to-image）生成，再抠白底 |
 | `scene-desktop.webp` / `scene-mobile.webp` | WorkBuddy ImageGen 生成（提示词见下），未使用任何外部素材 |
@@ -96,7 +96,8 @@ available = default,sakura,shiroko
 
 ### 生成与抠图参数
 
-- 参考图：`static/images/shiroko-cutout.png`，`input_fidelity: high`，保证角色造型与平涂风格一致；
+- 参考图：用户提供的立绘（**不入库**，随便放个工作目录，传给 `image1` 即可），
+  `input_fidelity: high`，保证角色造型与平涂风格一致；
 - 提示词骨架（四个姿态共用，只改动作句）：
 
   > Same character, same art style as the reference image: flat vector illustration, no outlines,
@@ -156,9 +157,10 @@ available = default,sakura,shiroko
 ## 替换 / 扩素材
 
 1. 加姿态：按上面的提示词骨架换动作句生成，白底 → 抠图 → 存 `chibi/<name>.webp`（高 620），
-   再塞进 `shiroko.css` 的 `--tb-deco`（记得保持 6 个值，并按上面的摆位原则定位）。
+   再塞进 `shiroko.css` 的 `--tb-deco`（**必须保持 10 个值**，`--tb-deco-size` / `-position` 同步补齐，
+   少写几个不会报错、只会让图层与尺寸错位；`TestDecoSlotCount` 会拦），并按上面的摆位原则定位。
    换 `<img>` 时别忘了给 URL 带 `?v=`——图片不走 `StaticVersion` 缓存键，`max-age` 是 1 天。
-2. 换立绘：透明 PNG 覆盖 `static/images/shiroko-cutout.png`，再按同一提示词骨架重新生成姿态。
+2. 换立绘：准备一张透明 PNG 立绘当参考图（不入库），再按同一提示词骨架重新生成姿态。
 3. 换配色：改 `shiroko.css` 的令牌即可，插画是位图，换色需重新生成。
 4. 新增素材不需要改 `static/fs.go`（已嵌整个 `images/themes` 目录）；但改了 CSS 必须把
    `conf.StaticVersion` +1，否则老访客吃缓存看不到变化。
diff --git a/static/images/shiroko-cutout.png b/static/images/shiroko-cutout.png
deleted file mode 100644
index 3a384de..0000000
Binary files a/static/images/shiroko-cutout.png and /dev/null differ