feat(webui): 界面加构建戳 —— 让"我这边改了没"变成可核对的

用户连续三轮说「webui 还没改」,而我每次都能证明部署是活的(入口 no-cache、
资源哈希 immutable、线上 bundle 与本地构建逐字节一致、无头浏览器实测生效)——
问题在于**隔着屏幕说不清对方的浏览器跑的是哪一份**。

现在界面里显示一行 `界面构建 <git短哈希>·<月日-时分>`(外观设置面板页脚):

- `vite.config.ts` 在构建时注入 `__BUILD_STAMP__`(git 短哈希 + 构建时刻)
- `BackgroundPicker` 渲染它,并带 title 说明格式
- 判据 4 条(vite 注入 / 组件渲染 / **产物里真的有** / 判据自检:正则不能匹配随便一段文本)

实测:产物与线上都是 `d2904fc·0914-0910`;刷新后数字变了就是拿到了新构建。

顺带修正一处过时文案:图片说明还写着"保存在本机",而它现在同时存到账号里
(服务端 + 本地缓存)。

前端 254 条 + 新增 4 条、打包一致性、server 10 包全绿;桌面包已重打。
This commit is contained in:
2026-09-14 09:11:36 +08:00
parent d2904fc45d
commit be13ae5959
4 changed files with 88 additions and 1 deletions

View File

@ -156,7 +156,7 @@ export default function BackgroundPicker() {
</div>
)}
<p className="text-2xs text-gray-500">
2560px 2.4MB
2560px 2.4MB
</p>
{error && (
<p role="alert" className="text-2xs text-red-600">
@ -195,6 +195,8 @@ export default function BackgroundPicker() {
</p>
</div>
)}
<BuildStamp />
</div>
);
}
@ -243,6 +245,21 @@ function Slider({
/** 「恢复默认」用到,导出以便测试断言默认值形状。 */
export { DEFAULT_BACKGROUND };
/**
* 界面构建戳。
*
* 用户连续三轮说"webui 还没改",而每次都能证明部署是活的 —— 问题在于浏览器跑的
* 是哪份 bundle隔着屏幕说不清。这行字把这件事变成可核对的它与部署产物同源
* vite define 注入,见 vite.config.ts刷新后数字变了就是拿到了新构建。
*/
function BuildStamp() {
return (
<p className="text-2xs text-gray-400 mt-4 pt-3 border-t border-gray-200" title="界面构建git 短哈希·月日-时分)">
{typeof __BUILD_STAMP__ === 'string' ? __BUILD_STAMP__ : 'unknown'}
</p>
);
}
/**
* 同步状态徽标。
*