SuperAPI AI 工具集

doc

办公与效率

查看项目

更新于 10-15 20:34

技能介绍

用途:读取、审阅或编辑 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% 缩放重新渲染并检查每一页,修复间距、对齐或分页问题并重复渲染流程;确认无临时文件、重复渲染等残留,除非用户要求保留。