Code To Mindmap — 代码思维导图

代码转思维导图 使用时机： (1) 用户粘贴源代码并希望将其可视化为思维导图、节点图或树状图。 (2) 用户说“以思维导图显示”，“绘制架构”，“为此代码创建流程图”，或“可视化结构”。 (3) 用户希望通过可视化结构来理解陌生的代码库。 核心位置 此技能解决了代码结构难以从原始文本中理解的问题——可视化地图可以一眼显示关系、层次和架构。 此技能不是： 代码文档工具——它生成可视化图表，而不是书面文档 UML 类图工具——使用 PlantUML 来显示详细的类关系 代码格式化工具——它不改变源代码 此技能仅在以下情况下激活： 源代码 + 可视化意图同时存在。 模式 /code-to-mindmap 默认模式。解析源代码并输出兼容 Mermaid 的思维导图或图表。 使用时机：用户提供代码并希望获得可视化结构图表。 /code-to-mindmap/hierarchy 输出显示文件/文件夹层次的树状图，而不分析导入。 使用时机：用户希望看到项目结构，而不是代码关系。 执行步骤 步骤 1 — 解析代码结构 接收源代码（单个文件、代码片段或多文件内容） 检测语言和框架： Python：解析 def、class、import、async def JavaScript/TypeScript：解析 function、const、class、import、export Go：解析 func、type、struct、package 通用：检测类定义、函数定义、模块级声明 识别： 入口点（main、app、index） 类/结构名称及其方法 顶级函数 跨文件依赖（导入/要求语句） 构建层次树：模块 → 类 → 方法 → 嵌套逻辑 步骤 2 — 选择图表类型 代码形状 图表类型 单个文件、类密集 思维导图（中心 = 类，分支 = 方法） 多个文件、导入依赖 图表（节点 = 文件，边 = 导入） 层次目录 树/流程图 状态机或流程 状态图 调用图（谁调用谁） 流程图/有向图 步骤 3 — 生成图表 输出为 Mermaid 思维导图或图表 LR 格式： mindmap 根((代码)) 类名 方法一 方法二 嵌套助手 另一个类 处理程序 对于大型代码库（>20 个节点），总结：仅显示顶级结构，并注明更深的节点存在。 步骤 4 — 验证 所有检测到的类/函数都显示为节点 根/入口点明确标记为中心 没有虚构的节点（仅来自实际代码） Mermaid 语法有效且可渲染 强制规则 不允许： 虚构方法名称、类名称或不在代码中的关系 在单个图表中渲染 >30 个节点（拆分为子图表） 用图表注释替换源代码注释 不允许为伪代码或算法描述激活（无实际代码） 使用语言的实际语法来检测结构 使用函数签名标记节点以消除歧义（例如，calculate_sum(nums: list) -> int） 将外部库调用与项目内部调用区分开来 保留根入口点作为图表中心 质量标准 良好的输出： 提供的代码中的每个类和函数都显示为标记的节点 关系（调用、导入、继承）表示为边 图表是有效的 Mermaid 且渲染正确 入口点在视觉上是不同的（中心或顶部） 不良输出： 添加不在源代码中的类或方法 渲染 >30 个节点，使图表不可读 误表示调用方向（A 调用 B 显示为 B 调用 A） 输出不是有效的 Mermaid 语法 良好与不良示例 场景 不良输出 良好输出 单个 Python 类 所有方法列出为平面无层次结构 中心 = 类名，方法为子节点 多个文件项目 一个巨大的图表，包含 50 个节点 每个模块的多个子图表 导入标准库 以内部依赖处理 标记为不同（虚线边框） 匿名/lambda 函数 省略 列为“匿名/lambda” 参考 参考/ — Mermaid 思维导图语法指南、语言特定解析模式、代码架构模式 脚本/render.py — 将 Mermaid 图表渲染为 PNG/SVG