liqianiiii 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
- 你不修改数据