文档

了解如何使用Archyl。

Getting started

  • Archyl 简介 — 了解 Archyl 是什么,以及它如何帮助您使用 C4 模型记录软件架构
  • 快速入门指南 — 5 分钟内开始使用 Archyl - 创建您的第一个架构图
  • 核心概念 — 了解 Archyl 中使用的关键概念和术语

C4 model

  • C4 模型概览 — 了解 C4 模型以及 Archyl 如何实现它来进行架构文档化
  • 元素与样式 — 了解每个 C4 层次的不同元素类型以及如何设置样式
  • 关系 — 了解如何创建和设置架构元素之间关系的样式

Features

  • AI 驱动的发现 — 了解 Archyl 如何使用 AI 从您的代码库中自动发现和记录架构,并在每次推送时进行增量更新
  • 架构变更请求 — 通过结构化的变更请求工作流提出、审查和合并对 C4 架构模型的变更
  • 文档与 ADR — 在 Archyl 中创建和管理架构文档及架构决策记录
  • 文档附件 — 通过拖放、粘贴或附件按钮将图片和文件上传到文档页面——安全存储在兼容 S3 的对象存储中
  • 用户流程 — 记录跨架构的用户和数据流程,可视化交互序列
  • 架构即代码 — 使用 archyl.yaml 定义和同步 C4 架构 — 版本控制、CI/CD 就绪、完全声明式
  • 架构延时影片 — 把项目的版本历史重播成一部电影般的短片——元素自行绘出、已移除的服务被划掉、片尾字幕滚动——再导出为完全在浏览器中渲染的 1080p MP4
  • 架构洞察 — 自动检测架构问题并获取改善系统设计的建议
  • 分享与导出 — 与利益相关者分享架构图并导出为各种格式
  • API 契约 — 记录和管理与 C4 架构元素直接关联的 API 规范
  • 发布管理 — 通过 GitHub Actions、Webhook 和 REST API 的自动摄取,跨架构跟踪部署
  • 市场集成 — 连接外部服务并在架构旁边显示实时指标、告警和仪表盘
  • 生产现实(Living Diagram,动态图) — 连接 Kubernetes、Datadog、New Relic 等生产环境数据源,发现实时运行的服务及其依赖关系,再将它们与你的 C4 模型进行对账——只读、无破坏性
  • 技术雷达 — 可视化您的技术全景,跟踪采用水平,并管理所有项目的技术栈
  • Webhook 通知 — 当架构变更发生时,实时接收 HTTP 通知
  • Slack 和 Teams 机器人 — 在 Slack 或 Microsoft Teams 中向 Archyl 询问你的架构,并让它使用实时 MCP 工具来回答和操作
  • 所有权地图 — 通过交互式气泡、依赖关系线和覆盖率跟踪,可视化团队和用户在架构中的所有权
  • 合规规则(护栏) — 定义确定性的架构规则,根据您的 C4 模型、技术决策和编码标准验证代码变更——全程不涉及 AI
  • GitHub Actions 集成 — 使用 Archyl 官方 GitHub Actions,在 CI/CD 管道中运行架构合规检查、漂移评分、上下文生成等任务
  • 合规规则包 — 面向常见架构模式的预置合规规则集——微服务、整洁架构、事件驱动、API 优先和安全基线
  • 托管 Agent 运行 — 调度自主 AI Agent,按计划运行,通过 MCP 连接器接入外部服务,并在完整架构上下文中对代码库执行任务
  • 自带 AI 提供商 — 通过您自己的提供商(OpenAI、Anthropic、Google Gemini、AWS Bedrock 或任何 OpenAI 兼容端点)使用您自己的凭据路由所有 Archyl AI 功能 — 并跳过 Archyl 配额限制。

Guides

  • 创建您的第一个项目 — 在 Archyl 中创建和记录您的第一个架构项目的分步指南
  • 嵌入图表 — 将交互式 Archyl 图表嵌入到 Confluence、Notion、Miro 及其他平台
  • 安全性 — 了解 Archyl 如何保护您的数据和架构信息
  • 设置与配置 — 配置 AI 提供商、管理订阅,并自定义您的 Archyl 体验
  • 编程代理技能 — 安装并使用 Archyl 的 11 个编程代理技能,直接在 Claude Code、Codex 或任何兼容的代理中验证、记录、审查和优化您的架构
  • Archyl Harness — 五分钟让任何编程代理理解您的架构:精准上下文、受管控的工作会话、Guardrails 强制执行,以及在代理之间不断累积的记忆

Git integration

Collaboration

  • 团队管理 — 了解如何在 Archyl 中创建和管理团队以实现更好的协作
  • 实时白板协作 — 与团队实时协作编辑架构图
  • 团队架构摘要 — 定期向每个团队发送架构动态汇总邮件——漂移、ADR、合规、讨论。

Api

  • API 概览 — 了解 Archyl 的 API 以及如何与您的工具和工作流程集成
  • 身份认证 — 了解如何使用 API 密钥进行 Archyl API 身份认证
  • MCP 服务器 — 将 Claude、Cursor 和 VS Code 等 AI 助手连接到您的架构 —— 189 个工具,涵盖 C4 模型、ADR、契约、合规性、漂移、DORA 等
  • SDK — 通过官方 Node.js 和 Python SDK 以编程方式访问 Archyl API