fix:小组件- PUSH

spec_kit/Daily Widget Reco/overflow.md

@@ -0,0 +1,24 @@
+# Daily Widget Reco（补充说明 / Overflow）
+
+## 1. 关键配置
+
+- **App Group suiteName**：`group.com.damer.mindfulness`
+- **后端鉴权**：无
+- **多语言**：仅 `en / tc`
+
+## 2. 共享存储 Key（App ↔ Widget）
+
+- `widget.config.v1`
+  - 字段：`schema_version=1`、`saved_at`、`apiBaseUrl`
+- `widget.userProfile.v1_2`
+  - 字段：`schema_version=1`、`saved_at`、`user_profile`（结构对齐 `UserProfileV1_2`）
+- `widget.dailyReco.v1`
+  - 字段：`schema_version=1`、`saved_at`、`day_key`（本地日 `YYYY-MM-DD`）、`lang`、`item{content_id,text}`、`source`
+
+## 3. 更新策略（双通道）
+
+- **Widget 主动拉取**：缓存过期时请求 `POST /v1/reco/widget`，写回 `widget.dailyReco.v1`，并使用 `TimelinePolicy.after` 设定次日刷新
+- **App 辅助刷新**：
+  - 启动与回到前台时调用 `ensureDailyWidgetRecoUpToDate`
+  - 成功写入缓存后调用 `WidgetCenter.reloadAllTimelines()`（系统仍可能延迟）
+