4v5u09Z5a4Yuc/English
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 学习目标定为日常与旅行，重写学习路线与词汇分层规格

Browse Source 
- 取消学习目标选择，不做学校场景，工作场景延后
- 词汇分两层：核心表达与分级词池，写明词池来源与校验方式
- 补充复习节点、掌握判定与阶段评估的规则说明

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
shenlei
2026-09-17 18:52:01 +09:00
co-authored by Claude Opus 5
parent 9d30cd681e
commit efdff769e4
7 changed files with 346 additions and 94 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Doc/AI-CONVERSATION-PRD.md
+43 -9
View File
@@ -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. 数据与隐私