Visio(.vsdx)图表的解析、生成、修改与导出能力。当用户要求读取或总结 .vsdx 文件内容、把架构图/流程图/链路图生成为可编辑的 Visio 文件、批量将 .vsdx 导出为 SVG/PNG/PDF、或按固定视觉规范(蓝
Visio 图表处理
概述
本 skill 提供 .vsdx(Visio 2013+)文件的程序化处理能力,覆盖四类任务:
- 解析:不依赖 Visio 安装,直接按 OPC 包解包 XML,输出页/图元/连线/文本的结构化摘要。
- 生成:由 JSON 规格确定性生成基础框图(矩形/圆角矩形节点 + 直线连线,可设箭头、虚线、标签),产物可用 Visio 打开继续编辑。
- 修改:解包 → 改写 pageN.xml → 重新打包的安全修改路径。
- 导出:通过 Visio COM 自动化批量导出 SVG/PNG/PDF(需本机安装桌面版 Visio)。
所有产出的视觉规范遵循用户固定配色与制图约定(见 references/style-mapping.md)。
工作方式
第一步:场景分流
读取 references/workflows.md 的场景分流表,确定技术路径:
- 「看看/讲讲这个 vsdx」→ 解析摘要路径。
- 「生成可编辑 Visio 图」→ 生成路径(基础框图用脚本;复杂图形先出 SVG 交付并附 Visio 导入指引)。
- 「批量转 SVG/PDF」→ COM 导出路径。
- 「改 vsdx 里的内容」→ 修改路径。
- 「要报告/汇报材料」→ 单文件 HTML 为主,Visio 文件作附件。
第二步:按需加载参考
- 需要理解 .vsdx 内部结构、解析或修改 XML 时,读
references/vsdx-format.md。 - 需要确定颜色、字体、图类画法时,读
references/style-mapping.md。 - 执行生成/导出/修改的具体步骤与注意事项,读
references/workflows.md。
第三步:调用脚本
| 任务 | 脚本 | 依赖 |
|---|---|---|
| 解析 .vsdx | python scripts/inspect_vsdx.py <file.vsdx> [--json] | Python 3 |
| 生成 .vsdx | python scripts/build_vsdx.py <spec.json> <output.vsdx> | Python 3 |
| 导出 SVG/PNG/PDF | scripts/export_via_com.ps1 -InputFile <vsdx> -OutDir <dir> -Format svg | 桌面版 Visio |
生成流程要点:
- 依需求设计节点/连线清单,按 style-mapping.md 定坐标(英寸,横向 A4:11.69×8.27)与颜色语义。
- 写 JSON 规格(格式见 build_vsdx.py 文件头),运行生成脚本。
- 本机有 Visio 时导出 SVG 自检(文字溢出、箭头方向、配色),再向用户交付。
- 说明产物为未胶水连接的自由形状,用户可在 Visio 中拖动微调。
已知限制
- 生成脚本仅支持矩形/圆角矩形节点与直线连线;泳道、扇形、模具图形需在 Visio 内精修或改走 SVG 交付。
- COM 导出依赖本机 Visio;未安装时交付 .vsdx 并附结构摘要代替预览。
资源文件
scripts/inspect_vsdx.py— .vsdx 结构解析器(页/图元/连线/文本,Markdown 或 JSON 输出)。scripts/build_vsdx.py— JSON 规格 → .vsdx 生成器(颜色 hex、箭头、虚线、标签、圆角)。scripts/export_via_com.ps1— Visio COM 批量导出 SVG/PNG/PDF。references/vsdx-format.md— .vsdx OPC 包结构、page XML 要点、Shapesheet 常用单元格。references/style-mapping.md— 固定配色/字体/图类到 Visio 的映射规则。references/workflows.md— 场景分流表、生成标准流程、修改注意事项、已知限制。
- Downloads
- 144All time
- Security audit
- Pass
- Last updated
- 1w ago
- Current version
- v1.0.0
- License
- MIT-0
