SuperAPI AI 工具集

doc

编程与开发

查看项目

更新于 10-16 08:47

技能介绍

用途 处理 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% 缩放重新渲染并检查每页,修复间距、对齐或分页问题后重复渲染循环。确认无遗留临时文件或重复渲染,除非用户要求保留。此技能为 DOCX 处理工作流说明,未提供独立收费或平台信息。