# 实现指南

英语默写AI版 · 交付 0.12.3 · 2026-10-13 · 新增我的15～23及错题本24，累计232页／状态；24／26功能模块已设计，25AI错题复习、26二维码与小程序暂缓

## 权威与边界

HTML 决定屏幕内视觉，confirmed 规格决定已定义行为。proposed 为设计建议与演示策略，pending 待产品决策；本地 Mock 与示例字段不构成 API 契约。手机外壳、项目导航、状态选择器及说明栏是预览宿主，业务组件不应照搬。

## 建议组件

PrintFlowShell、UnitSelection、WordSelection、LayoutConfig、PaperPreview、ExportSheet、QuotaSummary；以及AuthShell、AgreementControl、PrimaryButton、PhoneInput（11位原始值/3-4-4展示）、VerificationCodeInput、FeedbackRegion、BookFilters、BookCard、CoverPreview、HomePrintCard、HomeTopicCard、BottomTabs。组件可共享外观但各页条件以规格为准。

## 跨页状态

原型通过来源参数及 sessionStorage 保留输入和教材筛选；真实产品是否保留验证码、协议与候选课本需确认。B/C/D 共用课本档案为已定义规则。A-4 关闭保持 A-3 原选择为已定义规则。

## 真实接入点

运营商认证、短信发送与校验、用户档案、课本目录与封面、协议正文、首页错题统计、专题下载统计和教研音源。服务契约、频控、失效与锁定策略尚未提供。真实认证成功后统一进入 B。新老账号及课本状态仅影响首页内容和引导，不能将演示开关当服务结果。

## Mock 范围

协议开关、号码格式示例、60 秒发码演示及五张A-2状态展示、四位自动提交演示、请求／失败状态、样例课本筛选和封面查看。未接真实认证、短信、网络或服务端档案。发码演示无真实资金、短信和认证副作用。

## 对接与未决问题

B/C/D/E 四个首页、A～A-4 及 A-2 的五个状态展示在本包内互通。B-2～B-5及新增打印状态在本包内互通；其余二级和协议目标进入 boundary.html。当前规则是登录后统一到 B，再通过可关闭首页引导卡选课本；首次教材使用拦截及发码前协议门槛继续保留。源 UE 不合理或新业务建议见 DECISIONS.md，需用户确认后实施。当前首次使用教材选书后返回来源首页；自动恢复原打印动作尚未确认。

## 验收

按每页 given/when/then 验收；重点验证未勾协议不能发码/重发或演示登录、跳过后进入 B且不自动赋课本、首次教材使用触发选书、四位输入不会绕过登录前置条件、错误不会进入成功目标、来源返回和选书状态保留、原型与规格确认程度一致。设计工具只证明 Mock，不证明生产服务。

## 教材打印接入

- 本轮预览只提供练习卷；挑词页顺序在词表上方，按钮文案为选择样式。
- 原型演示整单元选择、词条、去重、词序、11个版式、自由配置、纸张分页、内容/格式和扣次数。纸张与分页为本地示意，正式产品预览必须和真实输出一致。
- 确认规则：纸卷二维码扫码进入小程序，26模块暂留空；三格式保留；PDF/Word双卷合一文件，图片逐页独立文件；每个成功生成文件计一次，再导出重新计次，失败文件不计，分享取消不撤销已成功文件计次。
- 范围选择已确认只按整单元勾选，所选单元全部词条带入挑词页再删选；摘要显示单元数与词数。首次默认及复用上次范围尚未定案。
- 挑词筛选已确认以练习卷成功导出词条为准，答案卷单独导出不更新；真实记录按成功文件对应的练习卷页面更新。补词共用03自建的手输/粘贴，词库纠错共用22帮助反馈。
- 真实适配器：目录/词库与音源、纸张预览与文件生成、逐文件计次与额度同步、系统分享/预览、纸卷二维码与小程序链接（26模块后续设计）。原型没有这些真实服务。
- 本批B-3仅教材挑词，专题直接B-4，B-4支持教材、专题、自建与自建历史；补词F已接入，词库纠错仍在22模块补全。二维码与小程序独立列为26模块，本轮留空；不得按旧扫码稿实施听原声或批改页面。
- 六种输入/导出状态展示都是父页的预览实例，不能把状态展示ID当成新的业务路由。

## 专题与自建接入

专题分组更多接固定B-1，专题卡和首页快捷卡直接B-4，完整内容已配好；自建F输入区确认收词，底部核对直接F-1补义、选择，B-4按实际入口返回。每个来源按上下文隔离草稿，额度演示共用计数；生产额度来源与会员权益到17模块确认。身体图为内嵌原创SVG示意，须教研逐词审核；字母为52个大小写四线三格。录入页命名保存区已删除，自建挑词页可保存，历史不限30天；历史保存词表与最近配置作为实现建议。补词回填保留原选择，新词加入并选中；词库纠错仍为22对接边界。词典示例匹配不代表正式多义候选服务，所选缺义先补全或取消选择，硬出规则待确认。专题目录14项具名示例，正式46专题内容未提供，目录需由教研补齐。

## v0.7.1当前流程覆盖旧稿

专题按首页分组固定展示，不提供分组滑块／搜索／挑词／挑字母，整份内容直接B-4。返回列表的group必须保留，首页快捷卡返回B。自建录入页删除名称输入＋保存栏，输入区确认同页加入已录入，底部核对直接F-1选择／补义，F-1保存与F-2历史保留。两页合并与自动去重尚未批准。该段及最新confirmed事实覆盖前版的专题挑词路线。

## v0.7.3当前自建入口

F输入区确认只做同页收词并清空输入，已录入区更新；底部核对直接F-1，只带已录入词，输入框未确认内容保留但不自动确认。核对弹窗及独立核对页已撤出当前包，旧F-review不能作为生产路由。F-1承担补义／删选／顺序，再进入样式。此段覆盖前版所有自建核对弹窗规则。

## v0.8.0 听写接入

本批04单词听写＋05重点句听写，共40张新增页面／状态。首页C两个入口分别走C-1和C-19。种类与课本隔离草稿；三种作答只在报告揭晓结果；实际会话固定题序；静态画布不启动倒计时或纸笔定时推进。手机手写为真实可画笔迹＋固定示例识别返回后直接提交，不是已接入识别。纸笔图为答案示例，不请求摄像头。标准音、OCR、会员及服务端记录待接入；提出的业务变更按确认记录执行，未决项不能成为生产默认。

## v0.9.0当前听写流程（覆盖前版手动推进和重点句独立页面）

G与H共用C-3～C-12一套流程；H只有C-19专题列表及空／失败状态。所有作答浅色。三张图示卡对比手机键盘、手机手写、纸上写后拍照。慢速15秒、正常8秒、快速5秒，从音频真实结束后开始等待，期限到自动记录并推进；手机识别失败暂停重写。原型用1.2秒模拟音频和700毫秒模拟识别，不能作为真实音源／识别实现。暂停及转屏保留阶段和剩余时间，重听当前题重新等待，后台暂停。报告和分享各一套共用页，保持原先两个用途。旧C-20／C-21路径仅作别名，不生成重复产品页。


## v0.10 拍照与搜词听写

拍照C-13→照片核对→识别→C-14词表；搜词C-15确认加入已录入→选词听写进入C-2搜词来源。均可在无课本时使用，分别保存来源草稿，接共用C-3～C-12，不复制三种作答、报告和分享。重拍成功才替换，补拍自动合并同词，保留用户修订和选择；同拼写不同词义不自动合并。标准读音优先，未匹配先核对拼写，再试听确认合成音；不能播放的词不能选入。搜词只接纯英文单词／短语与批量粘贴，支持原UE排序。搜词独立保存草稿，完成后进入听写记录，不自动写入F-2自建历史（用户已确认）。

页面清单包含当前累计156张页面／状态。相机、OCR、词库、标准音、TTS与云保存均未接入；播放成功、识别率和服务限额需真实客户端／服务验证。本地模拟不构成API契约。


## v0.11 练习08～14当前规则

本批7模块已确认：六种闯关整单元后挑词，不自动删长词或截数量；课文跟读选课文再挑单词／短语／句子，复用读单词流程。点击录音、停顿结束，可手动结束；有效反馈5秒自动推进，重读或回放暂停。朗读取最高有效分、低于80需再读；无声与录音／评测失败不算0。

五种客观题不限时、即时反馈、末尾再练一次，首答与再练分别统计；两步点选中英连线，每组最多4对，尾组不凑词。字母填空用候选字母池点选／拖入，提示完成单列。首答错误与跳过收录客观练习错题并保留题型来源，朗读低分独立。

朗读录音随练习记录保存、可删除，删除音频不删除成绩；分享只成绩不公开录音。记录期限和会员次数到后续模块确认，完整记录、成长、错题和AI复习仍为后续接口边界。标准音／麦克风／录音／评测／云保存均未接入；本地示例评分不是实际评测，示意波形不代表音量或音素结论。

D-1/D-2为六题型共用准备；D-16/D-17为课文跟读来源选择；D-3～D-8两种朗读来源共用；D-13/D-14五种客观题共用。首答、提示、跳过、未触达和再练分开，不将重复作答改写首答；取消／旧请求不覆盖当前会话，后台暂停。字母候选tile按ID区分重复字母；填入可退回，短语空格不挖空。连线只展示整组用时，不能伪造逐词最快。

已设计14／26功能模块，剩余12个（11个未开始＋26二维码暂缓）；累计146张页面／状态。当前七模块联合review后进入我的15～23，再处理交叉24／25。此前整篇跟读提案、原UE反馈两秒与只听写错题、字母键盘提案均由本轮用户规则覆盖。


## v0.11.1课文跟读补充

课文跟读复用D-3～D-8的朗读提示、标准音、跟读录音、评测、报告与分享。为审阅补齐10张mode=text上下文展示，覆盖课文句子的待录／录音中、评测中／反馈／失败及报告。展示ID不是额外业务路由，真实实现只保留共用组件，草稿来源与课文内容类型保持。当前156张页面／状态，功能模块仍14／26。

全部已有报告按三类共用：听写C-11/C-12（四来源三方式）；朗读与课文跟读D-7/D-8；五种客观题D-13/D-14。共用视觉骨架，评分数据模型按类别独立。详情见[报告共用关系](REPORTS.md)。记录列表以后复用对应历史快照，不重算。


## v0.11.2模块命名统一

D及之后的交付模块名称统一为Tab名称-功能模块名称：默写单、听写、练习、我的。认证及登录、课本设置、首页Tab保持原名。画布导航、模块标题、AI索引、manifest、逐页交互／功能规格及独立原型同步使用同一名称映射。页面ID、业务路由和原型产品文案不以交付模块前缀替代。二维码与小程序标为默写单来源；未来AI错题复习计划标出默写单／我的两个入口。当前156张页面／状态，设计模块数量保持14／26。


## v0.12.0 当前有效规则（覆盖历史说明中冲突口径）

- 积累单词统计成功导出的练习卷、已提交听写／客观练习、有效朗读涉及的词库单词，跨课本去重；答案卷不计，短语句子不拆词；表示接触，不表示掌握。
- 同一稳定错题首次改对计一次；同轮末尾再练答对也计入；首答正确率保持原成绩。反复错后再对不重复累计。
- 三类记录与错题长期保留，不按会员截断，支持主动删除；自建词表历史独立保留。
- 年卡68元、终身98元；手动续费，无自动续费。价格由正式商品配置校验。
- 中国区iOS使用系统内购，国内安卓使用微信或支付宝；恢复权益、延迟到账与取消／失败都有独立状态。
- 每账号免费累计3个成功导出文件、累计5轮听写／读单词／课文跟读批改评测，共用总额度，不按天恢复。失败不扣，同轮重试重读不重复扣。
- 客观练习不限次；免费开放6个专题、答案卷带水印；会员不限次数，手写／纸笔批改需会员。到期不重置已用免费总额度。
- 错题本仅做管理、来源／类型筛选、详情、移除及按原来源再练。听写与五种客观题收录，朗读低分独立。AI排期留25。
- 新用户经邀请完成注册即奖励邀请人7天会员，每月最多3次；年卡／赠送时长顺延，终身只记邀请不叠加时长；老用户重复邀请不奖励。
- 验证身份并二次确认后立即注销；退出登录保留账号资产；退款按真实渠道与正式条款处理。
- 先做帮助文章与邮箱联系版式；客服邮箱尚未确定；不编造可用邮箱。
- 打印记录统一更名为默写单记录，页面ID B-6与已确认记录／扣次规则保留。
- 听写历史及记录详情不按手机打字／手机手写／纸笔手写区分，不展示方式筛选或方式标签。历史共用报告也不显示方式名称；原始方式仅内部保留用于再次听写配置。
- 宝贝资料恢复头像，仅提供8个默认头像：小男孩、小女孩、小熊、小兔、小猫、小狗、熊猫、小考拉。不提供上传；确认选择后再保存资料，头像与昵称同步我的首页及邀请卡。

客服邮箱及正式协议／隐私／购买条款尚未提供；原型保留版式，不捏造正式正文。云服务、支付、邮箱、真实注销均未接入。
