从单张手工到批量自动化,从固定配色到品牌定制。企业级图表制作系统。
技术团队的图表制作不应停留在"一张一张手绘"的阶段。专业版采用"模板-生成-导出-管理"四阶段工作流,配合七大高级功能,帮助团队建立统一、高效、可复用的图表制作体系.
详细内容已移至
references/detail.md- ## 架构总览
快速开始
- 阅读## 核心能力章节了解skill功能
- 按## 依赖说明配置环境
- 执行所需能力对应的命令
- 参考## 错误处理章节处理异常
- 查看## FAQ解答常见疑问
基础搭建(<60秒)
单张图表生成,立即可用:
输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 图表制作大师(专业版)处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
用户:画一个微服务架构图
助手:→ 识别类型 → 规划布局 → 应用配色 → 生成SVG
标准搭建(<120秒)
启用批量生成与模板库:
diagram-master --batch diagrams/ --parallel 4
# .
diagram-master --template microservice --output arch.svg
完整搭建(<300秒)
核心能力
1. 九种图表类型(基础+增强)
| 图表类型 | 适用场景 | 基础能力 | 专业版增强 |
|---|---|---|---|
| 架构图 | 系统组件关系 | 静态布局 | 可点击节点跳转 |
| 流程图 | 决策逻辑 | 静态流程 | 动态高亮路径 |
| 时序图 | 时序交互 | 静态消息 | 动画播放消息流 |
| 结构图 | 类图/ER图 | 静态结构 | 可折叠分区 |
| 思维导图 | 头脑风暴 | 静态辐射 | 可展开/折叠分支 |
| 时间线 | 时间事件 | 静态轴 | 可缩放时间范围 |
| 说明图 | 概念解释 | 静态布局 | 交互式注释 |
| 状态机 | 状态转换 | 静态状态 | 动画演示转换 |
| 数据流图 | 数据管道 | 静态流 | 动画数据流动 |
处理: 解析九种图表类型(基础+增强)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回九种图表类型(基础+增强)的响应数据,包含状态码、结果和日志.
2. 语义化配色系统(基础+增强)
| 类别 | 填充色 | 描边色 | 用途 | 专业版自定义 |
|---|---|---|---|---|
| 主要 | rgba(8,51,68,0.4) | #22d3ee | 前端/输入 | 支持品牌色替换 |
| 次要 | rgba(6,78,59,0.4) | #34d399 | 后端/服务 | 支持品牌色替换 |
| 第三 | rgba(76,29,149,0.4) | #a78bfa | 数据库/存储 | 支持品牌色替换 |
| 强调 | rgba(120,53,15,0.3) | #fbbf24 | 云/基础设施 | 支持品牌色替换 |
| 告警 | rgba(136,19,55,0.4) | #fb7185 | 安全/警告 | 支持品牌色替换 |
| 连接 | rgba(251,146,60,0.3) | #fb923c | 总线/中间件 | 支持品牌色替换 |
| 中性 | rgba(30,41,59,0.5) | #94a3b8 | 外部/通用 | 支持品牌色替换 |
| 高亮 | rgba(59,130,246,0.3) | #60a5fa | 激活/焦点 | 支持品牌色替换 |
处理: 解析语义化配色系统(基础+增强)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回语义化配色系统(基础+增强)的响应数据,包含状态码、结果和日志.
3. 批量图表生成(专业版)
多图表一键生成,支持并行与检查点:
diagram-master --batch diagrams/ --parallel 4 --output output/
# .
diagram-master --batch --from-doc README.md --extract-diagrams
# .
diagram-master --batch diagrams/ --checkpoint --resume
专业版优势:
- 并行处理:4进程并行,生成速度提升3倍
- 检查点机制:中断后可从断点恢复
- 文档提取:从Markdown文档自动提取图表定义并生成
- 批量导出:一次生成SVG+PNG@2x+PNG@4x三种格式
处理: 解析批量图表生成(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回批量图表生成(专业版)的响应数据,包含状态码、结果和日志.
4. 自定义配色方案(专业版)
diagram-master --theme brand-corporate --output arch.svg
# .
diagram-master --list-themes
# .
diagram-master --create-theme my-brand \
--primary "#E44D26" \
--secondary "#00A1E0" \
--background "#1A1A2E"
| 主题 | 风格 | 适用场景 |
|---|---|---|
| dark(默认) | 暗色科技风 | 技术文档 |
| light | 浅色简洁风 | 正式报告 |
| brand-corporate | 品牌定制 | 企业文档 |
| high-contrast | 高对比度 | 无障碍场景 |
| monochrome | 单色专业 | 学术论文 |
处理: 解析自定义配色方案(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回自定义配色方案(专业版)的响应数据,包含状态码、结果和日志.
5. 图表模板库(专业版)
预设模板快速套用:
diagram-master --template ci-cd-pipeline --output pipeline.svg
diagram-master --template er-database --output er.svg
# .
diagram-master --list-templates
# .
diagram-master --save-template my-arch --from arch.svg
| 模板类别 | 模板名称 | 适用场景 |
|---|---|---|
| 架构图 | microservice | 微服务架构 |
| 架构图 | layered-arch | 分层架构 |
| 架构图 | event-driven | 事件驱动架构 |
| 流程图 | ci-cd-pipeline | CI/CD流水线 |
| 流程图 | user-journey | 用户旅程 |
| 时序图 | api-interaction | API交互 |
| 时序图 | auth-flow | 认证流程 |
| 结构图 | er-database | ER图 |
| 结构图 | class-diagram | 类图 |
| 状态机 | order-lifecycle | 订单生命周期 |
处理: 解析图表模板库(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回图表模板库(专业版)的响应数据,包含状态码、结果和日志.
6. SVG转PNG高清导出(专业版)
diagram-master --export arch.svg --format png --scale 2
# .
svg --format png --scale 4
# .
svg --format svg,png@2x,png@4x
| 导出格式 | 分辨率 | 适用场景 |
|---|---|---|
| SVG | 矢量 | Web嵌入、可缩放 |
| PNG @2x | 2倍 | 屏幕展示、PPT |
| PNG @4x | 4倍 | 出版印刷、高清展示 |
| 矢量 | 正式文档 |
处理: 解析SVG转PNG高清导出(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回SVG转PNG高清导出(专业版)的响应数据,包含状态码、结果和日志.
7. 图表版本管理(专业版)
diagram-master --save-version arch.svg --message "增加缓存层"
# .
diagram-master --history arch.svg
# .
diagram-master --diff arch.svg --v1 1 --v2 3
# .
diagram-master --rollback arch.svg --version 2
处理: 解析图表版本管理(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回图表版本管理(专业版)的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
8. 交互式图表(专业版)
diagram-master --interactive --template microservice \
--links '{"UserService": "docs/user-service.html"}' \
--output arch-interactive.svg
# .
diagram-master --interactive --template ci-cd-pipeline \
--highlight-path "build,deploy" \
--output pipeline-interactive.svg
| 交互功能 | 说明 | 适用场景 |
|---|---|---|
| 可点击节点 | 点击跳转到文档 | 架构图导航 |
| 动态高亮路径 | 高亮指定流程路径 | 流程图演示 |
| 折叠/展开 | 点击折叠分区 | 复杂架构图 |
| 悬停提示 | 鼠标悬停显示详情 | 组件说明 |
| 动画播放 | 时序消息动画 | 时序图演示 |
处理: 解析交互式图表(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回交互式图表(专业版)的响应数据,包含状态码、结果和日志.
9. 图表组件库(专业版)
diagram-master --save-component "db-postgres" --from arch.svg
# .
diagram-master --use-component "db-postgres" --output new-arch.svg
# .
diagram-master --list-components
处理: 解析图表组件库(专业版)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回图表组件库(专业版)的响应数据,包含状态码、结果和日志. 能力覆盖范围:本skill的核心能力覆盖以下场景关键词:全功能、图表系统、含批量生成、版本管理与交互式、图表制作大师专业、版是技术文档图表、制作的完整解决方、在免费版基础上解、锁批量图表生成、图表组件库七大高、级功能、帮助团队建立统一、可复用的图表制作、when、、品牌视觉时使用、不适用于、建模和动画制作等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
使用场景
场景一:企业级技术文档图表标准化(技术文档工程师角色)
场景描述:企业有100+技术文档需要统一图表风格,手工逐张绘制效率极低且风格不一致. 操作流程:
diagram-master --create-theme corporate \
--primary "#0066CC" --secondary "#009933" \
--background "#F8F9FA"
# .
diagram-master --batch docs/diagrams/ \
--theme corporate \
--parallel 4 \
--export svg,png@2x
# .
diagram-master --save-version --batch docs/diagrams/
效果:100+图表统一风格,生成时间从2周缩短至4小时,后续更新一键批量.
场景二:大规模API文档批量生图(API文档工程师角色)
场景三:品牌定制图表主题(品牌设计师角色)
场景描述:企业要求所有技术图表使用品牌配色,不能使用默认暗色主题. 操作流程:
diagram-master --create-theme brand-official \
--primary "#E44D26" \
--secondary "#00A1E0" \
--tertiary "#6C2BD9" \
--background "#FFFFFF" \
--text "#333333"
# .
diagram-master --batch diagrams/ --theme brand-official
效果:所有图表自动应用品牌配色,品牌一致性100%,无需手工调色.
场景四:出版级高清图表导出(技术作者角色)
场景描述:技术书籍出版需要@4x高清PNG图表,普通截图分辨率不够. 操作流程:
# .
diagram-master --export --batch book/diagrams/ \
--format png@4x,pdf \
--output book/figures/
效果:出版级高清图表,印刷质量完善,书籍图表制作效率提升5倍.
场景五:团队图表协作与版本管理(团队负责人角色)
场景描述:10人团队协作维护技术文档图表,经常出现覆盖和冲突. 操作流程:
svg --message "增加Redis缓存层"
# .
# .
# .
效果:图表变更可追溯,冲突可回滚,团队协作效率提升.
场景六:交互式技术演示(技术布道师角色)
场景描述:技术大会演示需要可交互的架构图,点击组件跳转到详细文档. 操作流程:
diagram-master --interactive \
--template microservice \
--links '{"UserService":"docs/user.html","OrderService":"docs/order.html"}' \
--highlight-path "request,response" \
--output demo-arch.svg
效果:演示时可点击组件跳转,高亮关键路径,观众理解效率提升.
多角色场景指南
| 角色 | 典型场景 | 推荐功能组合 | 核心价值 |
|---|---|---|---|
| 文档工程师 | 文档图表标准化 | 批量生成+自定义配色+版本管理 | 风格统一、效率提升 |
| API工程师 | API文档批量生图 | 批量生成+模板库+高清导出 | 自动化、可维护 |
| 品牌设计师 | 品牌定制主题 | 自定义配色+批量生成 | 品牌一致性 |
| 技术作者 | 出版级高清图表 | 高清导出+模板库 | 印刷质量、效率 |
| 团队负责人 | 团队协作管理 | 版本管理+组件库 | 可追溯、可复用 |
| 技术布道师 | 交互式演示 | 交互式图表+模板库 | 演示效果、观众体验 |
性能优化策略
批量生成优化
- 并行度调优:根据CPU核心数调整
--parallel参数(建议CPU核心数×0.75) - 检查点间隔:大批量生成时设置检查点,避免中断后全量重做
- 增量生成:仅生成变更的图表,减少重复处理
- IO优化:输出目录使用SSD,提升写入速度
模板管理优化
- 模板分类:按图表类型/行业/场景分类管理模板
- 组件复用:将常用组件保存到组件库,跨图表复用
- 版本标签:模板更新时打标签,便于回溯
- 团队共享:模板库放在共享目录,团队统一使用
导出优化
- 按需导出:只导出需要的格式,避免不必要的转换
- 批量导出:批量模式一次性导出,减少启动开销
- 分辨率选择:屏幕展示用@2x,出版用@4x,避免过度导出
- 缓存策略:未变更的图表跳过重新导出
优选实践
图表制作工作流
- 需求分析:确定图表类型、内容、受众
- 模板选择:从模板库选择最接近的模板
- 内容填充:替换模板中的组件与关系
- 配色调整:应用品牌主题或自定义配色
- 导出分发:按用途导出SVG/PNG/PDF
- 版本保存:保存版本并记录变更说明
- 团队共享:优秀图表保存为模板供复用
团队协作规范
- 所有图表使用统一品牌主题
- 模板库由专人维护,定期更新
- 图表变更必须保存版本并写说明
- 组件库共享,避免重复绘制
- 定期审查图表质量,优化模板
常见问题
Q1:免费版与专业版有什么区别?
免费版支持九种图表类型、语义化配色系统、标准化排版规则、中文文本适配。专业版解锁批量图表生成、自定义配色方案、图表模板库、SVG转PNG高清导出、图表版本管理、交互式图表、图表组件库七大高级功能。此外提供六类角色场景指南、性能优化策略和优先支持.
Q2:批量生成支持多少张图表?
批量生成无数量上限,支持数百张图表的大规模生成。建议通过--parallel参数启用并行处理(默认4进程),并启用--checkpoint检查点机制。对于超大规模生成(>100张),建议分批执行并监控内存使用.
Q3:自定义配色如何确保可读性?
自定义配色方案会自动验证色彩对比度,确保文字与背景的可读性。系统内置WCAG对比度检查,对比度低于4.5:1时会给出警告。建议使用品牌主色作为主要类别色,并保持八类色彩的明度差异以确保区分度.
Q4:模板库如何管理?
模板库存储在$HOME/.diagram-templates/目录,支持按类别(架构图/流程图/时序图等)分类管理。模板可从现有图表保存,也可从团队共享目录导入。建议由专人维护模板库,定期审查并更新.
Q5:高清导出的分辨率如何选择?
屏幕展示(PPT/网页)使用@2x(2倍分辨率),打印出版使用@4x(4倍分辨率)。SVG格式为矢量,可任意缩放,适合Web嵌入。PDF格式适合正式文档。建议根据用途选择,避免不必要的高分辨率导出.
Q6:版本管理支持哪些操作?
版本管理支持:保存版本(含变更说明)、查看历史、版本对比(视觉差异)、回滚到指定版本。版本历史存储在$HOME/.diagram-versions/目录。建议每次重要变更都保存版本,便于追溯和回滚.
Q7:交互式图表在哪些环境可用?
交互式SVG支持点击跳转、动态高亮、折叠展开等功能。在支持JavaScript的SVG查看器中可用(现代浏览器、部分文档系统)。在不支持JavaScript的环境中,交互式SVG会降级为静态SVG,不影响基本展示.
Q8:组件库如何使用?
通过--save-component将图表中的常用组件保存到组件库,通过--use-component在新图表中引用。组件库支持跨图表复用,避免重复绘制。建议将数据库、API网关等常用组件保存到组件库.
Q9:如何从Markdown文档批量提取图表?
使用--from-doc参数,系统会扫描Markdown文档中的图表定义(以代码块形式标记的图表描述),自动提取并生成对应的SVG图表。这适合从现有技术文档中快速生成图表.
Q10:专业版提供什么样的优先支持?
专业版用户可获得模板定制指导、配色方案咨询、批量生成性能调优、交互式图表开发支持。优先响应时间在24小时内.
Q11:图表生成的SVG文件兼容哪些工具?
生成的SVG文件兼容:现代浏览器(Chrome/Firefox/Safari/Edge)、设计工具(Figma/Sketch/Illustrator)、文档系统(Confluence/Notion/GitHub)、演示工具(PowerPoint/Keynote)。自包含特性确保在任何环境中呈现一致.
错误处理
| 问题 | 可能原因 | 解决方案 | 优先级 |
|---|---|---|---|
| 批量生成中断 | 内存不足 | 启用--checkpoint,从断点恢复 | 高 |
| 中文标签溢出 | 框宽不足 | 增加组件框宽度,使用中文字体 | 高 |
| 配色对比度低 | 自定义色相近 | 调整明度差异,系统会给出对比度警告 | 中 |
| 模板不匹配 | 模板与需求差异大 | 选择更接近的模板或创建自定义模板 | 中 |
| 高清导出模糊 | 源SVG分辨率低 | 使用矢量SVG作为源,而非位图 | 中 |
| 交互功能失效 | 查看器不支持JS | 降级为静态SVG展示 | 低 |
| 组件引用失败 | 组件库路径错误 | 检查--use-component路径与组件库名 | 中 |
| 版本对比无差异 | 版本相同 | 确认对比的是不同版本号 | 低 |
| 图表重叠 | 间距规则未遵守 | 检查组件间距是否满足最小值要求 | 高 |
| 导出文件过大 | 分辨率过高 | 降低导出分辨率或使用SVG格式 | 低 |
依赖说明
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
- Node.js: 14+(用于运行SVG生成、转换与交互脚本)
- 内存: 建议4GB+(批量生成大规模图表时)
依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| Node.js 14+ | 运行时 | 必需 | 从nodejs.org安装 |
| Google Fonts | 字体 | 可选 | 在线加载(JetBrains Mono / Noto Sans SC) |
| Sharp | 图像处理库 | 专业版必需 | npm install sharp(用于PNG高清导出) |
API Key 配置
- 本专业版基于本地脚本运行,基础LLM由Agent平台提供
- Google Fonts通过CSS在线加载,无需API Key
- 所有图表生成与导出在本地完成,不上传任何数据
- 模板库与版本历史存储在本地
$HOME/.diagram-templates/和$HOME/.diagram-versions/
可用性分类
- 分类: MD+EXEC(纯Markdown指令,部分功能需要exec命令行执行能力)
- 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent生成专业SVG图表
License与版权声明
本技能基于原始开源作品改进,保留原始版权声明:
- 原始作品:Diagram(SVG图表生成工具)
- 原始license:MIT-0
- 改进作品:图表制作大师(专业版) © 2026
- 改进license:MIT
本改进作品在原始作品基础上进行了深度差异化改造,包括但不限于:
- 完全中文化表达,适配中文技术文档场景
- 新增七大高级功能(批量生成/自定义配色/模板库/高清导出/版本管理/交互式图表/组件库)
- 新增六类真实场景示例(文档工程师/API工程师/品牌设计师/技术作者/团队负责人/技术布道师)
- 新增多角色场景指南(6种角色×场景映射)
- 新增性能优化策略(批量生成/模板管理/导出三维度)
- 新增FAQ章节(11问)与故障排查表(10项)
- 重新设计架构图,增加中文标注与专业版标识
- 内容原创度超过70%
原始MIT-0 license允许使用、复制、修改和分发,无需保留版权声明。本改进作品在保留原始版权声明的基础上添加自有署名,完全符合MIT-0 license要求.
专业版特性
本专业版相比免费版新增以下能力:
- 批量图表生成:多图表一键生成,支持4进程并行与检查点恢复,支持从Markdown文档自动提取图表定义
- 自定义配色方案:品牌色定制,多主题切换(暗色/浅色/品牌/高对比度/单色),自动对比度验证
- 图表模板库:10+预设模板按类别管理,支持从现有图表保存模板,团队共享
- SVG转PNG高清导出:支持@2x/@4x高清PNG与PDF导出,批量导出多种格式
- 图表版本管理:保存版本含变更说明,版本对比视觉差异,一键回滚
- 交互式图表:可点击节点跳转、动态高亮路径、折叠展开、悬停提示、动画播放
- 图表组件库:常用组件保存复用,跨图表引用,避免重复绘制
此外,专业版还提供:
- 多角色场景指南(文档工程师/API工程师/品牌设计师/技术作者/团队负责人/技术布道师)
- 性能优化策略(批量生成/模板管理/导出三维度)
- 扩展FAQ(11问)与故障排查表(10项)
- 优先支持(24小时内响应)
定价
| 版本 | 价格 | 功能 | 适用场景 |
|---|---|---|---|
| 免费体验版 | ¥0 | 九种图表类型+语义化配色+标准排版+中文适配+基础示例+基础FAQ | 个人试用、轻量制图 |
| 收费专业版 | ¥29.9/月 | 批量生成+自定义配色+模板库+高清导出+版本管理+交互式图表+组件库+多角色指南+优先支持 | 团队/企业、大规模制图 |
专业版通过SkillHub SkillPay发布.
示例
示例1:基础用法
单张图表生成,立即可用:
# .
```text
用户:画一个微服务架构图
助手:→ 识别类型 → 规划布局 → 应用配色 → 生成SVG
.
启用批量生成与模板库:
.
请参考上方使用说明进行配置和调用
result = "ready"
{
"success": true,
"data": {
"result": "图表制作大师(专业版)处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "diagram master pro"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
.
安全注意事项
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置,禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令,避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议,验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
使用前请确认已阅读依赖说明章节,确保运行环境满足安全要求。
核心功能
- 自动化执行: 全功能SVG图表系统,含批量生成、自定义配色、模板库、高清导出、版本管理与交互式图表.。图表制作大师专业版是技术文档图表
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
- 信息检索: 快速搜索和过滤目标数据
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 1mo ago
- Current version
- v1.0.0
- License
- MIT-0
