前言¶

写立项材料、售前方案或者培训课件时，最耗时的往往不是内容，而是那张架构图。文字版分层描述写得很清楚，落到图上就要手动画框、对齐、连线，改一次配置重画一次，Visio 里拖半天仍然对不齐。等到要给高管层汇报时，图的视觉一致性和专业性又成了一道坎。

下面介绍的 Skill 就是针对这个环节：你给出分层结构的描述，它负责排版、连线、上色和导出。

这是什么¶

产品架构图-business-architecture-diagram 是一个生成分层业务系统架构图与流程图的 Skill。坐标 @user_9f772957/business-architecture-diagram，版本 1.0.2，发布者 user_9f772957，来源 community，分类 design-media，无需 API Key。

它解决的问题很单一：把「展示层 → 应用层 → 能力层 → 数据层 → 基础设施层」这类文字描述，转成一眼能看懂、可以直接放进汇报材料的分层架构图。生成物支持 PNG / SVG / HTML / PPTX 四种导出格式，并且内置中文字体检测和输入校验。

核心功能¶

分层架构图与连线¶

支持多层结构自动排布，每层用层名色块加圆角模块卡片表示。模块之间可以画箭头连线，并标注依赖关系或数据流方向。这一层做了自动布局，不需要手工调位置。

多格式导出¶

• PNG：适合贴进文档、工单、公众号配图。
• SVG：矢量，可在 Figma、Illustrator 里二次编辑。
• HTML：带悬停提示的交互版，适合在浏览器里演示。
• PPTX：演示版，可直接放进幻灯片。官方资料提到，缺少对应运行环境时会自动降级为 JS 模板，不会直接失败。

中文字体自适应¶

自动检测 Windows / macOS / Linux 上的中文字体，缺失时给出明确的修复命令，而不是渲染出一片方框后静默继续。

校验与异常处理¶

对输入做健壮校验：配置缺层、模块重名、连线指向不存在的节点、画布超出边界，这些情况都会抛出 DiagramError 并附带修复建议，不会静默崩溃或输出一张错图。

零模板起步¶

内置 DEMO_CONFIG 示例配置，一行命令即可生成示例图，方便先确认环境是否可用。

安装与启用¶

已抓取的官方资料里没有给出安装命令和目录约定，这部分以下方官方页面为准：

https://www.skillhub.cn/skills/user_9f772957/business-architecture-diagram

需要说明的是，该 Skill 基于通用 SKILL.md 格式，具体是放到客户端的 skills 目录还是走对应客户端的 Skill 安装入口，应以官方页面说明为准，本文不作推测。无需配置 API Key，标签为 requires_api_key=false。

典型用法¶

按官方资料描述，使用路径是「填 JSON 配置 → 跑命令 → 出图」，从填配置到出图大约 30 秒量级。

上手顺序建议这样走：

1、先用内置 DEMO_CONFIG 跑一遍，确认中文字体检测和导出链路正常。
2、把 DEMO_CONFIG 复制出来，替换成自己的分层描述：层名、每层的模块、模块之间的连线与标注。
3、导出时按用途选格式：文档配图用 PNG，需要二次编辑用 SVG，演示用 PPTX，交互展示用 HTML。
4、改配置即改图，同一份配置可以随文档一起版本化管理。

配置中出现的错误，例如连线指向了不存在的模块，会以 DiagramError 抛出并给出修复建议，按提示改正即可，不需要去猜为什么图没出来。

适用场景与限制¶

适合的场景：产品/技术架构汇报、立项材料、售前方案、培训课件配图，以及任何需要把「文字版分层描述」转成「一眼看懂的架构图」的场合。

不适用的场景，官方资料已经明确列出：

• 时序图
• UML 类图
• 超大网络拓扑
• 3D 插画

这些超出本 Skill 边界，它会明确告知，不会硬画一张不合适的图出来。

使用前值得留意两点：一是中文字体环境，如果目标机器上没有中文字体，要先按提示补装，否则导出结果不可用；二是 PPTX 导出依赖运行环境，环境缺失时会降级为 JS 模板，介意成品差异的话需要先确认环境。

小结¶

这个 Skill 的价值在于把架构图从「画」变成「配」：改配置即改图，版本化管理避免手绘漂移，输出物能直接满足汇报场景的视觉要求。相比从零画 Visio，省下的主要是排版和重画的时间。

官方地址：https://api.skillhub.cn/user_9f772957/business-architecture-diagram