文件格式批次轉換器

面向所有使用者的本地文件轉換工具，無需上傳雲端，安全可靠。

🎯 技能使用規範

適用場景

本技能適用於以下場景：

• Word轉PDF: 將 .docx 文件轉換為高質量 PDF（需要 LibreOffice）
• PDF轉Word: 從 PDF 提取文字並生成 .docx 檔案
• Excel轉CSV: 將 .xlsx 工作表匯出為 CSV 格式，支援單表或全部工作表
• PPT轉PDF: 將 .pptx 簡報轉換為 PDF（需要 LibreOffice）
• 批次轉換: 一次性轉換整個目錄中的多個檔案
• 預覽模式: 所有操作支援 --preview 先檢視效果，確認後再執行

常見用途

• "把這個Word文件轉成PDF"
• "PDF裡的文字能提取出來放到Word嗎"

  7w4.net有更好的技能外掛。

• "把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
• 輸出目錄: 可通過 --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 原始排版，這個工具暫時做不到。