05-实现收口结论-2026-04-14

实现收口结论（2026-04-14）

这份文档记录这次产品文档同步所依据的最新事实节点。

1. 同步依据

本次以以下最新节点为准：

• 设计：
  • EveryDayJapanese-iOS/pencil/EveryDayJapanese-iOS.pen
  • EveryDayJapanese-iOS/docs/superpowers/specs/2026-04-13-yomiya-onboarding-07-20-reflow-design.md
  • feature/yomiya-onboarding-ios:docs/superpowers/specs/2026-04-13-yomiya-onboarding-pencil-07-19-ios-alignment-design.md
  • feature/yomiya-onboarding-ios:docs/superpowers/specs/2026-04-14-yomiya-onboarding-motion-and-badge-unification-design.md
• 实现提交：
  • 0388fcc feat: refine onboarding motion and bottom anchoring
  • ad6fad7 feat: refine onboarding plan result finale
  • fec8c16 feat: finalize onboarding modal flow and weekly default continue

2. 设计源管理结论

• 主目录与 worktree 中的 .pen 文件已核对为同一份内容。
• 当前应该只把主目录中的 EveryDayJapanese-iOS/pencil/EveryDayJapanese-iOS.pen 作为主维护对象。
• worktree 中的 .pen 当前可以视为由 git worktree 带出的镜像副本，不应继续独立维护。

3. opening 段当前收口

3.1 Brand Intro

• 白底
• 使用真实 logo 与真实 mascot
• 当前最短停留时间：2.7s
• mascot 继续保持“从下往上”进入
• mascot idle 动效改成向下压住底边，避免底部抬起露白

3.2 Welcome Showcase

• 02-05 共 4 个可见页面
• 当前每页轮播时长：3.0s
• 主按钮和 我已有账号 全程可点

3.3 Coach Intro

• 当前 👋 emoji 已按 Pencil 收口为 36
• 继续复用 coach 图，但比例缩小

4. header 与内容 reveal 当前收口

• 带返回和进度条的页面，顶部 header 不参与位移/淡入，不再跳动
• 内容按从上到下分组 reveal，而不是整页一起滑入
• 18 Explanation 与 19 Generating 的 badge 已统一成圆形红底白勾

5. 20 Plan Result 当前收口

当前 plan result 已不再使用旧的“结果页 + 固定底托”口径，而是以下结构：

• 顶部无返回、无进度、无壳层
• 标语固定：七天，听见进步
• coach 提示语在标题下方
• 底部按钮固定：出发吧！
• 按钮悬浮在物理屏幕底部，不再带白色底托
• 页面整体向下滚动，按钮上方持续露出下方内容

当前内容顺序：

1. coach 提示气泡
2. 成功暗示图
3. 计划摘要卡
4. 真实日语，每天更新
5. 听读同步，高亮注解
6. 逐句精听，啃下难句
7. 点词即查，阅读不断线
8. 逐句 AI 解惑

6. 登录与支付承接当前收口

6.1 登录

• 改为直接复用既有全屏登录组件
• 不再使用无法覆盖全屏的浮层方案
• 用户取消登录时，只关闭登录页，返回 onboarding
• 用户完成登录后，退出 onboarding shell，进入首页

6.2 支付

• 改为直接复用既有全屏 paywall 组件
• 不再使用无法覆盖全屏的浮层方案
• 用户关闭 paywall 后，退出 onboarding shell，进入首页

7. Weekly Frequency 当前收口

• 你想要一周练习几次 页面底部 下一步 现在默认存在
• 页面默认频次是 3 次/周
• 用户即使不手动调整，也可以继续
• 继续时会把 3 写入当前答案模型

8. 当前验证结论

当前已确认通过的命令口径：

IOS_ROOT=/path/to/EveryDayJapanese-iOS
SIMULATOR_ID=<SIMULATOR_ID>

xcodebuild test -quiet \
  -workspace "$IOS_ROOT/.worktrees/yomiya-onboarding-ios/EveryDayJapanese.xcworkspace" \
  -scheme EveryDayJapanese \
  -destination "platform=iOS Simulator,id=$SIMULATOR_ID,OS=18.3.1" \
  -only-testing:EveryDayJapaneseTests/YomiyaOnboardingShellEntryTests \
  -only-testing:EveryDayJapaneseTests/YomiyaOnboardingShellCoordinatorTests \
  -only-testing:EveryDayJapaneseTests/YomiyaOnboardingShellFixturesTests \
  -only-testing:EveryDayJapaneseTests/YomiyaOnboardingPencilRenderTests \
  -only-testing:EveryDayJapaneseTests/YomiyaOnboardingBrandIntroTests \
  -only-testing:EveryDayJapaneseTests/YomiyaOnboardingShellStateTests \
  -only-testing:EveryDayJapaneseTests/YomiyaOnboardingPencilLayoutTests \
  -only-testing:EveryDayJapaneseTests/YomiyaOnboardingShellCompletionTests

验证范围已经覆盖：

• entry / modal / exit 行为
• step 顺序与回退
• Pencil layout 与 render
• brand intro / opening motion
• plan generation fixture 与 plan result 基本结构