Archyl - AI驱动的架构文档平台 | C4模型图

使用C4模型创建交互式架构图，通过AI从代码中发现架构，与团队协作。

我们相信每个组织都应该对其软件架构拥有清晰的可见性。这就是我们构建 Archyl 的原因。

Archyl 成立于 2025 年，在超过 20 年的软件咨询经验之后。在那些年里，我们反复目睹同样的挑战：组织在理解、记录和沟通其软件架构方面苦苦挣扎。

复杂的系统变成了黑盒。知识只存在于少数高级工程师的脑海中。新成员的入职需要几个月而不是几天。架构决策在没有清晰了解现有系统的情况下做出。

我们创建了 Archyl 来解决这些问题。通过将经过验证的 C4 模型与 AI 驱动的发现相结合，我们让任何组织都能轻松获得对其架构的完整可见性，并保持文档始终最新。

我们希望以最简单的方式为每个人提供架构可观测性。

我们相信复杂系统在适当可视化后可以被理解。清晰推动更好的决策。

强大的工具不必复杂。我们专注于使架构文档毫不费力。

我们利用 AI 自动化繁琐的部分，让组织能够专注于构建优秀的软件。

加入信任 Archyl 来记录和理解其软件系统的组织。

查找有关 Archyl 功能和能力的常见问题解答。

通过 MCP 服务器和 REST API 连接

需要更多帮助？我们的团队随时为您服务。

找不到您需要的内容？我们在这里帮助您。

C4 模型是一种在四个抽象层次上可视化软件架构的分层方法： • 第 1 层 - 系统上下文：展示您的系统及其与用户和其他系统的交互 • 第 2 层 - 容器：展示高层技术构建块（应用程序、数据库等） • 第 3 层 - 组件：展示容器的内部结构 • 第 4 层 - 代码：展示组件的实现方式

点击侧边栏中的 '+' 按钮或从仪表盘选择'新建项目'，输入项目名称，然后开始添加系统。使用右键菜单进行快速操作。

双击任何元素可向下钻取。使用面包屑导航返回上层，或使用层级标签直接跳转到任何层级。

C4 模型是一种在四个抽象层次上可视化软件架构的分层方法： • 第 1 层 - 系统上下文：展示您的系统及其与用户和其他系统的交互 • 第 2 层 - 容器：展示高层技术构建块（应用程序、数据库等） • 第 3 层 - 组件：展示容器的内部结构 • 第 4 层 - 代码：展示组件的实现方式 这种方法帮助组织在适当的详细程度上为不同受众沟通架构。

Archyl 的导航非常直观： • 双击任何元素可向下钻取到下一层级 • 使用顶部的面包屑导航返回上层 • 层级标签（系统上下文、容器、组件、代码）可直接跳转到任何层级 • 使用侧边栏项目树直接导航到任何元素

可以！Archyl 支持多种导入方式： • AI 发现：连接 Git 仓库，让 AI 自动分析您的代码库 • ADR 发现：从仓库导入架构决策记录 • 文档发现：导入现有的 Markdown 文档 转到项目设置配置仓库连接并运行发现。

每个 C4 层级支持不同的元素类型： • 系统上下文（第 1 层）：软件系统、人员、外部系统 • 容器（第 2 层）：服务、API、Web 应用、移动应用、数据库、缓存、消息队列、文件存储 • 组件（第 3 层）：控制器、处理器、仓储、适配器、中间件、工具、模型 • 代码（第 4 层）：类、接口、结构体、函数、方法、枚举、常量、类型

覆盖层是带颜色的可视化分组，帮助在图表上组织元素： 1. 点击'添加'并选择'覆盖层' 2. 给它一个名称（例如'后端服务'、'前端应用'） 3. 从调色板选择颜色 4. 将元素拖入覆盖层区域 覆盖层是层级特定的，因此您可以在每个 C4 层级拥有不同的分组。

右键点击任何元素可访问样式选项： • 背景颜色 • 边框颜色 • 文字颜色 • 形状和图标 关系也可以使用不同的颜色、线宽和样式（实线、虚线、点线）进行样式设置。

AI 发现分析您的代码库以自动识别架构元素。转到项目设置 > AI 发现，配置您的 Git 仓库，然后点击'刷新发现'。在添加之前审查并批准发现的元素。

AI 发现分析您的代码库以自动识别架构元素： 1. 转到项目设置 > AI 发现 2. 配置您的 Git 仓库详情（提供商、所有者、仓库、分支） 3. 点击'刷新发现' 4. AI 将扫描您的代码并识别系统、容器、组件及其关系 5. 在'待审发现'中审查发现的元素 6. 在添加到架构之前批准或拒绝每个发现

Archyl 支持多个 Git 提供商： • 云端：GitHub、GitLab、Bitbucket • 自托管：GitHub Enterprise、GitLab（自托管）、Gitea • 企业：Azure DevOps 对于自托管提供商，您需要配置基础 URL 和访问令牌。

审批工作流让您控制添加到架构中的内容： • AI 建议可能需要完善 • 您可以在批准前编辑名称和描述 • 某些发现可能与您的文档目标无关 • 这防止了架构图的意外污染 您可以逐个批准/拒绝，或使用批量操作提高效率。

AI 发现限制取决于您的计划并按月重置： • Developer（免费）：每月 3 次 AI 发现 • Business：每月 10 次 AI 发现 • Scale：每月 50 次 AI 发现 • Custom：无限 AI 发现 升级您的计划以解锁更多 AI 发现容量。

可以！每个项目可以为不同目的配置多个仓库连接： • 一个用于 AI 发现（代码库分析） • 一个用于 ADR 发现（决策记录） • 一个用于文档发现 这允许您从不同来源获取架构信息。

如何使用自托管 Git 提供商？

Archyl 有三种团队角色： • 管理员：完全控制——可以管理团队设置和成员，并拥有所有团队项目的编辑权限 • 编辑者：可以在团队内创建、修改和删除项目及架构元素 • 查看者：只读访问——可以查看图表和文档但不能进行更改 查看者不计入付费席位数。每个团队可以拥有不同角色的成员。