# D-7-text · 课文跟读 · 共用报告

产品：英语默写AI版 · 交付 0.12.3 · 日期 2026-10-13 · 模块：练习-课文跟读

功能规格：[D-7-text.function.json](D-7-text.function.json)
原型设计：[D-7-text.prototype.html](D-7-text.prototype.html)

## 职责与进入条件

课文跟读来源下的共用报告展示；支持课文中的单词、短语和句子。与读单词使用同一业务页面及逻辑。

preconditions：已登录、已有当前课本；无课本入口先共用选书；演示数据与API契约分开；本ID是课文上下文展示，真实路由仍为D-7，mode=text；不新增重复业务流程。；rule_status：confirmed；from：课文跟读D-17及共用上下游；本分区独立上下文预览

## 界面元素

- id：D-7.ui.0；label：有效平均分；type：control；rule_status：proposed

- id：D-7.ui.1；label：已读／未读；type：control；rule_status：proposed

- id：D-7.ui.2；label：低于80分；type：control；rule_status：proposed

- id：D-7.ui.3；label：逐词／短语／句子成绩与录音；type：control；rule_status：proposed

- id：D-7.ui.4；label：删除录音；type：control；rule_status：proposed

- id：D-7.ui.5；label：再读／分享；type：control；rule_status：proposed

- id：D-7-text.content-context；type：label；label：课文来源与内容类型；description：mode=text显示当前课文及每项单词／短语／句子标记；mode=read保持单词来源；rule_status：proposed

## 数据与来源

- name：教材词条、义项、标准音、课文内容；contract_status：pending

- name：录音／语音评测／练习记录／错题服务；contract_status：pending

## 字段建议（尚非服务契约）

- id：draft；type：object；description：按课本和玩法来源隔离范围与选择；rule_status：proposed

- id：session；type：object；description：id/mode/items/phase/index/firstAnswers/retryAnswers/completed/cancelled；固定题序；rule_status：proposed

- id：attempt；type：object；description：itemId/answer/firstStatus/correct/hint/skipped/activeDuration/audioRef/requestId；rule_status：proposed

- id：readingItem；type：object；description：type:word/phrase/sentence、历次有效评分、最高分、其对应音频；删录音不删分；rule_status：proposed

- id：report；type：object；description：首次correct/wrong/hint/skipped/unattempted；再练；reading有效平均分与未读；saveStatus；rule_status：proposed

- id：wrongCandidates；type：array；description：五种客观题首答错误／跳过的待收录事件，sessionId+itemId+mode+book+source；未触达、提示项和朗读低分不擅自收录；rule_status：proposed

## 页面状态

- id：ready；description：本页ready状态；rule_status：proposed

- id：partial；description：未读项单列；均分仅对有效最高分计算，不把无效录音补0。；rule_status：proposed

- id：deleted；description：已删除音频不能回放，原有效评分不删除。；rule_status：proposed

- id：save-error；description：本机结果保留，幂等重试；未保存成功不宣称云端已有记录。；rule_status：proposed

## 可切换演示状态

- id：ready；label：默认主流程；scope：prototype_only

- id：partial；label：部分未读；scope：prototype_only

- id：deleted；label：录音已删除；scope：prototype_only

- id：save-error；label：记录保存失败；scope：prototype_only

## 交互 D-7-I-1：只读需要再读的

- 触发：只读需要再读的

- 条件：存在需再读项

- 反馈：选入低于80及未读项目，回实际挑选页

- 跳转目标：D-17／D-2

- 携带数据：mode与来源；课本／课文ID；选择的稳定内容ID及固定题序；sessionId、阶段、首答与再练结果；当前题／分组及剩余时间；mode=text；课文与内容类型；原始D-17选择及返回页

- 规则确认程度：confirmed

- 来源：原UE D-1～D-14及用户本轮确认；未确认补全标proposed

- 预览能力：本地样例可操作；标准音、录音、评测、词库、错题及云记录未接入

## 交互 D-7-I-2：删除录音

- 触发：删除录音

- 条件：录音存在

- 反馈：确认后删除指定音频引用；保留成绩；失败保留原引用并提示

- 跳转目标：本页

- 携带数据：mode与来源；课本／课文ID；选择的稳定内容ID及固定题序；sessionId、阶段、首答与再练结果；当前题／分组及剩余时间；mode=text；课文与内容类型；原始D-17选择及返回页

- 规则确认程度：confirmed

- 来源：原UE D-1～D-14及用户本轮确认；未确认补全标proposed

- 预览能力：本地样例可操作；标准音、录音、评测、词库、错题及云记录未接入

## 交互 D-7-I-3：回放录音

- 触发：回放录音

- 条件：当前操作可用

- 反馈：有录音才播放，已删明确提示不可回放

- 跳转目标：本页

- 携带数据：mode与来源；课本／课文ID；选择的稳定内容ID及固定题序；sessionId、阶段、首答与再练结果；当前题／分组及剩余时间；mode=text；课文与内容类型；原始D-17选择及返回页

- 规则确认程度：proposed

- 来源：原UE D-1～D-14及用户本轮确认；未确认补全标proposed

- 预览能力：本地样例可操作；标准音、录音、评测、词库、错题及云记录未接入

## 交互 D-7-I-4：分享

- 触发：分享

- 条件：当前操作可用

- 反馈：成绩快照共用朗读分享，不附录音

- 跳转目标：D-8

- 携带数据：mode与来源；课本／课文ID；选择的稳定内容ID及固定题序；sessionId、阶段、首答与再练结果；当前题／分组及剩余时间；mode=text；课文与内容类型；原始D-17选择及返回页

- 规则确认程度：confirmed

- 来源：原UE D-1～D-14及用户本轮确认；未确认补全标proposed

- 预览能力：本地样例可操作；标准音、录音、评测、词库、错题及云记录未接入

## 交互 D-7-I-5：完成

- 触发：完成

- 条件：当前操作可用

- 反馈：回练习首页

- 跳转目标：D

- 携带数据：mode与来源；课本／课文ID；选择的稳定内容ID及固定题序；sessionId、阶段、首答与再练结果；当前题／分组及剩余时间；mode=text；课文与内容类型；原始D-17选择及返回页

- 规则确认程度：proposed

- 来源：原UE D-1～D-14及用户本轮确认；未确认补全标proposed

- 预览能力：本地样例可操作；标准音、录音、评测、词库、错题及云记录未接入

## 返回与保留

destination：课文来源D-17／上一共用阶段，报告完成回D；preserve：选择与筛选；题序及当前项；首答与再练结果；最高有效分和音频引用；反馈剩余时间；rule_status：proposed

## 验收

- given：存在需再读项；when：只读需要再读的；then：选入低于80及未读项目，回实际挑选页；rule_status：confirmed

- given：录音存在；when：删除录音；then：确认后删除指定音频引用；保留成绩；失败保留原引用并提示；rule_status：confirmed

- given：当前操作可用；when：回放录音；then：有录音才播放，已删明确提示不可回放；rule_status：proposed

- given：当前操作可用；when：分享；then：成绩快照共用朗读分享，不附录音；rule_status：confirmed

- given：当前操作可用；when：完成；then：回练习首页；rule_status：proposed

- given：首答错误、末尾再练正确；或本次朗读有无效项；when：查看报告；then：首次结果不被再练覆盖；均分仅含最高有效评分，失败和无声不补0；分享不包含孩子录音；rule_status：confirmed

## 原材料待确认

## 补充未定义事项

- 正式教材／课文／标准音与语音评测服务契约；只有服务提供的维度和定位可展示，不编造音素级结论。

## 实现边界

- 题型标签沿练习首页UI；屏幕内不显示模块编号／演示开关。

- D-1/D-2由六题型复用；D-3～D-8由课文内容跟读与读单词复用；D-13/D-14由五种客观题复用。

- 五种客观练习错题写入来源标记，朗读低分不写知识错题；错题与AI复习策略仍在24/25。

- 上下文预览ID仅用于交付展示；App实现用D-7的同一个组件，不能复制一套评测、报告或数据。

## 原型限制

- 标准音、录音与评测用本地状态演示，不采集真实麦克风、不发送录音；演示分数和波形不是测量结果。

- 教材词库／课文／分句为具名示例，不能视为正式教研目录。

- 报告与录音删除为本地示例；生产云保存、跨设备同步及删除失败需真实服务验证。

- 分享用宿主提示演示，未接微信／系统相册；不公开录音。

- 画布静态预览不启动倒计时，也不写练习或错题记录。

- 标准音用1.3秒模拟播放、录音用4秒计时自动结束、评测用900毫秒模拟；这些定时不是实际音频结束、静音检测或服务时延。

- 展示草稿使用text-showcase来源隔离；不覆盖正常课文跟读或读单词的本地选择／报告。

## 能力与接入限制



## 预览宿主与产品 UI

手机外壳、项目导航、演示状态选择器、页面说明、页面编号与前后页导航属于预览宿主。产品实现包含屏幕内的业务 UI，状态栏与手势条由目标系统承载。原型仅操作本地示例状态，不发送真实短信，不执行真实认证；首页统计与教研目录为示例，不保存用户档案到服务端。
