SuperAPI AI 工具集

code_flow_graph

编程与开发

查看项目

更新于 11-02 01:29

技能介绍

用途

Code Flow Graph 是一个代码结构可视化技能,能够生成交互式 HTML 节点图,帮助开发者理解代码库的模块组织、类关系、函数调用链以及 UI 事件流。它适用于需要快速掌握项目架构、追踪调用路径或梳理 UI 事件分发的场景。

主要能力

  • 交互式节点图:生成模块级依赖图(Overview),展示主要模块/类、入口点、跨模块连接和包分组。
  • 函数调用链分析:针对指定入口函数,生成完整的调用链图,区分内部调用、跨模块调用,并过滤低价值函数。
  • UI 信号/事件分析(仅 UI 项目):可视化事件处理器到业务逻辑的连线。
  • UI 布局层级图(仅 UI 项目):生成可交互的 Widget 层级树,支持拖拽调整、撤销。
  • 智能过滤:基于扇出/扇入、分支逻辑、状态变更等规则筛选关键函数,避免噪声。
  • 增强交互:Ctrl+K 搜索模糊匹配函数名并跨图跳转;折叠子项时连线自动重定向;点击空白取消高亮;节点类型徽章与外部依赖标记;签名悬停提示;调用链详情面板(显示函数描述,点击节点可定位);数据字段详情面板;节点位置按图持久化到 localStorage;点击函数属性自动复制名称;Ctrl+Z 撤销布局移动。

使用方式

  1. 分析项目与确定范围:无需预先提问,立即读取项目顶层结构、入口脚本、配置文件,判断是否有 UI 层,识别主要模块与入口点,评估函数重要性。
  2. 创建输出文件夹:默认在项目 docs/code_graph/ 下创建输出目录,可自定义。
  3. 复制 HTML 引擎:从技能目录的 example/code_flow_graph.html 读取模板,原样写入输出文件夹,不修改内容。
  4. 生成概览图:创建 code_flow_graph_data.js,包含模块级依赖图,遵循数据格式规范。
  5. 验证与展示:检查 JS 语法,清理多余文件,在浏览器中打开 HTML。
  6. 提供深度分析选项:根据发现的入口点动态生成选项(如调用链分析、UI 事件分析、UI 布局可视化、数据结构分析、自定义),等待用户选择。
  7. 增量生成深度图:读取已有数据文件,追加新的图条目,保留原有内容。

适用场景

  • 新成员快速理解项目架构。
  • 追踪特定函数的调用路径与副作用。
  • 梳理 UI 事件绑定与分发逻辑。
  • 可视化 UI 界面布局层级。
  • 分析数据结构的生成与传递链路。

限制

  • 输出为两个文件:code_flow_graph.html(渲染引擎)和 code_flow_graph_data.js(图数据),必须位于同一目录。
  • HTML 模板来自技能仓库,不在用户项目中,需使用绝对路径读取。
  • 默认使用中文生成描述文本,可应要求切换语言。
  • 函数过滤规则可能排除部分辅助函数,但可通过折叠子项形式保留在调用者属性中。
  • 深度分析需用户选择后增量生成,不自动全量生成。
  • UI 布局可视化仅适用于有 UI 层的项目。
  • 未提及收费、价格或平台限制信息,暂未提供。