PDF to Word (pdf-to-word) Skill#

PDF 转 Word 转换技能，基于 doc-converter 项目实现。

项目位置#

text

/home/vei/.openclaw/workspace/doc-converter/
├── backend/          # Node.js 后端 (Fastify + Prisma)
├── frontend/         # React 前端 (Vite + TypeScript)
└── docker-compose.yml

核心转换流程#

1. 上传 PDF 文件#

前端上传（已实现于 HomePage.tsx）：

text

POST /api/v1/file/upload
Content-Type: multipart/form-data
Body: file (PDF文件，最大50MB)
Response: { fileId, originalName, format, size, pages }

直接 API 调用：

bash

curl -X POST http://localhost:3000/api/v1/file/upload \
  -F "file=@your.pdf"

2. 创建 PDF→Word 转换任务#

text

POST /api/v1/convert/
Content-Type: application/json
Body: { fileId: "<fileId>", conversionType: "pdf_to_word" }
Response: { taskId, status, conversionType, createdAt, expiresAt }

3. 轮询任务状态#

text

GET /api/v1/convert/:taskId
Response: {
  taskId, status: "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED",
  progress: 0-100,
  output: { fileId, originalName, format, size, downloadUrl } | null,
  errorMessage: string | null
}

状态说明：

• PENDING - 排队中
• PROCESSING - 转换中（有 progress 进度）
• COMPLETED - 完成，可下载
• FAILED - 失败，查看 errorMessage

4. 下载转换结果#

text

GET /api/v1/convert/:taskId/download
Response: 文件流 (application/vnd.openxmlformats-officedocument.wordprocessingml.document)

5. 转换历史#

text

GET /api/v1/convert/history
Response: { total, tasks: [{ taskId, conversionType, status, createdAt, input, output }] }

后端转换实现#

核心文件： backend/src/jobs/converter.ts

PDF → Word 使用 pdf2docx Python库：

python

from pdf2docx import Converter
c = Converter('input.pdf')
c.convert('output.docx')
c.close()

其他转换类型使用 LibreOffice：

• Word/Excel/PPT → PDF： soffice --headless --convert-to pdf
• PDF → 图片： pdftoppm -jpeg -r 200
• 图片 → PDF： convert 或 gs

前端组件#

• HomePage.tsx - 主转换界面（拖拽上传、转换选项、结果展示）
• HistoryPage.tsx - 转换历史
• convertStore - Zustand 状态管理

支持的转换类型#

conversionType说明引擎pdf_to_wordPDF → Wordpdf2docxword_to_pdfWord → PDFLibreOfficepdf_to_imagesPDF → 图片pdftoppmimages_to_pdf图片 → PDFImageMagick/gsword_to_imageWord → 图片LibreOffice + pdftoppmexcel_to_pdfExcel → PDFLibreOfficeppt_to_pdfPPT → PDFLibreOffice

快速使用流程#

1. 上传 PDF：拖拽或点击选择 PDF 文件
2. 选择转换格式：自动显示 PDF→Word 选项
3. 开始转换：点击转换按钮
4. 等待完成：轮询任务状态（每1.5秒）
5. 下载结果：点击下载按钮获取 .docx 文件

关键代码参考#

• 转换路由： backend/src/routes/convert.ts
• 转换Worker： backend/src/jobs/converter.ts
• 前端API： frontend/src/api/client.ts
• 状态管理： frontend/src/stores/convertStore.ts

详细 API 和架构说明见 references/