关键字 · DIAGRAM

全部详情 / 开源项目

stack-diagram:用一句话描述你的技术栈,AI 就画出一张带官方 logo 的架构图

开源技能 stack-diagram:一句话说清你用了哪些服务,Claude Code、Codex、Cursor 就画出带官方 logo 的架构图,支持亮色和暗色。

想给自己的项目画一张架构图,但又不想打开画图软件一个个拖框、找 logo?stack-diagram 是一个给编程 AI 用的技能:你用一句话描述你的技术栈,它就画出一张带官方 logo 的架构图。

比如你说:「画出我们的技术栈:Next.js 和 Hono API 部署在 Vercel,Postgres 用 Neon,登录用 Clerk,支付用 Stripe,GitHub Actions 负责部署。」它就会把这些都画出来。它开源(MIT 许可),作者是 caru-ini,GitHub 上大约有 2,500 颗星。

01你能得到什么

  1. 官方 logo 自动帮你找:依次从 svgl、devicon、gilbarbara/logos 或品牌自己的仓库获取;AWS、Google Cloud、Azure 和 Kubernetes 用的是它们自家的图标;
  2. 线条不会穿过文字:连线会绕开标签,AI 会先渲染、检查一遍再交给你;
  3. 需要什么格式都有:独立的 HTML 文件(默认)、PNG、没有依赖的 React 组件,或者一个 Artifact;
  4. 亮色和暗色两个版本都会画好,图块保持白色,让 logo 保留原本的颜色;
  5. 不只是云服务:开发工具链(比如 pnpm、Turborepo、Vitest)、AI 应用(比如向量数据库加 Claude)也能画。

02怎么安装

在 Claude Code、Codex、Cursor 或其他支持技能(skills)的编程 AI 里,运行:

  1. npx skills add caru-ini/stack-diagram

在 Claude 的应用里(claude.ai 或桌面版):从 GitHub 的 Releases 页面下载 stack-diagram.zip,作为技能上传。

需要 Python 3.9 或以上,还要能联网下载 logo。导出 PNG 需要 Playwright 和 Chromium。

03怎么用

  1. 第 1 步:用一两句话告诉 AI 你的技术栈,写清楚用了哪些服务、它们怎么连。例如:Draw our app on AWS: CloudFront in front of S3 and an ALB in a public subnet. Fargate, RDS and ElastiCache sit in a private subnet.
  2. 第 2 步:等它画好。它会自己检查一遍,然后给你一个 HTML 文件;
  3. 第 3 步:想要别的格式就直接说,比如要 PNG 或 React 组件;
  4. 第 4 步:分享:HTML 文件里已经内嵌了字体和 logo,不联网也能显示,可以发布成 Claude Artifact 分享链接,或者放进仓库或 wiki。

04要知道的事

  1. 许可:代码和文档是 MIT;内置字体是 SIL Open Font License 1.1;
  2. logo 不包含在技能里,是在生成时从 svgl、devicon(MIT)、gilbarbara/logos(CC0)以及各云厂商的官方图标库下载的,所以需要联网;
  3. 这些 logo 是各品牌的商标,用在你自己的图里时要留意各品牌的使用规定。

05相关链接

延伸阅读