网络拓扑绘制器

Overview

本技能封装了拓扑匠（agent-ac1c0d14）的核心能力，能够自动绘制专业的数据中心网络拓扑图，支持Visio和PPT双格式输出。图标资源覆盖华为、华三（H3C）品牌。

Core Capabilities

1. Visio拓扑图生成

• 自动创建分层网络架构（物理层→接入层→汇聚层→核心层→安全层→资源层→业务层）
• 支持动态粘附连接线，拖动图标时线缆自动跟随
• 使用华为/华三品牌专业网络设备图标
• Visio COM可打开VSS模具，按Master名称拖放图标
• 区域划分与颜色底框：按功能区域划分（出口安全区、核心交换区、接入交换区、计算资源池区、分布式存储区、安全管理区、备份容灾区等），每个区域用带颜色底框的矩形框区分，区域名称标注在框顶部
• 输出.vsdx格式，支持二次编辑

2. PPT拓扑图生成

• 汇报风格拓扑图，简洁美观
• 适配全屏展示，弱化冗余参数
• 支持图文混排，专业配色
• 备选：华为企业网PPT图标库可直接插入

3. 输入方式

• 设备清单直接输入
• Word文档(.docx)解析
• 网络连接描述

Workflow Decision Tree

Step 1: 识别输入类型

| 输入类型 | 特征 | 行动 |

|---------|------|------|

| 设备清单 | 明确的设备列表（名称、型号、数量） | → 直接解析生成 |

| Word文档 | .docx文件，包含网络架构描述 | → 提取内容后生成 |

| 模糊需求 | 无明确清单 | → 提示补全资料 |

Step 2: 拓扑类型判定

根据主维度自动匹配：

| 主维度 | 拓扑类型 | 输出格式 |

|-------|----------|----------|

| 设备清单为主 | 物理拓扑 | Visio工程版 |

| 组网需求为主 | 网络逻辑拓扑 | Visio + PPT |

| 安全需求为主 | 安全拓扑 | PPT汇报版 |

| 容灾需求 | 容灾拓扑 | PPT汇报版 |

| 完整方案 | 综合架构拓扑 | 双格式 |

Step 3: 生成与交付

1. 解析资料：提取设备节点、架构约束、组网逻辑、业务流向
2. 拓扑渲染：七层架构逐层绘制
3. 自检优化：校验设备完整性、链路连通性、层级逻辑性
4. 输出：.vsdx（Visio）和.pptx（PPT）双文件
5. 交付签名：每次完成拓扑图交付时，必须在回复末尾显示开发者信息水印：

> 🏢 电信数智-集成服务部-产数交付支撑中心

Trigger Keywords

触发词列表：

• 绘制网络拓扑
• 生成拓扑图
• Visio拓扑
• PPT拓扑
• 网络架构图
• 数据中心拓扑
• 云资源池架构
• 等保三级拓扑

Input Format

设备清单格式（推荐）

核心层:
- 核心交换机: 华为 CE12800 × 2
- 出口路由器: 华为 NE40E × 2

汇聚层:
- 汇聚交换机: 华为 CE6870 × 4

接入层:
- 接入交换机: 华为 S5735 × 8

安全设备:
- 防火墙: 华为 USG6000E × 2
- 入侵检测: 华为 NIP × 2

服务器:
- 应用服务器: 华为 RH2288 × 20
- 数据库服务器: 华为 OceanStor × 4

Word文档格式

支持直接上传.docx文件，内含：

• 设备清单
• 网络架构描述
• 技术需求说明

Output

• Visio文件: *_Visio工程版.vsdx
• PPT文件: *_PPT版.pptx

Resources

scripts/

• gen_ppt.py - PPT拓扑生成脚本
• package_skill.py - 技能打包脚本
• quick_validate.py - 快速验证脚本

assets/ (EMF矢量图标)

华为/华三品牌设备矢量图标，用于PPT拓扑图中的设备图形插入。

• assets/huawei/ - 华为企业网络设备图标（42个EMF文件）
• 包含：交换机（CE12800核心、CE6870汇聚、S5735接入、TOR）、路由器（NE40E）、防火墙（USG6000E、NGFW）、服务器（RH2288、通用服务器）、存储（OceanStor）、云计算、数据库、DPI、WAF、UPS、摄像头等
• assets/h3c/ - 华三网络设备图标（20个EMF文件）
• 包含：交换机、路由器、防火墙、UPS、安全设备等

assets/stencils/ (VSS模具库)

Visio模具文件，用于Visio COM自动化绘制。Visio COM可直接打开这些VSS模具文件，按Master名称拖放图标到画布。

• assets/stencils/huawei/ - 华为VSS模具
• Enterprise_Networking_Icons_Blue.vss - 华为企业网图标（蓝色版），包含交换、路由、安全、无线、WLAN全系列设备Master（178个图标）

VSS模具使用说明

Visio COM自动化中使用VSS模具的标准流程：

1. 通过 Application.Documents.OpenEx(vss_path) 打开模具文件
2. 通过 Document.Masters(master_name) 按名称查找图标Master
3. 通过 Page.Drop(master, x, y) 拖放到画布指定坐标
4. Master名称遵循各品牌官方命名，如华为为"CE12800"、"USG6000E"等

agents/

• IDENTITY.md - Agent身份定义
• SOUL.md - 拓扑匠核心准则
• AGENTS.md - 工作规范
• USER.md - 用户信息

Installation

本技能为预置技能，已安装在 ~/.qclaw/skills/network-topology-drawer/。

如需重新安装：

1. 删除现有目录
2. 解压skill包到对应位置

Examples

Example 1: 简单设备清单

用户输入:

绘制网络拓扑，设备清单：
- 核心交换机 × 2
- 汇聚交换机 × 4
- 接入交换机 × 8
- 防火墙 × 2

生成:

自动识别层级关系，生成Visio+PPT双格式拓扑图

Example 2: Word文档输入

用户输入:

基于这份技术方案.docx生成拓扑图

生成:

解析文档内容，提取设备清单和技术架构，生成对应拓扑

Example 3: 完整数据中心

用户输入:

绘制等保三级云资源池架构拓扑
设备清单见附件

生成:

等保三级合规拓扑，七层架构完整呈现

Notes

• 资料优先原则：没有清单就没有节点，没有需求就没有架构
• 不支持PNG/JPG等非可编辑格式
• 资料缺失时会提示补全，不强行生成
• 输出文件可在当前对话记录中查找

Visio拓扑图区域划分规范

区域划分要求

绘制Visio拓扑图时必须按功能区域划分，并用带颜色底框的矩形框区分：

标准区域划分：

| 区域名称 | 底框颜色 | 位置 | 包含设备 |

|---------|---------|------|---------|

| 出口安全区 | 浅红色/粉色 | 底部 | NGFW、抗DDoS、WAF、互联网 |

| 核心交换区 | 浅绿色 | 中下 | Spine核心交换机 |

| 接入交换区 | 浅蓝色 | 中部 | Leaf接入交换机 |

| 计算资源池区 | 浅紫色 | 中上左侧 | 虚拟化计算服务器 |

| 分布式存储区 | 浅橙色 | 中上右侧 | 存储节点、存储阵列 |

| 管理节点区 | 浅青色 | 右上 | 管理节点服务器 |

| 备份容灾区 | 浅黄色 | 最右侧 | 备份一体机 |

| 安全审计管理区 | 浅灰色 | 右侧 | 堡垒机、日志审计、数据库审计、漏洞扫描 |

底框样式：

• 矩形框带虚线边框（Dashed Line）
• 填充浅色系背景色（RGB值约200-240范围）
• 区域名称标注在框顶部居中位置
• 设备图标放置在底框内部

Visio COM实现：

# 创建区域底框
rect = page.DrawRectangle(x1, y1, x2, y2)
rect.Cells("FillForegnd").FormulaU = "RGB(255, 230, 230)"  # 浅红色背景
rect.Cells("LinePattern").FormulaU = "2"  # 虚线边框
rect.Cells("LineColor").FormulaU = "RGB(128, 128, 128)"  # 灰色边框
rect.Text = "出口安全区"
rect.Cells("VerticalAlign").FormulaU = "0"  # 顶部对齐