feat: complete kouyu_english app codebase, A0 specifications and .gitignore

Doc/PROTOTYPE-DESIGN-SPEC.md

@@ -0,0 +1,78 @@
+# M1 全部原型设计说明
+
+## 范围
+
+本设计覆盖个人学习工具 M1 的全部核心页面与关键状态，适配 Flutter 的 iPhone、Android 手机与 macOS。手机界面为第一优先级；Mac 复用相同的信息结构，以双栏和更宽的内容区呈现。
+
+范围以 [M1 开发与验收约定](M1-IMPLEMENTATION-CONTRACT.md) 为准，新增状态的文字线框见 [M1 页面规格](M1-WIREFRAMES.md) P04a、P09–P14 及 P09a。课前词汇预热和查词卡已同步到 [交互原型](learning-app-prototype.html)；其他新增评估、补练与服务状态仍以文字线框为准，尚未同步为 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 | 独立尝试 | 逐步撤掉帮助，取得真实作答证据 | 换题独立回答、恢复帮助、稍后续学 |
+
+## 关键流转
+
+```text
+首次：目标设置 → 起点定位 → 首页
+学习：首页 → 到期复习（有则按预算） → 预热 → 带帮助的听说读写 → AI 对话 → 独立尝试 → 总结
+识别不确定：AI 对话 → 转写确认 → AI 对话 / 总结
+查词：课程 / 阅读 / AI 对话 → 查词卡 → 返回原步骤
+复习：首页 → 今日复习 → 首页
+进度：首页 → 我的进步 → 设置
+评估：我的进步 → 评估准备 → 听说读写 → 结果 → 补练 → 换题补测
+通过：全部门槛满足 → A0 已通过 → A1 待提供 / 继续 A0 巩固
+服务：设置 → AI 配置 → 连接测试 → 保存 / 修正
+```
+
+## 视觉与交互规则
+
+- 使用低饱和绿色作为行动与完成状态，暖橙只用于“再练一次”等温和提醒。
+- 每个手机页面仅保留一个高强调操作；其余操作保持低强调。
+- 英文是学习内容，系统说明和反馈使用中文。
+- 大型底部录音区域始终可被单手触达；文字输入是继续练习的备选，但不是口语达标的等价证据。
+- 识别低置信度时，使用“我没有完全听清”，不能显示“你说错了”。
+- 总结页只显示一个待改进句，避免一次纠正多个语法或发音问题。
+- 手机上的底部导航固定为：首页、学习、对话、复习、我的。
+- Mac 不增加独立功能，只将相同内容改为左侧导航 + 宽内容区域。
+- AI 服务可选 Gemini API、OpenAI API 或 OpenAI 兼容反代；反代仅用于文字 AI，配置保存在设备安全存储，不展示网页登录凭据。
+- 教学与独立评估明确区分；独立听力先隐藏字幕/翻译，求助后标记辅助，不混入独立成功。
+- 教学中点英文词或短语可打开查词卡，短语优先于单词；显示当前语境中文意思、示范音、慢速与已学例句。关闭后不丢失步骤或对话轮次，可手动加入复习。
+- 独立练习和阶段评估隐藏查词入口；需要查词时明确切换为教学练习，并用不同题补测，不能把查词后的正确答案计入独立能力。
+- 每个有新语言的教学段在正式任务前显示 1–3 分钟词汇预热，通常 3–6 项；预热是熟悉输入而非掌握测试，允许跳过、回看，不增加掌握度或复习到期项。
+- 预热、对话、独立尝试均计入教学段时长；日预算不足保存步骤，不重复词卡教学或自动结课。独立尝试可复用对话最后一轮，恢复提示后标记辅助完成。
+- 复习按时间选任务，显示任务数和实际覆盖词句数；积压时减少新段，单次遗忘先安排复核，起算日期为词句首次完成正式教学。
+- 通用状态必须覆盖：空复习、断网、服务未配置、权限拒绝、缺音频、生成异常、待反馈、中断恢复、内容质疑与删除确认；行为见页面规格 P13。
+- 四技能和核心门槛分开展示；完成十课、轻量定位或手动修改转写都不能直接解锁下一阶段。
+
+## M1 未包含的界面
+
+- 登录、注册、找回密码、付费、订阅和通知；
+- 用户匹配、群聊、排行榜、公开个人主页；
+- 自动跨设备同步；
+- 加密导出/导入（留到 M2）；
+- 实时全双工通话、精细发音分数或公开分享录音。