安装
require('docx'); npm install docx only if require fails适合谁
适合要在代理里创建、读取、编辑或处理 Word 文档(.docx / .dotx)的人:报告、备忘、信件、模板,或从已有 Word 文件抽取、重排、替换图片、查找替换、处理修订和批注。证据写明:用户提到 Word 文档、.docx、.dotx,或要求带目录、标题、页码、信头的正式文档时使用该 skill。
不适合 PDF、电子表格、Google Docs,以及与文档生成无关的一般编程任务。证据用 Do NOT use 写死了这条边界,不要自行推广到其它格式。
使用前要承认依赖面:docx(npm,预装)、pandoc、LibreOffice(soffice)、pdftoppm(Poppler)。缺其中只读链路所需的 pandoc,第一次读取就走不下去。证据没有指定必须在哪个代理市场安装,不要推断商店或一键安装。
3 分钟完成第一次尝试
前提:当前代理已加载名为 docx 的 skill;本机或该 skill 目录能调用 pandoc。docx 包按官方说法是预装的,第一次不要先跑 npm install;只有 require('docx') 失败时才 npm install docx。
推荐主路径是只读查看,而不是立刻改文件。在已加载该 skill 的对话里,对一份你拥有的 .docx 执行官方读取命令:
pandoc -t markdown file.docx
把 file.docx 换成真实文件名。这会读文件并产出 Markdown,属于读取,不是无损保证;调用前确认文件路径,避免对不该暴露的文档做转换。证据没有写撤销。成功信号是命令跑完并得到 Markdown 文本。证据没有规定代理里如何点选该 skill,只要求在需要处理 Word 时使用它。
若你接下来要改已有文档,必须先停一下:官方路径是 unzip → 编辑 word/document.xml → zip,并且写明 docx-js 打不开已有文件。这是写操作,会改压缩包内容;动手前确认你有副本。第一次尝试不要从写路径开始。
使用案例
案例一:读取。用 pandoc -t markdown file.docx 把一份现有 Word 转成 Markdown,检查标题和正文是否出来。证据只覆盖这条读取命令,不覆盖其它转换器。
案例二:编辑已有文档。按官方三步处理压缩包并改 word/document.xml,再打回 zip。docx-js 不能打开已有文件,所以不要走“用 docx-js 直接开旧文件”。这是明确的副作用路径,先备份再改。证据没有提供完整脚本,走不到的参数保持未知。
使用边界
读路径依赖 pandoc;写路径依赖解压/改 XML/再打包,并可能再用 LibreOffice 与 pdftoppm 做后续核验,那些核验命令不在本指南第一次尝试里。不要用于 PDF、表格或 Google Docs。预装 docx 不代表可以跳过 require('docx') 失败时的安装。证据没有写支持哪些代理界面、也没有写撤销或权限模型;缺的信息保持未知,不要写成没有风险。