docs(build): 安装包嵌的是前端快照 —— 前端改动后必须重打,并给出自查命令

This commit is contained in:
2026-09-12 08:10:27 +08:00
parent 84c1d749cd
commit 0997d441af

View File

@ -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 分钟后失败