From efdff769e4535350f291809fa18fdcd301503fac Mon Sep 17 00:00:00 2001 From: shenlei Date: Thu, 17 Sep 2026 18:52:01 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AD=A6=E4=B9=A0=E7=9B=AE=E6=A0=87?= =?UTF-8?q?=E5=AE=9A=E4=B8=BA=E6=97=A5=E5=B8=B8=E4=B8=8E=E6=97=85=E8=A1=8C?= =?UTF-8?q?=EF=BC=8C=E9=87=8D=E5=86=99=E5=AD=A6=E4=B9=A0=E8=B7=AF=E7=BA=BF?= =?UTF-8?q?=E4=B8=8E=E8=AF=8D=E6=B1=87=E5=88=86=E5=B1=82=E8=A7=84=E6=A0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 取消学习目标选择，不做学校场景，工作场景延后 - 词汇分两层：核心表达与分级词池，写明词池来源与校验方式 - 补充复习节点、掌握判定与阶段评估的规则说明 Co-Authored-By: Claude Opus 5 --- Doc/AI-CONVERSATION-PRD.md | 52 ++++- Doc/LEARNING-ENGINE-SPEC.md | 304 ++++++++++++++++++++++++++---- Doc/M1-IMPLEMENTATION-CONTRACT.md | 2 +- Doc/M1-WIREFRAMES.md | 9 +- Doc/PRODUCT-PRD.md | 62 +++--- Doc/PROTOTYPE-DESIGN-SPEC.md | 4 +- Doc/learning-app-prototype.html | 7 +- 7 files changed, 346 insertions(+), 94 deletions(-) diff --git a/Doc/AI-CONVERSATION-PRD.md b/Doc/AI-CONVERSATION-PRD.md index bccb9f6..4381f4e 100644 --- a/Doc/AI-CONVERSATION-PRD.md +++ b/Doc/AI-CONVERSATION-PRD.md @@ -1,6 +1,6 @@ # 开口英语（暂定名）— AI 对话模块规格 -> 版本：1.1｜2026-09-12 +> 版本：1.3｜2026-09-17 > 模块定位：总产品中负责口语输出与真实情境练习的核心模块 > 核心承诺：每天 5–10 分钟，完成一次你在真实生活中用得上的英语对话。 @@ -35,7 +35,7 @@ M1 通常 3–5 分钟，最多 5 个用户回答轮；简单种子任务达标 | 页面 | 目的 | 必须内容 | |---|---|---| -| 欢迎与定位 | 了解用户起点和目标 | 目标选择、每日时长、可跳过的 3 分钟口语测评 | +| 欢迎与定位 | 了解用户起点 | 每日时长、可跳过的 3 分钟口语测评；学习目标固定为日常与旅行，不做选择 | | 对话入口 | 让用户立刻开口 | 一个推荐场景、继续上次对话 | | 场景页 | 让用户自主选择练习任务 | 分级场景卡、目标、预计时长 | | 对话页 | 完成交流 | AI 回复、语音/文字输入、求助按钮、进度提示 | @@ -86,9 +86,9 @@ AI: Great. One hot tea. Is that all? | A1 | 酒店入住 | 办理入住 | 姓名 + 预订/入住需求 | | A1 | 约时间 | 约见面 | 提议时间并完成确认 | | A1 | 生病求助 | 描述简单不适 | 说一个症状并回应一次追问 | -| A2 | 同事闲聊 | 交流周末/工作日常 | 连续完成 5 轮相关回应 | +| A2 | 聊兴趣与家乡 | 交流周末、兴趣和家乡 | 连续完成 5 轮相关回应 | -M1 先提供与 A0 核心课对应的受控对话；这些场景是起始内容，不是 A0 的对话总量。若出口能力尚未达标，系统继续围绕同阶段的薄弱点生成受控变式对话；A1 的生活场景和 A2 内容均作为后续扩展。 +A1 起的完整场景以《学习引擎规格》5.2 主题地图为准，上表只是示例。M1 先提供与 A0 核心课对应的受控对话；这些场景是起始内容，不是 A0 的对话总量。若出口能力尚未达标，系统继续围绕同阶段的薄弱点生成受控变式对话；A1 的生活场景和 A2 内容均作为后续扩展。 ## 7. 分级与对话控制 @@ -108,9 +108,42 @@ M1 先提供与 A0 核心课对应的受控对话；这些场景是起始内容 AI 必须记住当前场景、用户身份、完成目标、已知信息及难度上限。它不能突然转换角色、重复问已回答的问题，或为了“自然聊天”而跳过任务目标。 -给模型的指令必须把两件事分开：**本轮 AI 自己要说什么**，以及**学习者随后要完成什么任务**。两者混成一句会让模型替学习者把答案说出来。同时把当前课程及之前课程已教的词句作为可用语言清单随请求下发，A0 每轮最多 1 个清单外的词。 +给模型的指令必须把两件事分开：**本轮 AI 自己要说什么**，以及**学习者随后要完成什么任务**。两者混成一句会让模型替学习者把答案说出来。同时下发可用语言清单，但清单只作为模型的参考，不要求模型只能从清单里的短语拼句子；否则像 `What day is it today?` 这类已教句型也会因拆词不在清单而被模型回避。清单外词数由客户端统计，A0 每轮最多 1 个，超出按 7.3 的检查处理。 -模型只需返回 `reply`（英文回复）；`translation`（中文翻译）与 `feedback`（一句中文点评）可选，缺少可选字段不丢弃整条回复。是否完成任务由客户端按本轮必需表达判定，不采信模型的完成声明。AI 不可用时必须在对话页显示提示，说明当前这句来自内置示范脚本，不能让备用文案冒充 AI 回复。 +模型只需返回 `reply`（英文回复）；`translation`（中文翻译）与 `feedback`（一句中文点评）可选，缺少可选字段不丢弃整条回复。是否完成任务由客户端按本轮必需表达判定，不采信模型的完成声明。回退示范句时必须在对话页说明原因，并区分两种情况：AI 不可用（网络、服务或返回格式错误）时提示“AI 暂时无法连接”；AI 有回复但没通过检查时提示“这一句换成了示范句”。两种都不能让备用文案冒充 AI 回复。 + +### 7.3 场景、任务与对话调度 + +对话不再以“脚本第 N 句”作为 AI 目标，而由三层数据和一个本地调度器驱动： + +| 层 | 内容 | 来源 | +|---|---|---| +| LevelProfile（等级档） | 每轮英文词数上限、每轮问题数、清单外词上限、是否允许追问、中文辅助规则（即 7.2 表格） | 按等级固定在程序中 | +| Scene（场景） | 场景 ID、学习者与 AI 身份、背景、开场句、任务列表 | 冻结的单元内容包 | +| Task（任务） | 任务 ID、目标、引用的核心词句 ID、信息槽、示范句 | 冻结的单元内容包；判定条件（cues/done）由程序根据引用的词句 ID 编译 | + +每一轮的调度步骤： + +1. 客户端先在本地判定用户这句话完成了哪些任务、填了哪些信息槽，不等 AI； +2. 调度器按任务顺序选出下一个未完成任务；全部完成则收尾并进入总结； +3. 请求 AI 时下发：等级档、场景、**当前任务目标**、已收集的信息、可用语言清单、历史；要求先回应用户说的内容，再推进当前任务，一轮只推进一个任务； +4. 客户端检查 AI 回复： + - 通用检查：非空、是英文、不超过词数上限、问题数不超过上限、清单外词不超过上限、不替学习者说出答案、不重复问已收集的信息； + - 任务检查：回复确实在推进当前任务（包含任务的提问线索，或是收尾语）； +5. 检查不通过时带着具体原因重试一次；仍不通过则使用当前任务的示范句，并按 7.2 提示“这一句换成了示范句”。 + +技术约定： + +- 请求与返回均为 JSON；服务支持时开启 JSON 输出（如 DeepSeek 的 `response_format: {type: json_object}`）。历史中的 AI 轮同样以 `{"reply": ...}` 的 JSON 形式回放；若历史是纯文本，模型会跟着回纯文本或空白，导致误判为 AI 不可用。 +- 调用支持思考模式的模型时关闭思考，以控制延迟和费用。 +- 判定、计数和检查全部在客户端完成，模型返回的完成标记只作参考。 + +### 7.4 场景数据从哪里来 + +- **主线场景**：随单元内容包离线生成、校验、审核并经用户确认后冻结，流程见《学习引擎规格》第 5 节。运行时不生成主线场景。 +- **运行时变式**：AI 只能替换表面内容（人名、地点、物品、喜好等内容值，以及措辞和句子顺序），任务、引用的词句 ID 和判定条件保持不变；变式句同样要过 7.3 的通用检查。 +- **A0**：由现有课程对话脚本（`LessonDialogue`）转换为 Scene/Task；脚本中的问句作为任务示范句，`requiredTerms` 映射到 A0 核心词句 ID 后作为任务引用。脚本里的指令或操练轮（如“再说一遍”“跟我读”）不交给 AI，改为固定句。 +- **A2 及以上**：开放任务在 7.3 的检查之外，还按《学习引擎规格》5.8 用评分标准加 AI 评审判定完成。 ## 8. 对话交互细节 @@ -161,7 +194,7 @@ M1 发音反馈限示范音、慢放、录音回听和可选通用练习，不 ## 10. AI 提示词与质量要求 -AI 系统需要传入结构化上下文：用户等级、母语、场景、角色、任务目标、允许词汇/句型、轮次、用户已回答信息、求助状态与安全限制。 +AI 系统需要传入结构化上下文：等级档、母语、场景、角色、当前任务目标（而不是脚本原句）、已收集的信息槽、可用语言清单、轮次、求助状态与安全限制。返回格式为 JSON，检查与回退按 7.3。 词句的掌握状态、允许的新语言数量、失败后的降级练习，以及阶段出口任务，须遵循 [学习引擎规格](LEARNING-ENGINE-SPEC.md)。 @@ -182,6 +215,7 @@ AI 行为要求： | 语音对话 | 用户可完成至少 3 轮录音回复，识别失败时仍能编辑或改用文字继续 | | 难度控制 | A0 每轮最多一个明确问题，可加简短回应/开场词块，总计不超过 20 个英文词，不连问姓名和地点 | | 目标判定 | A0 初次见面场景提取姓名、地点和问候证据；客户端检查信息槽，不只采信 AI 完成标记 | +| 任务对齐 | 每轮 AI 回复先回应用户内容，再推进调度器选定的当前任务；不重复问已收集的信息；未通过检查时重试一次，仍失败则回退示范句并按 7.2 提示原因 | | 求助 | 四种求助操作不丢失当前会话状态 | | 总结 | 每段会话都生成一个积极反馈、一个改进句和一次立即重说机会 | | 复习 | 次日出现短变式或本地模板练习；技术失败不改变掌握度 | @@ -212,11 +246,11 @@ AI 行为要求： ### V1.1：改善日常使用 -对应总产品 M2：扩展 A1 场景与自由主题对话。目标推荐、基础进度和同阶段变式已包含在 M1；更多发音能力必须另行验证，不预设可用。 +对应总产品 M2：扩展 A1 场景与自由主题对话；A1 场景来自已冻结的 A1 单元内容包（主题地图见《学习引擎规格》5.2），单元冻结前显示“待提供”。目标推荐、基础进度和同阶段变式已包含在 M1；更多发音能力必须另行验证，不预设可用。 ### V2：扩展能力 -增加 A2 场景、旅行/职场对话包、个性化对话计划。在你能稳定完成 V1 场景且想继续学习时再投入。 +增加 A2、B1 单元场景（来自单元内容包，开放任务按评分标准判定）和个性化对话计划。在你能稳定完成 V1 场景且想继续学习时再投入。 ## 15. 数据与隐私 diff --git a/Doc/LEARNING-ENGINE-SPEC.md b/Doc/LEARNING-ENGINE-SPEC.md index 57d37a3..2432d07 100644 --- a/Doc/LEARNING-ENGINE-SPEC.md +++ b/Doc/LEARNING-ENGINE-SPEC.md @@ -1,35 +1,42 @@ # 学习引擎规格：每日内容、掌握判定与阶段升级 > 适用范围：个人使用的英语学习工具 -> 原则：课程主线保持稳定；AI 只在明确边界内生成变式练习与对话。 +> 原则：学习目标固定为日常生活与旅行，主线终点为 B1；课程主线由主题地图和冻结的单元内容包决定并保持稳定。目标决定学哪些场景，分级数据决定难度上限，AI 决定场景怎么演，程序决定怎样算完成。AI 只在明确边界内生成变式练习与对话。 M1 范围、生成与数据契约见 [开发与验收约定](M1-IMPLEMENTATION-CONTRACT.md)；A0 核心清单和四技能评估见 [A0 阶段标准](A0-STAGE-STANDARD.md)。以下规则是个人学习初始规则，不是 CEFR 认证标准。 ## 1. 学习体系的边界 -学习路径没有预设的总课数。当前 A0 的 10 节核心课和后续生活主题只是起始内容库；系统会根据掌握状态持续提供复习、变式任务和补救微课，直到达到阶段出口能力。它们不是“掌握英语”的终点。 +学习目标固定为**日常生活与旅行**，不提供目标选择。主线终点是 B1：CEFR 对 B1 的描述正是能应对在英语地区旅行时遇到的大多数情况，并能谈论熟悉的日常话题。B2 作为可选扩展，B1 通过后再规划。 + +不安排学校与学术场景，这类词汇不进入词池（5.4）。工作需求后续作为独立主题线增加：届时在主题地图中新增工作单元，使用 5.4 中预留的工作类词汇，不改变日常与旅行主线的单元和门槛；是否提供目标选择届时再定。 + +学习路径没有预设的总课数。A0 的 10 节核心课和第 5 节主题地图中的单元是主线内容；系统会根据掌握状态持续提供复习、变式任务和补救微课，直到达到阶段出口能力。它们不是“掌握英语”的终点。 阶段推进不取决于“学完多少课”。核心课用于建立能力骨架；当一个阶段的出口任务、词句掌握度和真实对话表现尚未达标时，系统继续生成符合该阶段范围的新情境与练习，而不是机械跳到下一阶段。 | 阶段 | 能力目标 | 主要学习形式 | |---|---|---| | A0 | 问候、自我介绍、数字、身边物品、基础短句 | 短课、模仿、受控对话 | -| A1 | 点餐、购物、问路、入住、预约等固定生活任务 | 场景课程、任务型 AI 对话 | -| A2 | 讲日常、过去经历、计划、比较、建议与简单问题解决 | 更长对话、短文本、变式任务 | -| B1 | 独立处理旅行、生活及一般工作交流；表达理由与经历 | 真实慢速输入、叙事、讨论、写作 | -| B2 | 较自然处理复杂讨论、长内容和工作沟通 | 自然语速输入、观点辩护、专业主题 | +| A1 | 点餐、购物、问路、交通、入住、看病等固定的生活与旅行互动 | 主题单元、任务型 AI 对话 | +| A2 | 讲经历、做预订与改期、比较选择、处理行程和住宿中的小问题 | 主题单元、较长对话、分级听读 | +| B1 | 独立应对旅行和生活中的大多数情况：突发问题、投诉协商、说明理由、讲完整经历 | 主题单元、较长听读材料、叙事、讨论、写作 | +| B2（可选） | 自然语速的生活与旅行内容、复杂协商和讨论 | B1 通过后再规划 | -“掌握英语”应被理解为逐步达成 B1/B2 的真实交流能力，而不是背完一套课。到 B1/B2 必须加入大量真实音频、视频、阅读、自由表达与阶段性任务测评。 +本工具说的“学会英语”，指达到 B1 的日常与旅行交流能力，而不是背完一套课。从 A2 起须逐步加大听读输入（第 6 节）。 + +**时间预期**：剑桥英语给出的累计指导学时参考为 A2 约 180–200 小时、B1 约 350–400 小时、B2 约 500–600 小时。每天 20 分钟约合每年 120 小时，大致对应 A2 约 1.5 年、B1 约 3 年；30 分钟模式约 2 年到 B1。这只用于设定预期，不作为进度要求或解锁条件。 ## 2. 每日内容生成引擎 -每天不由 AI 从零随机生成一整课。系统先从固定的能力地图中选内容，再让 AI 生成符合当前水平的例句、对话变式和纠错。 +每天不由 AI 从零随机生成一整课。系统先从固定的能力地图（主题地图与已冻结的单元内容包，见第 5 节）中选内容，再让 AI 生成符合当前水平的例句、对话变式和纠错。 ### 2.1 每日组成 ```text 到期复习（按时间选任务） → 教学段：词汇预热 → 带帮助的听说读写 → 受控对话 → 独立尝试 + → （A2 起）听读输入 → 总结与保存；未完成步骤留待续学 ``` @@ -39,6 +46,7 @@ M1 范围、生成与数据契约见 [开发与验收约定](M1-IMPLEMENTATION-C | 其中：词汇预热 | 新词与准备词块 | 认识声音和当前句义，之后在句中应用，不再重复整套词卡 | 占教学段 1–3 分钟 | | 其中：受控对话与独立尝试 | 已教语言 | 通常 3–5 个回答轮；结尾一轮可作为独立尝试 | 占教学段约 3–5 分钟 | | 到期复习与补救 | 到期词句和薄弱技能 | 合并同一目标的复习与错误修复，避免重复安排 | 按每日预算 | +| 听读输入（A2 起） | 当前单元的分级材料 | 积累可理解输入 | 从教学额度中划出：A2 约 20%，B1 约 35%（第 6 节） | 每日时间是安排上限，不保证每次完成整段。10 分钟：复习/补救 3 分钟、教学或续学 6 分钟、总结 1 分钟；20 分钟：5 + 14 + 1；30 分钟：8 + 20 + 2。30 分钟教学额度可用于慢练或可选巩固，不强制再学新段。无到期项时可将空余时间用于教学或提前结束。预热、课程内对话均包含在教学额度中，不另外叠加。只做复习的当天，独立输出可嵌入复习任务。 @@ -72,7 +80,7 @@ M1 范围、生成与数据契约见 [开发与验收约定](M1-IMPLEMENTATION-C ```text 当前阶段：A0 / A1 / A2 / B1 / B2 -当前主题与任务目标：例如“在咖啡店点饮料” +当前单元与任务：单元 ID、场景 ID、任务 ID、任务目标（例如“在咖啡店点饮料”）及任务引用的核心词句 ID 用户身份与 AI 身份 已掌握的词、句型 本教学段新词（最多 8 项）及主动句型（最多 2 项） @@ -95,7 +103,7 @@ AI 对话中的词条必须来自当前允许语言范围，或是事先标为 ## 3. 词汇与句型掌握模型 -词汇不以“看过一次”或“答对一次”为掌握。每个词和关键句型均经历五种状态： +词汇不以“看过一次”或“答对一次”为掌握。词汇分为“会用”的产出核心和“会认”的理解词两层（见 3.5）；本节五种状态与掌握规则适用于产出核心，每个词和关键句型均经历五种状态： | 状态 | 证据 | 系统动作 | |---|---|---| @@ -163,9 +171,50 @@ AI 对话中的词条必须来自当前允许语言范围，或是事先标为 一次反馈只处理一个点。`three/free` 可作为通用听辨、示范和回听练习，但界面须说明“识别可能有误，这不是发音诊断”。文字 AI 没有音频证据时不能断言用户把 /θ/ 发成 /f/；个性化音素诊断不在 M1。未编辑且确认的转写仅是受控口语的代理证据，不等于真人可理解度保证。 +### 3.5 两层词汇：会用与会认 + +| 层 | 范围 | 状态 | 是否计入升级分母 | +|---|---|---|---| +| 产出核心（会用） | 单元内容包中需要主动说、写的词、词块和句型；每单元 10–15 项 | 3.1–3.2 的五种状态和掌握规则 | 计入 | +| 理解词（会认） | 听懂、看懂即可的词；每单元 A1 20–35 项、A2 30–50 项、B1 50–80 项 | 新学 → 认识 → 熟悉 | 不逐项计入；升级时抽查（4.2） | +| 扩展词 | 听读材料中查过或多次出现、由用户加入复习的词 | 同理解词 | 不计入，也不参与升级抽查 | + +**学习流程**：单词不单独背，跟着单元场景学。 + +1. 会用的词：预热（只记“见过”）→ 在场景句中听辨 → 说、读、写的替换练习 → 受控对话中用出来 → 独立尝试 → 按 3.1 间隔复习，每次复习换语境（如从地铁站换到火车站）。 +2. 会认的词：不进预热，直接出现在教学段的听读材料里，首次出现可点开释义；教学段结束时做 2–3 道快速识别题，之后按下述理解词规则复习。 +3. 各等级侧重：A1 以具体名词和固定说法为主，用图片和替换练习；A2 增加词块、搭配和词形变化（如 `book a table`、`miss the bus`、过去式）；B1 的新词主要来自听读材料和查词，增加词族和近义词辨析（如 `complain`/`complaint`），并练习用英语解释词义。 + +**识别题要求**（两层词的“认识”证据，以及理解词和扩展词的全部证据）： + +- 至少一次在句子或场景语境中答对；孤立的中英互译不能作为唯一证据。 +- 干扰项取同单元或意思相近的词（如 `ticket` 配 `receipt`、`menu`），不用明显无关的词。 +- 提供“不认识”选项：选它不算语言失败，转为教学并换题补测。 +- 记录作答用时：听辨题超过约 10 秒、阅读识别题超过约 15 秒，记为带帮助完成，不算独立成功。 +- 理解词只考“听或读 → 意思”，不考拼写，也不要求说出。 + +理解词规则： + +- 一次独立的听辨或阅读识别成功进入“认识”；至少间隔 7 天后，换题、换语境再次独立识别成功，进入“熟悉”，之后每 30 天抽查。 +- 识别失败回到“认识”，次日换题复核；不做诊断降级。 +- 复习以 5–10 秒的快速识别题为主，可以成组出现，占复习预算不超过三分之一。 +- 在听读材料中答对与某个理解词直接相关的理解题，可计一次该词的识别证据。 +- 后续单元把某个理解词列为产出核心时，保留已有识别证据，从“认识”开始走完整掌握流程。 + +A0 的准备/辅助材料沿用《A0 阶段标准》，不套用本节。 + +### 3.6 免学与定级 + +已经会的内容不必重学，但“会”需要证据： + +- **单元预检**：进入单元时可选做一次不超过 3 分钟的预检，在单元场景里考听辨和独立表达（说或写）。某项产出核心两类题都独立答对，记为“免学待确认”，教学段中跳过其讲解；至少 3 天后换题独立复测一次，成功即记为已掌握并进入 30 天抽查，失败则按新项正常教学。理解词预检识别正确直接记为“熟悉”。预检答错不计语言失败。 +- **入门定级**：“完全零基础”从 A0 开始。“有一些基础”或“能简单对话”可做定级评估：依次使用各等级已冻结的出口题组中的一套（先 A0，通过后再 A1……），在第一个未通过的等级停止，从该等级开始学习。某等级题组尚未冻结时，定级最多只到该等级。 +- **定级通过**：定级跳过的等级记为“定级通过”，与“阶段通过”分开保存；14 天内再通过该等级的另一套题组才算确认。未确认时首页建议回到该等级，但不强制。 +- **定级免学**：跳过等级的产出核心不走四个检查点，每天从复习预算中最多抽 5 项独立复测；失败项转为需复核并安排补救。跳过的等级不参与后续等级的门槛计算。 + ## 4. 阶段升级规则 -已完成课数只用于回顾学习历史，不能决定升级。可以提前参加评估或延后升级，但只有门槛全部满足才记录阶段通过，不能手动跳级。入门轻量定位只推荐当前阶段内的教学起点，不替代出口评估。下一阶段内容未就绪时显示待提供，不自动生成未定义的主线。 +已完成课数只用于回顾学习历史，不能决定升级。可以提前参加评估或延后升级，但只有门槛全部满足才记录阶段通过，不能手动跳级。入门轻量定位只推荐起点，定级跳过等级须按 3.6 用出口题组证明。下一等级尚无已冻结的单元时显示待提供，不在运行时临时生成主线；单元内容包按第 5 节离线生成、校验、审核并经用户确认冻结后才可学习。 ### 4.1 A0 → A1 @@ -173,39 +222,228 @@ AI 对话中的词条必须来自当前允许语言范围，或是事先标为 初次见面对话只是口语评估的一部分，还须验证姓名拼读、数字、物品、家人、星期/整点及沟通补救；阅读和写作单独评估。带提示、修改转写或识别失败的处理按标准执行。未通过则定向补练与换题复测，不限制追加课程数量。 -### 4.2 A1 → A2 +### 4.2 A1 及以上的升级门槛 -以下为 M2 的能力方向，尚不是可直接启用的 A1 自动升级规则。启用 A1 前须另行冻结核心清单、四技能题组和阈值；未冻结前禁用 A1→A2 自动升级： +门槛只设在等级之间，单元之间不设门槛（见 5.1）。从 A1 起，进入下一等级须同时满足： -- 能在点餐、购物、问路、交通、酒店等 8–10 个场景中完成目标； -- 能听懂慢速日常对话的主要信息； -- 能写 4–6 句连贯的短消息； -- 能完成约 3 分钟任务型 AI 对话； -- 能表达一个过去经历和一个简单计划； -- A1 的核心词句门槛以未来有版本的 A1 标准为准，不复用未定义分母的“约 80%”。 +1. 本等级产出核心（全部单元之和，等级 stageVersion 冻结的分母）中至少 80% 为可使用或已掌握，其中至少 50% 为已掌握；需复核项的处理同《A0 阶段标准》； +2. 理解词抽查：从本等级已教的理解词中随机抽 30 项做听或读的识别，独立答对至少 24 项； +3. 两套不同题组的四技能评估分别通过，间隔至少 24 小时，最近一次在 30 天内； +4. 完成本等级的出口任务（4.3）。 -**出口任务**：完成一次旅行日：入住酒店、询问路线、点餐并处理一个简单问题。 +本等级的单元未全部冻结前，只能学习已冻结的单元，升级评估不可用。比例由程序固定，内容包不能修改。 -### 4.3 A2 → B1、B1 → B2 +### 4.3 出口任务 -| 升级 | 出口能力 | 建议任务 | +| 升级 | 出口能力 | 出口任务 | |---|---|---| -| A2 → B1 | 能讲经历、说明理由、处理多数日常突发情况 | 听 2–3 分钟慢速素材后复述；完成 5 分钟旅行问题解决对话；写一封短邮件 | -| B1 → B2 | 能理解自然语速主要内容、清楚支持观点、处理工作沟通 | 阅读/收听真实材料后总结和讨论；完成 10 分钟工作情境模拟；写结构化说明或意见 | +| A1 → A2 | 在点餐、购物、问路、交通、住宿、看病等场景中完成固定互动；能写 3–5 句短消息 | **旅行日**：入住酒店、询问路线、点餐并处理一个简单问题（约 3 分钟对话）；写一条告诉朋友当天安排的消息 | +| A2 → B1 | 讲经历，做预订和改期，比较选择，处理行程和住宿中的小问题 | **行程变化日**：电话改订并当面解决一个住宿问题（约 5 分钟对话）；听 1–2 分钟通知后说出要点；写 4–6 句消息讲当天发生了什么 | +| B1 结业（B2 可选） | 独立应对旅行和生活中的大多数情况，说明经过和理由 | 听 2–3 分钟广播或导览后复述；5 分钟旅途突发问题的解决与协商对话；写一封说明问题并提出要求的邮件 | -这两个阶段必须人工或通过高质量任务评估复核，不应只靠选择题自动升级。 +A2 起的出口任务按 5.8 判定；A2 → B1 与 B1 结业须人工或通过高质量任务评估复核，不应只靠选择题自动升级。 -## 5. 长期内容扩展 +## 5. 学习路线与单元内容包 -| 目标 | 新增内容 | 不可缺少的练习 | -|---|---|---| -| A2 | 过去时、将来计划、比较、建议、情绪、关系、问题解决 | 1–3 分钟叙述、短消息、生活变式对话 | -| B1 | 旅行问题、工作日常、观点与理由、故事复述 | 慢速真实音频/视频、段落写作、5 分钟讨论 | -| B2 | 复杂观点、会议、协商、跨文化表达、专业主题 | 自然语速材料、总结、辩护观点、10 分钟任务模拟 | +**目标决定学哪些场景，分级数据决定难度上限，AI 决定场景怎么演，程序决定怎样算完成。** 学习目标固定为日常生活与旅行；主题地图（5.2）列出每个等级要完成的生活和旅行任务；AI 从场景出发起草单元内容，再用分级数据检查难度；程序校验、编译判定条件并执行门槛。单元冻结后，运行时 AI 不能再改变它。 -系统要成为从零到 B1/B2 的骨架，必须逐阶段增加“可理解输入”和“开放输出”的比例：A0/A1 以受控短句为主；A2 开始加入短文本和变式表达；B1/B2 以真实材料、观点表达、长对话和写作为主。 +### 5.1 路线结构 -## 6. 个人使用检查 +```text +等级（A0 / A1 / A2 / B1） + → 主题单元（一组相关的生活或旅行任务） + → 教学段（沿用第 2 节，每段约 10–15 分钟） + → 场景与任务（单元主场景 + 2–3 个变式场景） +``` + +- **单元是冻结和学习的基本单位**：某个单元冻结后即可学习，不必等整个等级。 +- **单元之间不设门槛**：完成单元的教学段并尝试过单元任务后，即可进入下一单元；掌握在复习中继续推进。积压时按 2.2a 暂停推荐新单元。 +- **推荐顺序按依赖排列**（如价格先于购物、日期先于预订、问路先于交通）。用户可以自选单元；跳到后面的单元时，前面单元中被引用的词句作为预热新项先教。 +- **单元规模**：产出核心 10–15 项（词、词块、句型）；理解词 A1 20–35 项、A2 30–50 项、B1 50–80 项（两层词汇见 3.5）。A1 数量已按词池试建结果调整（5.4）；A2、B1 仍是初始估计，建好词池后再调整。 + +### 5.2 主题地图 + +A0 保持现有 10 节核心课（见《A0 初始核心课程包》）。A1 起的单元如下，“类别”表示该单元主要服务日常还是旅行。修改主题地图（增删、合并或调整单元）须用户确认；已冻结单元的 ID 不复用。 + +**A1：固定的生活与旅行互动** + +| 单元 | 主题 | 类别 | 单元结束后能做什么 | +|---|---|---|---| +| A1-U01 | 在咖啡店点单 | 日常 | 点饮料、说规格、礼貌确认 | +| A1-U02 | 价格与付款 | 日常/旅行 | 问价、说 100 以内的金额、选择现金或刷卡 | +| A1-U03 | 在餐厅点餐 | 日常/旅行 | 点餐、问推荐、要账单 | +| A1-U04 | 超市与便利店 | 日常 | 找商品、说数量 | +| A1-U05 | 买衣服 | 日常 | 问尺码和颜色、试穿 | +| A1-U06 | 认识新朋友 | 日常 | 问职业、兴趣和住在哪里 | +| A1-U07 | 我的一天 | 日常 | 说作息和常做的事 | +| A1-U08 | 天气与穿着 | 日常/旅行 | 问天气、说该穿什么 | +| A1-U09 | 日期与约时间 | 日常 | 说日期、约见面、改时间 | +| A1-U10 | 问路 | 旅行 | 问地点、听懂左右和距离 | +| A1-U11 | 公交与地铁 | 旅行 | 买票、问站点、确认下车 | +| A1-U12 | 打车 | 旅行 | 说目的地、确认价格或路线 | +| A1-U13 | 在机场 | 旅行 | 值机、问登机口、回答入境的简单问题 | +| A1-U14 | 入住酒店 | 旅行 | 说明预订信息、办理入住 | +| A1-U15 | 酒店里的需求 | 旅行 | 要物品、报告简单问题 | +| A1-U16 | 药店与不舒服 | 日常/旅行 | 说一个症状、听懂基本建议 | +| A1-U17 | 请求帮助 | 日常/旅行 | 礼貌求助、感谢与回应 | +| A1-U18 | 打电话与留言 | 日常 | 留下姓名、号码和简短信息 | +| A1-U19 | 周末计划 | 日常 | 说将要做的事 | + +**A2：讲经历、做安排、处理小问题** + +| 单元 | 主题 | 类别 | 单元结束后能做什么 | +|---|---|---|---| +| A2-U01 | 上个周末 | 日常 | 用过去时讲做了什么 | +| A2-U02 | 上一次旅行 | 旅行 | 讲去了哪里、怎么样、感受如何 | +| A2-U03 | 预订酒店与餐厅 | 旅行 | 电话或当面预订：日期、人数、要求 | +| A2-U04 | 改期与取消 | 日常/旅行 | 说明原因、提出新时间 | +| A2-U05 | 餐厅里的问题 | 旅行 | 说明忌口或过敏、菜品有问题、分开结账 | +| A2-U06 | 比较与选择 | 日常/旅行 | 比较商品、房间或路线并做选择 | +| A2-U07 | 退换货 | 日常 | 说明问题、要求退换 | +| A2-U08 | 行程出问题 | 旅行 | 误车、延误、换乘、改票 | +| A2-U09 | 住宿里的问题 | 旅行 | 报修、换房、提出要求 | +| A2-U10 | 看病 | 日常/旅行 | 说症状和持续时间、听懂用药说明 | +| A2-U11 | 聊兴趣与家乡 | 日常 | 围绕一个话题连续聊几轮 | +| A2-U12 | 建议与意见 | 日常/旅行 | 给建议、征求意见 | +| A2-U13 | 介绍城市与景点 | 旅行 | 描述地方、推荐去处 | +| A2-U14 | 丢东西与求助 | 旅行 | 在服务台说明丢了什么、在哪里丢的 | +| A2-U15 | 消息与短邮件 | 日常 | 写邀请、感谢、说明迟到 | + +**B1：独立应对大多数情况** + +| 单元 | 主题 | 类别 | 单元结束后能做什么 | +|---|---|---|---| +| B1-U01 | 讲一段完整的旅行经历 | 旅行 | 按顺序叙述，加入背景和感受 | +| B1-U02 | 规划行程 | 旅行 | 比较交通和住宿方案，说明理由和预算 | +| B1-U03 | 入境与行李 | 旅行 | 回答入境问题，报告行李延误或丢失 | +| B1-U04 | 听懂广播与讲解 | 旅行 | 抓住车站、机场广播和导览讲解的要点 | +| B1-U05 | 紧急情况 | 旅行 | 证件或钱包丢失、报警、求助 | +| B1-U06 | 就医 | 日常/旅行 | 说明症状变化和病史，理解医嘱要点 | +| B1-U07 | 投诉与协商 | 日常/旅行 | 要求退款或补偿，谈出解决办法 | +| B1-U08 | 租住与长住 | 日常 | 沟通租房或短租，理解规则要点 | +| B1-U09 | 生活服务 | 日常 | 办银行和手机卡业务、寄收快递、预约维修 | +| B1-U10 | 观点与理由 | 日常 | 推荐并说明理由，回应不同意见 | +| B1-U11 | 习俗与文化 | 旅行 | 谈小费、礼仪和节日，比较不同做法 | +| B1-U12 | 深入聊天 | 日常 | 聊经历、计划和感受，维持 5 分钟对话 | +| B1-U13 | 读懂生活文本 | 日常/旅行 | 读懂评价、说明、规则和通知 | +| B1-U14 | 写说明与投诉 | 日常/旅行 | 写邮件说明经过并提出要求 | + +B2 为可选扩展（自然语速的生活与旅行内容、复杂协商和讨论），B1 通过后再规划单元。 + +### 5.3 数据来源 + +| 数据 | 锁定版本 | 规模 | 用途 | 许可与要求 | +|---|---|---|---|---| +| CEFR-J Vocabulary Profile | 1.5 | 7,799 条（按词+词性），词头 6,867；A1 1,164、A2 1,411、B1 2,446、B2 2,778 | 词汇难度上限；建立等级词池（5.4）。约 1,740 条自带主题标注（如 Shopping 197、Food and drink 167、Travel 120、Education 85） | 研究和商用免费；须注明出处（CEFR-J，東京外国語大学投野由紀夫研究室） | +| CEFR-J Grammar Profile | 20180315 | 500 条语法项；约 170 条标了 A1.1–B2.2 子级，其余为同一项的否定/疑问变体 | 单元主动语法的难度上限 | 同 CEFR-J 词表 | +| Octanove Vocabulary Profile C1/C2 | 1.0 | 2,136 条：C1 1,111、C2 1,025 | 判断超出 B2 的词 | CC BY-SA 4.0；须署名，衍生数据须用同一许可 | +| NGSL / NGSL-Spoken | 导入时记录 | NGSL 2,809 词 | 候选词按（口语）频率排序 | CC BY-SA，可商用；须署名 | +| ECDICT | 导入时记录提交号 | 约 76 万词条 | 中文释义、音标、考试标签和词频，供人工复核 | MIT；只用 translation、phonetic、tag、bnc、frq，不用来源不明的 collins、oxford 字段 | + +不导入、不抄录：Cambridge English Vocabulary Profile / English Grammar Profile、Oxford 3000、Pearson GSE（没有开放许可）。 + +原始数据文件与来源说明（版本、下载地址、SHA-256、许可文本）随内容包一同存档。 + +### 5.4 分级数据怎么用 + +分级数据只做**难度上限和覆盖检查**，不决定单元的内容和顺序： + +- **语法**：单元主动使用的语法项不高于本等级（A1 单元只用 A1.x，A2 不超过 A2.x，B1 不超过 B1.x）；未标等级的否定/疑问变体按主项等级处理。数据等级明显不合生活场景的（如 `You are` 标为 B1.1）可以提前，须写明理由。 +- **词汇**：功能词、动词、形容词不高于本等级。CEFR-J 依据日本中小学教材统计，不少旅行名词等级偏高（`passport`、`luggage`、`platform`、`pharmacy`、`reservation` 都标为 B1），因此场景必需的具体名词和固定说法可作为**场景词**提前使用：须标注，且每个单元产出核心中场景词不超过 1/3。 +- **理解词**：不高于本等级加一级，场景词除外。 +- **等级词池**：起草某等级的单元前，先建立该等级的词池，作为词汇覆盖目标： + 1. 取 CEFR-J 中属于本等级的词头； + 2. 按用途分类：通用（功能词和不限场景的常用词）、日常、旅行、工作、学校与学术、其他。分类可多选；CEFR-J 自带主题标注的直接使用，未标注的由 AI 离线分类，用户抽样审核； + 3. 属于通用、日常或旅行任一类的词进入词池；只属于学校与学术或其他的词不进入；只属于工作的词单独保存，留给后续工作主题线； + 4. 单元提出的场景词（包括 CEFR-J 未收录的，如 `boarding pass`）并入词池。 + 5. 程序把词池中尚未被前面等级覆盖的词**预分配**给本等级单元，作为各单元的候选词：有主题标注的按主题对应单元（如 Food and drink 分到点单、餐厅、超市），其余的形容词、动词、副词由 AI 按场景合适程度分配，每个单元都要分到一部分。功能词（代词、限定词、介词、连词、情态动词）不分配，靠词块和句型覆盖。 + 词池随等级 stageVersion 冻结，分类结果随数据来源一同存档。 +- **覆盖检查**：冻结等级 stageVersion 前，本等级词池至少 85% 须被覆盖：作为产出核心或理解词，或出现在产出核心的词块、句型里（如 `Can I have ...?` 覆盖 can、I、have），A0 已教的词也算。每冻结一个单元，其候选词中未覆盖的词顺延到后面的单元；未覆盖的词逐个补进某个单元、放进听读材料，或写入排除项并说明理由。 +- **A1 词池试建（2026-09-17，未经用户抽样审核）**：CEFR-J 1.5 的 A1 共 1,066 个不同词头。排除只属于学校与学术或其他的 102 个（如 homework、grammar、ruler，以及 fairy、prince、lion、kite、DVD 等儿童读物词和过时词），单独保存只属于工作的 15 个（如 meeting、interview、engineer、business），合并 is/was/did 等词形变体后，词池为 932 个。其中 A0 已覆盖 68 个，约 126 个是功能词和数词，其余约 770 个是实词：无主题标注的形容词 109、名词 105、动词 88、副词 40；有标注的 Free time 68、Personal identification 60、House and home 55、Food and drink 52、Shopping 44、Travel 23、Health 23 等。85% 覆盖需要 A1 单元再覆盖约 730 个。按每单元产出核心 12 项、其中约 8 项覆盖词池词（其余是场景词或纯句型）估算，产出核心覆盖约 150 个，加上词块中的功能词约 100 个，理解词需要覆盖约 480 个，也就是每单元平均约 25 个，因此 A1 的理解词数量从 15–30 调为 20–35。试建发现主题地图的缺口：family 类（aunt、cousin、husband、daughter 等约 20 个）和住处类（kitchen、bedroom、sofa、garden 等约 15 个）没有对应的 A1 单元，描述人和情绪的形容词（tall、young、angry、lonely 等）也没有集中的单元。 +- **A0**：保持已冻结的 60 项（`A0-1.0`），不按数据重新生成。对照 CEFR-J 1.5：40 个单词按词形还原后有 39 个属于 A1（`movies`→`movie`、`okay`→`OK/okay`），`zero` 不在词表中，作为 A0 自有项保留。 + +### 5.5 单元内容包组成 + +| 部分 | 内容 | +|---|---| +| 元数据 | 单元 ID、修订号（如 `A1-U03 r1`）、数据来源与版本、起草与审核所用模型、审核记录、确认冻结日期 | +| 能力 | can-do 描述，对应主题地图中的“单元结束后能做什么” | +| 场景 | 场景 ID、学习者身份与 AI 身份、背景、开场句；一个主场景加 2–3 个变式场景 | +| 任务 | 任务 ID、目标、引用的产出核心 ID、需要收集的信息槽、示范句；判定条件由程序根据引用编译，不由 AI 填写 | +| 产出核心 | 稳定 ID（如 `A1-U03-W01` 词、`A1-U03-P01` 词块或句型）、英文、当前义中文、CEFR-J 等级、是否场景词及理由 | +| 理解词 | ID、英文、当前义中文、等级 | +| 语法项 | CEFR-J 语法 ID、主动使用或仅理解 | +| 单元预检 | 覆盖全部产出核心的听辨与独立表达题（3.6） | +| 听读材料（A2 起） | 2–3 篇材料及理解题（第 6 节） | +| 排除项 | 考虑过但不纳入的词句及理由 | +| 评分标准（A2 起） | 开放任务的评分维度、各档描述和及格档 | + +等级内全部单元冻结后，再生成该等级的出口评估蓝图和至少两套题组（覆盖每个单元的能力），冻结为等级 stageVersion（如 `A1-1.0`），锁定升级分母。之后修改已冻结的单元须新建 stageVersion 并提供旧新 ID 映射，遵循《A0 阶段标准》；已通过的记录保留原版本。 + +### 5.6 生成与冻结流程 + +```text +主题地图中的一个单元（主题 + 能做什么） + → AI 起草单元内容包：先写场景和任务，再从中提取产出核心和理解词；理解词优先从本单元的候选词（5.4）中选 + → 程序校验（失败则带错误清单退回修复，最多 2 次，仍失败则停止并提示人工处理） + → 独立审核（另一次 AI 调用，逐项列问题；有问题则退回修复） + → 用户确认 → 冻结单元，随应用发布 + +等级内全部单元冻结 + → 生成出口评估题组 → 同样校验、审核、确认 → 冻结等级 stageVersion，启用升级评估 +``` + +程序校验至少包括： + +- ID 唯一；每个词都能在锁定数据版本中查到等级，或标为人工补充并给出理由； +- 符合 5.4 的语法、词汇、场景词和理解词上限； +- 任务引用的 ID 都存在；每个产出核心至少被一个任务和单元预检覆盖； +- 示范句与开场句只使用本单元、推荐顺序在前的单元以及 A0 的词句，专名和数字除外； +- 听读材料符合第 6 节的覆盖率要求； +- 单元覆盖的候选词不少于候选词数的 60%（候选词本身少于 20 个时不检查），未覆盖的候选词顺延； +- 冻结等级 stageVersion 时，词池覆盖率符合 5.4。 + +单元未冻结时显示“待提供”，不能学习。运行时 AI 只能生成表面变式（人名、地点、物品等内容值，以及措辞和句子顺序），不能增删核心项，也不能改变任务目标或判定条件。 + +### 5.7 决定权 + +| 事项 | 由谁决定 | +|---|---| +| 学哪些场景和能力 | 主题地图（5.2），目标固定为日常与旅行；修改须用户确认 | +| 单元的核心词句、理解词、语法项 | AI 从场景出发起草，按 5.4 校验，审核后由用户确认冻结 | +| 场景设定、角色、开场句、示范句 | AI 离线起草，冻结后固定 | +| 每一轮说什么 | 运行时 AI，受对话调度约束（见《AI 对话模块规格》7.3） | +| 任务是否完成 | 程序按任务引用的词句和信息槽判定；A2 起再加评审（5.8） | +| 掌握状态与复习 | 程序，按第 3 节 | +| 升级门槛 | 程序固定，见 4.1 与 4.2；AI 与内容包都不能修改 | + +### 5.8 A2 及以上的开放任务判定 + +A2 起任务包含叙述、理由、建议等开放表达，不能只靠关键词判定： + +- **程序硬性检查**：句数或长度、必需信息槽、是否用到任务要求的目标语言项、清单外词比例、是否为英文； +- **AI 评审**：按单元的评分标准逐维度给档，每一档须引用用户原句作为证据；程序核对引用确实出自用户作答，引用不符则丢弃这次评审； +- **判定**：硬性检查全部通过，且各维度达到及格档，才算完成任务；评审失败或服务不可用记为待确认，不记语言失败； +- A2 → B1 与 B1 结业的出口评估须人工复核，与 4.3 一致。 + +## 6. 听读输入 + +A0–A1 的听读输入在课程和对话里完成。从 A2 起单独安排输入，并逐级提高比例： + +| 等级 | 占每日时长 | 听 | 读 | 语速与声音 | +|---|---|---|---|---| +| A2 | 约 20%（20 分钟模式约 4 分钟） | 1–2 分钟的对话、通知、电话留言 | 150–250 词的消息、菜单、说明、短文 | 慢速到正常；2–3 种声音 | +| B1 | 约 35%（20 分钟模式约 7 分钟） | 2–4 分钟的广播、导览、访谈式对话 | 300–500 词的评价、邮件、规则、故事 | 正常语速；多种常见口音，可加轻微背景声 | + +输入时间从教学额度中划出，不额外加时。 + +- **材料来源**：每个单元随内容包冻结 2–3 篇；另可由 AI 在运行时按同样规则生成新篇目，只作练习。不内置未授权的真实材料。 +- **程序检查**：按词次计，超出“已学产出核心 + 已学理解词 + 本单元场景词”的词不超过 2%（约 98% 的词汇覆盖才能较好理解），每个超出词附当前义释义；句长与语法不高于本等级。 +- **理解题**：每篇 2–4 道（要点、细节、推断），结果只更新相关理解词的识别证据，不更新产出核心。 +- **查词**：材料中查过或多次出现的词可一键加入扩展词复习（3.5）。 +- **记录**：进度页显示每周听读分钟数；不设硬指标，连续两周明显低于计划时在首页提示。 + +## 7. 个人使用检查 不需要留存指标。每周检查以下问题即可： diff --git a/Doc/M1-IMPLEMENTATION-CONTRACT.md b/Doc/M1-IMPLEMENTATION-CONTRACT.md index 4cf7b3d..4aa9534 100644 --- a/Doc/M1-IMPLEMENTATION-CONTRACT.md +++ b/Doc/M1-IMPLEMENTATION-CONTRACT.md @@ -17,7 +17,7 @@ M1 是完整的 **A0 学习闭环**，不是全部 A0–B2 产品： 不包含：账号、社交、付费、留存运营、通知、自建业务后台、自动同步、导出/导入、自由主题聊天、实时全双工语音、精细发音诊断。导出/导入和 A1 课程在 M2；A2 及以上逐阶段扩展，不因文档列出目标而视为已经交付。 -M1 通过 A0 后记录 `A0 已通过，A1 内容待提供`，可继续 A0 巩固；不生成未经定义的 A1 主线。只有阶段通过且下一阶段内容及评估规范已就绪时才允许进入。入门定位不能绕过阶段门槛。 +M1 通过 A0 后记录 `A0 已通过，A1 内容待提供`，可继续 A0 巩固；不在运行时生成 A1 主线。A1 内容须按《学习引擎规格》第 5 节离线生成单元内容包并经确认冻结；只有 A0 通过且至少有一个已冻结的 A1 单元时才允许进入。A1 内容冻结前，入门定位只在 A0 内推荐起点；之后的定级规则见学习引擎 3.6。 ## 2. 内容与生成契约 diff --git a/Doc/M1-WIREFRAMES.md b/Doc/M1-WIREFRAMES.md index e174a49..25de91d 100644 --- a/Doc/M1-WIREFRAMES.md +++ b/Doc/M1-WIREFRAMES.md @@ -19,16 +19,13 @@ M1 是手机优先的 A0 单人学习闭环：10 节种子课及分段、听说 - 进度以“能完成什么”展示，不只显示词汇数量或分数。 - 学习进度、复习队列与设置保存在本机；如需换设备续学，后续提供加密导出/导入，不需要账号系统或多人数据模型。 -## P01 欢迎与目标 +## P01 欢迎与每日时长 ```text ┌──────────────────────────┐ │ 开口英语 │ │ 每天 20 分钟，说出能用的英语 │ │ │ -│ 你的主要目标是？ │ -│ ○ 日常生活 ○ 旅行 ○ 工作起步│ -│ │ │ 每天可以学习多久？ │ │ [10 分钟] [20 分钟] [30 分钟]│ │ │ @@ -36,9 +33,9 @@ M1 是手机优先的 A0 单人学习闭环：10 节种子课及分段、听说 └──────────────────────────┘ ``` -**输入**：目标、每日时长。 +**输入**：每日时长（学习目标固定为日常与旅行，不做选择）。 **输出**：保存为学习计划参数；进入 P02。 -**验收**：全程不超过 2 次选择；跳过不影响后续使用。 +**验收**：全程 1 次选择；跳过不影响后续使用。 ## P02 起点定位 diff --git a/Doc/PRODUCT-PRD.md b/Doc/PRODUCT-PRD.md index 5c0b7eb..cd1f7d4 100644 --- a/Doc/PRODUCT-PRD.md +++ b/Doc/PRODUCT-PRD.md @@ -1,8 +1,8 @@ # 开口英语（暂定名）首版产品 PRD -> 版本：0.2｜2026-09-12 +> 版本：0.3｜2026-09-17 > 使用方式：个人自用、手机优先，支持 iPhone、Android 与 Mac 的中文英语学习工具 -> 学习目标：按可用时间练习，逐步把英语用在生活中，追求稳定听懂、稳定被听懂；不承诺固定周数达标。 +> 学习目标：固定为日常生活与旅行，不提供目标选择；按可用时间练习，逐步达到 B1 的日常与旅行交流能力，追求稳定听懂、稳定被听懂；不承诺固定周数达标。 ## 1. 产品概述 @@ -14,7 +14,7 @@ 发音目标是清楚、可理解、可完成任务，而非模仿特定地区口音；听力目标是理解当前阶段场景中的主要意思与关键细节，并能在没听清时继续沟通。 -每日内容生成、词句掌握判定、阶段出口任务与通向 B1/B2 的内容扩展，统一以 [学习引擎规格](LEARNING-ENGINE-SPEC.md) 为准。 +每日内容生成、词句掌握判定、阶段出口任务、主题地图（A1–B1 单元）与听读输入，统一以 [学习引擎规格](LEARNING-ENGINE-SPEC.md) 为准。 M1 范围、内容数据和异常验收以 [开发与验收约定](M1-IMPLEMENTATION-CONTRACT.md) 为准；A0 可执行门槛见 [A0 阶段标准](A0-STAGE-STANDARD.md)。下文 A1 场景是后续方向，不属于 M1。 @@ -26,7 +26,8 @@ M1 范围、内容数据和异常验收以 [开发与验收约定](M1-IMPLEMENTA ### 1.3 当前不做 -- 不以雅思、托福、四六级等考试提分为目标。 +- 不以雅思、托福、四六级等考试提分为目标，不安排学校与学术场景。 +- 暂不做工作场景；工作需求后续作为独立主题线增加，见学习引擎第 1 节。 - 不在首版提供高阶新闻阅读、商务谈判或开放社交社区。 - 不把整套教材或外部网站内容直接搬入应用。 - 不做登录注册、付费、消息推送、排行榜、多人协作、增长分析或上线运营。 @@ -38,7 +39,7 @@ M1 范围、内容数据和异常验收以 [开发与验收约定](M1-IMPLEMENTA | 用户 | 现状 | 需求 | |---|---|---| -| 零基础职场成人 | 认识少量单词，羞于开口 | 从最简单且有用的句子开始，得到耐心纠错 | +| 零基础成人 | 认识少量单词，羞于开口 | 从最简单且有用的句子开始，得到耐心纠错 | | 有基础但遗忘的成人 | 学过语法，听说困难 | 快速定位起点，恢复日常对话能力 | | 旅行/生活需求者 | 有明确近期出行或生活任务 | 在出发前完成点餐、问路、入住等演练 | @@ -49,8 +50,9 @@ M1 范围、内容数据和异常验收以 [开发与验收约定](M1-IMPLEMENTA | 等级 | 名称 | 核心能力 | 进入条件 | |---|---|---|---| | A0 | 起步 | 认识常用字母/声音，能说极短句 | 新用户默认起点或测评结果 | -| A1 | 生存 | 用简单句完成固定生活互动 | A0 通过且 A1 内容就绪；M1 显示待提供 | -| A2 | 日常 | 描述日常、计划与简单经历 | 首版仅显示“即将推出” | +| A1 | 生存 | 用简单句完成固定的生活与旅行互动 | A0 通过且有已冻结的 A1 单元；M1 显示待提供 | +| A2 | 日常 | 讲经历、做预订与改期、处理行程和住宿中的小问题 | A1 通过且有已冻结的 A2 单元 | +| B1 | 独立 | 独立应对旅行和生活中的大多数情况 | A2 通过且有已冻结的 B1 单元；B2 为可选扩展 | ### 3.1 入门测评 @@ -60,11 +62,11 @@ M1 范围、内容数据和异常验收以 [开发与验收约定](M1-IMPLEMENTA 2. 1 题朗读 `Hello. My name is ...`，可跳过； 3. 1 题回答 `What is your name?`，可用文字或录音。 -结果只给出建议起点和原因，不给“失败”标签。用户可随时选择“从更简单内容开始”。语音题不作为硬性分级依据，避免麦克风环境造成误判。 +结果只给出建议起点和原因，不给“失败”标签。有基础的用户可再做定级评估，用出口题组证明后从更高等级开始，规则见学习引擎 3.6；A1 内容冻结前只推荐 A0 内的起点。用户可随时选择“从更简单内容开始”。语音题不作为硬性分级依据，避免麦克风环境造成误判。 ### 3.2 阶段升级 -阶段升级不由完成课数决定。A0 必须达到固定核心词句门槛并通过两次不同题组的听说读写评估；初次见面对话仅是其中一部分。可提前评估但不得未通过就跳级。A1→A2 的旅行日模拟是后续方向，须先补齐 A1 标准才能启用。完整规则见 [学习引擎规格](LEARNING-ENGINE-SPEC.md)。 +阶段升级不由完成课数决定。A0 必须达到固定核心词句门槛并通过两次不同题组的听说读写评估；初次见面对话仅是其中一部分。可提前评估但不得未通过就跳级。A1 起门槛只设在等级之间，单元之间不设门槛；各等级门槛与出口任务见学习引擎 4.2、4.3。完整规则见 [学习引擎规格](LEARNING-ENGINE-SPEC.md)。 ## 4. 学习体验与信息架构 @@ -76,7 +78,7 @@ M1 范围、内容数据和异常验收以 [开发与验收约定](M1-IMPLEMENTA | 学习 | 完成一节新课 | 情境、词句、听说读写任务 | | 对话 | 在安全的情境中开口交流 | 场景卡、语音/文字对话、对话总结 | | 复习 | 巩固个人薄弱点 | 忘记的词、说错的句、听错的音频 | -| 我的 | 看得见进步 | 当前等级、掌握句型、练习记录、目标设置 | +| 我的 | 看得见进步 | 当前等级、掌握句型、练习记录、每周听读时间、每日时长设置 | 课程、阅读和对话中的英文均可点词或点短语查看当前语境下的中文意思、音频、短例句，并手动加入复习；短语优先于单词。查词卡不是独立主导航，关闭后回到原步骤。 @@ -85,8 +87,7 @@ M1 范围、内容数据和异常验收以 [开发与验收约定](M1-IMPLEMENTA ### 4.2 新用户流程 ```text -选择目标（生活 / 旅行 / 工作起步） - → 选择每日时间（10 / 20 / 30 分钟） +选择每日时间（10 / 20 / 30 分钟） → 可选入门测评 → 得到起点与第一节课 → 完成一次开口练习 @@ -105,7 +106,7 @@ M1 范围、内容数据和异常验收以 [开发与验收约定](M1-IMPLEMENTA ### 4.4 每日内容选择 -每日任务按预算从“到期复习、未完成课/主线新课、错误修复、短对话”选择，缺少到期项或错误项时不硬凑。AI 不能随机决定能力主线，只能生成通过校验的变式。具体优先级见 [学习引擎规格](LEARNING-ENGINE-SPEC.md)。 +每日任务按预算从“到期复习、未完成课/主线新课、错误修复、短对话”选择，缺少到期项或错误项时不硬凑。AI 不能在运行时决定能力主线，只能生成通过校验的变式；主线来自主题地图和离线生成、冻结的单元内容包。具体优先级见 [学习引擎规格](LEARNING-ENGINE-SPEC.md)。 每个包含新语言的教学段在听力前先提供 1–3 分钟“今天先认识”的词汇预热：只展示本段会用到的 3–6 个词或词块（不超过该段预算），逐项播放英文、显示当前句义中文与一个短例句，再完成一次轻量匹配/听辨。用户可跳过或回看；预热不是掌握测试，不能因看过词卡就增加掌握度或自动完成课程。 @@ -166,30 +167,9 @@ M1 范围、内容数据和异常验收以 [开发与验收约定](M1-IMPLEMENTA | 9 | 我喜欢… | 表达一项喜好 | | 10 | A0 小对话 | 完成 45 秒自我介绍 | -### A1：生存英语（11–30） +### A1 起：主题单元 -| 编号 | 主题 | 课后能做什么 | -|---:|---|---| -| 11 | 在咖啡店点单 | 点饮料并表达礼貌需求 | -| 12 | 在餐厅点餐 | 点餐、询问推荐 | -| 13 | 结账与价格 | 询价、付款、确认金额 | -| 14 | 买衣服 | 询问尺码、颜色、试穿 | -| 15 | 超市购物 | 找商品、说数量 | -| 16 | 问路 | 询问地点与方向 | -| 17 | 打车 | 告知目的地并确认路线 | -| 18 | 公交与地铁 | 买票、问站点、确认下车 | -| 19 | 入住酒店 | 办理入住、说明预订信息 | -| 20 | 酒店里的问题 | 要毛巾、报告房间问题 | -| 21 | 在机场 | 办理值机、问登机口 | -| 22 | 看病不舒服 | 说明简单症状、听懂基本建议 | -| 23 | 预约时间 | 约见面、改时间 | -| 24 | 打电话留言 | 留下姓名、号码和简短信息 | -| 25 | 认识新朋友 | 询问职业、兴趣和居住地 | -| 26 | 介绍日常生活 | 说作息和常做的事 | -| 27 | 今天的天气 | 谈天气与穿衣建议 | -| 28 | 周末计划 | 说将要做的事 | -| 29 | 请求帮助 | 礼貌求助、感谢与回应 | -| 30 | A1 生活挑战 | 完成 3 分钟多场景模拟 | +A1（19 个单元）、A2（15 个）和 B1（14 个）的主题单元统一以 [学习引擎规格](LEARNING-ENGINE-SPEC.md) 5.2 主题地图为准，本文不再重复列出。单元围绕日常生活与旅行，按依赖顺序推荐，单元之间不设门槛。 ## 7. 功能需求与验收标准 @@ -304,7 +284,7 @@ AI 对话区分以下模式，不能将受控场景误做成无限聊天： ## 9. 数据与进度 -为每位用户记录：当前等级、目标、课程完成状态、词汇/句型掌握度、听力正确率、常见写作错误、口语尝试次数和复习到期时间。进度页避免只显示“学了多少词”，应显示可完成的任务，例如“你已能用英语点餐”。 +为每位用户记录：当前等级、课程完成状态、词汇/句型掌握度、听力正确率、常见写作错误、口语尝试次数和复习到期时间。进度页避免只显示“学了多少词”，应显示可完成的任务，例如“你已能用英语点餐”。 ## 10. 个人使用验收清单 @@ -323,11 +303,15 @@ AI 对话区分以下模式，不能将受控场景误做成无限聊天： ### M2：完整个人学习路径 -在 M1 闭环基础上新增 A1 能力地图、核心清单、种子主题及出口评估，扩展生活场景与自由主题对话；可增加加密导出/导入。M1 已有的复习、纠错、场景页和进度不重复列为 M2 首次交付。 +在 M1 闭环基础上新增 A1 单元内容包（19 个单元，见学习引擎 5.2）、单元预检、两层词汇及出口评估，扩展生活场景与自由主题对话；可增加加密导出/导入。M1 已有的复习、纠错、场景页和进度不重复列为 M2 首次交付。 ### M3：个性化与 A2 -加入更细的能力诊断、学习计划调整、旅行/工作目标路径，以及 A2 课程。在你完成 A1 路径并确认现有内容和反馈确实满足个人学习需要后再启动。 +加入更细的能力诊断、学习计划调整、入门定级跳级，以及 A2 单元与听读输入。在你完成 A1 路径并确认现有内容和反馈确实满足个人学习需要后再启动。 + +### 之后：B1 + +A2 通过后启动 B1 单元（见学习引擎 5.2）。B1 是主线终点，B2 为可选扩展，B1 通过后再规划。工作需求作为后续主题线增加，不改变日常与旅行主线。 ## 12. 版权与内容来源 diff --git a/Doc/PROTOTYPE-DESIGN-SPEC.md b/Doc/PROTOTYPE-DESIGN-SPEC.md index 20197f7..bf57a48 100644 --- a/Doc/PROTOTYPE-DESIGN-SPEC.md +++ b/Doc/PROTOTYPE-DESIGN-SPEC.md @@ -10,7 +10,7 @@ | 编号 | 页面 / 状态 | 主要目的 | 关键动作 | |---:|---|---|---| -| 01 | 目标设置 | 设置学习目的和每日时长 | 进入起点定位 | +| 01 | 每日时长 | 设置每日学习时长（目标固定为日常与旅行） | 进入起点定位 | | 02 | 起点定位 | 选择或轻量确认起始等级 | 开始学习 / 跳过 | | 03 | 首页 | 呈现唯一的今日主任务 | 开始课程或短对话 | | 04 | 学习地图 | 查看当前阶段与课程顺序 | 进入课程 | @@ -38,7 +38,7 @@ ## 关键流转 ```text -首次：目标设置 → 起点定位 → 首页 +首次：每日时长 → 起点定位 → 首页 学习：首页 → 到期复习（有则按预算） → 预热 → 带帮助的听说读写 → AI 对话 → 独立尝试 → 总结 识别不确定：AI 对话 → 转写确认 → AI 对话 / 总结 查词：课程 / 阅读 / AI 对话 → 查词卡 → 返回原步骤 diff --git a/Doc/learning-app-prototype.html b/Doc/learning-app-prototype.html index 13ea20f..1a039d9 100644 --- a/Doc/learning-app-prototype.html +++ b/Doc/learning-app-prototype.html @@ -123,7 +123,7 @@
开口英语

M1 · 手机优先原型

- + @@ -150,8 +150,7 @@
欢迎

每天 20 分钟，
说出能用的英语。

从真实生活场景开始，先做到听得懂、说得清。

-
你的主要目标
日常生活旅行工作起步
-
每天学习多久？
10 分钟20 分钟30 分钟
+
每天学习多久？
10 分钟20 分钟30 分钟
@@ -270,7 +269,7 @@