# C-13-partial-error · 拍照听写 · 部分照片识别失败

产品：英语默写AI版 · 交付 0.12.3 · 日期 2026-10-13 · 模块：听写-拍照听写

功能规格：[C-13-partial-error.function.json](C-13-partial-error.function.json)
原型设计：[C-13-partial-error.prototype.html](C-13-partial-error.prototype.html)

## 职责与进入条件

逐张标出失败图片，成功结果保留；可单独重试、重拍或删除失败照片后继续。

from：C听写首页；本来源词表、共用设置或同页支线状态；preconditions：已登录；不要求先选课本；图片／词条为本地示例，演示状态不是生产识别结果；rule_status：confirmed

## 界面元素

- id：C-13-partial-error.ui.0；label：已拍数量／逐张状态；description：已拍数量／逐张状态；rule_status：proposed

- id：C-13-partial-error.ui.1；label：照片缩略图或列表；description：照片缩略图或列表；rule_status：proposed

- id：C-13-partial-error.ui.2；label：单张查看、删除、重拍；description：单张查看、删除、重拍；rule_status：proposed

- id：C-13-partial-error.ui.3；label：批次识别及返回保留；description：批次识别及返回保留；rule_status：proposed

## 数据与来源

- name：相机／系统相册、OCR、词库、音源、TTS、共用听写服务；data：图片与识别请求ID；英文原文及修订记录；稳定词条ID、词义ID；标准音／合成音状态；服务失败与重试；contract_status：pending

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

- id：entryDraft；type：object；description：entry来源隔离photo/search/textbook；items及selected稳定ID；输入、照片模式、页码、receipt；不与教材选词混写；rule_status：proposed

- id：word；type：object；description：id/en/cn/ipa/pageNo/pageRefs/audioStatus:standard/unconfirmed/confirmed/error；修订拼写需重置旧audio确认；rule_status：proposed

- id：imageRequest；type：object；description：requestId、图片引用、方向、有效识别区域、action:replace/append；取消／离开后丢弃迟到结果；rule_status：proposed

- id：photoBatch；type：object；description：batchId、action:replace/append、orderedPhotos[{photoId,imageRef,turns,quality,status,payload,requestVersion}]；按照片及词条顺序合并，结果保留稳定photoIds引用；取消旧请求不覆盖后来重拍；rule_status：proposed

## 页面状态

- id：partial-error；description：拍照听写 · 部分照片识别失败；rule_status：proposed

## 可切换演示状态

- id：partial-error；label：拍照听写 · 部分照片识别失败；scope：prototype_only

## 交互 RETRY-ONE：重试这张

- 触发：重试这张

- 条件：该图片失败

- 反馈：只重试这一张，成功图片不重跑，词表在全部处理完成前不被替换

- 跳转目标：C-13-recognizing

- 携带数据：批次ID、photoId、图像引用、方向、来源页、识别版本及结果

- 规则确认程度：proposed

- 来源：用户拍多张需求的详细设计补全

- 预览能力：本地示例可操作；相机、相册和OCR均未接入

## 交互 RETAKE-ONE：重拍

- 触发：重拍

- 条件：失败照片存在

- 反馈：只替换这张照片，其他成功图片结果保持

- 跳转目标：C-13

- 携带数据：批次ID、photoId、图像引用、方向、来源页、识别版本及结果

- 规则确认程度：proposed

- 来源：用户拍多张需求的详细设计补全

- 预览能力：本地示例可操作；相机、相册和OCR均未接入

## 交互 HANDLE：处理照片

- 触发：处理照片

- 条件：有失败项

- 反馈：回照片列表处理，不能静默丢弃失败页

- 跳转目标：C-13-photos

- 携带数据：批次ID、photoId、图像引用、方向、来源页、识别版本及结果

- 规则确认程度：proposed

- 来源：用户拍多张需求的详细设计补全

- 预览能力：本地示例可操作；相机、相册和OCR均未接入

## 返回与保留

destination：实际来源页；preserve：未确认输入；本来源词条及选择；词条改动、读音状态、排序；重拍／补拍模式、旧词表、页码；共用播报偏好、滚动位置；rule_status：proposed

## 验收

- given：该图片失败；when：重试这张；then：只重试这一张，成功图片不重跑，词表在全部处理完成前不被替换；目标 C-13-recognizing；rule_status：proposed

- given：失败照片存在；when：重拍；then：只替换这张照片，其他成功图片结果保持；目标 C-13；rule_status：proposed

- given：有失败项；when：处理照片；then：回照片列表处理，不能静默丢弃失败页；目标 C-13-photos；rule_status：proposed

## 原材料待确认

- 正式OCR在反光、弯页和手写体下的准确性需服务验收；原型不承诺识别率

- 图片留存、用户删除与请求日志保留到23设置及服务契约确认；不在草稿永久保存原图

- 词数／补拍页数限制依据性能、计费及音频时长评估；本轮不虚设任意上限

## 补充未定义事项

- 拍单词表OCR的权益和次数在17会员模块确认，不混同纸笔答案批改的会员门槛

- 合成读音不可用时禁选该词，保留词条让用户重试；音源供应商与英文口音待正式音频配置

## 实现边界

- 屏幕内产品UI不显示页编号、实现字段或Mock开关

- 图片采集与答题纸拍照不可混淆；前者准备题目，后者批改答案

- 实际音频播放完成才可确认，不以按钮点击替代试听成功

- photo/search分别保留草稿；C-3开始时快照所选词、音源及固定题序

- 相同词合并以已匹配词条及词义身份为准；仅拼写相同但词义不同不自动合并；保留用户修订

- 不重画C-3～C-12下游，保留实际来源返回和复听上下文

- 拍完不立即识别；拍摄／相册返回同一批次，点击完成进入照片列表

- 每张照片有稳定photoId、方向、清晰度、请求版本和结果；只对重拍／旋转的照片重新识别

- 部分照片失败保留其余成功结果，显示失败页并允许单张重试、重拍或删除；全部保留照片成功后才汇总词表

- 删除最后一张后显示空状态，识别禁用，不能自动塞回示例照片

- 同一批次相同词去重；补拍与已有词表也去重，保留原手工修订、选择和来源照片引用

## 原型限制

- 相机和相册使用示例单词表，旋转仅演示方向；不请求实际摄像头或读用户照片

- OCR、词典、标准音、合成音均为本地样例；固定匹配结果不构成API契约

- 共用后续听写同v0.9模拟定时和识别；服务器保存及跨设备恢复尚未实现

## 能力与接入限制



## 预览宿主与产品 UI

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