安裝
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') 失敗時的安裝。證據沒有寫支援哪些代理介面、也沒有寫撤銷或權限模型;缺的資訊保持未知,不要寫成沒有風險。