ielts-dashboard

name	ielts-dashboard
description	启动本地 IELTS Dashboard。React + Vite，浏览器查看备考数据可视化。 触发方式：/ielts-dashboard、「打开仪表盘」「看看进度」「dashboard」
metadata	{"version":"3.0.0"}

IELTS Dashboard — 本地可视化仪表盘

你负责帮用户启动本地 Dashboard，查看所有备考数据的可视化。

---

执行步骤

Step 1：检查依赖

检查 dashboard/ 目录下是否有 node_modules/：

• 没有 → 运行 cd dashboard && npm install
• 有 → 跳过

Step 2：导出最新数据

运行 node scripts/data-export.js dashboard/public/data

这会把 ~/.ielts/ 下的所有数据导出为 JSON 文件，供 Dashboard 读取。

Step 3：启动开发服务器

运行 cd dashboard && npm run dev

Vite dev server 默认在 http://localhost:5173 启动。

Step 4：告知用户

Dashboard 已启动！

打开浏览器访问：http://localhost:5173

数据已从 ~/.ielts/ 导出。
如需刷新数据，运行：node scripts/data-export.js dashboard/public/data

关闭 Dashboard：在终端按 Ctrl+C

---

Dashboard 包含的模块

模块	数据	展示形式
考试倒计时	config.yaml	天数 + 目标分
写作分数趋势	writing.json	四维折线图
四科雷达图	stats.json	雷达图对比目标
阅读正确率	reading.json	折线图 + 题型分布饼图
听力正确率	listening.json	折线图 + 错因分布
错题热力图	errors.json	错误类型 × 日期
同义替换库	synonyms.json	可搜索表格
词库进度	vocabulary.json	掌握度分布 + 到期词数
备考计划	plan.json	每日任务清单

---

故障排除

端口被占用：

lsof -i :5173  # 查看占用进程
kill -9 {PID}  # 杀掉进程后重新启动

数据不显示：

• 确认 ~/.ielts/ 下有数据文件
• 重新运行 node scripts/data-export.js dashboard/public/data
• 刷新浏览器

npm install 失败：

• 确认 Node.js 版本 ≥ 18
• 删除 node_modules/ 和 package-lock.json 后重试

---

边界

• 你不负责数据训练——只负责启动 Dashboard
• Dashboard 数据是静态导出的，不会自动更新——需要手动运行 data-export.js
• 你不修改数据