墨墨背单词电脑端背诵工具，本地 Web 应用。
采用单向同步设计：从墨墨开放 API 拉取学习任务，在本地完成背诵与反馈记录，所有反馈只存本地，不会回写墨墨账号。
- 今日任务同步 — 拉取墨墨今日学习计划，自动过滤手机端已完成和本地已完成的单词。
- 卡片式背诵 — 按
空格揭晓释义；四档反馈（1认识 /2模糊 /3忘记 /4熟知）。 - 错词自动重背 — 标记为忘记的单词自动重新入队，直到全部背完。
- 真人发音 — 有道词典 TTS 发音（优先美音，自动降级英音）。
- 统计看板 — 连续打卡（今天没背从昨天续数，不误断签）、累计词数、错词率、今日学习词数、近 8 周复习热力日历。
- 错词回顾 — 按「忘记/模糊」次数降序排列，勾选后一键进入复习模式。
- 释义兜底 — 墨墨返回空释义（无自建释义的账号为常态）时，自动回落有道公开词典，含音标。
- Node.js ≥ 18（零依赖，无构建步骤）
Windows — 双击 start.bat。
macOS / Linux：
./start.sh或手动启动：
node server/index.js然后在浏览器打开 http://localhost:8765（端口 8765）。
- 打开设置页，粘贴你的墨墨开放平台 token。
- 进入背诵页 — 自动加载今日任务（已过滤手机端与本地已完成）。
- 逐卡背诵：按
空格揭晓释义，听发音，按1（认识）/2（模糊）/3（忘记）/4（熟知）反馈；忘记的词会重新入队，直到全部背完。 - 可在统计与回顾页查看看板与错词回顾。
墨墨 App 需开启自动同步，学习数据接口才会返回数据。
所有数据保存在本地 data/ 目录（已 gitignore）：
| 文件 | 内容 |
|---|---|
data/config.json |
API token |
data/study.json |
学习记录（原子写入） |
data/interpretations.json |
释义缓存 |
| 端点 | 方法 | 说明 |
|---|---|---|
/api/config |
GET / POST | 读取 / 保存 token |
/api/today |
GET | 今日任务列表 |
/api/progress |
GET | 学习进度 |
/api/feedback |
POST | 提交反馈档位 |
/api/interpretation?voc_id= |
GET | 单词释义（带缓存，有道兜底） |
/api/reset-today |
POST | 清空今日反馈，全部重新背诵 |
/api/stats |
GET | 看板统计数据 |
/api/review |
GET | 错词回顾列表 |
server/index.js HTTP 服务、路由、静态文件
server/maimemo-api.js 墨墨 API 封装（串行队列 + 频控）
server/store.js JSON 存储 + 统计聚合
public/index.html 单页界面
public/style.css 深色极简卡片风格
public/app.js 前端逻辑
data/ 本地数据（gitignore）
- 反馈不回写墨墨 — 开放 API 无「提交复习反馈」端点，手机端任务仍显示未完成。这是 API 硬限制，方案按单向同步设计。
- 学习数据接口为公测 — 官方文档标注「不保证可用性、可能随时调整」。
- 墨墨释义接口返回用户自建释义；无自建释义时走有道兜底（实测为常态）。
本项目为个人开发的非官方工具，使用墨墨开放 API 与有道公开词典接口，所有数据仅保存在本机。请自行承担使用风险，并遵守墨墨开放平台相关条款。