今日改动一览
2026年6月10日，对博客背后的技能系统和一篇具体文章进行了多项调整。以下是完整记录。
一、Skill 重构：maki-math-blog-style → feynman-blog-compiler
背景
原有的 maki-math-blog-style 只是一个「格式模板指南」，告诉我用哪个引用块、KaTeX 怎么写、封面参数是什么。但它没有约束文章内容怎么写——导致之前的博客写出来像聊天记录堆砌，而不是一篇正经的教材/讲义。
改动
将 maki-math-blog-style 吸收合并为 feynman-blog-compiler，并删除了旧 skill。
新 skill 的核心升级：
| 维度 | 旧版 | 新版 |
|---|---|---|
| 文章结构 | 6 段自由骨架 | 4 个硬性板块（地图→精拆→实战→交锋） |
| 概念处理 | 简单放定义+例题 | 条件拆解表格 + 反例 + 易错预警 自动展开 |
| 推导要求 | 无硬性约束 | 禁止省略词 + 必须保留中间步骤 |
| 卡壳处理 | 散布在"注"里 | 💥 显式标记，交锋实录集中复盘 |
| 砍了「显然」「易得」 | ❌ 无限制 | ✅ 全文禁止出现 |
写入 skill 的硬性约束（以后每篇文章自动遵守）
- 中间步骤保留：所有通分、化简、泰勒展开到第几阶、等价无穷小替换，至少保留 1 步过渡公式
- 零省略词：全文不得出现「显然」「易得」「不难看出」「同理可得」
- 卡壳点显式标记：用 💥 标记费曼复习中被卡住的地方
二、Mermaid 主题定稿：手绘彩铅风 🎨
经历了漫长的配色试错后，最终确定所有 mermaid 图使用手绘彩铅风配色。
试错过程
mindmap 默认样式 → 太素，不美观
↓
graph TD + 手动 style → 树形太挤，字太小
↓
graph LR + subgraph → 横向排布仍然拥挤
↓
mindmap + 马卡龙渐变风 → 配色太甜腻
↓
mindmap + 夏日果汁风 → 用户说不是想要的效果
↓
mindmap + 冰蓝理工风 → 太冷淡
↓
mindmap + 手绘彩铅风 ✅ → 用户满意
定稿配色
%%{ init: { "theme": "base", "themeVariables": { "background": "#fffaf0", "primaryColor": "#e0bbff", "primaryTextColor": "#3c3c3c", "primaryBorderColor": "#b388eb", "lineColor": "#f694c1", "textColor": "#444", "mainBkg": "#caffbf", "secondaryColor": "#bdb2ff", "tertiaryColor": "#ffd6a5", "nodeBorder": "#a0c4ff", "nodeTextColor": "#333", "fontFamily": "Comic Sans MS, cursive", "fontSize": "18px" } } }%%
mindmap
root((手绘彩铅风))
淡紫 #e0bbff
薄荷绿 #caffbf
蜜瓜橙 #ffd6a5
天空蓝 #a0c4ff
粉线 #f694c1
- 字体 Comic Sans MS（手写感）
- 暖米色背景
#fffaf0 - 所有 mermaid 代码块顶部必须加
%%{ init }%%指令
学习地图固定用 mindmap
未来每篇博客的「今日学习地图」板块统一使用 mindmap 类型 + 手绘彩铅风配色，不再尝试其他布局。
三、踩坑修复：$$ 不能放在 blockquote 内部
症状
文章发布后发现连续定义的公式渲染出多余 > 符号：
> \lim_{x \to x_0} f(x) = f(x_0) >
根因
这是 Goldmark passthrough + blockquote 不兼容 的经典陷阱——$$ 放在 blockquote 里面时，> 会被包含进 passthrough 块，KaTeX 读到 > \lim ... > 报语法错误。
修复范围
在文章中排查并修复了 6 处 $$ 在 blockquote 内的写法：
| 位置 | 内容 |
|---|---|
| 连续的定义 | \lim_{x \to x_0} f(x) = f(x_0) |
| 例1.71 题目 | 分段函数 cases 环境 |
| 补充题 | 1 - \cos(xf(x)) 极限 |
| 例1.75 题目 | 分式函数 |
修复方式：将 $$ 块从 blockquote 中拆出，用空行隔开。
以后写文章时所有 $$ 独立公式不得放在 blockquote 内部——skill 中已有此陷阱记录，但自己写文章时仍然踩了，说明需要在后处理检查清单里也加上这一项。
四、后处理检查清单更新
在 feynman-blog-compiler 的检查清单中新增了一条：
- [ ] `$$` 没有放在 blockquote 内部（最常见无声错误）
同时确认已有检查项：
- front matter 有
math: true - front matter 有
mermaid: true - 全文无「显然」「易得」「不难看出」「同理可得」
- 所有中间步骤至少有 1 步过渡公式
- 卡壳点已用 💥 标记
总结
这次改造的核心是把写博客这件事从’自由发挥’变成了’有规范约束的流程’。以后每篇费曼复习的博客都会自动遵守这套规范，质量和一致性有了保障。
附：当前博客技能树
feynman-blog-compiler— 费曼对话→博客的编译流水线（writing）hugo-blog-management— Hugo 构建/发布/排障（software-development）feynman-flow— 费曼学习法互动流程（通用）
