用途
Code Flow Graph 是一个代码结构可视化技能,能够生成交互式 HTML 节点图,帮助开发者理解代码库的模块组织、类关系、函数调用链以及 UI 事件流。它适用于需要快速掌握项目架构、追踪调用路径或梳理 UI 事件分发的场景。
主要能力
- 交互式节点图:生成模块级依赖图(Overview),展示主要模块/类、入口点、跨模块连接和包分组。
- 函数调用链分析:针对指定入口函数,生成完整的调用链图,区分内部调用、跨模块调用,并过滤低价值函数。
- UI 信号/事件分析(仅 UI 项目):可视化事件处理器到业务逻辑的连线。
- UI 布局层级图(仅 UI 项目):生成可交互的 Widget 层级树,支持拖拽调整、撤销。
- 智能过滤:基于扇出/扇入、分支逻辑、状态变更等规则筛选关键函数,避免噪声。
- 增强交互:Ctrl+K 搜索模糊匹配函数名并跨图跳转;折叠子项时连线自动重定向;点击空白取消高亮;节点类型徽章与外部依赖标记;签名悬停提示;调用链详情面板(显示函数描述,点击节点可定位);数据字段详情面板;节点位置按图持久化到 localStorage;点击函数属性自动复制名称;Ctrl+Z 撤销布局移动。
使用方式
- 分析项目与确定范围:无需预先提问,立即读取项目顶层结构、入口脚本、配置文件,判断是否有 UI 层,识别主要模块与入口点,评估函数重要性。
- 创建输出文件夹:默认在项目
docs/code_graph/下创建输出目录,可自定义。 - 复制 HTML 引擎:从技能目录的
example/code_flow_graph.html读取模板,原样写入输出文件夹,不修改内容。 - 生成概览图:创建
code_flow_graph_data.js,包含模块级依赖图,遵循数据格式规范。 - 验证与展示:检查 JS 语法,清理多余文件,在浏览器中打开 HTML。
- 提供深度分析选项:根据发现的入口点动态生成选项(如调用链分析、UI 事件分析、UI 布局可视化、数据结构分析、自定义),等待用户选择。
- 增量生成深度图:读取已有数据文件,追加新的图条目,保留原有内容。
适用场景
- 新成员快速理解项目架构。
- 追踪特定函数的调用路径与副作用。
- 梳理 UI 事件绑定与分发逻辑。
- 可视化 UI 界面布局层级。
- 分析数据结构的生成与传递链路。
限制
- 输出为两个文件:
code_flow_graph.html(渲染引擎)和code_flow_graph_data.js(图数据),必须位于同一目录。 - HTML 模板来自技能仓库,不在用户项目中,需使用绝对路径读取。
- 默认使用中文生成描述文本,可应要求切换语言。
- 函数过滤规则可能排除部分辅助函数,但可通过折叠子项形式保留在调用者属性中。
- 深度分析需用户选择后增量生成,不自动全量生成。
- UI 布局可视化仅适用于有 UI 层的项目。
- 未提及收费、价格或平台限制信息,暂未提供。