# 06 实施路线图与资源准备清单 > 所属:`tasks/0913-EnglishStudyAnalysis/`(阶段 1 文档) > 版本:v1.0(2026-09-17) > 上游:`01`-`05` > 用途:主 agent 立项三条 product-pipeline 时的范围与验收依据;Hermes/火山/HTTPS 的安装清单;资料处理脚本清单;风险与用户决策汇总。 --- ## 1. 阶段总览 | 阶段 | 内容 | 产出 | 退出标准 | 依赖 | | --- | --- | --- | --- | --- | | 0 | 方案与计划(已完成) | `.cursor/plans/儿童英语学习辅导闭环方案_*.plan.md` | 用户批准 | — | | 1 | 阶段 1 文档(本目录 01-06) | 6 份文档 | **用户审阅并回答各文档「待用户确认」** | — | | 2 | 流水线 `daily-plan-engine` + Hermes 前 4 个 cron | 后端 plan/events/srs/reports/curriculum(最小)、今天页、深链改造、localStorage 迁移、家长报告页 V1;Hermes skill 与 cron 上线 | 跑通「19:30 微信收链接 → 完成 6 卡 → 20:45 收星星 → 周六家长收周报」连续 3 天;`child-ux-tester` 无 P0/P1 | 阶段 1 确认;Hermes 主机可用 | | 3 | 流水线 `speaking-coach-agent` + 写字照片打卡 | HTTPS、Speak PWA、speech 服务、反馈 TTS、speaking 事件与 SRS 联动;Hermes 图片入站 | iPad Safari 录音 → 4 秒内得分与语音反馈;三次尝试逻辑;弱音素进入复习;照片打卡记事件 | HTTPS 方案落地;火山语音开通 | | 4 | 流水线 `listening-clips-and-starters` + 基线评测模式 | 课程数据 7 个文件、clips 切片、Listen 页、Starters 录分、评测模式与报告 | 每周 5 句可播可跟读;月末流程可完整执行一次;基线报告生成 | 资料处理脚本完成 | | 5 | 真实运行 2 周并调参 | 调整 profile 阈值、文案、卡片时长;教训写入 pd-* 与 skill | 完成率 ≥ 80%;家长确认周报有用 | 阶段 2-4 上线 | 阶段 2 与阶段 4 的**课程数据最小集**有重叠:阶段 2 需要 `phonics-units.json`(至少前 4 周)、`hf-words.json`(组 A/B)、`ort-sequence.json`、`letters.json` 才能生成完整 6 卡;`clips.json`、`qa-bank.json`、`starters-words.json` 可后置(卡 2 在阶段 2 先用「整本绘本音频一段」占位,或直接隐藏卡 2/卡 4 只发 4 卡)。建议:阶段 2 立项时把「最小课程数据(W1-W4)」作为后端任务之一。 ## 2. 流水线 1:`daily-plan-engine` **目录**:`tasks/pipeline/daily-plan-engine/`;走 `.agents/skills/product-pipeline/SKILL.md` 全流程;满足 openspec 衔接条件(≥ 3 页面、前后端都动、任务 ≥ 10 条)→ 阶段 4 体验审查通过后建 openspec change。 **V1 范围(必须)** - 后端:`services/store.py`、`curriculum.py`(读取 W1-W4 最小数据)、`srs_engine.py`、`plan_engine.py`、`reports.py`(日/周)、`wechat_templates.py`、`scheduler.py`;路由 `plan`、`events`、`srs`、`reports`、`days`、`curriculum/week`;`/api/records` 兼容转发;`.env.example`。 - 前端:`/today`;书架「今天」入口卡;Learn/Quiz/SpellingGame/ChildBookReader 接受 `?plan=` 并上报事件;`bookStudy.ts` 改为缓存 + 事件 + 一次性 `srs/sync`;`/parent/report` V1(周报字段 + 跳过卡片);离线事件队列。 - Hermes:`deploy/hermes/skills/easy-study-coach/`(SKILL.md + 6 个脚本)、`deploy/hermes/cron.md`、`deploy/hermes/README.md`(安装步骤 §5)。 - 数据:`docs/data/curriculum/{phonics-units(W1-W4), hf-words(A/B), ort-sequence, letters}.json`;`docs/data/learning/` gitignore + 备份脚本。 **V1 不做**:口语评分(卡 4 显示「即将开放」或不生成)、听一听切片(卡 2 用绘本整本音频段占位或不生成)、Starters 录分、评测模式、视频。 **验收口径(供 pd-acceptance-reviewer)** 1. `GET /api/plan/today` 在无计划时 300 ms 内生成且再次调用返回同一份;周日 / day_off 返回 `dayType` 且无任务卡。 2. 完成 Learn 三连关后 `events` 有 `phonics` 记录且卡 1 状态 `done`,今天页翻绿。 3. 闯关中 `responseMs < 1500` 且错的题不改变 `wrongCount`,并触发「慢一点」提示(连续 2 次)。 4. `srs/sync` 把现有 localStorage 状态导入后,书架三条引导内容与 `/api/plan/today` 一致;重复调用不重复导入。 5. `wechat-text?kind=nudge` 全部完成时返回空体;Hermes `es-nudge` 静默。 6. 家长页周报显示 03 §6 字段;`skip` 后今天页对应卡消失且事件有 `card_skip`。 7. `child-ux-tester` 报告无 P0/P1(今天页、卡片文案、返回路径)。 ## 3. 流水线 2:`speaking-coach-agent` **前置(主 agent 在立项前完成,属环境不属角色工作)** 1. HTTPS 落地(05 §9 方案 A 或 B),`https://…/estudy/today` 在 iPad Safari 可开、证书受信。 2. 火山控制台开通豆包语音 ASR 2.0 与 TTS,拿到 APP ID / Access Token / Resource ID;方舟标准 API Key;写入本机后端 `.env`。 3. 本机安装 `ffmpeg`(转码),`nltk` cmudict 数据(已有 `generate_phonics.py` 依赖)。 **范围**:`services/speech/*`、`/api/speech/*`、Speak 页(PWA manifest、微信 UA 引导、录音、三次尝试、星星与反馈播放)、speaking 事件与 SRS 音素联动、卡 4 正式启用、基线模块 C/G 自动判定、Hermes 图片入站(SKILL 规则 3)。 **验收口径** 1. iPad Safari(主屏 PWA)录一个词 → 4 秒内返回 `AssessResult`,页面显示星星并自动播放反馈语音。 2. 故意读错首音(ship → sip)时 `weakGraphemes` 含 `sh`,`phoneme:ʃ` 状态回到 `learning`。 3. 不说话 / 只有噪音 → `noSignal`,不计错,提示「没听清」。 4. 微信内打开 `/speak/*` 显示引导页而不是报错。 5. LLM 超时或凭证错误时仍返回模板反馈(降级可用)。 6. 孩子 chat 发照片 → 微信收到 ≤ 3 行鼓励,`events` 出现 `writing_checkin(photo=true)`。 ## 4. 流水线 3:`listening-clips-and-starters` **范围**:资料处理脚本(§6)产出 `clips.json`、`qa-bank.json`、`starters-words.json`、`phonics-units.json`(W5-W26)、`hf-words.json`(C-F);`/listen/:clipId`;卡 2 正式启用;`/api/curriculum/*`;Starters 录分与词表覆盖率;评测模式(题源参数)与 `/api/reports/assessment`、月报;stage-05 结构化(复用 OCR 管线)。 **验收口径** 1. 本周 5 句在 Listen 页可播、可复读计数、有中文与截图;音频起止误差 ≤ 300 ms(抽查 10 句)。 2. `starters-words?coverage=1` 返回覆盖率并随事件变化。 3. 月末流程可完整走一遍:月测 20 题 → 基线复测抽样 → Starters 录分 → 月报 md/json 生成 → 家长微信月报。 4. `phonics-units.json` 26 周例词全部存在于 `phonics-data.json` 并有 `letterPhonemes`(脚本校验通过)。 ## 5. Hermes 安装与验证清单(todo `hermes-setup`) 1. 在 Hermes 主机确认版本与网关:`hermes --version`、`hermes gateway status`;若未运行 `hermes gateway start`。 2. 微信:`hermes gateway setup` → 选择 Weixin → 扫码;`.env` 写 `WEIXIN_DM_POLICY=allowlist`、`WEIXIN_ALLOWED_USERS=<孩子>,<家长>`、`WEIXIN_GROUP_POLICY=disabled`、`WEIXIN_HOME_CHANNEL=<孩子 chat_id>`。用两个账号各发一条消息,从网关日志取 chat_id。 3. 模型:`arkcli helper configure --agent hermes`(按 `arkcli-helper` skill)接方舟 Agent Plan;`hermes model` 选 `doubao-seed-2.0-mini` 作全局默认。 4. 网络:在 Hermes 主机 `curl http://192.168.11.157:8120/api/health` 通;若不通改走 `https:///estudy/api/health`。 5. Skill:`cp -r deploy/hermes/skills/easy-study-coach ~/.hermes/skills/`;`chmod +x scripts/*.sh`;`.env` 追加 05 §8.2 变量;`hermes skills list` 可见。 6. cron:按 `deploy/hermes/cron.md` 创建 6 个任务;`hermes cron run es-morning` 立即测一次,孩子微信应收到今日任务;`hermes cron run es-nudge` 在全完成状态下应**无消息**(验证空 stdout 静默)。 7. 入站:孩子号发「完成了」→ 后端 `events` 出现 `writing_checkin`;家长号发「今天休息」→ `days.json` 记 off;非 allowlist 号发消息无响应。 8. 固定模型与推理强度:`hermes cron edit es-evening --model doubao-seed-2.0-mini --reasoning-effort minimal`;`es-weekly-parent` 同。 9. `hermes cron doctor` 与 `hermes cron list` 无告警;把最终命令回填 `deploy/hermes/cron.md`。 ## 6. 资料处理脚本清单(`bookshelf/backend/tools/`,Python,遵循现有 `pipeline.py` 风格) | 脚本 | 输入 | 输出 | 复用 | 阶段 | | --- | --- | --- | --- | --- | | `build_phonics_units.py` | 人工种子 `tools/seeds/phonics-units.seed.json`(按 02 §3.3 表 + `牛津自然拼读规则表.pdf` 人工核对)、`251228-words/phonics-data.json`、stage-03/04 structured | `docs/data/curriculum/phonics-units.json`(校验例词存在与 letterPhonemes;补出处 bookId/page) | `generate_phonics.py` 的 CMU 工具函数 | 2(W1-W4)/ 4(全) | | `build_hf_words.py` | 种子六组(02 §4)、structured 句子、`clips.json`(可选) | `hf-words.json`(词、混淆集、句子模板含出处) | `tmp-plan/analyze.py` 词频逻辑 | 2(A/B)/ 4 | | `build_ort_sequence.py` | `book-index.json`、structured | `ort-sequence.json`(按 unique_word_count 排序 + 建议月份 + readable) | — | 2 | | `build_letters.py` | `E:/nginx-1.8.0/html/flashcards/letters` | `letters.json`(大小写、图片、混淆对) | — | 2 | | `import_starters_wordlist.py` | 官方 Pre A1 Starters 词表(PDF → 文本,人工校对一次) | `starters-words.json`(主题、词、词性) | — | 4 | | `extract_peppa_scripts.py` | `小猪佩奇剧本台词-colorful/PeppaPig第1季剧本台词.docx`(python-docx)或 `.txt` | `tools/out/peppa/S01Exx.lines.json`(逐句、说话人) | — | 4 | | `extract_bluey_scripts.py` | `布鲁伊1-3/08 中英双语台词PDF/S01/*.pdf`(pymupdf,有文字层则直读,否则 EasyOCR) | `tools/out/bluey/S01Exx.lines.json`(中英对照) | `ocr_utils.py` | 4 | | `align_clip_audio.py` | 剧集 mp3(`配套音频/S1音频`、布鲁伊 `配套音频MP3`)+ lines.json | 每句 `start/end`;ffmpeg 切片到 `audio/clips/{series}/S01E01/{clipId}.mp3`;场景段(句前后各 20 s) | `extract_book_audio_timeline.py`(ASR)+ `match_book_audio_timeline.py`(单调匹配) | 4 | | `select_clips.py` | 对齐结果、`phonics-units.json`、`hf-words.json` | `clips.json`(每周 5 句:长度 4-8 词、含本周规则/词、可截帧) | — | 4 | | `frame_grab.py`(可选) | 剧集 mp4 + 句起止 | 截图 `images/clips/{clipId}.jpg` | ffmpeg | 4 | | `prepare_starters_tests.py` | `真题Starters 1-4`(PDF + CD 音频) | 音频复制到 `audio/cambridge/starters/{set}/`;`starters-tests.json`(每套 Listening P1 / R&W P1 的页码与音轨) | — | 4 | | `structure_stage05.py` | stage-05 图片 | `book-ocr/stage-05`、`book-structured/stage-05` | `pipeline.py` 全套 | 4 | | `build_baseline_bank.py` | 01 §3.2 表 + 上述数据 | `docs/data/assessment/baseline-v1.json` | — | 4 | | `backup_learning.py` | `docs/data/learning/`、`audio/speech/` | NAS 共享目录 zip(保留 30 天) | — | 2 | 每个脚本:`--dry-run` 打印统计不写盘;写盘前校验 schema(`jsonschema`);产出附 `generatedAt` 与输入文件 hash。 ## 7. 风险与验证项 | # | 风险 | 影响 | 验证 / 对策 | 阶段 | | --- | --- | --- | --- | --- | | R1 | iPad Safari `getUserMedia` 需要 HTTPS | 口语卡不可用 | 先做 05 §9 方案 A,在 iPad 上用一个最小页面验证录音 | 3 前置 | | R2 | 微信内置浏览器打开 https 自签证书站点可能提示不安全 | 孩子点链接受阻 | iPad 安装并完全信任 mkcert 根证书后实测微信内打开;不行则改方案 B | 3 前置 | | R3 | iLink bot 是否能收发图片 | 写字照片打卡 | Hermes 文档标 Weixin Images ✅;安装后用孩子号发一张图实测 | 2 | | R4 | Hermes 主机到后端网络 | 提醒失败 | `health.sh` cron 告警;两条路径(直连 / 经 NAS) | 2 | | R5 | 儿童语音 ASR 准确率与「纠错效应」 | 评分偏松/偏严 | 热词候选集;通过线初期放宽;两周后按均分校准;预留第三方评测适配 | 3 / 5 | | R6 | 火山凭证/配额中断 | 口语卡失败 | 降级为录音保存 + 家长判定;家长页可回放 | 3 | | R7 | 台词与音频不同版本(剪辑差异)导致对齐失败 | 今日一句错位 | ASR 对齐时以音频识别文本为准回写台词;对齐置信度 < 0.8 的句不入 `clips.json` | 4 | | R8 | 佩奇/布鲁伊/真题版权 | 合规 | 只在局域网服务;不进仓库;不做公网部署 | 全程 | | R9 | 学习数据丢失 | 进度归零 | gitignore + 夜间 zip 备份;`srs/sync` 保留原 localStorage 不清空 | 2 | | R10 | 孩子对固定 6 卡产生倦怠 | 完成率下降 | 自适应降档;周六自选;卡内容每周换规则/集数;阶段 5 按数据调 | 5 | | R11 | 现有 `readable` 书仅 10 本,OCR 热区错误影响点词 | 读一读体验 | 非 readable 书只安排听读;周报列待校对书目;沿用校对流程逐本放开 | 2 | | R12 | Hermes 命令行参数随版本变化 | 安装文档失效 | `cron.md` 注明以 `--help` 为准,验证后回填实际命令 | 2 | ## 8. 用户决策清单(汇总 01-05「待用户确认」) | # | 问题 | 默认(未答复时采用) | 出处 | | --- | --- | --- | --- | | D1 | 基线评测何时做:阶段 2 上线后第一周(口语部分家长判)还是等阶段 3 | 阶段 2 后第一周 | 01 §5 | | D2 | Starters 基线卷用 `真题Starters 1` Test 1,其余轮换 | 是 | 01 §5 | | D3 | M4 从佩奇切到布鲁伊,还是全程佩奇、布鲁伊只作周六自选 | M4 切换,周六自选任意 | 02 §9 | | D4 | 每周 1 个拼读规则(可自动加速到 1.5) | 是 | 02 §9 | | D5 | 是否生成字母描红/四线格打印 PDF | 阶段 4 顺带生成 | 02 §9 | | D6 | 19:30 / 20:15 / 20:45 / 周六 10:00 / 20:00 时间点 | 采用 | 03 §9 | | D7 | 周日完全不提醒 vs. 一条「今天休息」 | 完全不提醒 | 03 §9 | | D8 | 周 ≥ 30 星实物奖励文案 | 不配置,仅动画奖励 | 03 §9 | | D9 | 通过线 词 70 / 句 65 | 采用,两周后校准 | 04 §14 | | D10 | `mastered` 90 天抽检 | 保留 | 04 §14 | | D11 | 迁移时「已掌握」降为 `weekly` 再考一次 | 是 | 04 §14 | | D12 | HTTPS 方案 A(mkcert)/ B(域名) | A | 05 §13 | | D13 | Hermes 主机位置(NAS docker / 本机 WSL / 其他 Linux) | 需回答,影响 `EASYSTUDY_API` | 05 §13 | | D14 | `docs/data/learning/` gitignore + 夜间备份 | 是 | 05 §13 | | D15 | 反馈语音用豆包 TTS 还是先用 edge-tts 中文音色 | 先 edge-tts(零成本),豆包 TTS 作可选 | 05 §13 | ## 9. 里程碑(相对周,从用户确认阶段 1 起) | 周 | 里程碑 | | --- | --- | | W0 | 用户确认 D1-D15;主 agent 立项 `daily-plan-engine` | | W1-W2 | 流水线 1 走完 8 阶段;Hermes 安装验证;孩子开始用今天页(4-6 卡) | | W2 | 基线评测(家长判口语部分) | | W3 | HTTPS + 火山开通;立项 `speaking-coach-agent` | | W3-W4 | 流水线 2 走完;卡 4 启用;照片打卡 | | W4-W6 | 立项并走完 `listening-clips-and-starters`;卡 2 启用;第一次月末流程 | | W6-W8 | 阶段 5 运行调参;教训沉淀到 `.cursor/agents/pd-*.md` 与 `easy-study-coach/SKILL.md` | ## 10. 与仓库既有约定的衔接 - 三条流水线都动孩子端 → 每条在宣称完成前跑 `child-ux-tester`,报告只读 `bookshelf/tasks/child-ux-report.md`(AGENTS.md 第 5 条)。 - 用户对流水线产出的质疑 → `.agents/skills/pipeline-feedback/SKILL.md` 记入 `tasks/pipeline/challenges.md`。 - `product-loop-state.md` 中「远期:每日计划、生词复习调度」由本方案接管;阶段 2 完成后在该文件加一行指针指向本目录。