这是 Beta 课程,内容结构、章节安排和示例可能会继续调整。
《视光学与眼镜科普》读者视角问题清单
检查时间: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.vue 和 components/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=1 | index=0, light-refraction=1 |
prescription/ | index=3, lens-selection=3 | index=0, lens-selection=3 |
refractive-errors/ | index=2, hyperopia=2 | index=0, hyperopia=2 |
correction/ 目录无冲突(index=4,子页面为 1/2/3)。
P2:阅读体验问题
图像和可视化资源偏少 ✅ 已核实:不准确
原报告称”18 个 MDX 页面,图片引用约 0 处”。实际情况:
- 3 个核心概念页(
eye-structure.mdx、myopia.mdx、glasses-principles.mdx)均使用 Vue 组件渲染了完整的 SVG 图示 - 组件包含交互式的模式切换(正视 vs 近视)和结构化标注
结论:核心页面已有图示覆盖,当前资源密度对本科普课程可接受。 如需进一步增强,可考虑为 lenses.mdx(透镜成像)和 astigmatism.mdx(散光焦线)补充图示。
修复记录
| # | 问题 | 状态 | 修改文件 |
|---|---|---|---|
| 1 | 练习页缺少答案 | ✅ 已修复 | prescription/reading-prescriptions.mdx |
| 2 | optics-basics order 冲突 | ✅ 已修复 | optics-basics/index.mdx |
| 3 | prescription order 冲突 | ✅ 已修复 | prescription/index.mdx |
| 4 | refractive-errors order 冲突 | ✅ 已修复 | refractive-errors/index.mdx |
