SuperAPI AI 工具集

doc

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:在任务涉及读取、审阅或编辑 .docx 文档时使用,特别是当表格、图表、分页等版面效果重要时;也用于创建和编辑具有专业格式的 DOCX 文件。

主要能力:优先进行可视化审阅(版面、表格、图表)。若环境中有 soffice 和 pdftoppm,可将 DOCX 转为 PDF 再转为 PNG 逐页检查;或使用 scripts/render_docx.py(需 pdf2image 和 Poppler)。编辑与结构化创建(标题、样式、表格、列表)使用 python-docx。每次有意义的修改后重新渲染并检查页面;若无法可视化审阅,则用 python-docx 提取文本作为回退方案,并提示版面风险。中间产物需组织整齐,最终确认后清理。

使用方式:临时文件放在 tmp/docs/,完成后删除;最终产物写入 output/doc/。文件名保持稳定且具描述性。依赖优先用 uv 管理: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% 缩放重新渲染并逐页检查,修复间距、对齐或分页问题并重复渲染;确认无残留文件(临时文件、重复渲染),除非用户要求保留。