Effect 4.1.4 深度课 · 教学设计说明书

受众：有 TypeScript / Promise / async-await 经验，但没有系统学过 effect system 的工程师。不要求函数式编程背景。

总目标：能独立讲清「一个 Effect 从构造、组合、装配依赖，到被 root fiber 解释、被调度器让出、最终产出 Exit」的完整链路，并能在真实项目里渐进落地。

设计原则：每个新概念至多依赖 1–2 个已学概念；先把「能跑起来」的心智模型建立好，再引入抽象；底层原理放在第 4 阶段，此时学习者已有足够的具体经验支撑抽象。难度按 1→5 递进，阶段 4 是唯一的陡坡，用 3 个交互演练拆解。

合计约 12 小时净学习时长，建议按 25–30 分钟/天推进，约 4–5 周完成，之后进入长期复习。

26 个概念节点，每个带 stage / weight / prereqs。引擎据此做前置缺口归因。主干依赖（箭头表示依赖方向）：

program-value → three-channels → composition → gen → type-accumulation
                     ↓                                   ↓
                  laziness → runners → exit        typed-error → defect → cause → recovery
                     ↓                    ↓                                   ↓
                   fiber → runloop → scheduler              context → layer → layer-graph
                     ↓                                              ↓
                  concurrency → stream                          scope
                     ↓
                    stm                              schedule ← recovery
                                              ecosystem ← layer-graph + context

数据采集：课时访问次数、停留时长（进入/离开计时）；每次答题记录 ts / lessonId / qIndex / correct / concept / isReview；演练完成标记、课时完成时间、每日会话汇总；全部存 localStorage（键 effect-course-state-v1），可导出 JSON。

mastery = 100 × (0.30·recent + 0.20·accuracy + 0.25·retention + 0.25·exposure)
recent    = 最近 5 次作答按 exp(-Δt / 14天) 加权的正确率
accuracy  = (correct + 1) / (total + 2)              // 拉普拉斯平滑，避免 1 题满分
retention = exp(-Δt / S)                             // 艾宾浩斯式遗忘
exposure  = min(1, total / 4)                        // 样本不足不轻易判「掌握」

答对：S ← min(90, S × (1 + 0.8·(1 − R)) + 0.6)
答错：S ← max(0.5, S × 0.55)

复习调度：retention < 0.82 进入复习队列，按 retention 升序排列；复习答对会拉长 S，从而把下次复习推远。复习中心可随机抽该概念的题，错题本保留最近 12 条错误记录并支持一键回到原课时。

运行：pnpm dev（开发）或 pnpm build && PORT=3100 node .output/server/index.mjs（生产预览）。

内容、引擎、演练、视图四层解耦：app/data/effect-course.ts 是唯一内容源，app/data/courses.ts 是课程注册表，app/lib/analytics.ts 是学情引擎，app/lib/widgets.ts 是 11 个演练内核，app/components/course/* 与 app/pages/courses/[slug]/* 是 Vue 视图。

浏览器需支持 ES2022+（Chrome / Edge / Firefox / Safari 近两年版本）。

移动端适配（≤780px）：顶栏精简为「菜单 / logo / 版本 / 主题」，6 个主视图改固定底部标签栏（图标 + 短标签，触控高度 ≥48px，含「教学设计」）；24 课目录改左侧抽屉（遮罩、Esc、点击空白、切页自动关闭）；卡片单列或两列，KPI 两列；代码块、原理图示、课时数据表、14 天时间轴保留独立横向滚动并给出滑动提示；输入框 16px 防 iOS 自动缩放；适配 viewport-fit=cover 与刘海屏 env(safe-area-inset-*)；横屏矮视口与 prefers-reduced-motion 另有规则。

回归自检：pnpm verify（数据一致性 + 学情引擎全轨迹）、python scripts/smoke.py --base http://127.0.0.1:3100（SSR 路由、客户端渲染、320/390/768/1440 四种真实视口的横向溢出与导航检查）。每次改动 effect-course.ts、引擎或样式后都跑一遍。

手机视口用 scripts/cdp.py 通过 CDP Emulation.setDeviceMetricsOverride 构造：无头 Chrome 的 --window-size 被钳在约 500 CSS px，测不到 390px。