vsdx-wzq

SVG 矢量图 → Microsoft Visio VSDX 原生可编辑文件转换器（附 WorkBuddy 技能 svg-vsdx 自动同步）。

作者：吴振谦　邮箱：wuzhenqian@nbu.edu.cn　QQ：38328063

一、功能介绍

• SVG → VSDX 批量转换：把 .svg 矢量图转换为原生可编辑的 Visio .vsdx 文件，支持单文件、目录（递归）、ZIP 压缩包三种输入。
• 原生可编辑对象：矩形/椭圆变成 Visio 原生 2-D 形状，线条/箭头变成原生 1-D 连接线（箭头为 Visio 自带 EndArrow），框内文字写入 Shape.Text——选中即可编辑，不是图片。
• 教科书排版（textbook-16k-12cm 默认）：页面宽 120 mm（16 开），字号随版面缩放（Word 插入 11 cm 时正文约 5 号字），框内文字自动防溢出。
• 四色规范配色：所有框的填充/线色收敛为灰、深灰、深蓝、淡蓝四种，同级并排框自动间隔交替，重点框用深蓝凸显；文字全黑，中文宋体、英文数字 Times New Roman（罗马体）。
• 嵌套/悬浮文字正确归属：文字自动合并进所属小框的 Shape.Text，悬浮标注独立保留。
• WorkBuddy 技能自动同步：pip install 后自动把本包内置的技能（svg-vsdx）同步到 WorkBuddy 技能目录，开箱即用。

二、环境要求

三、安装

pip install vsdx-wzq

安装后 无需任何额外操作：本包会在你下一次运行任意 Python 命令时，自动把技能 svg-vsdx 同步到 ~/.workbuddy/skills/svg-vsdx/（首次安装才执行，不会覆盖你对技能的后续修改）。

四、命令行用法（CLI）

# 转换单个 SVG
svg2vsdx 图1.svg -o 输出目录

# 转换整个目录（递归收集 *.svg），不生成 PNG 预览、不打 zip
svg2vsdx 图片目录/ -o 输出目录 --no-preview --no-zip

# 转换 zip 压缩包
svg2vsdx 图片包.zip -o 输出目录

# 手动同步技能到 WorkBuddy（一般不需要，自动同步已覆盖）
svg2vsdx sync-skill
# 强制覆盖已安装技能（升级技能文件时用）
svg2vsdx sync-skill --force

# 帮助与版本
svg2vsdx --help
svg2vsdx --version

常用转换选项：

批量转换会在输出目录生成 conversion-report.json（每张图的形状/连接线/文字统计与警告）。

五、在 WorkBuddy 里的用法

1. pip install vsdx-wzq（自动同步技能，或手动执行一次 svg2vsdx sync-skill）；
2. 在 WorkBuddy 对话中直接引用技能，例如：
   • @svg-vsdx 把 C:\图片\图1.svg 转成 vsdx
   • @svg-vsdx 把 C:\图片目录\ 下所有 svg 批量转成 vsdx，不需要 png 预览
3. WorkBuddy 会读取 ~/.workbuddy/skills/svg-vsdx/ 下的技能说明自动完成转换。

提示：技能同步位置可通过环境变量 WORKBUDDY_SKILLS_DIR 指定其他 WorkBuddy 技能目录（默认 ~/.workbuddy/skills/）。

六、常见问题

• 转换报错「需要 Windows / Visio」？ 转换必须在装有桌面版 Microsoft Visio 的 Windows 机器上运行；WorkBuddy 中执行时需允许桌面 COM 授权（不要在受限沙箱里跑）。
• 技能没生效？ 确认 ~/.workbuddy/skills/svg-vsdx/SKILL.md 存在（svg2vsdx sync-skill 可手动补装）；然后重启 WorkBuddy 或新开对话。
• 技能被我改坏了/想升级？ 执行 svg2vsdx sync-skill --force 从包内恢复官方版本。
• 如何升级插件？ pip install -U vsdx-wzq，然后 svg2vsdx sync-skill --force 同步新技能。

七、许可

MIT License，© 2026 吴振谦（wuzhenqian@nbu.edu.cn）