English/Doc/M1-WIREFRAMES.md

M1 页面线框与交互规格

本文件定义首版的核心页面和状态。视觉参照请见同一交付中的页面线框；本文件用于产品、设计和研发对齐行为与验收。

完整页面清单、视觉规则和关键流转见 M1 全部原型设计说明。

M1 范围和跨页面行为以 开发与验收约定 为准；评估页面执行 A0 阶段标准。本次仅更新文档线框，不代表 HTML 或应用界面已同步实现。

M1 范围

M1 是手机优先的 A0 单人学习闭环：10 节种子课及分段、听说读写、受控 AI 对话、变式/补救、次日复习、掌握证据、进度与四技能出口评估。课程总量不限，未通过不升级；通过后 A1 内容未就绪则显示待提供。每台设备独立使用；不含登录、社交、付费、通知、增长、自动同步或导出/导入。

全局规则

• 界面默认中文，英文只出现在学习材料、示范句和对话中。
• 每个页面最多一个高强调主按钮；离开流程的操作为低强调按钮或文字链接。
• 教学音频提供文字、重放和慢放；课程、阅读与对话中的英文词或短语可点开查词，关闭后回到原步骤。独立听力/评估先隐藏文字，查看后标记辅助，播放次数遵循评估标准。录音失败可切换文字学习，但不能记为口语达标。
• 你可中断课程或对话，回到首页后显示“继续上次练习”。
• 进度以“能完成什么”展示，不只显示词汇数量或分数。
• 学习进度、复习队列与设置保存在本机；如需换设备续学，后续提供加密导出/导入，不需要账号系统或多人数据模型。

P01 欢迎与目标

┌──────────────────────────┐
│ 开口英语                  │
│ 每天 20 分钟，说出能用的英语 │
│                          │
│ 你的主要目标是？           │
│ ○ 日常生活  ○ 旅行  ○ 工作起步│
│                          │
│ 每天可以学习多久？          │
│ [10 分钟] [20 分钟] [30 分钟]│
│                          │
│             [继续]         │
└──────────────────────────┘

输入：目标、每日时长。
输出：保存为学习计划参数；进入 P02。
验收：全程不超过 2 次选择；跳过不影响后续使用。

P02 起点定位

┌──────────────────────────┐
│ 从哪里开始？  第 1 / 3 步    │
│                          │
│ ○ 完全零基础               │
│   从你好、自我介绍开始       │
│ ○ 能说一点                 │
│ ○ 能简单对话               │
│                          │
│ [开始 3 分钟定位]           │
│ [直接从第一课开始]           │
└──────────────────────────┘

测评流程：听句选义（1 题）→ 读 Hello. My name is ...（1 题，可跳过）→ 回答 What is your name?（1 题，可文字输入）。
结果页：显示“建议从 A0 第 X 课开始”，用一句中文说明原因；提供“从更简单内容开始”和“开始今天学习”。
验收：不出现百分制、排名、失败字样；录音权限被拒后自动显示文字作答。

轻量定位不生成阶段通过记录、不解锁 A1。已会部分内容的用户可从进度页申请正式 A0 评估。

P03 首页

┌──────────────────────────┐
│ 早上好，Shen               │
│ 今天，说 3 句英语。          │
│ [当前掌握 ███░░░░░░░]        │
│                          │
│ 第 2 课 · 拼读姓名           │
│ 12 分钟 · 先认识 4 个词 · 听说读写│
│ [开始今天的学习]             │
│                          │
│ 快速练习 · AI 对话           │
│ 初次见面 · 3 分钟            │
│ [开始对话]                   │
│                          │
│ 首页   学习   对话   复习   我的│
└──────────────────────────┘

规则：只显示一个主任务，按当日时间预算优先复习，再续学/新能力；用户可恢复中断会话。分别显示复习任务数和覆盖词句数，不设每天五个词的硬上限。积压超过学习引擎阈值时显示“今天先巩固，明天再安排新内容”，允许用户自主选择新课。
验收：首次用户从首页开始课程不超过 1 次点击；学习完成后首页立即更新下一任务。

P04a 课前词汇预热

┌──────────────────────────┐
│ 第 2 课 · 先认识今天的词     │
│ ●○○○  约 2 分钟             │
│                          │
│ 今天会遇到 4 个词和词块       │
│                          │
│ spell                      │
│ /spel/ · 拼写               │
│ 🔊 [播放]     [慢速]         │
│ How do you spell that?     │
│ 那个怎么拼？                 │
│                          │
│ [认识了，下一个]             │
│ [跳过，直接进入课程]          │
└──────────────────────────┘

规则：只列出当前教学段将出现的新增词和理解词块，通常 3–6 项；按词条逐项听、看当前句义、查看短例句，并至少做一次轻量匹配或听辨。可重放、查词、跳过、结束后回看；预热不出现长词表或完整词典。
证据：仅保存“已看过/已播放/已跳过”，不增加掌握度、不产生错误或到期复习。预热后仍要在课程中独立听懂、回忆和使用。
验收：新教学段从首页进入后先到此页；没有新语言或恢复已开始课程时不强制显示。用户跳过仍可进入课程，之后能在课程目录回看。

预热计入教学段总时长；后续直接在句中练习，仅在需要时回看词卡。到每日预算边界显示“今天先到这里 / 继续练”，保存下一步骤，不自动标记课程完成。

P04 课程页（通用）

┌──────────────────────────┐
│ 第 4 课 · 数字              │
│ ●●○○○  4 分钟               │
│                          │
│ 听一听                      │
│ 🔊  My number is 138.       │
│ [慢速] [重说]                │
│                          │
│ 这句话是什么意思？           │
│ ○ 我的号码是 138。           │
│ ○ 我有 138 本书。            │
│                          │
│ [检查]                       │
└──────────────────────────┘

组件：课前词汇预热、步骤进度、情境图/音频、句中应用、听力题、跟读录音、短阅读、写作题、AI 对话入口、结尾独立尝试。
规则：每教学段最多 8 个新词汇、2 个主动句型、2 个理解用词块；超出则拆段。每个关键句至少复现两次。点词/点短语打开查词卡，短语优先，显示当前句义、中文释义、音频、慢放、已学例句和“加入复习”。听力示意中的字幕仅代表教学态，独立答题态隐藏。
验收：用户可在任一步重放、慢放或查看中文；保存中断位置。

P05 AI 情境对话

P04b 的独立尝试可在本页最后一轮执行，避免重复进入另一整套测试。

┌──────────────────────────┐
│ 初次见面 · 2 / 4            │
│ 目标：说姓名和来自哪里       │
│                          │
│ AI：What’s your name?       │
│ 我：My name is Shen.         │
│ AI：Where are you <点词>from</点词>? │
│                          │
│ [提示] [慢一点] [翻译] [重说] │
│                          │
│ [按住说话 🎙]  [输入文字]     │
└──────────────────────────┘

输入：语音（默认）或文字；语音转写发送前可编辑。低可信度时显示“我没有完全听清”，并提供“确认转写 / 修改文字 / 重新说”，不直接判错。
AI 行为：只问当前等级能理解的单一问题，记住已回答信息，优先推进任务；只有无法理解、关键任务阻塞或用户点“提示”时才简短辅助。AI 消息中可点英文词/短语打开查词卡；关闭后保持同一会话轮次，不重新生成或重复提问。
验收：完成 3–5 轮不超过 5 分钟；语音识别失败时不丢失上下文，也不记录为发音错误。

P06 课程/对话总结

┌──────────────────────────┐
│ 你完成了自我介绍！           │
│ 你说出了姓名和来自哪里。      │
│                          │
│ ✓ 做得好                     │
│   My name is Shen.          │
│ → 下次这样说                 │
│   I’m from Hong Kong.       │
│                          │
│ [录音重说]                   │
│ [明天复习这句话]              │
│ [回到首页]                   │
└──────────────────────────┘

规则：总结显示教学完成与独立尝试结果的区别：独立完成/帮助下完成/待做/待确认。需要补救的目标合并到次日复习，已稳定项目保留原间隔，不因总结重说统一改成明日到期。
验收：每次自由输出至少生成一个正向反馈与一个可复习项目；无错误时给一句可替换表达，而非强行挑错。

P07 复习页

┌──────────────────────────┐
│ 今天复习 · 3 项              │
│                          │
│ 昨天你在问候时练过：          │
│ AI：How are you?            │
│                              │
│ [按住说话 🎙] [查看提示]       │
│                              │
│ 完成后：下一项 1 / 3          │
└──────────────────────────┘

规则：以各词句首次完成正式教学为起点安排间隔，不等待整课结束。任务可覆盖多个词句但逐项记证据，预算和队列公平性按学习引擎；单次遗忘显示“下次换题确认”，复核后才决定降级。技术失败不算错误，离线切换审核模板。
验收：只移出本次已有效完成的到期项，其余仍保留；辅助完成次日换题，不因完成五项就清空队列。

P08 我的进步

┌──────────────────────────┐
│ 我的进步                     │
│ 当前：A0 起步                │
│ 已能做到                     │
│ ✓ 介绍姓名                    │
│ ✓ 说出来自哪里                │
│ ○ 拼读电话号码                │
│                              │
│ 已完成 3 个核心任务            │
│ [调整每日学习时间]             │
└──────────────────────────┘

规则：能力清单由分技能有效证据驱动，课程完成不自动等于掌握。显示已练习、可使用、已掌握与待评估区别，不把词数设为唯一成就。
验收：用户能看到当前等级、已能完成的任务、接下来要练的能力和每日时间设置。

设置页还应提供“AI 对话服务”入口，供个人使用时选择 Gemini API、OpenAI API 或 OpenAI 兼容反代。兼容反代仅显示 Base URL、Token、模型名与“仅文字对话”能力状态；不在常规学习流程中暴露网页登录或订阅凭据。

页面流转

P01 → P02 → P03
P03 → P07 到期复习 → 教学/续学 → P06 总结 → P03
P03 → P08
P03 → P04a 课前词汇预热 → P04 课程（有新语言时）
P04：听力 → 跟读 → P09 阅读 → 写作 → P05 对话 → P04b 独立尝试 → P06
P04 / P05 / P09 → P09a 查词卡 → 返回原步骤
P08 → P10 评估准备 → 四技能任务 → P11 结果 → P12 补练 → 换题补测
设置 → P13 服务配置 → 连接测试 → 保存

P09 阅读（课程子页）

第 6 课 · 阅读
Mia: Where are you from?
Shen: I'm from Hong Kong.
Shen 来自哪里？
○ Hong Kong   ○ China
[检查答案]    [查看翻译]

保留英文短文和题目，选答案后反馈并进入写作。教学可点词/翻译；正式评估不提供释义，使用后当前题转练习。记录 reading，不把点击朗读算听力成功。

P04b 独立尝试（课程或对话子状态）

试着自己说 / 写一次 · 约 1 分钟
请介绍你来自哪里。
[录音回答] 或 [输入完整句子]
[需要帮助]   [稍后继续]

不给英文句框、词库或范句；听力只播问题，阅读仍保留英文材料。每次选择一种技能，不能用打字算口语。换已教范围内的图片或任务值；独立成功才产生该技能证据。需要帮助则恢复句框/查词、标记辅助完成并结束该次尝试，后续换题再练；稍后继续则保留待做。该步骤包括在教学预算内，可复用对话结尾；各主题四技能机会按课程包安排。

P09a 查词卡（课程/阅读/对话子状态）

┌──────────────────────────┐
│ from                       │
│ /frʌm/ · 介词              │
│ 来自；从……                  │
│                            │
│ 🔊 from        [慢速]       │
│ I'm from Hong Kong.        │
│ 我来自香港。                 │
│                            │
│ [加入复习]                  │
│ [关闭，回到对话]             │
└──────────────────────────┘

以底部卡或弹层展示，不跳转或清空课程/对话状态。优先匹配完整短语，例如 Nice to meet you，找不到时再显示单词；专名、数字或离线缺失词条显示清楚说明，不编造释义。教学态允许查词并记录为帮助完成；评估态不显示入口，若用户提出查词，先说明会转为教学练习并换题补测。

P10 阶段评估准备

A0 能力检查 · 题组 1 / 2
核心可使用及以上 48 / 60
其中已掌握       30 / 60
听 / 说 / 读 / 写  · 约 12–18 分钟，可分段
不看翻译和句框；语音识别不清不会扣分
[开始检查]   [先补练]

数字是展示样例，不是用户已有记录。未达核心门槛仍可参加评估，但不能仅凭评估升级。检查音频/麦克风能力；不可用可做其他技能，口语或听力显示待评估。提供明确的播放、提示限制；最多 7 天内完成当前题组。退出保存有效步骤，不提前展示未答题答案。

P11 评估结果

A0 检查结果
听 ✓   说 待评估   读 ✓   写 需练习
写作：再练“我来自哪里”
口语：上次转写有修改，需要换题录音
[开始补练]   [查看证据]

区分 needsPractice、pending、passed，不将技术失败显示成语言失败。第二题组只在第一组完成至少 24 小时后开始。两组通过仍需检查核心门槛和证据有效期。全部满足显示“A0 已通过”；M1 显示“A1 内容待提供”和“继续 A0 巩固”，没有可强制解锁的按钮。四技能、核心门槛和题组进度分别可查看。

P12 定向补练与补测

列出未通过能力、原因和一个主任务；从已有合格模板或经审核的变式选题。完成至少一次相关补练后提供“换题再检查”，7 天题组窗口内保留其他已通过技能。技术失败可直接恢复或换题，不强制补练。同原题立即重做只算练习。

P13 AI 服务与通用错误状态

设置显示提供商、Base URL、模型、掩码 Token、“测试连接”和能力结果。测试前提示会发送测试文本且可能计费；成功后保存，不自动把文字代理用于语音。无流式但非流式可用不算整体失败；鉴权失败、地址不可达、模型不支持、结构异常分别给出中文原因。手机访问 Mac 时说明 localhost 限制；不自动切换付费服务。

状态	展示与操作	保留内容
无到期复习	今天暂无到期项目，可自选巩固/回首页	不伪造待练项
AI 未配置/断网	本地练习可用；配置服务/稍后重试	当前步骤与待反馈答案
麦克风拒绝	前往系统设置/文字练习	口语待评估，不判错
无可用音频	先做阅读写作/稍后补听	听力待评估
生成或判题异常	使用本地练习/重试；可举报内容	不写入假成功或语言失败
中断返回	继续上次练习/返回首页	最近已提交步骤，不自动重复提交
内容有问题	标记题目/换题	隔离相关证据并说明状态重算原因
删除记录	显示录音/会话/学习进度具体范围并二次确认	未选择数据与密钥不受影响

转写确认页始终区分未修改确认与编辑后提交，后者显示“本次作为文字练习；口语可稍后补做”。

P14 通用发音练习（跟读子状态）

显示示范音、慢放、自己的录音、回听和可选的一条动作提示；标题为“对比听一听”，不显示“你的 /θ/ 错了”。用户可重录或返回，不因跳过影响升级；真实口语证据仍从独立任务采集。