SuperAPI AI 工具集

doc

办公与效率

查看项目

更新于 10-16 05:47

技能介绍

用途:读取或审阅 DOCX 内容(表格、图表、分页等版面重要时),创建或编辑具有专业格式的 DOCX 文件,并在交付前验证视觉版面。

主要能力:以 python-docx 进行结构化编辑与创建(标题、样式、表格、列表);通过渲染进行视觉审阅。若系统具备 soffice 与 pdftoppm,可将 DOCX 转 PDF 再转 PNG;也可使用 scripts/render_docx.py(依赖 pdf2image 与 Poppler)。每次有意义的修改后重新渲染并检查页面。若无法视觉审阅,则用 python-docx 提取文本作为回退,并说明版面风险。

使用方式:优先用 uv 管理依赖,安装 Python 包:uv pip install python-docx pdf2image;若 uv 不可用则用 python3 -m pip install python-docx pdf2image。渲染所需系统工具:macOS 用 brew install libreoffice poppler;Ubuntu/Debian 用 sudo apt-get install -y libreoffice poppler-utils。渲染命令:DOCX 转 PDF 用 soffice -env:UserInstallation=file:///tmp/lo_profile_$$ --headless --convert-to pdf --outdir $OUTDIR $INPUT_DOCX;PDF 转 PNG 用 pdftoppm -png $OUTDIR/$BASENAME.pdf $OUTDIR/$BASENAME;内置辅助脚本用 python3 scripts/render_docx.py /path/to/file.docx --output_dir /tmp/docx_pages。无需环境变量。中间文件放 tmp/docs/ 并在完成后删除,最终产物写入 output/doc/,文件名保持稳定且具描述性。

质量要求:交付客户可用文档,字体、间距、页边距一致,层级清晰;避免文字裁切或重叠、表格断裂、乱码或默认模板样式;图表、表格与视觉元素在渲染页中清晰且对齐正确;仅使用 ASCII 连字符,避免 U+2011 等 Unicode 破折号;引用与参考文献需人类可读,不得残留工具标记或占位字符串。

最终检查:交付前以 100% 缩放重新渲染并检查每一页,修复间距、对齐或分页问题并重复渲染循环;确认无临时文件或重复渲染残留,除非用户要求保留。

限制:若环境中无法安装依赖,需告知用户缺少哪个依赖及本地安装方式;无法视觉审阅时只能回退到文本提取并提示版面风险。