# Image To Visio Redraw

> 把一张架构图/流程图/体系图的图片（截图、照片、PPT 导出图）按内容用 Visio 原生矢量形状重绘为可编辑 .vsdx——不贴图、不描图，每个元素都是独立可编辑形状。适用于用户说"把这张图做成 Visio/ vsdx"、"按图片内容重画"、"不要直接插入图片"、"要可编辑的"。含看图拆解方法论、布局还原公式、配色语义提取、模板脚本与自检清单。

- Skill: `share-budaozhe/image-to-visio-redraw` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add share-budaozhe/image-to-visio-redraw`
- Raw SKILL.md: https://api.skillmd.com/api/skills/share-budaozhe/image-to-visio-redraw/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: share-budaozhe (https://skillmd.com/u/share-budaozhe)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/share-budaozhe/image-to-visio-redraw

---


# 图片转 Visio 矢量重绘

把一张位图里的架构图，**按内容重新画成原生可编辑的 Visio 矢量形状**。

## 触发条件

用户给出一张图（PNG/JPG/截图/照片）并表达以下任一意图：

- "把这张图做成 vsdx / 画成 Visio"
- "按图片内容重画一份可编辑的"
- "不要将图片直接插入 Visio"（**明确要求不贴图**）
- "这张架构图矢量化"

## 核心原则

| 要求 | 说明 |
|---|---|
| **不贴图** | 绝不 `Page.Import` 或插入图片对象。原图只作为"内容来源"，不出现在产物里 |
| **逐元素重画** | 每个框、每条线都是独立 Visio 形状，可选中、可拖动、可改字 |
| **结构一致** | 位置关系、层次、配色语义要还原原图 |
| **允许纠错** | 原图若有标注错误（如标签重复、分类不合理），按逻辑修正并在回复中告知用户 |

---

## 工作流（6 步）

```
① 读图  →  ② 拆解结构  →  ③ 写数据脚本  →  ④ 生成 vsdx  →  ⑤ 导出 PNG  →  ⑥ 对比修正
   Read         方法论          模板改造        build.ps1      export.ps1      与原图逐区核对
                                                                    ↑                  │
                                                                    └────── 迭代 ───────┘
```

### ① 读图

用 Read 工具直接读图片文件（多模态能力）。**读的时候就要开始拆解**，不要读完后凭印象画。

### ② 拆解结构（核心，见 `references/01-看图拆解方法论.md`）

产出三样东西：
1. **区域清单**：顶部/主体/侧栏/底部各是什么
2. **配色语义表**：每种颜色代表什么角色
3. **层级树**：哪块包含哪块

### ③ 写数据脚本

复制 `scripts/template_gen_data.py`，改内容。**不要从零写**——模板已含全部 helper。

### ④ 生成 vsdx

```powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force
& "scripts\build_visio.ps1" -JsonPath "_visio_data.json" -OutPath "输出图.vsdx"
```

### ⑤ 导出 PNG

```powershell
& "scripts\export_png.ps1" -VsdxPath "输出图.vsdx" -OutDir "预览"
```

### ⑥ 对比修正（不可省略）

**读导出的 PNG，与原图逐区域对比**。这一步能抓出：

| 常见问题 | 表现 | 修正 |
|---|---|---|
| 文字溢出 | 字超出框 | 增大 `h` 或减小 `fs` |
| 元素重叠 | 两块叠在一起 | 检查 Y 累加 |
| 方向错 | 该竖排的横排了 | 检查循环写的是 x 还是 y |
| 层级丢失 | 看不出包含关系 | 加底色块作背景，子卡片叠在上面 |
| 颜色不对应 | 视觉层次变了 | 核对配色语义表 |

---

## 布局还原要点

### 坐标系

- 页面 **A2 横向**：`PW, PH = 23.4, 16.5`（英寸）
- 页边距 `0.4`
- **Y 从上往下累加**（脚本内部会自动翻转成 Visio 的左下原点坐标）
- 单位统一用英寸，文字大小用 `pt`（由 `fs` 参数控制）

### 高度估算公式

```
标题条高        ≈ 0.40 ～ 0.60
内容行高（单行）≈ 0.23 ～ 0.28
卡片总高        = 标题高 + 行数 × 行高 + 上下 padding(各 0.10～0.14)
```

宁可**预留略高**，也不要让文字挤出去——溢出比留白难看得多。

### 分区顺序

```
1. 先切竖向大块（左栏 / 主体 / 右栏）
2. 再在主体内切横向行（云 / 网 / 端…）
3. 行内切列（等宽均分）
4. 列内切卡片（标题条 + 内容）
5. 最后放页眉、页脚、角标
```

### 层级表达

靠三件事表达"包含"：
1. **大底色块**先画（作为容器背景）
2. **子卡片**后画，叠在容器内（留 0.08～0.15 内边距）
3. **容器边框**用深一档的颜色，`lw` 加粗（1.0～1.2）

---

## 配色语义提取

架构图里**颜色 = 角色**。动手前先列一张表：

```
深蓝 NAVY (31,78,121)   → 主标题 / 层名 / 页眉
亮蓝 BLUE (46,117,182)  → 卡片标题条
浅蓝 XLBLUE(222,235,247) → 容器背景
白   WHITE              → 内容区
橙 / 绿 / 紫 / 黄        → 区分不同归属方（同色 = 同类）
```

**同色必定同角色**，这是还原视觉层次的关键。如果原图用了某个色只出现一次，多半是强调，单独记下来。

---

## 处理原图的"不完整"和"错误"

架构图常见两种情况，都要主动处理：

**① 省略号 / "…" / "等"**
按其归类**补全**完整列表，并在页脚注明"原图中『…』表示未完整列出的同类项目，已按其归类完整列出"。

**② 标注错误**
例如某分类里同一个标签出现两次（疑似原图标注失误）。按合理逻辑重新拆分，并**在回复中明确告诉用户**：

> 原图右半"信息物理基础设施"里"低空通信基础设施"重复出现两次，疑似标注错误，我按逻辑拆成了 5 段：通信 → 导航 → 监视 → 其他保障 → 管控。如需保留原样请告诉我。

---

## 模板脚本用法

`scripts/template_gen_data.py` 已含全部 helper：

| helper | 用途 |
|---|---|
| `newpage(name)` | 建页 |
| `add(...)` | 基础矩形（最常用） |
| `card(...)` | 标题条 + 内容框 |
| `section(...)` | 带标题条的分区块（用于端层这类多段） |
| `sidebar(...)` | 左右竖栏（标题 + 若干项） |
| `cols(n, gap)` | n 列等宽的 x 坐标 |
| `footer(...)` | 页脚说明 |

**改造流程**：
1. 复制模板 → 重命名
2. 改 `PAGES` 里的内容
3. 运行输出 JSON
4. 跑 `build_visio.ps1`

---

## 完整示例：低空智能网联体系参考架构

原图是一张网传的架构截图，要求重绘为 vsdx。

| 项目 | 结果 |
|---|---|
| 产出 | 1 页 A2 横向，91 个原生矢量形状 |
| 结构 | 顶部 4 场景 + 左标准栏 + 右安全栏 + 云/网/端三层 + 底部 5 参与方 |
| 迭代 | 2 轮（首轮布局可用，微调后定稿） |
| 纠错 | 原图"低空通信基础设施"标签重复，按逻辑拆为 5 段 |

布局骨架（可直接复用）：

```
PW, PH = 23.4, 16.5
LX, LW = 0.4, 2.5          # 左竖栏
RX, RW = 20.5, 2.5         # 右竖栏
CX = LX + LW + 0.2         # 主体起点
CW = RX - CX - 0.2         # 主体宽度
ROW_H = [3.0, 2.4, 剩余]    # 云 / 网 / 端 三行高度
```

---

## 常见问题

**Q：能不能直接把图片插入 Visio 然后描图？**
A：技术上可以，但违反用户"不要贴图"的要求，产物也不可编辑。**始终用矢量形状重画。**

**Q：原图很复杂，形状超过 200 个怎么办？**
A：优先保证**结构和主要元素**完整。细碎的装饰（阴影、渐变、图标）可以省略——架构图的信息价值在结构和文字，不在装饰。

**Q：用户要多页怎么办？**
A：同一份 JSON 里放多个 `newpage()`，每页独立布局。参考 `visio-com-automation` skill 的 9 页案例。

**Q：中文字体显示不对？**
A：`build_visio.ps1` 已处理（用字体 ID 而非名称，YaHei ID=174）。详见下方踩坑清单。

---

## 踩坑清单（绘制引擎层）

已内置在 `build_visio.ps1` 里，此处列出备查：

1. **字体用数字 ID**：`Char.Font = $doc.Fonts.Item("Microsoft YaHei").ID`（不是字体名）
2. **箭头是 `EndArrow`/`BeginArrow`**，不是 `LineEndArrow`
3. **Y 轴翻转**：`$y = $pageH - $top - $h`
4. **不要删最后一页**：复用 `Pages.Item(1)` 作首页
5. **PS 5.1 中文编码**：脚本保持纯 ASCII，中文走 UTF-8 JSON
6. **加粗**：`Char.Style = "1"`
7. **进程残留**：`finally` 里 `Quit()` + `ReleaseComObject` + `GC`
8. **exit code 会骗人**：用日志文件捕获输出再读
9. **生成失败后先查残留 Visio 进程**：构建在 SaveAs 处失败（日志停在 `page done`、无 SAVED）时，
   常有卡死的 VISIO 进程占着文件 → `Get-Process VISIO | Stop-Process -Force`，删旧文件再重跑；
   每轮生成结束后主动清一次 Visio 进程更稳妥
10. **conn 的 dash 是 LinePattern 编号**：0=线不显示（箭头也消失），实线必须 1，虚线 2
11. **椭圆**：`add(..., oval=True)`（引擎 DrawOval）；云朵等不规则形用大椭圆近似，页脚注明

---

## 依赖

- **本机需安装 Microsoft Visio**（Office16，COM `Visio.Application` 已注册）
- Python 3（生成 JSON，标准库即可）
- Windows PowerShell 5.1+

> 本 skill 与 `visio-com-automation` 共享同一套绘制引擎，后者涵盖更多通用场景（多页架构图、接口表、标准矩阵）。当前 skill 专注「图片 → 矢量」这一特定入口。