《视光学与眼镜科普》读者视角问题清单

检查时间:2026-06-04 复核时间:2026-06-04

检查范围:content/courses/zh-cn/vision-science 下的课程入口、章节索引和主要 MDX 课文。以下问题从读者学习体验出发整理,优先级越高,越可能直接导致读者中断阅读、误解知识或不信任课程。

P0:会直接阻断学习的问题

暂未发现会直接阻断学习的 P0 问题。

P1:结构和学习路径问题

4 个章节索引页缺少导读 ✅ 已核实:不存在

经核实,4 个章节索引页均已有导读文字:

  • optics-basics/index.mdx — 含”你会学到”列表(折射、透镜成像、眼球光学系统)
  • prescription/index.mdx — 含流程概述(验光 → 读单 → 选镜)
  • refractive-errors/index.mdx — 含四类屈光不正的简要说明
  • correction/index.mdx — 含矫正方案概述(框架、隐形、近视防控、手术)

结论:无需修复。

3 个页面文字依赖图示但没有实际图片 ✅ 已核实:不存在

经核实,3 个页面均使用了 Vue 组件渲染内联 SVG 图示:

  • correction/glasses-principles.mdx — 引用 <LightPathDiagram mode="myopia">(凹透镜矫正光路 SVG)
  • optics-basics/eye-structure.mdx — 引用 <EyeStructureDiagram>(眼球剖面 SVG,含角膜、晶状体、视网膜、黄斑标注)
  • refractive-errors/myopia.mdx — 引用 <LightPathDiagram mode="myopia">(近视光路 SVG)

组件文件位于 components/LightPathDiagram.vuecomponents/EyeStructureDiagram.vue,均包含完整的 SVG 绘制和文字说明。

结论:无需修复。

1 个练习页缺少答案或反馈 ✅ 已修复

受影响文件:

  • prescription/reading-prescriptions.mdx

原问题:页面包含 1 个验光单解读示例,但没有供读者自测的练习题和答案。

修复内容: 将原有示例保留为练习 3,并新增练习 1(单纯近视无散光)和练习 2(远视+散光+ADD),每题均提供 <details> 折叠的参考答案与关键提示。

6 个同级页面共享相同 order ✅ 已修复(部分)

经核实,实际冲突为 3 处(每个目录的 index 页与子页面 order 重复),而非 6 处:

目录修复前修复后
optics-basics/index=1, light-refraction=1index=0, light-refraction=1
prescription/index=3, lens-selection=3index=0, lens-selection=3
refractive-errors/index=2, hyperopia=2index=0, hyperopia=2

correction/ 目录无冲突(index=4,子页面为 1/2/3)。

P2:阅读体验问题

图像和可视化资源偏少 ✅ 已核实:不准确

原报告称”18 个 MDX 页面,图片引用约 0 处”。实际情况:

  • 3 个核心概念页(eye-structure.mdxmyopia.mdxglasses-principles.mdx)均使用 Vue 组件渲染了完整的 SVG 图示
  • 组件包含交互式的模式切换(正视 vs 近视)和结构化标注

结论:核心页面已有图示覆盖,当前资源密度对本科普课程可接受。 如需进一步增强,可考虑为 lenses.mdx(透镜成像)和 astigmatism.mdx(散光焦线)补充图示。

修复记录

#问题状态修改文件
1练习页缺少答案✅ 已修复prescription/reading-prescriptions.mdx
2optics-basics order 冲突✅ 已修复optics-basics/index.mdx
3prescription order 冲突✅ 已修复prescription/index.mdx
4refractive-errors order 冲突✅ 已修复refractive-errors/index.mdx