vector-text-fixer

用途：修复 PDF 与 SVG 矢量文件中因字体嵌入、编码错误或字体缺失替换造成的乱码文本，并生成可用于 AI 编辑工具的修复文件或可编辑 JSON。主要能力：支持单文件与文件夹批处理；覆盖 PDF 的方框、问号、编码转换乱码、字体替换缺失及多语言混合编码，以及 SVG 的文本实体编码错误、特殊字符转义、无效字体引用和 XML 编码声明错误；提供 minimal/standard/aggressive 三档修复级别，standard 为默认；可选交互式修复与导出 JSON；无字体映射时输出文本映射 JSON 供人工校正。使用方式：先确认输入的 PDF/SVG 路径或批处理文件夹及输出路径；运行脚本，如 python scripts/main.py --input document.pdf --output fixed.pdf、--input diagram.svg --output fixed.svg、--batch ./input_folder --output ./output_folder、--interactive、--export-json editable.json，或加 --repair-level aggressive。参数中 --input 与 --batch 至少提供一个，--output 必填，--encoding 默认自动检测。限制与注意：加密 PDF 需先解锁，扫描件需先做 OCR，严重损坏文件可能无法完全修复，罕见字体可能映射错误；低置信度文本块需人工复核，脚本失败时按回退模板报告；本技能不处理格式转换、直接编辑 PDF 内容或非矢量文件。依赖：pdfplumber>=0.10.0、PyMuPDF>=1.23.0、cairosvg>=2.7.0、beautifulsoup4>=4.12.0、fonttools>=4.40.0、chardet>=5.0.0、Pillow>=10.0.0。