English/Doc/PROTOTYPE-DESIGN-SPEC.md

M1 全部原型设计说明

范围

本设计覆盖个人学习工具 M1 的全部核心页面与关键状态，适配 Flutter 的 iPhone、Android 手机与 macOS。手机界面为第一优先级；Mac 复用相同的信息结构，以双栏和更宽的内容区呈现。

范围以 M1 开发与验收约定 为准，新增状态的文字线框见 M1 页面规格 P04a、P09–P14 及 P09a。课前词汇预热和查词卡已同步到 交互原型；其他新增评估、补练与服务状态仍以文字线框为准，尚未同步为 HTML 页面。

页面清单

编号	页面 / 状态	主要目的	关键动作
01	每日时长	设置每日学习时长（目标固定为日常与旅行）	进入起点定位
02	起点定位	选择或轻量确认起始等级	开始学习 / 跳过
03	首页	呈现唯一的今日主任务	开始课程或短对话
04	学习地图	查看当前阶段与课程顺序	进入课程
05	听力练习	在清晰音频中理解核心句	选择答案、重放、慢放
06	跟读练习	模仿示范音并录音	录音、重说、转文字
07	造句练习	将词句转成自己的表达	输入、提交、进入对话
08	对话场景	选择当前等级的任务型对话	开始场景
09	AI 对话	在限制范围内完成 3–5 轮交流	说话、文字输入、提示、慢放
10	转写确认	在语音识别不确定时保护用户	确认、修改、重说
11	练习总结	给出一个成功点与一个重说句	重说、加入复习、回首页
12	今日复习	用微对话复练到期表达	说话、提示、进入下一项
13	我的进步	展示可完成的真实能力	查看下一能力、调整设置
14	设置	控制学习节奏、声音、数据与 AI 服务	更改偏好、配置与测试提供商、删除所选数据
15	Mac 适配	展示桌面端同一学习结构	继续课程或进入对话
16	阅读子页	理解短文本，不用听力替代	阅读、答题、教学态查释义
17	阶段评估准备	说明核心门槛、题组与提示规则	检查设备、分技能开始/继续
18	阶段评估结果	区分通过、需练习、待评估	看证据、补练、A1 待提供
19	补练与补测	针对薄弱能力取得新证据	完成补练、换题复测
20	AI 配置与错误状态	验证实际能力、提供本地降级	测试、修正配置、重试
21	通用发音练习	示范和录音对比，不诊断音素	慢放、回听、重录、返回
22	查词卡	在原步骤理解词或词块	看当前句义、播放、慢放、加入复习、关闭返回
23	课前词汇预热	在正式任务前认识当天的新语言	逐项听、看句义、轻量匹配、跳过或回看
24	独立尝试	逐步撤掉帮助，取得真实作答证据	换题独立回答、恢复帮助、稍后续学

关键流转

首次：每日时长 → 起点定位 → 首页
学习：首页 → 到期复习（有则按预算） → 预热 → 带帮助的听说读写 → AI 对话 → 独立尝试 → 总结
识别不确定：AI 对话 → 转写确认 → AI 对话 / 总结
查词：课程 / 阅读 / AI 对话 → 查词卡 → 返回原步骤
复习：首页 → 今日复习 → 首页
进度：首页 → 我的进步 → 设置
评估：我的进步 → 评估准备 → 听说读写 → 结果 → 补练 → 换题补测
通过：全部门槛满足 → A0 已通过 → A1 待提供 / 继续 A0 巩固
服务：设置 → AI 配置 → 连接测试 → 保存 / 修正

视觉与交互规则

• 使用低饱和绿色作为行动与完成状态，暖橙只用于“再练一次”等温和提醒。
• 每个手机页面仅保留一个高强调操作；其余操作保持低强调。
• 英文是学习内容，系统说明和反馈使用中文。
• 大型底部录音区域始终可被单手触达；文字输入是继续练习的备选，但不是口语达标的等价证据。
• 识别低置信度时，使用“我没有完全听清”，不能显示“你说错了”。
• 总结页只显示一个待改进句，避免一次纠正多个语法或发音问题。
• 手机上的底部导航固定为：首页、学习、对话、复习、我的。
• Mac 不增加独立功能，只将相同内容改为左侧导航 + 宽内容区域。
• AI 服务可选 Gemini API、OpenAI API 或 OpenAI 兼容反代；反代仅用于文字 AI，配置保存在设备安全存储，不展示网页登录凭据。
• 教学与独立评估明确区分；独立听力先隐藏字幕/翻译，求助后标记辅助，不混入独立成功。
• 教学中点英文词或短语可打开查词卡，短语优先于单词；显示当前语境中文意思、示范音、慢速与已学例句。关闭后不丢失步骤或对话轮次，可手动加入复习。
• 独立练习和阶段评估隐藏查词入口；需要查词时明确切换为教学练习，并用不同题补测，不能把查词后的正确答案计入独立能力。
• 每个有新语言的教学段在正式任务前显示 1–3 分钟词汇预热，通常 3–6 项；预热是熟悉输入而非掌握测试，允许跳过、回看，不增加掌握度或复习到期项。
• 预热、对话、独立尝试均计入教学段时长；日预算不足保存步骤，不重复词卡教学或自动结课。独立尝试可复用对话最后一轮，恢复提示后标记辅助完成。
• 复习按时间选任务，显示任务数和实际覆盖词句数；积压时减少新段，单次遗忘先安排复核，起算日期为词句首次完成正式教学。
• 通用状态必须覆盖：空复习、断网、服务未配置、权限拒绝、缺音频、生成异常、待反馈、中断恢复、内容质疑与删除确认；行为见页面规格 P13。
• 四技能和核心门槛分开展示；完成十课、轻量定位或手动修改转写都不能直接解锁下一阶段。

M1 未包含的界面

• 登录、注册、找回密码、付费、订阅和通知；
• 用户匹配、群聊、排行榜、公开个人主页；
• 自动跨设备同步；
• 加密导出/导入（留到 M2）；
• 实时全双工通话、精细发音分数或公开分享录音。