实体依赖图

Kode 提供实体依赖关系图，用于查看实体继承结构和实体间引用关系。

能力概览

从 entities.xml 加载实体列表
分析实体继承关系
分析 ENTITYCALL 及容器中的实体引用
Mermaid 可视化展示
图中打开实体定义
导出 SVG
导出 PNG

相关命令

kbengine.dependency.show

配置联动

依赖图会读取这些配置：

kbengine.entitiesXmlPath
kbengine.entityDefsPath

如果你的项目没有把实体文件放在默认的 scripts/ 目录下，需要先把这两个路径配对，否则图里会缺节点或无法打开定义。

图中展示内容

节点

每个节点代表一个实体。

节点会标记实体类型：

Base
Cell
Client

边

当前主要包含：

继承关系
ENTITYCALL / 实体引用关系

面板中的功能

刷新

重新读取当前项目结构，更新依赖图。

适合在这些场景使用：

新增实体
修改继承关系
调整实体引用

打开实体定义

从图中点击实体，直接打开对应 .def 文件。

导出

支持：

SVG
PNG

适合：

放到设计文档
发给团队讨论
做架构评审材料

使用建议

看继承深度

如果你发现某类实体继承链过深，通常意味着：

结构可能过于耦合
行为分层可能不清晰
后续维护成本会上升

看引用热点

最常被引用的实体通常是系统核心点。它们值得单独审视：

是否承担了过多职责
是否应该拆分
是否会成为改动风险集中区

当前边界

依赖图现在更适合“结构可视化”和“导航”。

还没有做到：

超大项目下的聚类和分层过滤
自定义布局策略
只显示某个子图或某条依赖链
自动优化建议