diff --git a/client/electron/BUILD.md b/client/electron/BUILD.md
index b32f161..5ba9ff5 100644
--- a/client/electron/BUILD.md
+++ b/client/electron/BUILD.md
@@ -12,6 +12,19 @@ npm run build:win       # NSIS 安装器
 
 产物在 `release/`（已在 `.gitignore` 里，不要提交 —— AppImage 约 122MB、deb 约 100MB）。
 
+> ⚠️ **安装包里嵌的是前端的一份快照**（构建时的 `dist/`）。
+> 因此**任何前端改动（组件、样式、主题、背景）之后都必须重打安装包**，
+> 否则 `release/` 里那份会静默地是旧界面 —— 而它本身不会报错，
+> 只有装上去的人会看到与 Web 不一致的样子。
+>
+> 自查（不需要真正安装）：直接查包内 asar 里的 CSS 有没有你刚加的东西：
+>
+> ```bash
+> node -e "const a=require('@electron/asar');const l=a.listPackage('release/linux-unpacked/resources/app.asar');
+> const c=l.find(p=>/\\/dist\\/assets\\/index-.*\\.css$/.test(p));
+> console.log(c, a.extractFile('release/linux-unpacked/resources/app.asar', c.replace(/^\\//,'')).toString().includes('--bg-scrim'))"
+> ```
+
 ## 本机环境的两个坑
 
 ### 1. `SHASUMS256.txt` 不可达 → 构建会卡 10 分钟后失败