内容优先 Markmap 思维导图

把项目、文档、代码库或概念整理成可以用 Markmap 渲染的 Markdown，并在需要时校验结构、生成 HTML。

核心规则

• 先整体后局部：根主题说明对象和目的，再展开真实主概念、流程、模块和细节。
• 用材料本身组织导图。不要为了照顾小白阅读而发明空泛分类标题。
• 去掉只起分类作用的标题，例如“项目定位”“运行机制”“开发版图”“核心概念”“主要模块”“使用场景”等，除非这些词本来就是原文的一部分。
• 每个节点的直接子节点默认最多 5 个，这是默认硬约束，不是建议值。
• 只有用户明确声明“可以更多分支/可以超过 5 个/最多 N 个”时，才允许提高上限；提高后仍应尽量克制。
• 不要因为真实内容很多就平铺超过 5 个分支；应按材料里的真实子主题继续分组。
• 如果某个层级看起来需要超过 5 个分支，先合并相近内容，再按“整体 -> 分组 -> 局部细节”重排。
• 类比是可选的。只有确实帮助记忆时才使用，并放在内容标签之后；不能让类比变成节点主体。
• 不要编造确定性。总结仓库前先看 README、文档、包配置、测试、源码目录和本地脚本。
• 保持导图简洁。节点用短内容标签，必要时补一句有依据的说明。

处理复杂仓库或长文档时，先读 references/analogy-structure.md。