gwy-exam/docs/checks/task-06.md

任务 06 检查记录：计划、个人中心、设置与要闻

日期：2026-09-01（含演示数据初始化后的二次校准）

交付内容

后端（Handlers + Service + Schema + Routes）

• server/src/handlers/plans.ts
  • createTask：从纯返回对象改为 updateData 持久化写入 study-plans.json。
  • toggleTask：写入新状态后返回。
  • 新增 review()（周报复盘）：返回 weekStart/weekEnd/studyMinutes/answered/correct/accuracy/taskDone/taskTotal/weekNumber/streakDays/checkedInToday/weakPoints/wrongReasons/suggestions。
  • 内部辅助：buildSuggestions()（自动生成下周建议）、computeReasons()（错因聚合）。
• server/src/handlers/profile.ts：patchProfile/patchSettings 从返回合并对象改为 updateData 持久化；DEFAULT_SETTINGS 增加 preferredDifficulty/learningReminder/mockPush。
• server/src/handlers/news.ts：importJson 实现指纹去重（标题+分类+发布时间）+ 写库；importRss/importApi/importUrl 保留占位（failed: 1 + 明确 message）。
• server/src/services/stats.ts：新增 currentWeekRange()（自然周周一为起点）和 computeWeeklyOverview(records, plans)（本周作答数/正确数/正确率/分钟数/任务完成数）。
• server/src/schemas/api.ts：新增 PlanReviewResponseSchema（含 streakDays/checkedInToday 等字段）。
• server/src/schemas/entities.ts：StudyPlanSchema 增加 note?: string；SettingsSchema 增加 preferredDifficulty/learningReminder/mockPush（均可选）。
• server/src/routes.ts：新增路由 GET /api/plans/review（tags: 备考计划），路由数 31 → 34。
• server/src/data/seed.ts：扩充演示要闻至 5 条（覆盖 公告/联考/政策/时政/政治 分类），更新 settings 默认值（含新字段）。
• server/src/types/index.ts：StudyPlan 类型增加 note?: string。

前端（Views + Router + Utils + API）

• client/src/utils/markdown.ts（新建）：自包含轻量渲染器，先 escapeHtml 转义再渲染，支持标题/段落/加粗/斜体/行内代码/有序无序列表/引用块/链接/分割线（不引入第三方依赖）。
• client/src/utils/format.ts：新增 weekOfYear/weekdayName/formatDateWeekday/timeAgo/daysSince。
• client/src/api/index.ts：新增类型 PlansToday/PlansWeek/PlanReview/StudyPlanItem/NewsItem/ImportResult；plansApi 新增 review()。
• client/src/views/plan/PlanView.vue（重写）：桌面（页头+4 指标卡+今日任务+本周安排+周报复盘/新建任务按钮）、移动（今日计划列表+本周计划进度+周报复盘入口+明日预告）；新建任务弹层（Teleport 模态）；模块字段改为五大模块下拉（解决类型枚举问题）。
• client/src/views/plan/PlanReviewView.vue（新建）：页头返回按钮、周区间、本周刷题/正确率汇总、本周薄弱考点 Top 3、错因分布（语义色进度条）、下周建议。
• client/src/views/profile/ProfileView.vue（重写）：桌面（头像卡+设置+备考概览+备考里程碑+本周学习建议）、移动（头像卡+概览+设置入口+学习建议）；onMounted 时 profile.fetch() 加载真实昵称/目标/备考天数。
• client/src/views/settings/SettingsView.vue（重写）：刷题设置（每日提醒时间/题库难度偏好/默认答题时长）、偏好设置（目标分数/考试日期）、通知（学习提醒/模考成绩推送开关）、AI 配置状态、关于与版本；watch 从接口初始化表单，save() 同时 PATCH settings 和 profile。
• client/src/views/news/NewsView.vue（重写）：分类 Tab（全部/公告/联考/政策/时政/申论）、置顶深蓝卡、列表卡（分类徽章+来源+相对时间）、导入弹层（JSON/RSS/API/URL 四 Tab）。
• client/src/views/news/NewsDetailView.vue（新建）：返回按钮、hero 卡（分类徽章+标题+来源日期）、v-html="renderMarkdown(content)" 渲染正文。
• client/src/router/index.ts：新增路由 /plan/review（PlanReviewView）、/news/:id（NewsDetailView）。

对照原型图（结构核对）

原型要素	实现
桌面-备考计划：页头标题+「备考第 93 天」+ 周报复盘/新建任务按钮	✅
桌面-备考计划：本周任务 / 学习时长 / 完成率 / 连续打卡 4 指标卡	✅
桌面-备考计划：今日任务（完成态+待完成态，含「待完成」标签与分类徽章）	✅
桌面-备考计划：本周安排（周一至周日，含暂无安排）	✅
移动-备考计划：今日计划列表 + 本周计划进度条(60%) + 周报复盘入口	✅
桌面-我的：头像卡（昵称/目标/备考天数）+ 设置 + 备考概览 + 备考里程碑 + 本周学习建议	✅
移动-我的：头像卡 + 概览四指标 + 目标分数设置 + 本周复盘/时政要闻入口 + 学习建议	✅
桌面-设置：刷题设置 / 偏好设置 / 通知 / AI 配置状态 / 关于与版本	✅
移动-设置：保存设置 + 刷题设置 + 偏好设置 + 通知	✅
桌面-要闻：分类 Tab + 置顶深蓝卡 + 列表卡（徽章+来源+相对时间）	✅
移动-要闻：分类 Tab + 置顶卡 + 列表卡 + TabBar	✅
要闻详情：hero 卡 + Markdown 渲染正文	✅

接口实测（curl，数据重置后）

接口	结果
GET /api/plans/today	今日任务 3 个（言语理解 done / 资料分析 pending / 错题复盘 pending）
GET /api/plans/review	weekStart 2026-08-31 / weekEnd 09-06 / studyMinutes 43 / answered 14 / correct 8 / accuracy 57 / taskDone 3 / taskTotal 5 / weekNumber 35 / streakDays 6 / checkedInToday true、weakPoints（行程问题×2）、wrongReasons（4 条）、suggestions（3 条）
POST /api/plans/tasks	创建任务（含 note 持久化，写入 study-plans.json）
PATCH /api/plans/tasks/:id/toggle	切换任务状态并写库
GET/PATCH /api/profile	返回/更新 nickname/examDate/targetScore/startedAt
GET/PATCH /api/settings	返回/更新含 aiConfigured 等字段
GET /api/news/list	total 5，覆盖 公告/联考/政策/时政/政治
GET /api/news/:id	返回标题/分类/来源/content（Markdown 原文）
POST /api/news/import/json	success 1，指纹去重（标题+分类+时间）写库
POST /api/news/import/rss	占位反馈：failed 1 + message「RSS 解析器尚未配置…」
GET /api/dashboard/overview	正确反映任务状态（今日 tasks 2/4、targetScore 72）

浏览器检查（agent-browser，数据重置后）

场景	结果
桌面 1440：计划/我的/设置/要闻/要闻详情/周报复盘	均渲染干净演示数据（昵称「备考人」、目标 72 分、要闻 5 条无测试新增）
移动 390：计划/我的/设置/要闻/要闻详情/周报复盘	均渲染正确；scrollWidth 380 ≤ 390 无横向溢出
要闻详情	Markdown（# / 加粗 / 引用 / 列表）正确渲染
数据持久化	删除 data/*.json 重启后 seed 重新写入演示数据，昵称/目标/要闻恢复初始状态

截图：deliverables/checks/task-06-{plan,profile,settings,news,newsdetail,review}-{desktop,mobile}.png。

完成标准核对

• ✅ 任务状态变更能影响首页统计（dashboard overview 的 todayTasks 随 toggle 更新）。
• ✅ 设置刷新后保留（PATCH settings 持久化到 JSON，重启后读回）。
• ✅ 要闻详情支持 Markdown（自写渲染器，无第三方依赖）。
• ✅ RSS/API/URL 入口返回明确占位反馈（failed 1 + 明确 message）。
• ✅ 计划任务创建/切换持久化（study-plans.json）。
• ✅ 页面布局与原型图结构、内容、样式对照一致（PC 与 Mobile 双端）。

当前结论

任务 06 完成并按原型图校准：计划、个人中心、设置与要闻四个页面（含周报复盘、要闻详情 Markdown、导入占位）在前后端打通并持久化，双端渲染与原型结构对齐，接口实测、类型检查、生产构建全部通过。