代码可视化

读代码时缺的不是注释，而是「结构」

接手遗留模块、刷题复盘或评审 PR 时，你往往要在脑子里重建控制流和数据怎么变。口头描述容易漏分支，纯贴代码又看不出 O(n²) 从哪一层嵌套来的。这个技能把「读懂一段代码」拆成可检查的流水线，最终落成一份可分享的 Markdown 分析文档。

六阶段工作流在做什么

1. 输入预处理：区分单段代码、多文件粘贴或路径；记录「重点关注」；识别是否进入对比模式（两段代码 A/B）。
2. 语言与特征：按扩展名与关键字推断语言；抽取函数/类、依赖、核心数据结构与控制流特征。
3. 逻辑分析：一句话意图、算法类型、关键变量与边界、输入输出关系。
4. 可视化：必选 Mermaid flowchart（多函数时用子图或调用关系图）；按数据结构类型画变化过程（数组步进、链表 ASCII、树缩进等）；超过约 100 行可补模块依赖图。
5. 复杂度：逐段说明循环/递归代价，给出推导过程，再写最坏/平均/最好情况；空间含栈与辅助结构。
6. 质量与解读：温和审查反模式（重复、魔法数、深嵌套等）并附改进建议；按 3～5 行一组做逐行解读，算法关键点用标记突出。

对比模式下，在流程图之后增加差异与等价性分析章节。

适用边界

• 输出质量依赖模型对代码的真实理解；无法确认的逻辑会标注需用户确认，而不是硬编故事。
• Mermaid 必须可在 mermaid.live 渲染——节点 ID、转义与子图 end 是硬性要求。
• 行数很少时会写得更细，上百行则侧重架构与主路径，避免逐行灌水。