# daily-plan-engine 流水线状态 - 需求一句话:服务端每日计划引擎(六张卡 + SRS 状态机 + 日/周报告 + 微信文案)、孩子端「今天」页与现有页面事件上报、localStorage 学习状态迁移上云、家长周报页、Hermes 微信提醒 skill/cron 定义。 - 当前阶段:阶段 7 测试 第 1 轮(进行中) - openspec change:`daily-plan-engine`(`openspec/changes/daily-plan-engine/`,specs:`bookshelf-daily-plan`、`bookshelf-learning-events`、`bookshelf-parent-report`、`easy-study-hermes-coach`;tasks.md 11 组 45 条:1.x–6.x 后端 25 条、7.x–11.x 前端与集成 20 条;`validate --strict` 通过) - 用户停点:原型确认**不阻塞**(用户已审阅整体方案并选默认设计) - 上游方案:`tasks/0913-EnglishStudyAnalysis/01-06`;用户决策 D1-D15 全部默认 - 用户约定(2026-09-19 07:21):**先出设计,设计文档定稿后由 grok 4.6 模型(`cursor-grok-4.6-xhigh-fast`)的 subagent 执行开发**——阶段 5 后端、阶段 6 前端的 pd-* 角色调度时指定该模型;门禁角色(体验审查、测试、验收)沿用默认模型 | 阶段 | 角色 | 轮次 | 结论 | 文档 | | --- | --- | --- | --- | --- | | 0 | 主 agent | 1 | 已立项;服务已启动(8000 / 5173 / Nginx 80) | `00-request.md` | | 1 | pd-requirements-analyst | 1 | 分析完成,交产品设计;3 处契约冲突需主 agent 裁决 | `10-analysis.md` | | 2 | pd-product-designer | 1 | 方案完成,交 UI/UX;需后端(非纯前端) | `20-product.md` | | 3 | pd-uiux-designer | 1 | 原型完成,交体验审查 | `30-uiux.md`、`prototype/` | | 4 | pd-experience-reviewer | 1 | 返工:退回 UI/UX(5 P0 + 3 P1) | `40-review.md` | | 3 | pd-uiux-designer | 2 | 原型完成,交体验审查(真实学习步骤 + 服务确认 + localStorage 共享状态 + 跳卡同步 + 口径修正) | `30-uiux.md`、`prototype/` | | 4 | pd-experience-reviewer | 2 | 返工:退回 UI/UX(第 1 轮 8 项已修;新增 2 P0 + 2 P1) | `40-review.md` | | 3 | pd-uiux-designer | 3 | 原型完成,交体验审查(写字成人长按门禁、仓促判定按契约、拼读 4 词门槛、D1 播放状态) | `30-uiux.md`、`prototype/` | | 4 | pd-experience-reviewer | 3 | **通过,可进开发**(余 1 条 P2:无障碍标签,开发阶段吸收) | `40-review.md` | | 5 | pd-backend-developer(grok 4.6) | 1 | 接口就绪,可对接(tasks 1.1~6.3 共 25 条勾选) | `50-backend.md` | | 6 | pd-frontend-developer(grok 4.6) | 1 | 可进测试(tasks 7.1~10.2、11.2、11.3 勾选;tsc/build 通过;报 2 处后端契约缺口) | `55-frontend.md` | ## 日志 - 2026-09-19 06:45 阶段0 第1轮:立项,写 `00-request.md`;启动后端 8000(系统 Python,venv 缺 uvicorn)、Vite 5173、Nginx 80(默认 conf 已 include estudy 反代),`http://127.0.0.1/estudy/api/health` 200。并行启动课程数据工作流(`tools/build_*.py` → `docs/data/curriculum/`)。 - 2026-09-19 06:58 阶段1 第1轮:需求分析完成,R1~R16 各配验收口径,非目标明确;开放问题 11 条,其中 1(六卡 vs V1 后置)、2(`card_skip` 未定义)、3(阅读双写)需裁决。 - 2026-09-19 07:02 主 agent 裁决(铁律 5,均为不改功能范围的契约缺口,不退回):V1 生成 5 卡(卡 2 绘本音频占位、卡 4 不生成、星星分母动态);新增事件 `card_skip`;`/api/records` 为阅读唯一提交入口(新增 `plan_item_id/mode/event_id`,服务端幂等转一条 reading);事件按 `(childId, id)` 幂等;卡 done 只由服务端聚合;顺延只一次。裁决写入 `00-request.md`「主 agent 裁决记录」,并同步修订 `05-系统总体设计.md` §3.4/§4.2/§4.7。交产品设计。 - 2026-09-19 07:12 阶段2 第1轮:产品方案完成(功能清单 F1~ 追溯 R1-R16;五卡闭环、最高 7 星、Today 信息架构、服务端完成聚合、离线/顺延/跳过、家长周报)。两处小缺口自补并在「上游核对」注明(铁律 5 小缺口,记录):① 跳过卡不赚该卡星不扣星、有跳过时不显示「全部完成」只显示「今天结束啦」;② V1 卡 2 在 Today 页内完成播放并提交 `listening` 事件,不新建 `/listen` 页面(正式 Listen 页留给后续流水线)。「数据与状态」需新接口与新数据 → 非纯前端,阶段 5 不跳过。交 UI/UX。 - 2026-09-19 07:20 阶段3 第1轮:设计说明 + 可点击原型(`prototype/index.html` 今天页五卡与 7 星反馈、`shelf.html` 书架「今天」入口与休息态、`parent.html` 家长周报/跳过;含加载、休息、离线、空数据状态)完成;上游核对通过。交体验审查。 - 2026-09-19 07:30 阶段4 第1轮:浏览器实走原型(孩子 + 家长视角),返工退回 UI/UX。P0:听一听播到 0:45 卡在弹层不完成;闯关无题目且「慢一点」后按钮永久禁用;拼/读/闯用一个「完成这张」代替真实流程(完成标准变成孩子自报);家长跳卡后孩子 Today 未同步移除;刷新/跨页后进度清零。P1:休息/离线页自由入口点击无反应;家长空状态与有数据同时渲染;周报 `cape` 归入短 a、写字次数口径与 03 不一致。保留项:书架入口、五卡/7 星、跳卡先选原因再确认。 - 2026-09-19 07:40 阶段3 第2轮:逐条回应第 1 轮 5 P0 + 3 P1——拼/听/读/闯补齐可点击真实步骤(三连关、播放到点自动完成回 Today、翻页到末页、5 题含仓促错答→重播→锁 2 秒→恢复),完成由「服务确认」后返回;localStorage 模拟服务端使刷新/跨页保持进度、家长跳卡后孩子页同步移除并显示「今天结束啦」;休息/离线自由入口可点可返回;家长空状态替换全部结论;短 a 例词与写字次数口径按 02/03 修正。交体验审查第 2 轮。 - 2026-09-19 07:50 阶段4 第2轮:复验第 1 轮 5 P0 + 3 P1 均已修复;新增 P0:写一写「家长确认」按钮在孩子页无成人门禁,孩子可自报得星;P0:仓促判定不按 `<1500ms` 且连续 2 次执行(超 2 秒答错也锁选项)。P1:拼一拼只走完 1 词就整卡得星(应 4 词);读一读 D1 无喇叭/播放状态。返工退回 UI/UX 第 3 轮(门禁最后一轮)。 - 2026-09-19 07:52 主 agent 裁决 #10(写入 `00-request.md`):写一写完成只能经 Hermes 照片/「写好了」,或成人门禁(复用长按小熊解锁模式)后的家长确认;孩子页无直接完成按钮。不改数据契约。 - 2026-09-19 08:00 阶段3 第3轮:逐条修复第 2 轮 2 P0 + 2 P1——写一写改为长按 2 秒成人门禁后的「家长确认」面板、孩子页无直接完成按钮;仓促判定从可作答起计时、仅 `<1500ms` 且错记 hasty、连续 2 次才重播锁 2 秒;拼一拼显示「第 N/4 个词」走完 4 词才收星;读一读 D1 补整本/逐页播放入口与状态。角色已从重置状态浏览器实走。交体验审查第 3 轮。 - 2026-09-19 08:10 阶段4 第3轮:复验通过——第 2 轮 2 P0 + 2 P1 均修复,孩子五卡 7 星与家长跳卡闭环实走成立;余 1 条 P2(无障碍标签)交开发吸收。原型确认停点不阻塞:原型路径 `tasks/pipeline/daily-plan-engine/prototype/index.html`(另 `shelf.html`、`parent.html`)已通知用户,继续 openspec-propose。 - 2026-09-19 08:12 课程数据:`docs/data/curriculum/` 六文件已生成并 commit(8216094);78 个不在拼读词库的种子例词正在补录重跑(不改 schema)。 - 2026-09-19 08:20 课程数据收口:补录 73+14 词、修正 7 个错位词,拼读词库 1923 词,重跑后 26 周 329 例词、混淆对 120、无剔除(commit acec7a3)。 - 2026-09-19 08:25 openspec-propose:以 00/10/20/30/40 + 03/04/05/06 为输入建 change `daily-plan-engine`(proposal / design 18 条决策 / 4 个 delta spec 共 37 Requirement 77 Scenario / tasks 45 条),`npx @fission-ai/openspec validate daily-plan-engine --strict` 通过。design 记两处保守假设:`carry_over_expired` 只改状态不写 `card_skip`;无任务日 `morning/saturday` 返回空体。进入阶段 5 后端(按用户约定用 grok 4.6 模型)。 - 2026-09-19 08:40 阶段5 第1轮(grok 4.6):新增 `routers/{plan,events,srs,reports,days,curriculum}.py`、`app/deps.py`(token 校验)、`app/services/*`(store/curriculum/srs_engine/plan_engine/reports/wechat_templates/scheduler)、`tests/`;`records.py` 兼容转发一条 reading 事件;`config.py`/`main.py` 加路径与挂载;`requirements.txt` 加 APScheduler;`.env.example`;`deploy/hermes/{README.md,cron.md,skills/easy-study-coach/}`、`deploy/backup/`;`.gitignore` 排除 `docs/data/learning/`。经 Nginx 实测 health/plan/events 正常,`/docs` 六组新 tag。openspec tasks 1.1~6.3 勾选。注:本次提交的 `config.py`/`main.py`/`.gitignore` 同时带入此前工作区未提交的小改动;`routers/books.py`、`words.py` 与 `deploy/nginx/*` 的既有未提交改动不属本阶段,未提交。交前端。 - 2026-09-19 09:05 阶段6 第1轮(grok 4.6):新增 `Today.tsx/.css`、`StarCollect.tsx/.css`、`learningEvents.ts`(事件 id/离线队列/批量重放)、`usePlanMode.ts`(`?plan=` 解析)、`parent/Report.tsx/.css`;`App.tsx` 路由 `/today`、`/parent/report`;`Home.tsx` 书架「今天」入口与三条计划提示;`Learn/Quiz/SpellingGame/ChildBookReader` 接 `?plan=` 上报事件并返回 Today;`bookStudy.ts` 改缓存 + 一次性 `srs/sync`;写一写长按 2 秒家长确认;`client.ts` 新增 plan/events/srs/reports/days API。`tsc -b --noEmit` 与 `npm run build` 通过;经 Nginx 实走写一写翻绿、跳卡同步、书架入口、迁移。报 2 处后端缺口 → 主 agent 裁决 #11(周六 15 题补齐规则)、#12(「我要练」不加 type:阅读走 records.unknown_words,Learn 发 `phonics.stage=want_practice`),归后端第 2 轮,与测试门禁的 bug 一并处理。注:前端提交同样带入此前工作区未提交的既有改动(App/client/Home/Learn/Quiz/ChildBookReader/bookStudy/NavBar/vite.config 等)。交测试。