项目导出与导入：你的架构，完全可移植
我们认为，你的架构文档属于你自己。不是被锁定在专有格式中，不是被困在 API 后面，不是被订阅层级绑架。如果你投入了时间来记录你的系统、容器、组件和关系，你应该能够随身携带这些工作成果。
今天，我们将这一信念付诸实践。Archyl 现在支持完整的项目导出和导入。
一切尽在一个文件中
当你导出一个项目时，你会获得一个包含完整 C4 模型的 JSON 文件。你定义的每一个系统、这些系统中的每一个容器、每一个组件，如果你建模到了代码级别，还包括代码级元素。连接它们的关系，以及描述和技术注释。你创建的用于分组和组织图表的可视化覆盖层。
导出会保留图表的空间布局。你花费时间定位元素来清晰地传达结构——API 网关在左侧、数据库在右侧、外部系统在顶部。这些排列不是随意的；它们是你传达架构的方式的一部分。导出会全部捕获。
格式是简洁的 JSON，带有版本号和文档说明。用任何文本编辑器打开就能阅读。如果你想做一些自定义处理，可以用脚本解析它。这是你的数据，以你可以控制的格式呈现。
导出如何工作
打开你有权访问的任何项目，导航到导出选项，选择你的格式。对于数据可移植性，选择 JSON。文件会立即下载——即使是包含数百个元素的大型项目也只需几秒钟。
我们还支持针对不同用例的可视化导出。SVG 提供矢量格式，可以在 Illustrator 中编辑或嵌入到文档中。PNG 提供可分享的图片。PDF 创建专业文档。还有一个选项可以将所有四个 C4 层级合并为一个综合导出。
对于自动化，API 端点完全按照你的预期工作。向 /projects/{id}/export 发送 GET 请求即可返回完整的 JSON 数据。将其集成到你的 CI 流水线中、计划每周备份，或与你已有的任何工作流集成。
导入创建全新项目
当你导入一个架构时，Archyl 会创建一个全新的项目。你提供名称和 slug，可选择一个团队，然后上传 JSON 文件。系统会解析导出文件、验证其结构，并用全新的标识符重建每一个元素。
这是一个刻意的设计选择。导入不会合并到现有项目中，也不会尝试协调冲突。它创建一个干净的副本，独立于源项目。原始项目保持不变；导入的项目开始自己的生命。
导入过程透明地处理 ID 重新映射的复杂性。你的导出文件包含元素创建时的原始 UUID。导入会为所有内容生成新的 UUID，同时保留元素之间的关系。属于特定系统的容器仍然属于该系统。连接两个组件的关系仍然连接它们。结构完全相同；只有标识符发生了变化。
如果导出中的关系引用了不存在的元素——也许来自部分导出或损坏的文件——导入会记录警告并继续。你会获得所有可以导入的内容，并能看到哪些被跳过了。
实际使用场景
我们合作的一家咨询公司使用导出来向客户交付架构文档。他们在 Archyl 中对客户的系统建模，通过发现和手动文档化进行完善，然后导出最终结果。客户收到一个 JSON 文件，可以导入到自己的 Archyl 实例中，或者简单地归档为项目记录。
一个企业平台团队每周将架构导出到内部备份系统。如果主要文档出现任何问题，他们可以从最新的导出中恢复。JSON 格式意味着备份是可读且可验证的，而不是一个不透明的二进制文件。
一家初创公司在被收购过程中使用了导出功能。收购方需要了解目标公司的系统架构。团队没有安排数周的知识转移会议，而是导出了 Archyl 项目并分享了文件。收购方导入了它，进行交互式探索，然后带着对所收购内容的真正理解来参加整合讨论。
开发团队使用导出作为架构快照。在重大发布后，他们导出当前状态并将 JSON 文件与代码一起提交。几个月后，当有人问"微服务迁移之前架构是什么样的？"时，答案只需一次 git checkout 即可获得。
导出包含什么
导出包括完整的 C4 层次结构。最顶层的系统，其中嵌套着容器，容器中包含组件，组件中包含代码元素。每个元素都携带完整的元数据：名称、描述、类型、技术栈、标签、位置坐标和任何自定义样式。
关系连同双方端点一起导出，还有它们的类型、描述和视觉属性（如标签位置）。导入过程会将这些映射到新创建的元素上，保持完全相同的连接结构。
覆盖层——你创建的用于组织复杂图表的可视化分组——包含它们的位置、尺寸、颜色和所包含的元素。
目前未导出的内容：ADR、项目文档、用户流程和代码仓库连接。导出聚焦于 C4 模型本身——系统、容器、组件、代码及其关系。我们正在根据用户反馈考虑在未来版本中扩展范围。
无锁定，无花招
导出格式今天使用版本"1.0"。随着我们添加功能，我们会更新格式同时保持向后兼容性。今天创建的导出在多年后仍能正确导入，即使 Archyl 不断演进。
我们对锁定你的数据没有兴趣。我们感兴趣的是提供足够有用的服务，让你选择留下。导出和导入是我们对这一理念的承诺。如果 Archyl 不再是适合你的工具，带走你的架构。如果竞争对手构建了更好的东西，我们已经让切换变得容易。压力在我们这边，要持续赢得你的信任。
开始使用
导出和导入在所有计划中可用，包括免费版。没有人为限制，没有"导出是付费功能"的套路。
要导出：打开任何项目，找到导出按钮，选择 JSON，然后保存文件。
要导入：从项目列表中，点击导入，上传 JSON 文件，为新项目命名，然后确认。
你的架构文档是你的。现在你可以带它去任何地方。
想了解更多关于在 Archyl 中可以记录什么？阅读我们的 C4 模型简介，或了解 AI 驱动的架构发现 如何自动映射你的现有系统。