Cheese TOEIC Tracker

"Sprint to Mastery." 纯本地、高颜值的 TOEIC 冲刺训练看板。全流程闭环集成计时、复盘、生词、估分与数据同步，支持自定义冲刺目标（5~20套题），精准适配每一个备考周期。

---

核心设计理念

传统的 TOEIC 备考往往在题库中迷失，而 Cheese TOEIC Command Deck 专注于流程管理与深度反馈：

• 自定义冲刺引擎：摒弃死板的固定周期，支持 5 / 10 / 15 / 20 套题动态重构，完美兼容短期突击与长线作战。
• 线性冲刺流：将计时、对分、错题归因整合成无缝的单向工作流，彻底消除决策损耗。
• Widget 化沉浸看板：参考台与备份中心均采用 Apple-inspired 的悬浮卡片式 UI 架构，信息呈现从容、美观，化解备考焦虑。
• 生词记忆仓库：不再只是记录，通过自动词典查阅、例句提取与重复频率追踪，构建高频考点词库。
• 估分模型：按答对题数分段插值换算（TOEIC 只看答对数，不因错题分布扣分）；没做的阅读题按考场上随手涂满、约蒙对 1/4 计入；首页「当前水平」取最近 5 套、越新权重越高，套数越多、越稳定，区间越窄；还能把「距目标分」换算成「约需多对几题」。
• 隐私与自由：数据 100% 存在本地，不收集隐私，不依赖服务端，随时生成快照或一键扫码转端同步。

模块介绍

模块	核心功能
Mission Control	首页仪表盘。考试倒计时、下一步行动建议、最近成就、活动热力图。
Sprint Flow	计时 -> 复盘 -> 结果 三位一体。支持阅读分段计时（Waterfall Chart）与严格听力限时。
Vocab Vault	自动查词（英汉双语）、语音朗读、例句提取。追踪“重复栽跟头”的顽固生词。
Insights & Analytics	估分与波动区间、多套综合水平、目标所需题数、CEFR 等级、错因分布雷达、分段耗时偏差分析。
What-if Simulator	分数实验台。模拟不同正确率下的得分走向，提前感知提分路径。
Engagement	游戏化激励。勋章系统（Achievements）、周报总结、练习活跃热力图。
Data Vault	JSON 高版本快照导出、极简压缩同步链接、二维码跨端传输。

页面路由

/              首页 — 新手指引、下一步建议、套题进度、考试倒计时
/practice      练习 — 计时 → 对答案 → 看结果，步骤条可回跳修改
/vocab         生词本 — 查词与记忆追踪
/insights      分析 — 估分、弱项、阅读用时、没做完的题
/vault         备份 — 下载 / 恢复备份文件、同步到其他设备、自动备份恢复

旧路由 /plan、/timer、/scores、/analytics、/unfinished 会永久重定向到上面对应的新页面。

推荐工作流

我们的设计鼓励一种 “专注 -> 诊断 -> 固化” 的循环：

1. Plan：在首页 / 的套题网格中选择当前的练习节点（如 R3 或 L5），再点一次即可进入训练。
2. Practice：进入 /practice 启动计时。阅读时点击 Part 卡片或按 空格 / → 切到下一题型、1–4 直接跳转，当前卡片实时显示「本 Part 用时 / 预算」，超预算变红。计时期间屏幕保持常亮，标签页标题同步显示剩余时间；中途切到别的页面，底部会出现「返回计时」浮标。
3. Review：交卷后填一下没来得及做的题数（按错题算，和真实考试一致），再对照答案填每个 Part 错了几题；错因和笔记可选（Ctrl/Cmd + Enter 保存）。没做完的题可以「继续做完」单独计时，看看时间充足时能拿几分，也可以直接跳过。保存后仍可通过步骤条或「修改错题数」回来调整。
4. Log Vocab：复盘页和结果页下方就有生词输入框，回车即查词并自动关联当前套题；更完整的整理在 /vocab 完成。
5. Result：结果页给出估分、与上一套同类题的分差，以及本套失分最多的 Part，一键进入下一套未完成的题。
6. Analyze：在 /insights 查看本次练习后的分数波动与弱项变化。
7. Sync：周期性在 /vault 生成同步链接，备份到移动端或备忘录。

技术栈

层级	关键选型
Framework	Next.js 16 (App Router) · React 19 · TypeScript
UX/UI	Tailwind CSS 4 · Framer Motion · Lucide Icons · Radix UI
State	Zustand (with Storage Persistence)
Data Viz	Recharts · SVG Heatmaps
Algorithm	分段插值换算 + 蒙题期望 + 近期加权平均（区间按 ±25 分测量误差 / √有效套数）
Sync	fflate (zlib) · base64url compression

快速开始

环境依赖

• Node.js 20+
• npm 10+

本地运行

git clone https://github.com/Chizukuo/toeic-tracker.git
cd toeic-tracker
npm install
npm run dev

访问 http://localhost:3000 即可开启你的冲刺。

可用脚本

• npm run dev: 开发模式，支持 HMR。
• npm run build: 生产构建，产物静态导出至 out/ 目录。
• npm run test: 运行 Vitest 单元测试（核心逻辑、同步、估分）。
• npm run lint: ESLint 代码质量检查。

环境变量

变量名	默认值	用途
NEXT_PUBLIC_SITE_URL	https://toeic.chizunet.cc	用于生成 canonical 链接、OG 图片地址与 sitemap

部署说明

本项目采用 SSG (Static Site Generation) 模式，不依赖任何服务端运行时。

• Cloudflare Pages: 推荐方案。设置构建命令为 npm run build，输出目录为 out。
• GitHub Pages / Vercel: 同样支持，确保启用静态导出模式即可。

已知边界

• 个人工具定位：本项目专注于个人冲刺提分，不提供公共账号系统或联网题库。
• 数据安全：由于数据仅存储在浏览器 localStorage，请务必养成在 /vault 导出备份的习惯。
• 估分参考：ETS 没有公开统一的换算表（每份试卷单独等化），这里的换算曲线是常见参考表的近似；单套题的测量误差约 ±25 分。估分仅供参考，不作为官方成绩保证。

License

MIT © 2026 chizukuo