《一个圆的数学漫游》读者视角问题清单

检查时间：2026-06-04

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

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

1. 多个页面仍是空骨架，读者点进去没有可学习内容

受影响文件：

• zh-cn/functions-and-circle/piecewise-functions.mdx
• zh-cn/series-representation/leibniz-series.mdx
• zh-cn/series-representation/power-series-trigonometric.mdx
• zh-cn/multivariable-calculus/directional-derivatives.mdx

这些页面只有 frontmatter、标题和四个固定小节标题（“问题提出 / 观察与猜想 / 严格证明 / 结论与应用”），正文为空。读者在课程中途点到这些页面，会以为内容加载失败或课程未完成。

建议：要么补齐正文、例题和总结，要么先从导航中隐藏这些页面。尤其 leibniz-series.mdx 和 power-series-trigonometric.mdx 位于“π 的级数表示”章节核心路径中，缺失会让该章节的知识链断开。

2. multivariable-functions.mdx 会把元数据渲染到正文中

受影响文件：zh-cn/multivariable-calculus/multivariable-functions.mdx

该文件在 frontmatter 和 import 之后，又出现了一段裸露的：

lastChecked: ...
title: 多元函数与圆
description: ...
order: 63
---

从读者视角看，这些会变成正文里的奇怪文本，破坏页面开头的专业感，也容易让人误以为页面解析出错。

建议：删除第二段重复元数据和多余的 ---。

3. approximating-pi-with-sequences.mdx 中夹逼证明存在数学错误

受影响文件：zh-cn/sequences-limits-pi/approximating-pi-with-sequences.mdx

页面在证明 lim(sin x / x) = 1 时写道：

• 角 x 的弧长为 x
• 弦长为 2 sin x
• 切线段长为 2 tan x
• 因此 2 sin x < x < 2 tan x

这里角度、弦长和切线段的对应关系不一致。对很小的正 x，2 sin x 约等于 2x，不可能小于 x。后续虽然形式上推出了正确结论，但中间不等式是错的，读者只要代入一个小角度就会发现证明站不住。

建议：改成标准单位圆面积夹逼证明：sin x < x < tan x，再推出 cos x < sin x / x < 1。同课程的 measurement/circumference-formula.mdx 已使用了更正确的面积夹逼写法，可以复用那里的解释。

P1：结构和学习路径问题

4. 课程整体跨度过大，但入口没有说明适合读者和前置知识

课程从“什么是圆”很快扩展到：

• 极限、级数、幂级数
• 隐函数、参数方程求导、曲率
• 二重积分、三重积分、曲线积分
• 线性变换、圆锥曲线
• π 的无理性、超越性
• 傅里叶级数、复数与欧拉公式

但课程首页只写了故事设定和“必须证明”的要求，没有告诉读者需要哪些数学基础，也没有给出“初中/高中/大学”分层路径。读者可能从基础几何进入后，突然遇到高等数学主题而失去方向。

建议：在课程首页增加“适合读者”“前置知识”“推荐路径”。例如分成基础路线、解析几何路线、微积分路线、拓展阅读路线，而不是默认线性读完全课。

5. 章节索引页几乎都是空页

受影响文件：各章节下的 index.mdx，例如：

• zh-cn/geometric-basics/index.mdx
• zh-cn/measurement/index.mdx
• zh-cn/functions-and-circle/index.mdx
• zh-cn/trigonometric-functions/index.mdx
• zh-cn/integral-calculus/index.mdx
• zh-cn/advanced-applications/index.mdx

这些索引页基本只有 frontmatter 和 # {frontmatter.title}。读者进入章节页时，得不到本章目标、知识地图、先后依赖或章节导读。

建议：每个章节索引至少补充三类信息：本章要解决的问题、读完后应掌握什么、建议先读/可跳过哪些小节。

6. order 同时用于章节和文章，可能导致导航顺序混乱

示例：

• geometric-basics/index.mdx 的 order: 1，同章节下 basic-definition.mdx 也是 order: 1
• 课程入口 zh-cn/index.mdx 是 order: 10，而 functions-and-circle/piecewise-functions.mdx 和 integral-calculus/index.mdx 也有 order: 10
• 多个章节索引和文章共享相同 order，例如 measurement/index.mdx 与 geometric-basics/basic-elements.mdx 都是 order: 2

如果站点按全局 order 排序，读者可能看到章节页和文章页交错出现；如果按目录局部排序，也会出现同级顺序不稳定。

建议：明确导航排序规则。章节索引用独立层级排序，文章用章节内排序；或者把全局课程序号和章节内序号拆成两个字段。

7. 部分标题承诺和实际内容不匹配

受影响文件：zh-cn/series-representation/geometric-series-pi.mdx

标题是“几何级数与π”，但正文真正用于 π 的是反正切级数/莱布尼茨级数。几何级数只是开场介绍，后面并没有形成“几何级数如何计算 π”的主线。读者会觉得标题误导。

建议：要么改标题为“从几何级数到反正切级数”，要么重写正文，让几何级数确实承担推导角色。当前空缺的 leibniz-series.mdx 也应和该页重新分工，避免重复或错位。

P1：表达和证明确认问题

8. 多处“严格证明”实际上依赖未证明结论

示例：

• measurement/discovering-pi.mdx 在“严格证明”里接受“所有圆相似”作为几何事实。
• sequences-limits-pi/area-formula-with-limits.mdx 用“内接正多边形面积小于圆面积（显然）”和“内外接多边形趋向同一极限”支撑面积定义。
• integral-calculus/revolution-surface-area.mdx 把证明交给“参数积分或者 Pappus-Guldin 定理”。
• trigonometric-functions/trigonometric-identities.mdx 写“详细推导涉及较多几何知识，此处略去”。

课程设定强调“结论必须给出证明”，但这些页面会让读者感觉承诺和正文不一致。

建议：把“严格证明”分层：如果暂时引用结论，应明确标注为“暂用定理/后续证明/超出本课范围”，并给出最少的直观理由和后续链接。不要把未证明的关键步骤放在“严格证明”标题下。

9. 高阶主题解释过快，缺少过渡台阶

典型页面：

• pi-deep-exploration/pi-irrational-proof.mdx
• pi-deep-exploration/pi-transcendental.mdx
• advanced-applications/fourier-series.mdx
• multivariable-calculus/line-integral-circumference.mdx

这些内容对没有大学数学背景的读者要求很高，但页面仍沿用基础课的叙事节奏，概念往往被快速定义后直接计算。读者容易“字都认识，但不知道为什么要这样做”。

建议：高阶章节增加“本节只看思想 / 完整证明需要哪些工具 / 读者可以跳过哪些技术细节”的提示。对无理性、超越性、傅里叶等主题，优先讲清问题价值和证明路线，再进入符号推导。

P2：阅读体验问题

10. 课程大量依赖“画图/观察图像”，但正文几乎没有配套图

检查结果：除引言的 2 张 SVG 和 sector-area-integral.mdx 的 1 张 placeholder 图片外，主要数学课文基本没有实际图像资源。

读者会在多处看到“我在黑板上画了图”“观察图像”“如下图”一类表达，但页面没有图。例如圆与直线位置关系、圆的位置关系、三角函数图像、参数方程、极坐标、向量、积分面积元等内容都高度依赖图形。

建议：优先为基础几何、三角函数、解析几何、微积分面积元补图。每张图都应配短说明，避免只靠文字描述空间关系。

11. 存在外部 placeholder 图片

受影响文件：zh-cn/integral-calculus/sector-area-integral.mdx

该页使用：

https://via.placeholder.com/300x200/4CAF50/FFFFFF?text=Polar+Area+Element

这会让读者看到占位素材而不是课程图。外部 placeholder 还可能因为网络或服务不可用导致图片加载失败。

建议：替换为本地课程图，或用站内组件/绘图资源生成极坐标面积元素示意图。

12. 练习缺少答案或反馈机制

课程里有一些“练习”“留给同学们”的内容，例如：

• analytic-representation/circle-equation.mdx 有口答练习
• vector-representation/vector-operations.mdx 有课后练习
• multivariable-calculus/triple-integral-sphere.mdx 写“计算过程留给同学们作为练习”

但多数练习没有答案、提示、常见错误或自检标准。读者自学时无法判断自己是否做对。

建议：每个练习至少提供答案折叠区；较难题提供提示、关键步骤和最终结果。

13. 叙事口吻不够统一，部分页面像由不同风格拼接

前几节建立了“呼噜星球”“外星学生要求证明”的课程设定，但后续有些页面使用更泛化的教材口吻，有些页面又重新用“大家好，我是地球老师”开场。高阶章节中反复介绍同一设定，会打断连续阅读。

建议：统一叙事规则。每章可以短暂回到故事，但不要每页都重新开场；技术密集页应减少重复寒暄，把叙事用于提出问题和总结洞见。

14. 页面长度差异极大，阅读节奏不稳定

有的核心页面超过 700 行，例如：

• analytic-representation/circle-equation.mdx
• analytic-representation/standard-general-equation.mdx
• geometric-basics/line-circle-positions.mdx

也有 18-19 行的空骨架页面。长页面中经常包含多个可独立成课的概念，短页面则完全没有内容。读者会遇到一会儿信息过载、一会儿内容缺失的问题。

建议：把超过 500 行的页面拆成更小主题，或增加页内目录、阶段小结和练习；空骨架页面先隐藏或补齐。

建议修复顺序

1. 先修复 P0：补齐/隐藏空骨架页面，删除 multivariable-functions.mdx 的重复元数据，修正 sin x / x 证明。
2. 再补课程入口和章节索引：明确前置知识、读者路径和每章目标。
3. 处理图像缺失：优先补基础几何、三角函数、解析几何和积分面积元图。
4. 统一“严格证明”的标准：引用未证结论时给出标注和后续链接。
5. 最后做全课节奏整理：拆分超长页面，补答案，统一叙事口吻。