@@ -67,9 +67,17 @@ share_target 对称）+ manifest shortcuts/screenshots；P2 showSaveFilePicker /
   `'unsupported'` 供回退）；两个截图 hook 的管线抽 `runCapture(mode)`，`mode='share'` 时把卡片图转
   File 系统分享，不支持/失败回退 `a[download]` 保存；推文与 IG 三点菜单各加「分享截图」（ImagePlus，
   截图中禁用防并发）。
-- **门禁**：typecheck / lint（仅改动文件，避免 eslint 重排全仓 md）/ test 360 / `verify --module pwa
-  --exit-on-fail`（38）全绿。
+- **版本更新提示（AC-PWA-008，优雅更新）**：owner 问「已安装用户如何优雅版本更新」→ 选「提示刷新」。
+  因 SW 零缓存/SSR 回源，无旧 HTML 滞留，唯一缺口=已打开窗口需 reload 才见新 bundle。新增
+  `app/lib/pwa/update.ts`（可见/聚焦 10min 节流 `registration.update()`；`updatefound`→`installing`
+  statechange；`shouldOfferUpdate` 仅在**受控且有新 worker 接管**时提示，首次访问不打扰，单会话去重）
+  + `app/components/pwa/UpdateNotice.tsx`（底部横幅「发现新版本·立即刷新」，稍后可隐藏；reload 前对
+  waiting worker `postMessage({type:'SKIP_WAITING'})`），挂载 root `<body>`（SSR null）；`sw.js` 补
+  message→skipWaiting 通道（仍零缓存）。
+- **门禁**：typecheck / lint（仅改动文件，避免 eslint 重排全仓 md）/ test 366 / `verify --module pwa
+  --exit-on-fail`（44）全绿。
 - **提交**：`6a49f8a` feat(pwa) iOS+manifest；`807660b` feat(share) share-out；`cfd84c3` feat(share)
-  share 截图；`f776c3d` docs AC v1.2；`9ac167a`/`e954616`/`d22ec18` docs。
-- **待 owner**：真机验证（安装 / share 进出 / share 截图发聊天 / iOS 添加主屏幕 / 安装对话框截图）；
-  maskable 图标与 apple-touch-icon 底色观感（视觉项）。
+  share 截图；`63ce84b` feat(pwa) 版本更新提示；`f776c3d`/`2d84c59` docs AC；`9ac167a`/`e954616`/
+  `d22ec18`/`3710c38` docs。
+- **待 owner**：真机验证（安装 / share 进出 / share 截图发聊天 / 更新横幅 / iOS 添加主屏幕 / 安装对话框
+  截图）；maskable 图标与 apple-touch-icon 底色观感（视觉项）。
@@ -72,15 +72,18 @@ beforeinstallprompt、`onLine` 处理。
 | 22 | Media Session | ❌ | 延后 | `media.tsx` 有 `<video>`（preload=metadata）；仅解锁播放时锁屏控制有价值，收益低 |
 | 23 | 「最近查看 / 本地历史」 | ❌（弱 PWA 关联） | P2 候选 | 无账号下解决「回访同一推文/IG」痛点：localStorage 记最近 N 条 → 首页快捷入口；与词典同思路，成本低 |
 
-## 4. 实施与下一步（2026-09-06 owner 选定并落地 4 项）
+## 4. 实施与下一步（2026-09-06 owner 选定并落地 5 项）
 
-**✅ 已落地（AC-pwa.md v1.2：AC-PWA-004~007，门禁 typecheck/lint/test 360/verify pwa 全绿）**
+**✅ 已落地（AC-pwa.md v1.3：AC-PWA-004~008，门禁 typecheck/lint/test 366/verify pwa 44 全绿）**
 
 1. iOS 安装外壳：root `<head>` apple-touch-icon + apple-mobile-web-app-* meta（AC-PWA-004）；
 2. manifest shortcuts（搜索推文 → `/search`）+ screenshots（真实 wide/narrow 首页截图）（AC-PWA-005）；
 3. 分享外发：推文/IG OptionsMenu「分享」= navigator.share，无 API 降级复制原文链接（AC-PWA-006）；
 4. 分享截图：推文/IG OptionsMenu「分享截图」把截图卡片转 File 走 Web Share L2（navigator.share files），
-   不支持环境回退下载保存（AC-PWA-007；owner 追问「分享能否带图」衍生的场景）。
+   不支持环境回退下载保存（AC-PWA-007；owner 追问「分享能否带图」衍生的场景）；
+5. 优雅版本更新：`lib/pwa/update.ts` 节流探测新 SW + root 挂载「发现新版本·立即刷新」横幅，
+   用户点击才 reload（不打断编辑/阅读），首次访问不提示（AC-PWA-008；owner 经典问题「已安装用户
+   如何版本更新」落地，见 devlog）。
 
 **剩余（未做 / 待 owner）**
 
 
@@ -60,7 +60,7 @@
 
 > 阶段计划之外、按需推进的增量项，完成后勾选。
 
-- [ ] [ux] 可安装 PWA + Web Share Target：系统分享 X/IG 链接直达推文/IG（方案：`docs/features/pwa/web-share-target.md`；AC：`verify/acceptance-criteria/AC-pwa.md`；域名：https://anon-tweet.chilfish.top/）— ✅ 已实现（AC-PWA-001/002/003 落地）；✅ 能力盘点（`docs/features/pwa/capability-audit.md`，2026-09-06：线上与仓库同步、SW #6900 健康）；✅ 场景落地（2026-09-06，AC-pwa.md v1.2 AC-PWA-004~007）：iOS 安装外壳 meta（apple-touch-icon + apple-mobile-web-app-*）+ manifest shortcuts(/search)/screenshots(wide/narrow 真实截图) + share 出向（navigator.share，降级复制原文链接）+ share 截图（卡片图转 File 走 Web Share L2 files，不支持降级下载）。**待真机验证**（安装 + 系统分享进出 + iOS 添加主屏幕 + 安装对话框截图，沙箱无设备）。视觉遗留：图标/theme_color/maskable/apple-touch-icon 底色待所有者验收。P2 候选（showSaveFilePicker / 最近查看 / 静态缓存需 ADR）见 capability-audit.md。
+- [ ] [ux] 可安装 PWA + Web Share Target：系统分享 X/IG 链接直达推文/IG（方案：`docs/features/pwa/web-share-target.md`；AC：`verify/acceptance-criteria/AC-pwa.md`；域名：https://anon-tweet.chilfish.top/）— ✅ 已实现（AC-PWA-001/002/003 落地）；✅ 能力盘点（`docs/features/pwa/capability-audit.md`，2026-09-06：线上与仓库同步、SW #6900 健康）；✅ 场景落地（2026-09-06，AC-pwa.md v1.3 AC-PWA-004~008）：iOS 安装外壳 meta（apple-touch-icon + apple-mobile-web-app-*）+ manifest shortcuts(/search)/screenshots(wide/narrow 真实截图) + share 出向（navigator.share，降级复制原文链接）+ share 截图（卡片图转 File 走 Web Share L2 files，不支持降级下载）+ 版本更新提示（可见/聚焦探测新 SW → 横幅「立即刷新」，首次访问不打扰，AC-PWA-008）。**待真机验证**（安装 + 系统分享进出 + iOS 添加主屏幕 + 安装对话框截图，沙箱无设备）。视觉遗留：图标/theme_color/maskable/apple-touch-icon 底色待所有者验收。P2 候选（showSaveFilePicker / 最近查看 / 静态缓存需 ADR）见 capability-audit.md。
 
 ## 不做清单（裁决为删除/延后，Apple 式减法）