LikeC4 Skill:用代码实时生成软件架构图的 C4 模型神器

LikeC4 Skill:用代码实时生成软件架构图的 C4 模型神器

总结

LikeC4 是一个开源的「架构即代码」工具,让你用简洁的 DSL 描述软件架构,自动生成实时、可交互的架构图。它基于 C4 Model 理念,但比传统工具更灵活——支持自定义符号、无限层级嵌套,并可直接从代码生成活文档。由于 GitHub Trending 今日暴涨 339 星、总星数突破 4,996,LikeC4 正成为 2026 年下半年架构可视化赛道最受关注的新晋项目。

功能与原则

LikeC4 的核心能力是「架构即代码」:开发者用类 C4 Model 的 DSL 编写架构模型,工具自动渲染为可视化图表。设计原则非常明确:模型必须版本化、可协作、可被 AI 读取。它不追求做一个静态绘图工具,而是要让架构图像代码一样活在仓库里,随代码演进而自动更新。项目还内置 MCP Server,把架构上下文直接暴露给 AI Agent,实现「AI 读代码前先读懂架构」。

认可度

  • GitHub Stars:4,996 星(截至 2026-07-24),今日新增 339 星,位列 GitHub Trending 日榜
  • Forks:334
  • 社区热度: 2026 年 3–6 月持续有中文技术博客深度解析,CSDN 上至少 5 篇专题文章;Discord 社区活跃,VSCode 插件已上架 Open VSX
  • Trending 经历: 2026-07-24 登上 GitHub Trending 日榜,属于「近期正在爆」的新晋热门项目

链接

  • GitHub: https://github.com/likec4/likec4
  • 官网: https://likec4.dev/
  • Playground: https://playground.likec4.dev/
  • Demo: https://template.likec4.dev/view/index

原作者

LikeC4 由 likec4 组织维护,核心贡献者为 davydkov 等。项目以 MIT 协议开源,社区驱动开发,已获得 OpenCollective 和 GitHub Sponsors 支持。

介绍

LikeC4 是一个架构建模语言和配套工具链。它受到 C4 Model 和 Structurizr DSL 启发,但提供了更大的灵活性:你可以自定义元素类型、符号体系,以及任意层级的嵌套深度。项目提供 CLI 工具 npx likec4 start 即可本地预览架构图,也可通过 VSCode 插件实时编辑。

Unlike 传统绘图工具,LikeC4 的图是「活的」——源码在 Git 里,图表随代码库演进而自动更新。项目还支持 MCP Server 和 API,将架构上下文暴露给 AI Agent,让 Claude Code、Codex 等工具在阅读代码前先理解系统结构。协作方面,LikeC4 提供交互式视图,支持多人评审和架构讨论。

特点

  • C4 Model 超集: 在标准 C4 基础上支持自定义 notation、element types 和嵌套层级,不强制套模板
  • 架构即代码: 架构模型存入 Git,版本化、可 Review、可 Diff,随代码库一起演进
  • AI 原生友好: 内置 MCP Server,LLM-friendly DSL 语法让 AI Agent 原生理解架构上下文
  • 交互式可视化: 支持 drill-down、组件关系浏览、实时预览,CLI / Web / VSCode 多端可用
  • 开源生态: MIT 协议,VSCode / Open VSX 插件可用,模板仓库和 Demo 开箱即用

使用方法

安装:

npx likec4 start

最小示例:
创建一个 architecture.c4 文件:

model {
  user = person 'User'
  system = softwareSystem 'My System'
  user -> system 'Uses'
}

运行 npx likec4 start 即可在浏览器预览架构图。

VSCode 插件: 在 VSCode marketplace 搜索 likec4.likec4-vscode 安装,获得语法高亮和实时预览。

API / MCP: 项目提供 LikeC4 API,可直接在 Node.js 中加载工作区:

import { LikeC4 } from 'likec4'
const likec4 = await LikeC4.fromWorkspace('./workspace')

使用场景与人群

  • 架构师 / 技术负责人: 需要维护系统架构文档,要求「图即代码」、版本化、可协作
  • 开发团队: 新成员 onboarding 时快速理解系统结构,架构评审时用活图替代静态截图
  • AI 编程场景: 将架构上下文注入 Claude Code / Codex,让 AI Agent 在修改代码前先理解系统边界
  • 技术写作 / 方案评审: 用架构图支撑技术方案文档,支持交互式探索

输入与输出案例

输入:

model {
  user = person 'Admin'
  api = softwareSystem 'API Gateway'
  service = container 'Order Service' {
    component 'Order Controller'
    component 'Payment Handler'
  }
  db = container 'Database' 'PostgreSQL' 'Stores orders'

  user -> api 'Manages orders'
  api -> service 'Routes requests'
  service -> db 'Reads/writes'
  service.component 'Payment Handler' -> db 'Transaction logs'
}

输出: LikeC4 渲染出一张 C4 架构图,包含 System、Container、Component 三层视图,支持点击 drill-down 查看 Payment Handler 与 PostgreSQL 的详细关系,图随 architecture.c4 文件更新而自动刷新。


GitHub: https://github.com/likec4/likec4

评论区

0 条评论

登录后可评论。

查看完整榜单
查看完整榜单
查看完整榜单