依赖分析¶

概述¶

随着决策项目的不断迭代，资源文件（变量库、规则集、决策树、决策流等）之间会形成错综复杂的依赖网络。当修改某个底层变量或基础规则时，常常难以评估其变更的爆炸半径。

依赖分析（Dependency Analysis）功能提供了可视化的全局依赖追踪能力，支持正向和反向两种视图，并且能自动推导出所受影响的顶级知识包。

核心功能¶

1. 自动构建依赖图谱¶

依赖关系在控制台前端和后端内存中动态提取。提取器会解析不同类型的文件引用特点，建立起以下依赖关系链路： - 知识包 -> 组件（决策流/规则/变量库） - 决策流 -> 子规则/变量库 - 规则组件（决策表、规则集等） -> 变量/参数/动作库

2. 双向血缘追踪¶

通过依赖分析面板，能清晰查看选定目标文件的完整血缘网络： - 上游依赖（它依赖了谁）：分析出该文件在运行过程中，会直接和间接调用哪些外部规则与变量字典。 - 下游引用（谁依赖了它）：列出哪些父级文件（如其它规则集、决策流、大包）引入或依赖了该文件，从而精确告知使用者“修改当前文件会影响谁”。

3. 影响面（受影响的知识包）评估¶

在下游引用的基础上，系统会自动向上传导至终点，从而推导出本次文件变更直接威胁的部署层 知识包 (Knowledge Packages) 列表，有助于评估发版的测试范围和风险范围。

操作入口¶

在管理端的编辑器中有两处主要入口可以唤起依赖分析抽屉（DependencyDrawer）：

资源树右键菜单：在左侧项目资源列表中，在任意规则文件上点击鼠标右键，选择“依赖分析”。
编辑器工具栏：打开并在编辑某一个决策组件时，点击顶部工具栏中的“依赖分析”快捷按钮。

最佳实践与建议¶

排查幽灵依赖：在打包或发布遇到未找到变量或缺失项时，可通过分析规则的“上游依赖”排查它是否引用的对象已被更名或删除。
修改前的影响力评估：在大幅度调整某基础配置/变量之前，先看一眼“下游引用”和“受影响知识包”，评估其兼容性，从而确认是否需要直接做新版本，而不是强制打补丁。
按需清理冗余：当一棵规则树或变量组在“下游引用”视图中没有被任何上游调用时，说明它是游离和冗余的代码，可考虑清退下线。