mindfulness/spec_kit/iOS Widget/plan.md

iOS Widget（技术计划，V1 写死文案）

1. 计划目标

在 iOS 上实现真正可添加到桌面的小组件（WidgetKit Extension），V1 先展示写死的美观文案，不做 App->Widget 数据同步与更新。

• 构建方式：方案 A（expo prebuild + Xcode）
• 点击跳转：跳转到 App 的 Home
• 尺寸：Small / Medium / Large 都支持

2. 默认技术决策

• 小组件实现：iOS 原生 WidgetKit Extension（SwiftUI）
• 数据来源：V1 写死在 Widget 代码内
• 跳转：使用 Widget 的 widgetURL 打开 App（深链）
• App 侧路由：使用现有 expo-router

3. Deep Link 约定（点击小组件打开 Home）

3.1 Scheme

当前 client/app.json 中已存在：

• expo.scheme = "client"

因此小组件点击跳转使用：

• client:///(app)/home

说明：这是 expo-router 的路径形态；若你后续调整路由结构，需要同步更新此 URL。

4. 实施步骤（高层）

1. 预构建 iOS 原生工程：生成 client/ios/
2. 在 Xcode 创建 WidgetKit Extension：命名例如 MindfulnessWidget
3. 实现 3 种尺寸 UI：Small/Medium/Large 都展示写死文案，但排版适配不同尺寸
4. 设置点击跳转：为 Widget 配置 widgetURL 指向 client:///(app)/home
5. 本地运行验证：在模拟器安装 App，添加桌面小组件并验证显示与跳转

5. 验收标准

• 可以在 iOS 桌面添加小组件（Small/Medium/Large）
• 小组件展示写死文案，排版美观
• 点击小组件能打开 App 并进入 Home

6. 风险与注意事项

• Expo Go 不支持：必须用 Xcode 运行预构建后的 App（或后续 EAS Build）
• Bundle Identifier：当前 client/app.json 使用 com.anonymous.client，仅适合本地验证；上线前需替换为真实 bundle id，并同步证书/签名