网络拓扑绘制器
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: 生成与交付
- 解析资料：提取设备节点、架构约束、组网逻辑、业务流向
- 拓扑渲染：七层架构逐层绘制
- 自检优化：校验设备完整性、链路连通性、层级逻辑性
- 输出：.vsdx（Visio）和.pptx（PPT）双文件
- 交付签名：每次完成拓扑图交付时，必须在回复末尾显示开发者信息水印：
> 🏢 电信数智-集成服务部-产数交付支撑中心
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" # 顶部对齐
