Archify 软件架构图与拓扑可视化引擎

Archify 软件架构图与拓扑可视化引擎

@tt-a1i/archify·v2.0.4·tools

根据系统源码拓扑与数据库实体模型自动逆向生成高质量 Mermaid、PlantUML 与 C4 架构图的渲染引擎。支持依赖追踪、序列流转图绘制与架构漂移实时告警。

架构图 · Mermaid · C4模型 · 依赖分析

GitHubNPM
快速安装与集成
bash
manager:
$ pnpm add @tt-a1i/archify

架构解析

「Archify」专注于让工程架构具备透明度与即时可视性。在快速迭代的代码库中,文档与架构图往往在第一周就与实际代码严重脱节,沦为误导新人的失效资产。 本插件通过静态代码分析(AST)与运行时调用栈抓取,自动提取微服务调用关系、模块分层依赖以及数据表关系。支持一键输出现代化 Mermaid 图表、C4 软件架构模型以及时序图,并无缝集成进 Git CI 流水线中,实现“代码即架构图”的持续同步。

核心特性

01

C4 架构规范原生支持:自顶向下支持系统上下文图、容器图与组件图逐级下钻

02

Mermaid & PlantUML 双栈:灵活生成各种通用 Markdown 渲染器支持的文本图表

03

循环依赖深度扫描:自动识别代码架构中潜藏的模块死锁与双向紧耦合依赖

04

CI/CD 架构漂移告警:在 PR 中自动对比架构演进变动并生成差异高亮图

核心机制

01

代码依赖萃取

静态扫描项目源码文件,提取类、包、函数导入关系与 RPC 接口。

02

分层模型构建

建立符合 C4 标准的系统上下文、容器图与组件级有向关系网。

03

图表语法渲染

自动排版并生成无死锁连线的 Mermaid、PlantUML 或 SVG 源码。

04

文档嵌入与告警

自动写回 Markdown 维基,并在架构出现非预期循环依赖时触发预警。

配置参数参考 (YAML / JSON)

参数名类型默认值说明
diagramTypestringmermaid输出图表语法格式 (mermaid / plantuml / d2)
depthLevelnumber3AST 解析嵌套调用深度级别 (1 - 5)
detectCyclesbooleantrue是否开启循环依赖与反模式自动告警