english-memory-method：把英语文章变成完整背诵方案的 Agent Skill
yxdwind/english-memory-method
开源项目 english-memory-method 能把任意英语文章转成自包含 HTML 背诵方案，普通文章 15 节、演讲稿 16 节、500~2000 词长文 17 节，含逐句连读标注、链式问题链、复述五级阶梯与折叠自测。
把"背英语文章"从死记硬背，变成一条能走完的路。
丢给它任何一篇英语文章，它还你一份完整背诵方案（普通文章 15 节 · 演讲稿 16 节含骨架 · 长文 17 节含分段仪表，自包含 HTML）： 逐句连读标注、钩子焊成问题链、复述五级阶梯、专业词汇梳理、折叠自测——全在一份文件里。
安装 · 功能特性 · 工作原理 · 平台支持 · English
✨ 功能特性
| 功能 | 一句话说明 | |
|---|---|---|
| 🧠 | 链式复述 | 钩子焊成问题链：每一环由上一环推出，能推出来的不用背 |
| 📖 | 逐句精读 | 中文翻译 + 全现象连读标注（⌒ 连读 / 弱读 / flap t / h 击穿）+ 专业词高亮 |
| 📚 | 专业词汇梳理 | 构词拆解（词根词缀）+ 音标 + 记忆钩子——认得词根，生词变熟词 |
| 💬 | 短语生活例句 | 每条搭配配一个纯英文日常例句，直接模仿开口（不带翻译，逼英语思维） |
| 🗂 | 15 节闭环（长文 17 节 / 演讲稿 16 节） | 策略 → 精读 → 钩子与链 → 复述阶梯 → 三遍法 → 复习 → 自测 → 积累 → 句型 → 宫殿 → 听写 |
| 🔁 | 复习闭环 | 句级「顺/卡」打卡 → 薄弱句清单 → 连顺 2 轮毕业，进度存本地不丢 |
| 🏛 | 记忆宫殿 | 25 站生活动线，每句一个站点——空间线索与钩子链互为兜底，随机丢句时「空站」直接暴露断点 |
| 🎧 | 听写验证 | TTS 逐句朗读 → 听写输入 → 逐词比对高亮，错句直通薄弱清单 |
| 💎 | 金句句型库 | 每篇 5~9 条可迁移句型（加粗可替换部分 + 换装模板），背了直接用进写作/演讲 |
| 🎤 | 演讲稿模式 | 自动识别三幕骨架（开场钩/论点/升华），附朗读要点；问题链与复述阶梯按演讲特点改造 |
| 📜 | 长文模式 | 500~2000 词自动启用：分段进度仪表（🔒▶✅随打卡流转）+ 段落单元按段展开 + 按段艾宾浩斯错峰 |
| 🧠 | SM-2 间隔算法 | 轻量/标准双模式：标准档每句独立 ef/间隔/到期日，逾期高亮（Wozniak 1990） |
| 🎙 | 影子跟读 | TTS 播放 → 录音 → 波形对照评分；错词 ≥25% 自动进薄弱清单 |
| 📚 | 个人记忆库 | 背过的方案汇成一个书架页：搜索/轻刷/实时进度，一个 HTML 装下所有 |
| 🙈 | 自测三档 | 关 → 遮译文 → 全遮，点句子临时揭开 |
| ⚡ | 薄弱快刷 | 只显示卡壳句，5 分钟过完一轮；挖空自动批改，错词直通薄弱清单 |
| 🛡 | 进度指纹 | 方案内容变了自动检测，进度不再错位嫁接 |
| 📅 | 今日任务卡 | 按段艾宾浩斯自动算今天学什么，支持「设为今天新学」顺延 |
| 🧪 | 472 项自动化测试 | 冒烟 + 运行时 + 端到端 35 步 + 跨浏览器矩阵，npm test 一键全跑 |
| 🔒 | 折叠自测 | 挖空先自己填，答案藏在"▶ 查看本段答案"里，打印自动隐藏 |
| 🖥 | 16+ 平台直装 | Claude Code / Codex / Trae / 通义灵码 / Comate / CodeBuddy / WorkBuddy / Kimi / MiniMax… |
| 📄 | 自包含单文件 | 每份方案一个 HTML：内联 SVG、可折叠、打印友好、零外部依赖 |
🚀 快速开始
Windows（PowerShell）：
irm https://cdn.jsdelivr.net/gh/yxdwind/english-memory-method@main/install.ps1 | iex
macOS / Linux：
curl -fsSL https://cdn.jsdelivr.net/gh/yxdwind/english-memory-method@main/install.sh | bashClaude Code（零命令行）：
/plugin marketplace add yxdwind/english-memory-method
/plugin install english-memory-method
npm / npx：
npx english-memory-method
安装器自动探测本机全部已装平台并逐一装入（16+ 平台别名见平台支持）。 jsdelivr 不通时换官方源：
irm https://raw.githubusercontent.com/yxdwind/english-memory-method/main/install.ps1 | iex
触发：丢一篇英语文章 + 一句"出背诵方案"（或"出记忆技巧"）。装完无需重启。
🔒 可审计 / 离线安装（安全敏感环境）
若所在组织禁止 irm | iex / curl | bash 等远程执行，可改用可审计路径：
- 先下载、后审阅、再运行：手动下载
install.ps1/install.sh，通读确认无异常后再本地执行； - 校验和核对：发布包附带
SHA256SUMS，安装前sha256sum -c SHA256SUMS验证完整性与来源； - 离线包：
git clone或下载仓库 tarball 后，直接拷至目标机离线运行安装脚本，全程不依赖 jsDelivr / raw.githubusercontent； - npm 替代：
npx english-memory-method（走 npm 官方源，可配合企业私有 registry）。
发版一致性要求见 RELEASE-CHECKLIST.md。
📖 工作原理（15/16/17 节按文体）
| 节 | 章节 | 干什么 |
|---|---|---|
| 1 | 整体策略 | 判断文体与逻辑骨架，估算句数与背诵天数 |
| 2 | 文章结构图 | 全文压成一张 SVG 背诵地图 |
| 3 | 原文逐句精读 | 中文翻译 + 连读标注 + 专业词高亮（逐句三层） |
| 4 | 关键词串联表 | 每句 1~2 个钩子词 + 中文提示 |
| 5 | 链式化问题链 | 钩子焊成 4~7 个路标问题——复述时自问自答 |
| 6 | 复述五级阶梯 | L1 看钩子 → L2 看问题链 → L3 看标题 → L4 空手 → L5 转述他人 |
| 9 | 当天三遍法 | 理解朗读 ×3 → 看钩子复述 → 看问题链复述 |
| 10 | 艾宾浩斯复习 | 5 分钟 → 睡前 → 次日 → 第 3 天 → 第 7/15 天 |
| 11 | 挖空自测 | 每段挖 2~5 空，答案折叠、先填后核对 |
| 12 | 必背短语清单 | 8~15 条搭配 + 真实语料例句，可直接迁移 |
| 13 | 专业词汇梳理 | 构词拆解 + 音标 + 记忆钩子 |
| 14 | 金句句型库 | 可迁移句型四列表：句型 / 释义 / 可替换模板 / 使用场景 |
| 15 | 记忆钩子 | 文内语言钩 + 三层钩子链：段钩 → 句钩链（逻辑桥串联）→ 英文锚点，逐句放行 |
| 16 | 复述技巧包 | 10 条纯技巧：卡壳自救 / 表达提速 / 练习要领 |
| 17 | 记忆宫殿映射 | 25 站生活动线，每句一个站点——空间线索兜底随机丢句 |
🎤 演讲稿模式章节表（16 节）
| 节 | 章节 | 说明 |
|---|---|---|
| 1 | 整体策略 | 演讲背诵路径：骨架 → 关键词 → 三遍法 → 间隔复习 |
| 2 | 文章结构图 | 三幕演讲结构 SVG 地图 |
| 3 | 演讲骨架 🎤 | 三幕站点（开场钩/论点展开/升华收尾），每站【作用】+【可迁移技巧】，附朗读呼吸群与升降调 |
| 4 | 原文逐句精读 | 翻译 + 连读标注 + 朗读要点（逐句三层） |
| 5 | 关键词串联表 | 每句钩子词 + 中文提示 |
| 6 | 链式化问题链 | 观众视角「接下来呢？」6 问自问自答 |
| 7 | 复述五级阶梯 | L3 = 看骨架说（演讲线性记忆） |
| 8 | 当天三遍法 | 理解朗读 ×3 → 看钩子复述 → 看问题链复述 |
| 9 | 艾宾浩斯复习 | 5 分钟 → 睡前 → 次日 → 第 3 天 → 第 7/15 天 |
| 10 | 挖空自测 | 答案折叠、先填后核对 |
| 11 | 必背短语清单 | 搭配 + 真实语料例句 |
| 12 | 专业词汇梳理 | 构词拆解 + 三地音标 + 记忆钩子 |
| 13 | 金句句型库 | 演讲金句四列表（开场/排比/收尾模板） |
| 14 | 记忆钩子 | 三层钩子链 |
| 15 | 复述技巧包 | 10 条纯技巧（含演讲救场） |
| 16 | 记忆宫殿映射 | 25 站路线，空间线索兜底 |
样例：葛底斯堡演说（三连否定蓄力 · 言行对举金句 · of-by-for the people 三介词排比）。
📜 长文模式章节表（17 节 · 500~2000 词自动启用）
| 节 | 章节 | 说明 |
|---|---|---|
| 1 | 整体策略 | 含分段排期表：每天 1~2 段 |
| 2 | 文章结构图 | 全篇总图（含跨段总链） |
| 3 | 分段进度仪表 📜 | 每段一行：段名/排期/🔒▶✅状态随打卡自动流转/段薄弱句数 |
| 4.1~4.N | 段落单元 📜 | 每段独立闭环：全现象标注精读 + 关键词表 + 问题链 + 三层钩子链 |
| 9 | 当天三遍法 | 只针对当天段落 |
| 10 | 艾宾浩斯复习 | 按段错峰排期 + 全文合体日 |
| 11 | 挖空自测 | 每段一组挖空 + 折叠答案 |
| 12 | 必背短语清单 | 全文短语汇总 |
| 13 | 专业词汇梳理 | 全文术语汇总 |
| 14 | 金句句型库 | 全文金句汇总 |
| 15 | 记忆钩子 | 跨段总链：先背全篇总链再进各段 |
| 16 | 复述技巧包 | 10 条纯技巧 |
| 17 | 记忆宫殿映射 | 站点跨段连续累加（站 1 = 全篇第 1 句） |
样例：《独立宣言》背诵精编版（5 段 / 21 句 / ~830 词 / 5 天，分段仪表 + 按段艾宾浩斯）。
核心理念：孤立钩子 = 断点——钩子要背、顺序要背、映射也要背，三重负担。 v2 把钩子焊成链：每一环由上一环"推"出来，能被逻辑推出的内容不需要背。
🖥 平台支持
遵循开放的 Agent Skills 标准（skills/<name>/SKILL.md），三级支持：
- L1 · Skill 直装：AutoClaw / OpenClaw / Claude Code / Codex / Trae / 通义灵码 / Comate / CodeBuddy / WorkBuddy / Kimi Code / MiniMax / Qwen Work / Windsurf / Continue / Roo Code
- L2 · 规则注入（Markdown 方案）：Cursor / Qoder / GitHub Copilot / Gemini CLI / Cline / Aider —— 适配文件见
platforms/ - L3 · 手动跟随：其他平台把
SKILL.md内容粘贴到自定义指令
完整矩阵（21 平台 × 安装方式）见 platforms/README.md。
📜 版本历史
从新到旧排列，最早版本见底部折叠区。
完整版本历史（含历史 bug 修复与 CI 自检锚点
EMM_*）已迁出至 CHANGELOG.md。
入门减负 + L2/L3 兜底（v2.29.0）
v2.29.0：🚀 首屏「3 步快背」极简入口卡（听读→钩子链→复述打卡，带跳转，其余章节折叠）；⚠️ 能力探测横幅（TTS/录音/存储不可用时显式告知 + 替代做法，不再静默降级）；🗂 Anki/CSV 导出（挖空卡 + 复述卡一键进 Anki）；🏛 记忆宫殿路线引导（首次使用自定义 25 站动线，localStorage 持久化、所有方案通用）；L2/L3 平台统一交付「Markdown 精简版」（方法论内核不缩水，交互组件给口头替代法）；图例条补逻辑桥符号（⇒↔→＋:）；修复 v2.18 折叠样式被误嵌套进移动端媒体查询（桌面端失效）；模板页脚自动版本戳；修复 skills/ 嵌套 SKILL.md 漏同步造成的双源分叉。锚点 20 组。
工程收尾（v2.28.2）
v2.28.2：审计遗留五项——build-samples 填充挖空节并锁死幂等（重跑不再回退占位符）；version-check 锚点表 EMM_UX_V224 重映射到 library；记忆库 ?check=1 新增重复 key（同名陷阱）运行时检测；verify-plan 锚点期望按文件类型区分；新增 .gitattributes 统一行尾。总测试数 472。同批新增 npm 发布链路：GitHub Actions Trusted Publishing（OIDC 零 token，tag 即自动发布，免疫 npm 2026-08/2027-01 bypass-token 收紧），首版 npx english-memory-method 随首次发布上线。
审计修复（v2.28.1）
v2.28.1：副本分叉 + 截断防护——修复 v2.18→v2.28 批量更新造成的双源真相破裂（assets/ 停在 v2.16/v2.17、plugin.json 漏更，npm 用户拿到旧组件；version-check 新增 plugin.json 与主副本一致性 2 组检查，现 9 组）；修复记忆库 </script 截断隐患（SKILL.md 硬性校验 + 3 项冒烟防护：含闭合序列的数据会让解析器提前闭合脚本、整页 JS 静默挂掉）；按段统计表补进横滚容器；轻刷结算句号缺省补「?」；文章卡显示计划天数；测试数改动态比对 CHANGELOG。总测试数 468。
测试基建（v2.26.0–v2.28.0）
v2.28.0：端到端 session driver——jsdom 完整跑 35 步用户流（bin/e2e-flow.mjs，--strict 严格模式）；修复 endRound 持久化覆盖 bug；总测试数 455。
v2.27.0：跨浏览器 API 静态扫描器（43 API × 4 浏览器矩阵）+ docs/CROSS-BROWSER.md。
v2.26.0：fixture 同步工具 bin/sync-fixtures.mjs + CI 友好 --check 模式。
打磨与自测（v2.23.0–v2.25.0）
v2.25.0：📝 60 秒挖空挑战倒计时；🎯 毕业阈值可配置（连顺 2/3/4/5）。
v2.24.0：轻刷「🎯 一键回原方案补打卡」；记忆库状态筛选 chip。
v2.23.0：Step 0 体裁识别（短文/长文/演讲稿）写入工作流程；按段统计表。
调度与可携带（v2.19.0–v2.22.0）
v2.22.0：git tag 自动化 bin/tag.mjs；.ics 时区修复。
v2.21.0：进度导出/导入（💾/📥）；长文「📌 设为今天新学」顺延。
v2.20.0：SM-2 间隔算法（Wozniak 1990）替换固定毕业阈值；轻量/标准双模式切换。
v2.19.0：影子跟读——TTS 播放 → MediaRecorder 录音 → 对照评分；错词自动入薄弱清单。
平台与记忆库（v2.16.0–v2.18.0）
v2.18.0：首屏折叠（h2 ≥9 默认收起）+ 首次访问 on-boarding 引导卡。
v2.17.0：个人记忆库 memory-library.html——书架 / 搜索 / 轻刷（链回忆→挖空→结算）/ 实时进度。
v2.16.0：窄屏（≤720px）移动适配——表格横滚、任务卡堆叠、工具条吸顶。
学习闭环（v2.13.0–v2.15.0）
v2.15.0：进度内容指纹——方案重新生成自动检测，旧进度不再错位嫁接；宫殿 data-sents 精确映射薄弱站。
v2.14.0：薄弱句快刷「⚡ 只刷薄弱(N)」；挖空交互化——运行时转输入框自动批改，错词直通薄弱清单。
v2.13.0：自测模式「🙈 自测」三档循环（关 → 遮译文 → 全遮）；今日排期「📅 今日任务」卡——按段艾宾浩斯自动算今天学什么。
展开查看早期版本（v2.1 → v2.12.0）
v2.12.0：长文模式——文章 5002000 词或超 12 句自动启用 17 节方案：新增第 3 节「分段进度仪表」（段名/排期/🔒▶✅状态随打卡自动流转/段薄弱句数），4.14.N 按段展开段落单元（每段独立精读+关键词+问题链+钩子链），艾宾浩斯按段错峰排期+全文合体日，跨段总链先背、宫殿 21 站跨段连续。样例：《独立宣言》背诵精编版（5 段/21 句）。
v2.11.0：演讲稿模式——输入演讲稿自动生成 16 节方案：新增第 3 节「演讲骨架」（三幕结构站点：开场钩/论点展开/升华收尾，每站含作用与可迁移技巧，附朗读呼吸群与升降调要点）；问题链改为观众视角自问自答，复述阶梯 L3=看骨架说；样例：葛底斯堡演说全篇方案。
v2.10.0：新增第 12 节「金句句型库（写作/演讲可复用）」——每篇精选 5~9 条可迁移句型（实用框架 + 经典修辞两类），四列表格：句型（可替换部分加粗）/ 中文释义 / 可替换模板（换主语换话题即复用）/ 使用场景；后续章节顺延：记忆钩子→13、复述技巧包→14、记忆宫殿→15。30 篇存量方案 187 条金句全量回填。
v2.9.0：听写验证模式——逐句区新增「🎧 听写模式」：浏览器美音 TTS 逐句朗读（零配置），输入听到的句子，逐词比对高亮（错词黄/漏词红/多词灰/正确绿），错句自动进薄弱清单，与打卡、宫殿红站三线联动；听写进度独立存档，打印自动隐藏。30 篇方案全量内置。
v2.8.1：宫殿×打卡联动补全——「结束本轮」结算时薄弱句对应站点自动标红，连顺毕业同步取消；打开文件按存档恢复标红，宫殿区始终反映当前薄弱站。
v2.8.0：记忆宫殿层——第 14 节「记忆宫殿映射」：25 站生活动线（起床→…→床，可传参换自己的路线），每句按序入座站点，句钩与锚词直接复用钩子链；平时走逻辑线（钩子链），卡壳/复习时走空间线（宫殿），「空的站点」直接暴露丢句位置。30 篇方案全量注入。
v2.7.0：复习闭环——方案文件内置句级打卡组件：每句「顺 / 卡」自评，卡壳句自动进薄弱句清单（点击跳转原文），连顺 2 轮自动毕业；轮次自动记日期结算，进度存浏览器本地、刷新不丢、打印自动隐藏。30 篇方案全量内置，双击打开即可追踪背诵进度。
v2.6.0：记忆钩子升级为三层钩子链——① 层1 段钩（每段一个画面感大钩）；② 层2 句钩链（每句一个 24 字微钩，钩间标逻辑桥：⇒因果 / ↔转折 / →递进 / ＋并列 / :举例）；③ 层3 英文锚点（每钩挂 23 个原句锚词，中文钩→锚词→原句）。盖住原文只看链，一钩一句往外说；卡在哪一钩就只重背那一句。30 篇存量方案 124 条链 / 423 句钩全量升级。
v2.5.0：专业词汇音标升级为三地标注——默认美音，英音差异另起 UK: 行，印度发音按系统规则标 IN: 行；189 个术语全量标注（57 处英美差异、68 处印度音）。
v2.4.0：必背短语例句升级为真实语料风格（新闻 / TED / 原版素材语感），搭配句中加粗、无翻译、可直接迁移写作；30 篇 728 条例句全量重写。
v2.3.0：① 必背短语清单升级为三列表格（短语 / 中文释义 / 生活例句）——例句纯英文、贴近日常、直接模仿；② 全部章节重排为 1~13 顺序编号，阅读流更清晰。
v2.2.1：挖空自测答案折叠——每段答案装进「▶ 查看本段答案」折叠条，先自己填、再点开核对，打印时自动隐藏。
v2.2.0：专业词汇功能——① 逐句精读区专业词黄色高亮；② 「6.5 专业词汇梳理」表（术语 / 构词拆解 / 音标 / 中文 / 记忆钩子）；30 篇存量方案全量升级。
v2.1.1：① 「7.5 复述技巧包」——10 条纯技巧（卡壳自救 / 表达提速 / 练习要领）固定附在记忆钩子之后；② 多平台支持——安装器自动铺装 16 个 agent 平台，并为无 skills 机制的平台提供规则适配文件。
v2.1：原文逐句精读区——逐句中文翻译（可传参换语种）+ 全现象连读标注（⌒ 连读 / 弱读 / flap t / h 击穿）+ 美式 IPA 读法注解。
🎯 适用场景
四六级 / 考研 / 雅思托福的精听与背诵、成人英语自学、AI 辅助语言学习。 配套训练法（同系列）：《精听诊断五步流程》《连读·弱读四步拆解法》。
⚠️ 已知局限与适用边界
透明起见，先说清楚这份方案"在哪里会打折扣"。完整能力请见上方功能特性。
平台体验差异（L1 / L2 / L3）
- L1 直装平台（Claude Code / Codex / Trae / 通义灵码 / Comate / CodeBuddy / WorkBuddy / Kimi / MiniMax / Qwen Work / Windsurf / Continue / Roo Code 等）：功能完整——SVG 结构图 + 自包含 HTML 方案 + 逐句连读标注 + 浏览器内交互打卡/听写/影子跟读。
- L2 规则注入平台（Cursor / GitHub Copilot / Gemini CLI / Cline / Aider / Roo 项目级）：以 Markdown 规则注入，输出为 Markdown 版方案，不含 SVG 结构图与可交互 HTML 组件（打卡、听写、影子跟读等需浏览器的交互不可用）。需要完整交互体验，建议优先在 L1 平台使用。
- L3 手动跟随：把
SKILL.md内容粘贴到自定义指令，体验取决于平台对长指令的支持程度。
浏览器与设备依赖
自测、听写、影子跟读依赖浏览器的 speechSynthesis / MediaRecorder / getUserMedia：
- Firefox 的 TTS 语音列表可能为空 → 听写/朗读可能不发声（已静默降级为手动模式）。
- iOS < 14.1 不支持
MediaRecorder→ 影子跟读录音不可用（已降级为手动自评）。 - Safari 以
file://打开本地方案时，getUserMedia需 HTTPS（localhost 除外）→ 录音不可用（已降级）。
进度保存在浏览器 localStorage：Safari / iOS 配额较小，方案堆积过多可能触发写入失败（已 try/catch 兜底，建议定期导出备份）。推荐使用桌面版 Chrome / Edge / Firefox 获得完整体验；移动端功能受限。
安装与网络
- 一键安装会直接执行远端脚本（
irm | iex/curl | bash）。安全敏感环境请先下载脚本审阅再运行，或使用npx/ 插件市场方式。 - 安装源默认走
raw.githubusercontent.com与 jsDelivr；若所在网络访问不稳，可改用可达镜像或离线包。
生成质量依赖宿主模型
方案由宿主 Agent 的模型现生成，质量随模型能力浮动；弱模型或 L2/L3 平台输出会更简略。472 项测试覆盖模板与运行时，不保证任意模型生成内容的优劣。
这份方案「不适合」谁
- 想要 5 分钟极简背词的纯新手（本方案偏重方法论，入门成本较高）。
- 完全不懂 IPA / 音系符号、也不愿先学"怎么读方案"的纯初学者（连读标注含专业符号）。
- 想要 Anki 式 SRS App、账号 / 多端云同步的人（本方案是单文件 HTML，进度存本地）。
- 仅用手机、不便运行现代桌面浏览器的用户。
- 安全合规禁止远程执行脚本的组织（需改用可审计安装方式）。
FAQ
Q：为什么我在 Cursor / Copilot 里看不到 SVG 图和打卡按钮？ A：这些是 L2 平台，输出为 Markdown 方案，不含可交互 HTML 组件。需要完整体验请用 L1 平台。
Q：打开方案后朗读 / 录音没反应？ A：检查浏览器是否支持对应 API（见"浏览器与设备依赖"）。Firefox 可能不发声，iOS 旧版不能录音，Safari 本地文件不能录音——均会自动降级为手动模式。
Q：进度会丢吗？
A：进度存在浏览器 localStorage，清缓存 / 换浏览器 / 无痕模式会丢失。建议用导出（JSON）备份，并避免 Safari / iOS 小配额下堆积过多方案。
Q：装完要不要重启？ A：不需要。装完直接丢一篇英语文章 + 一句"出背诵方案"即可。
📄 License
来源：GitHub · github.com