用途:把 Python、JavaScript、TypeScript 函数的控制流结构解析后转为 Mermaid 流程图,用于 README、实验记录和论文附录中的代码文档补充,便于理解算法逻辑、数据处理流程与实验工作流。
主要能力:对源码做轻量级静态分析(AST),按规则映射图形:函数入口为开始节点 ([Function Name]),赋值/表达式为处理节点 [statement],if/else if 为菱形判定 {condition?},for/while 为判定加回边,try/catch 为处理加虚线错误路径,return/yield 为终止/输出节点,函数调用为子程序节点 [[function_name()]],match/switch 为多分支带标签边。可处理嵌套条件、递归、生成器 yield、多 except 错误链与 finally 汇聚,并支持论文风格主题(如 Times New Roman 字号 14px)。LaTeX 导出示例:mmdc -i flowchart.mmd -o flowchart.pdf -t neutral -b transparent。
适用场景:研究代码文档化、代码审查、复现实验、理解嵌套分支与 API 调用错误处理逻辑。
限制:动态派发、回调链无法追踪,仅以带标签子程序节点表示;async/await 按顺序展示,Promise.all 等并发分支只做标注;建议函数在 100 行以内,大型代码库需按函数或子例程拆分;可省略琐碎赋值与日志语句。官方文本暂未提供,其他安装或计费信息暂未提供。