由于 trendforge.devlive.top 访问受限,请切换到 trendforge.devlive.org 域名

5分钟快速开始:diagram-design 图表设计项目

这是一个基于纯HTML+SVG的图表设计项目,包含27种编辑图表类型,无需任何构建步骤或外部依赖,直接在浏览器中打开即可查看。

环境要求

支持的操作系统

macOS Windows Linux

所需工具

现代浏览器

直接打开HTML文件查看图表

必需
Git

克隆项目仓库

必需

操作步骤

1

克隆项目仓库

使用Git克隆项目到本地目录

克隆GitHub仓库到本地
git clone https://github.com/cathrynlavery/diagram-design.git

预期结果::成功创建diagram-design文件夹,包含所有项目文件

如果网络较慢,可以使用浅克隆:git clone --depth 1 https://github.com/cathrynlavery/diagram-design.git

2

查看图表画廊

直接打开项目提供的HTML文件,浏览所有27种图表类型

进入项目目录
cd diagram-design
macOS系统打开HTML文件
open skills/diagram-design/assets/index.html

预期结果::浏览器打开图表画廊页面,显示27种图表类型,可通过标签页切换查看light、dark和full-editorial三种样式

Windows系统使用 'start skills/diagram-design/assets/index.html',Linux系统使用 'xdg-open skills/diagram-design/assets/index.html'

3

查看单个图表示例

直接打开任意一个图表HTML文件,查看具体效果

打开一个流程图示例(最小化浅色样式)
open skills/diagram-design/assets/diagrams/minimal-light/flowchart.html

预期结果::浏览器显示一个干净、专业的流程图,使用SVG渲染,没有JavaScript依赖

其他图表类型在 skills/diagram-design/assets/diagrams/ 目录下,按图表类型和样式分类存放

验证项目已成功运行

确认项目文件完整且能在浏览器中正常显示

成功克隆了项目仓库
浏览器能正常打开图表画廊页面
能看到27种图表类型的预览
点击具体图表能正常渲染SVG图形

快速提示

使用方式

所有图表都是纯HTML+SVG,无需安装任何依赖,直接双击HTML文件即可在浏览器中查看

样式选择

项目提供了light、dark和full-editorial三种样式变体,适合不同的设计需求

AI集成

图表使用语义化模式描述行为,可以用于Claude Code、Codex等AI工具生成图表

高级功能

默认使用静态HTML输出,如需动画效果可参考animation.md文档

常见问题

1

浏览器打开HTML文件显示空白或样式错乱

确保使用现代浏览器(Chrome、Firefox、Safari、Edge),并检查是否正确链接了SVG文件。尝试直接访问 https://cathrynlavery.github.io/diagram-design 在线查看

2

找不到图表画廊文件

确认在正确的目录中:skills/diagram-design/assets/index.html。如果文件不存在,可能需要重新克隆仓库

3

图表无法渲染或显示错误

检查浏览器控制台是否有错误信息。这些是纯静态HTML+SVG文件,理论上不应有JavaScript错误。尝试刷新页面或清除浏览器缓存

4

想要自定义图表样式

参考项目中的style-guide.md文档了解样式配置。可以通过修改HTML文件中的内联SVG样式或CSS来调整颜色、字体等

下一步

探索所有图表类型

浏览 skills/diagram-design/assets/diagrams/ 目录下的所有27种图表,了解每种类型的用途和设计特点

集成到AI工作流

如果使用Claude Code、Codex等工具,可以参考SKILL.md文档将图表设计能力集成到你的开发流程中

自定义品牌样式

按照onboarding.md文档的指导,提取自己网站的品牌颜色和字体,让生成的图表匹配你的设计系统

导入现有图表

如果你有.drawio或.mermaid格式的图表,可以按照import-drawio.md或import-mermaid.md文档的说明进行转换和重绘

助手