SuperAPI AI 工具集

docx-svg

办公与效率

查看项目

更新于 10-15 23:42

技能介绍

用途:向 Word .docx 文件添加、嵌入或更新 SVG 图形。核心政策为零转换:不得先把 SVG 转成 PNG/JPEG 等位图,现代 Word(2016+)通过 asvg:svgBlip OOXML 扩展原生支持 SVG,转换会损失矢量优势。

主要能力:提供两种插入方式。首选 officecli(需 v1.0.64 及以上),支持内联图片、指定尺寸、插入到指定段落后、浮动图片与文字环绕,以及设置 alt、亮度、对比度、位置等属性。回退方案为 Python 猴子补丁 scripts/svg.py,导入后自动为 python-docx 和 docxtpl 增加 SVG 支持,可用 add_picture 直接插入 .svg,或用 SvgInlineImage 在模板中渲染;省略宽高时自动按页面可用宽度缩放。

使用方式:先运行 officecli --version 检查版本,满足则用 officecli add/set 命令;否则用 uv run python scripts/svg.py 安装依赖并启用补丁。

限制:Word 将 SVG 渲染为静态图,不支持悬停、动画或内嵌 JavaScript;Python 回退方案不生成 PNG 兜底,旧版 Word(2016 前)可能无法显示;其尺寸解析统一按 72 DPI 归一为像素,打印精确尺寸需显式指定 Mm/Inches/Cm。