SuperAPI AI 工具集

doc

办公与效率

查看项目

更新于 10-15 21:12

技能介绍

用途:读取或审阅 DOCX 内容(表格、图表、分页等布局重要处);创建或编辑具有专业排版的 DOCX 文件;交付前校验视觉布局。

主要能力与工作流:优先进行可视化审阅。若环境中有 soffice 和 pdftoppm,可先将 DOCX 转 PDF 再转 PNG;或使用 scripts/render_docx.py(需 pdf2image 与 Poppler)。工具缺失时需安装,或请用户在本地查看渲染页面。编辑与结构化创建(标题、样式、表格、列表)使用 python-docx。每次实质修改后应重新渲染并检查页面;无法可视化审阅时,用 python-docx 提取文本作为回退,并说明布局风险。保持中间产物有条理,最终确认后清理。

目录约定:中间文件放入 tmp/docs/,完成后删除;最终产物在本仓库中写入 output/doc/;文件名保持稳定且具描述性。

依赖安装:推荐 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。

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

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