SuperAPI AI 工具集

office-docx

办公与效率

查看项目

更新于 10-15 19:58

技能介绍

用途:用 Python 的 python-docx 构建可编辑的 .docx 文档,也可读取和解析已有文档,不依赖 LibreOffice。

主要能力:使用真实 Heading 样式(doc.add_heading 或 paragraph.style = "Heading 2")驱动导航窗格、大纲和目录;显式设置字体与字号(run.font.name、run.font.size = Pt(11)、run.font.bold);用 doc.add_table(rows, cols) 创建带样式和加粗表头的原生 Word 表格;支持标题、Heading 1/Heading 2 分节、项目符号与编号列表(style="List Bullet" / "List Number")以及分页。读取时用 Document(path) 打开文件,遍历 doc.paragraphs(p.text、p.style.name)和 doc.tables(table.rows[i].cells[j].text)提取或编辑内容。

使用方式:uv 必须在 PATH 上,所有 Python 通过 uv run 执行,运行时注入包镜像环境变量,无需自行配置镜像。若 uv 缺失,应停止并报告:office-docx requires 'uv' on PATH, but 'uv --version' failed. This is an environment problem — uv should be provisioned by the PawWork runtime. Do not fall back to system pip; report the missing uv instead. 不要回退到系统 pip 或 pip install。技能目录在应用包内只读,切勿写入,应在全新目录中工作。SKILL_DIR 使用纯文件系统路径,若只有 file:// URL 需先去掉前缀。示例:mkdir -p work && cp "$SKILL_DIR/pyproject.toml" work/pyproject.toml(固定 python-docx==1.1.2),所有 uv run 命令在 work/ 下运行。

交付前须运行结构检查,直到打印 OK:uv run python "$SKILL_DIR/scripts/check_docx.py" out.docx --min-paragraphs 1 [--require-heading] [--require-table]。结构化报告或多节文档加 --require-heading,需要表格时加 --require-table。检查确认文档可打开、有真实正文段落,并在要求时使用真实 Heading 样式和包含表格。

限制:不得用大号加粗正文冒充标题;不得手改 zip 修复,应从生成器重建;文档未通过检查即未完成。其他收费、平台与效果信息暂未提供。