325 lines
18 KiB
Markdown
325 lines
18 KiB
Markdown
# M1 页面线框与交互规格
|
||
|
||
本文件定义首版的核心页面和状态。视觉参照请见同一交付中的页面线框；本文件用于产品、设计和研发对齐行为与验收。
|
||
|
||
完整页面清单、视觉规则和关键流转见 [M1 全部原型设计说明](PROTOTYPE-DESIGN-SPEC.md)。
|
||
|
||
M1 范围和跨页面行为以 [开发与验收约定](M1-IMPLEMENTATION-CONTRACT.md) 为准；评估页面执行 [A0 阶段标准](A0-STAGE-STANDARD.md)。本次仅更新文档线框，不代表 HTML 或应用界面已同步实现。
|
||
|
||
## M1 范围
|
||
|
||
M1 是手机优先的 A0 单人学习闭环：10 节种子课及分段、听说读写、受控 AI 对话、变式/补救、次日复习、掌握证据、进度与四技能出口评估。课程总量不限，未通过不升级；通过后 A1 内容未就绪则显示待提供。每台设备独立使用；不含登录、社交、付费、通知、增长、自动同步或导出/导入。
|
||
|
||
## 全局规则
|
||
|
||
- 界面默认中文，英文只出现在学习材料、示范句和对话中。
|
||
- 每个页面最多一个高强调主按钮；离开流程的操作为低强调按钮或文字链接。
|
||
- 教学音频提供文字、重放和慢放；课程、阅读与对话中的英文词或短语可点开查词，关闭后回到原步骤。独立听力/评估先隐藏文字，查看后标记辅助，播放次数遵循评估标准。录音失败可切换文字学习，但不能记为口语达标。
|
||
- 你可中断课程或对话，回到首页后显示“继续上次练习”。
|
||
- 进度以“能完成什么”展示，不只显示词汇数量或分数。
|
||
- 学习进度、复习队列与设置保存在本机；如需换设备续学，后续提供加密导出/导入，不需要账号系统或多人数据模型。
|
||
|
||
## P01 欢迎与目标
|
||
|
||
```text
|
||
┌──────────────────────────┐
|
||
│ 开口英语 │
|
||
│ 每天 20 分钟，说出能用的英语 │
|
||
│ │
|
||
│ 你的主要目标是？ │
|
||
│ ○ 日常生活 ○ 旅行 ○ 工作起步│
|
||
│ │
|
||
│ 每天可以学习多久？ │
|
||
│ [10 分钟] [20 分钟] [30 分钟]│
|
||
│ │
|
||
│ [继续] │
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
**输入**：目标、每日时长。
|
||
**输出**：保存为学习计划参数；进入 P02。
|
||
**验收**：全程不超过 2 次选择；跳过不影响后续使用。
|
||
|
||
## P02 起点定位
|
||
|
||
```text
|
||
┌──────────────────────────┐
|
||
│ 从哪里开始？ 第 1 / 3 步 │
|
||
│ │
|
||
│ ○ 完全零基础 │
|
||
│ 从你好、自我介绍开始 │
|
||
│ ○ 能说一点 │
|
||
│ ○ 能简单对话 │
|
||
│ │
|
||
│ [开始 3 分钟定位] │
|
||
│ [直接从第一课开始] │
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
**测评流程**：听句选义（1 题）→ 读 `Hello. My name is ...`（1 题，可跳过）→ 回答 `What is your name?`（1 题，可文字输入）。
|
||
**结果页**：显示“建议从 A0 第 X 课开始”，用一句中文说明原因；提供“从更简单内容开始”和“开始今天学习”。
|
||
**验收**：不出现百分制、排名、失败字样；录音权限被拒后自动显示文字作答。
|
||
|
||
轻量定位不生成阶段通过记录、不解锁 A1。已会部分内容的用户可从进度页申请正式 A0 评估。
|
||
|
||
## P03 首页
|
||
|
||
```text
|
||
┌──────────────────────────┐
|
||
│ 早上好，Shen │
|
||
│ 今天，说 3 句英语。 │
|
||
│ [当前掌握 ███░░░░░░░] │
|
||
│ │
|
||
│ 第 2 课 · 拼读姓名 │
|
||
│ 12 分钟 · 先认识 4 个词 · 听说读写│
|
||
│ [开始今天的学习] │
|
||
│ │
|
||
│ 快速练习 · AI 对话 │
|
||
│ 初次见面 · 3 分钟 │
|
||
│ [开始对话] │
|
||
│ │
|
||
│ 首页 学习 对话 复习 我的│
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
**规则**：只显示一个主任务，按当日时间预算优先复习，再续学/新能力；用户可恢复中断会话。分别显示复习任务数和覆盖词句数，不设每天五个词的硬上限。积压超过学习引擎阈值时显示“今天先巩固，明天再安排新内容”，允许用户自主选择新课。
|
||
**验收**：首次用户从首页开始课程不超过 1 次点击；学习完成后首页立即更新下一任务。
|
||
|
||
## P04a 课前词汇预热
|
||
|
||
```text
|
||
┌──────────────────────────┐
|
||
│ 第 2 课 · 先认识今天的词 │
|
||
│ ●○○○ 约 2 分钟 │
|
||
│ │
|
||
│ 今天会遇到 4 个词和词块 │
|
||
│ │
|
||
│ spell │
|
||
│ /spel/ · 拼写 │
|
||
│ 🔊 [播放] [慢速] │
|
||
│ How do you spell that? │
|
||
│ 那个怎么拼？ │
|
||
│ │
|
||
│ [认识了，下一个] │
|
||
│ [跳过，直接进入课程] │
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
**规则**：只列出当前教学段将出现的新增词和理解词块，通常 3–6 项；按词条逐项听、看当前句义、查看短例句，并至少做一次轻量匹配或听辨。可重放、查词、跳过、结束后回看；预热不出现长词表或完整词典。
|
||
**证据**：仅保存“已看过/已播放/已跳过”，不增加掌握度、不产生错误或到期复习。预热后仍要在课程中独立听懂、回忆和使用。
|
||
**验收**：新教学段从首页进入后先到此页；没有新语言或恢复已开始课程时不强制显示。用户跳过仍可进入课程，之后能在课程目录回看。
|
||
|
||
预热计入教学段总时长；后续直接在句中练习，仅在需要时回看词卡。到每日预算边界显示“今天先到这里 / 继续练”，保存下一步骤，不自动标记课程完成。
|
||
|
||
## P04 课程页（通用）
|
||
|
||
```text
|
||
┌──────────────────────────┐
|
||
│ 第 4 课 · 数字 │
|
||
│ ●●○○○ 4 分钟 │
|
||
│ │
|
||
│ 听一听 │
|
||
│ 🔊 My number is 138. │
|
||
│ [慢速] [重说] │
|
||
│ │
|
||
│ 这句话是什么意思？ │
|
||
│ ○ 我的号码是 138。 │
|
||
│ ○ 我有 138 本书。 │
|
||
│ │
|
||
│ [检查] │
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
**组件**：课前词汇预热、步骤进度、情境图/音频、句中应用、听力题、跟读录音、短阅读、写作题、AI 对话入口、结尾独立尝试。
|
||
**规则**：每教学段最多 8 个新词汇、2 个主动句型、2 个理解用词块；超出则拆段。每个关键句至少复现两次。点词/点短语打开查词卡，短语优先，显示当前句义、中文释义、音频、慢放、已学例句和“加入复习”。听力示意中的字幕仅代表教学态，独立答题态隐藏。
|
||
**验收**：用户可在任一步重放、慢放或查看中文；保存中断位置。
|
||
|
||
## P05 AI 情境对话
|
||
|
||
P04b 的独立尝试可在本页最后一轮执行，避免重复进入另一整套测试。
|
||
|
||
```text
|
||
┌──────────────────────────┐
|
||
│ 初次见面 · 2 / 4 │
|
||
│ 目标：说姓名和来自哪里 │
|
||
│ │
|
||
│ AI：What’s your name? │
|
||
│ 我：My name is Shen. │
|
||
│ AI：Where are you <点词>from</点词>? │
|
||
│ │
|
||
│ [提示] [慢一点] [翻译] [重说] │
|
||
│ │
|
||
│ [按住说话 🎙] [输入文字] │
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
**输入**：语音（默认）或文字；语音转写发送前可编辑。低可信度时显示“我没有完全听清”，并提供“确认转写 / 修改文字 / 重新说”，不直接判错。
|
||
**AI 行为**：只问当前等级能理解的单一问题，记住已回答信息，优先推进任务；只有无法理解、关键任务阻塞或用户点“提示”时才简短辅助。AI 消息中可点英文词/短语打开查词卡；关闭后保持同一会话轮次，不重新生成或重复提问。
|
||
**验收**：完成 3–5 轮不超过 5 分钟；语音识别失败时不丢失上下文，也不记录为发音错误。
|
||
|
||
## P06 课程/对话总结
|
||
|
||
```text
|
||
┌──────────────────────────┐
|
||
│ 你完成了自我介绍！ │
|
||
│ 你说出了姓名和来自哪里。 │
|
||
│ │
|
||
│ ✓ 做得好 │
|
||
│ My name is Shen. │
|
||
│ → 下次这样说 │
|
||
│ I’m from Hong Kong. │
|
||
│ │
|
||
│ [录音重说] │
|
||
│ [明天复习这句话] │
|
||
│ [回到首页] │
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
**规则**：总结显示教学完成与独立尝试结果的区别：独立完成/帮助下完成/待做/待确认。需要补救的目标合并到次日复习，已稳定项目保留原间隔，不因总结重说统一改成明日到期。
|
||
**验收**：每次自由输出至少生成一个正向反馈与一个可复习项目；无错误时给一句可替换表达，而非强行挑错。
|
||
|
||
## P07 复习页
|
||
|
||
```text
|
||
┌──────────────────────────┐
|
||
│ 今天复习 · 3 项 │
|
||
│ │
|
||
│ 昨天你在问候时练过： │
|
||
│ AI：How are you? │
|
||
│ │
|
||
│ [按住说话 🎙] [查看提示] │
|
||
│ │
|
||
│ 完成后：下一项 1 / 3 │
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
**规则**：以各词句首次完成正式教学为起点安排间隔，不等待整课结束。任务可覆盖多个词句但逐项记证据，预算和队列公平性按学习引擎；单次遗忘显示“下次换题确认”，复核后才决定降级。技术失败不算错误，离线切换审核模板。
|
||
**验收**：只移出本次已有效完成的到期项，其余仍保留；辅助完成次日换题，不因完成五项就清空队列。
|
||
|
||
## P08 我的进步
|
||
|
||
```text
|
||
┌──────────────────────────┐
|
||
│ 我的进步 │
|
||
│ 当前：A0 起步 │
|
||
│ 已能做到 │
|
||
│ ✓ 介绍姓名 │
|
||
│ ✓ 说出来自哪里 │
|
||
│ ○ 拼读电话号码 │
|
||
│ │
|
||
│ 已完成 3 个核心任务 │
|
||
│ [调整每日学习时间] │
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
**规则**：能力清单由分技能有效证据驱动，课程完成不自动等于掌握。显示已练习、可使用、已掌握与待评估区别，不把词数设为唯一成就。
|
||
**验收**：用户能看到当前等级、已能完成的任务、接下来要练的能力和每日时间设置。
|
||
|
||
设置页还应提供“AI 对话服务”入口，供个人使用时选择 Gemini API、OpenAI API 或 OpenAI 兼容反代。兼容反代仅显示 Base URL、Token、模型名与“仅文字对话”能力状态；不在常规学习流程中暴露网页登录或订阅凭据。
|
||
|
||
## 页面流转
|
||
|
||
```text
|
||
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 阅读（课程子页）
|
||
|
||
```text
|
||
第 6 课 · 阅读
|
||
Mia: Where are you from?
|
||
Shen: I'm from Hong Kong.
|
||
Shen 来自哪里？
|
||
○ Hong Kong ○ China
|
||
[检查答案] [查看翻译]
|
||
```
|
||
|
||
保留英文短文和题目，选答案后反馈并进入写作。教学可点词/翻译；正式评估不提供释义，使用后当前题转练习。记录 reading，不把点击朗读算听力成功。
|
||
|
||
## P04b 独立尝试（课程或对话子状态）
|
||
|
||
```text
|
||
试着自己说 / 写一次 · 约 1 分钟
|
||
请介绍你来自哪里。
|
||
[录音回答] 或 [输入完整句子]
|
||
[需要帮助] [稍后继续]
|
||
```
|
||
|
||
不给英文句框、词库或范句；听力只播问题，阅读仍保留英文材料。每次选择一种技能，不能用打字算口语。换已教范围内的图片或任务值；独立成功才产生该技能证据。需要帮助则恢复句框/查词、标记辅助完成并结束该次尝试，后续换题再练；稍后继续则保留待做。该步骤包括在教学预算内，可复用对话结尾；各主题四技能机会按课程包安排。
|
||
|
||
## P09a 查词卡（课程/阅读/对话子状态）
|
||
|
||
```text
|
||
┌──────────────────────────┐
|
||
│ from │
|
||
│ /frʌm/ · 介词 │
|
||
│ 来自；从…… │
|
||
│ │
|
||
│ 🔊 from [慢速] │
|
||
│ I'm from Hong Kong. │
|
||
│ 我来自香港。 │
|
||
│ │
|
||
│ [加入复习] │
|
||
│ [关闭，回到对话] │
|
||
└──────────────────────────┘
|
||
```
|
||
|
||
以底部卡或弹层展示，不跳转或清空课程/对话状态。优先匹配完整短语，例如 `Nice to meet you`，找不到时再显示单词；专名、数字或离线缺失词条显示清楚说明，不编造释义。教学态允许查词并记录为帮助完成；评估态不显示入口，若用户提出查词，先说明会转为教学练习并换题补测。
|
||
|
||
## P10 阶段评估准备
|
||
|
||
```text
|
||
A0 能力检查 · 题组 1 / 2
|
||
核心可使用及以上 48 / 60
|
||
其中已掌握 30 / 60
|
||
听 / 说 / 读 / 写 · 约 12–18 分钟，可分段
|
||
不看翻译和句框；语音识别不清不会扣分
|
||
[开始检查] [先补练]
|
||
```
|
||
|
||
数字是展示样例，不是用户已有记录。未达核心门槛仍可参加评估，但不能仅凭评估升级。检查音频/麦克风能力；不可用可做其他技能，口语或听力显示待评估。提供明确的播放、提示限制；最多 7 天内完成当前题组。退出保存有效步骤，不提前展示未答题答案。
|
||
|
||
## P11 评估结果
|
||
|
||
```text
|
||
A0 检查结果
|
||
听 ✓ 说 待评估 读 ✓ 写 需练习
|
||
写作：再练“我来自哪里”
|
||
口语：上次转写有修改，需要换题录音
|
||
[开始补练] [查看证据]
|
||
```
|
||
|
||
区分 needsPractice、pending、passed，不将技术失败显示成语言失败。第二题组只在第一组完成至少 24 小时后开始。两组通过仍需检查核心门槛和证据有效期。全部满足显示“A0 已通过”；M1 显示“A1 内容待提供”和“继续 A0 巩固”，没有可强制解锁的按钮。四技能、核心门槛和题组进度分别可查看。
|
||
|
||
## P12 定向补练与补测
|
||
|
||
列出未通过能力、原因和一个主任务；从已有合格模板或经审核的变式选题。完成至少一次相关补练后提供“换题再检查”，7 天题组窗口内保留其他已通过技能。技术失败可直接恢复或换题，不强制补练。同原题立即重做只算练习。
|
||
|
||
## P13 AI 服务与通用错误状态
|
||
|
||
设置显示提供商、Base URL、模型、掩码 Token、“测试连接”和能力结果。测试前提示会发送测试文本且可能计费；成功后保存，不自动把文字代理用于语音。无流式但非流式可用不算整体失败；鉴权失败、地址不可达、模型不支持、结构异常分别给出中文原因。手机访问 Mac 时说明 localhost 限制；不自动切换付费服务。
|
||
|
||
| 状态 | 展示与操作 | 保留内容 |
|
||
|---|---|---|
|
||
| 无到期复习 | 今天暂无到期项目，可自选巩固/回首页 | 不伪造待练项 |
|
||
| AI 未配置/断网 | 本地练习可用；配置服务/稍后重试 | 当前步骤与待反馈答案 |
|
||
| 麦克风拒绝 | 前往系统设置/文字练习 | 口语待评估，不判错 |
|
||
| 无可用音频 | 先做阅读写作/稍后补听 | 听力待评估 |
|
||
| 生成或判题异常 | 使用本地练习/重试；可举报内容 | 不写入假成功或语言失败 |
|
||
| 中断返回 | 继续上次练习/返回首页 | 最近已提交步骤，不自动重复提交 |
|
||
| 内容有问题 | 标记题目/换题 | 隔离相关证据并说明状态重算原因 |
|
||
| 删除记录 | 显示录音/会话/学习进度具体范围并二次确认 | 未选择数据与密钥不受影响 |
|
||
|
||
转写确认页始终区分未修改确认与编辑后提交，后者显示“本次作为文字练习；口语可稍后补做”。
|
||
|
||
## P14 通用发音练习（跟读子状态）
|
||
|
||
显示示范音、慢放、自己的录音、回听和可选的一条动作提示；标题为“对比听一听”，不显示“你的 /θ/ 错了”。用户可重录或返回，不因跳过影响升级；真实口语证据仍从独立任务采集。
|