技术知识生动讲解

为什么技术文档往往难以理解？

我们在阅读框架文档或论文时，经常遇到全是公式和专业术语的说明。这种纯文字描述很难建立直觉，导致读完后依然无法向他人复述核心逻辑。根本原因在于传统写作忽略了视觉化呈现和认知降维。

核心机制：七层讲透法

该技能通过一套结构化工作流生成教学页面。它不只输出 Markdown，而是产出自包含的 .html 文件，内联 CSS 和 SVG 矢量图，实现零依赖离线阅读。

• 直觉优先：禁止一上来堆砌术语。必须先用精准的生活比喻（如用列竖式类比 CoT）建立初步认知，再展开机制。
• 图是骨架：依据概念特征（数据流、对比、结构）生成对应图表。所有图形内联 SVG，包含明确的文字标签，支持指向性讲解。
• 横向对比：新概念总是相对旧方法的改进。通过并排对比图和表格，直观展示演进差异。
• 记忆锚点：提炼一句话本质、口诀或易错点，确保读者能三句话内讲清核心逻辑。

适用边界与注意事项

• 无需安装依赖：生成的文件无外部 CDN 引用，双击即可打开，支持直接打印为 PDF。
• 复杂度自适应：七层结构非强制。简单概念合并层级即可，避免注水。
• 模板依赖：生成前需读取 assets/explainer-template.html 获取统一配色和版式。请确保当前工作目录允许写入文件。
• 非万能的：不适用于超长篇学术综述或需要精确数学证明的场景，更适合概念入门和心智模型构建。