一键将 Structurizr、LikeC4 和 IcePanel 项目导入 Archyl
如果您曾尝试将架构项目从一个工具迁移到另一个工具,您一定深有体会:手动重建每个系统、重新绘制每个关系、重新输入每个技术标签,还要祈祷没有遗漏任何内容。对于一个有一定规模的代码库来说,这需要数天的枯燥工作——而且几乎必然会引入错误。
正是这种迁移阻力让团队被绑定在不再适合的工具上。不是因为工具有多好,而是因为离开太痛苦了。
今天,这一切将改变。Archyl 现在可以直接从 Structurizr DSL、LikeC4 和 IcePanel 导入架构项目——在几分钟内自动将您的整个 C4 模型转换为一个完整的 Archyl 项目。
三种格式,一个导入流程
Archyl 的导入功能支持三种最广泛使用的 C4 建模格式,每种都保持完整的结构保真度。
Structurizr DSL
Structurizr 由 Simon Brown(C4 模型的发明者)创建,是该生态系统中最成熟的工具。它的 .dsl 文件是基于文本的架构建模的事实标准。
Archyl 解析 Structurizr DSL 并提取:
- 带完整描述的软件系统和人员/参与者
- 嵌套在系统内的容器和组件
- 基于标签的外部系统检测
- 使用
->语法的所有关系,包含描述和技术信息 - 来自位置参数的技术信息
- 来自逗号分隔标签字符串的标签
LikeC4
LikeC4 是一种更新的、开发者友好的 C4 建模方式。目前没有其他工具支持导入 LikeC4 文件。 Archyl 是第一个。
导入器处理 LikeC4 的独特特性:
- 自定义元素类型映射到 C4 概念
- 嵌套元素层次结构解析为容器和组件
#external标签检测用于边界分类technology:属性的提取和应用
IcePanel
IcePanel 是一个以可视化为核心的 C4 建模平台,以 JSON 格式导出架构。
IcePanel 导入器映射:
system类型映射为软件系统,actor类型映射为人员app和store类型映射为容器,component类型映射为组件external: true字段映射为外部系统分类modelConnections映射为带完整元数据的关系
工作原理
第一步 — 在任意 Archyl 项目中打开导入对话框。 第二步 — 选择源格式并上传或粘贴内容。 第三步 — Archyl 验证并显示预览。 第四步 — 一键点击。项目即填充所有元素。
适用于 AI 代理工作流
同样的导入功能也可通过 MCP import_dsl 工具供 AI 编程代理使用。
导入后您将获得什么
AI 驱动的架构漂移检测 — 将文档化的架构与实际代码库进行对比。 架构合规规则 — 自动执行架构标准。 DORA 指标跟踪 — 将架构与交付性能关联。 架构决策记录 — 记录选择背后的原因。 API 契约管理 — 关联 OpenAPI、gRPC 和 GraphQL 规范。 事件通道管理 — 映射 Kafka 主题、RabbitMQ 交换器。 MCP 集成 — 每个 AI 编程代理共享相同的架构上下文。
我们为什么要构建这个功能
我们决定彻底消除迁移障碍。导入功能在所有方案中均可使用,包括免费版。
立即开始导入
试用导入功能 — 创建免费账户,将您的架构带过来。
您的架构文档太有价值了,不应该重新手动输入。直接导入它。