文档格式批量转换器

面向所有用户的本地文档转换工具，无需上传云端，安全可靠。

🎯 技能使用规范

适用场景

本技能适用于以下场景：

• Word转PDF: 将 .docx 文档转换为高质量 PDF（需要 LibreOffice）
• PDF转Word: 从 PDF 提取文字并生成 .docx 文件
• Excel转CSV: 将 .xlsx 工作表导出为 CSV 格式，支持单表或全部工作表
• PPT转PDF: 将 .pptx 演示文稿转换为 PDF（需要 LibreOffice）
• 批量转换: 一次性转换整个目录中的多个文件
• 预览模式: 所有操作支持 --preview 先查看效果，确认后再执行

常见用途

• "把这个Word文档转成PDF"
• "PDF里的文字能提取出来放到Word吗"
• "把Excel表格导出成CSV"
• "PPT转成PDF方便发给客户"
• "把这个文件夹里的Excel都转成CSV"
• "预览一下转换效果"

前置条件

使用前请确保：

1. ✅ 安装依赖（首次使用）: 在终端中 cd 进入本技能目录，然后运行 python3 scripts/install_deps.py
2. ✅ 确认Python环境: 运行 python3 --version（需要 Python 3.8+）
3. ✅ Word/PPT转PDF需要LibreOffice: 该功能依赖系统安装的 LibreOffice
4. ✅ 建议使用预览模式: 首次操作请先用 --preview 查看效果

📁 路径与入口

• 技能目录: {baseDir}/doc-converter-expert/
• 统一入口: python3 scripts/main.py [功能] [参数]（必须在技能目录下执行）
• 依赖安装: python3 scripts/install_deps.py

  7w4.net小葱技能站收录全网优质技能，值得收藏。

• 输出目录: 可通过 --output 参数指定，默认为源文件同目录

🔧 执行规范

详细的操作流程、调用规范、错误处理等，请参考以下文档：

使用指南

该文档定义：

• 各功能模块的标准调用格式
• --preview 预览模式的最佳实践
• 错误处理和友好提示机制
• LibreOffice 安装指南

📋 输出产物

严格按照执行规范执行完成后生成：

• 转换后的目标格式文件（默认与源文件同目录，或 --output 指定）
• 批量转换：每个源文件对应一个输出文件
• 预览模式：无文件产生，仅显示转换计划

💡 快捷命令速查

依赖安装（首次使用）

python3 scripts/install_deps.py

Word 转 PDF

# 单文件转换
python3 scripts/main.py word-to-pdf \
  --input report.docx \
  --preview

# 指定输出目录
python3 scripts/main.py word-to-pdf \
  --input report.docx \
  --output ./pdf_output/

PDF 转 Word

python3 scripts/main.py pdf-to-word \
  --input document.pdf \
  --output ./word_output/ \
  --preview

Excel 转 CSV

# 转换第一个工作表
python3 scripts/main.py excel-to-csv \
  --input data.xlsx \
  --preview

# 转换所有工作表
python3 scripts/main.py excel-to-csv \
  --input data.xlsx \
  --all-sheets \
  --output ./csv_output/

PPT 转 PDF

python3 scripts/main.py ppt-to-pdf \
  --input presentation.pptx \
  --output ./pdf_output/ \
  --preview

批量转换

# 转换目录下所有 xlsx 为 csv
python3 scripts/main.py batch-convert \
  --input ./data_folder/ \
  --from xlsx \
  --to csv \
  --preview

预览模式

# 查看目录下所有可转换文件
python3 scripts/main.py preview \
  --input ./my_documents/

🗣️ 口语化触发词

当用户提到以下任何说法时，请立即使用本技能：

Word/PDF转换类

• "Word转PDF" / "把docx转成pdf"
• "PDF转Word" / "把pdf转成docx"
• "提取PDF中的文字到Word"

Excel/CSV转换类

• "Excel转CSV" / "把xlsx导出成csv"
• "把工作表单独存成csv"
• "把表格导出为文本格式"

PPT转换类

• "PPT转PDF" / "把pptx转成pdf"
• "演示文稿转PDF"

批量处理类

• "批量转换这些文件"
• "把这个文件夹里的文档都转成PDF"
• "所有Excel都转成CSV"

格式转换类

• "文档格式转换"
• "Office文件转换"
• "换一个文件格式"

🚨 重要限制（明令禁止）

• 禁止依赖外部API: 所有转换必须本地完成，不上传任何文件到云端
• 禁止改变源文件: 所有操作必须生成新文件，绝不能修改原始文档
• 禁止跳过依赖检查: 转换前必须验证依赖安装状态，不可强行执行
• 禁止技术错误输出: 错误信息必须翻译为用户可理解的语言
  • ❌ 错误: subprocess.CalledProcessError: libreoffice command failed
  • ✅ 正确: "转换失败，请确认 LibreOffice 已正确安装"
  • ❌ 错误: ModuleNotFoundError: No module named 'pdfplumber'
  • ✅ 正确: "缺少必要的转换组件，请先运行 python3 scripts/install_deps.py 安装依赖"

📚 参考文档

完整操作指南请参考以下文档：

• 安装与使用指南 - 依赖安装、LibreOffice配置、基本用法
• 支持格式 - 输入输出格式对照表与转换原理
• 故障排除 - 常见问题与解决方案

这个工具质量不错，功能覆盖日常办公常用的文档格式转换需求。文档写得很清楚，安装使用都有详细指导，预览模式和友好的错误提示让新手也能上手。不过 PDF 转 Word 功能只能提取文字，排版和图片都会丢失，这点比较遗憾。缺少示例文件，刚安装完没法马上验证是否工作正常。总体来说是个好用的工具，主要功能稳定，但如果你需要保留 PDF 原始排版，这个工具暂时做不到。