報價單翻譯器 - Quote Translator

讀取現有報價單檔案（Excel/HTML/Word），僅翻譯文字內容，保留原始樣式、格式、公式，輸出同格式的多語言報價單。

🎯 核心特點

• ✅ 保留原樣式 - Excel 格式、CSS、佈局、字型、顏色、公式完全不變
• ✅ 僅翻譯文字 - 不改動任何格式、結構、圖片
• ✅ 多格式支援 - Excel (.xlsx/.xls)、HTML、Word (.docx)
• ✅ 11 種語言 - 中文、英語、西班牙語、印地語、阿拉伯語、法語、俄語、葡萄牙語、德語、日語、韓語
• ✅ 無需 API - 內建翻譯能力，開箱即用
• ✅ 支援定製 - 可為特定客戶/產品定製翻譯詞庫

📋 支援語言

🚀 使用方式

方式 1：直接告訴 AI（推薦）

直接告訴我檔案路徑和目標語言，我幫你翻譯：

"把 C:\Users...\quote.xlsx 翻譯成日語" "翻譯這個 Excel 報價單為西班牙語" "生成阿拉伯語版本的報價單"

方式 2：使用指令碼

python scripts/translate_quote.py <報價單檔案> -l <語言程式碼> [-o 輸出路徑]

引數說明

示例

# 翻譯 Excel 報價單為日語
python scripts/translate_quote.py quotation.xlsx -l ja

# 翻譯 HTML 報價單為西班牙語，指定輸出路徑
python scripts/translate_quote.py quote.html -l es -o spanish_quote.html

# 翻譯 Word 報價單為法語
python scripts/translate_quote.py quote.docx -l fr

# 使用自定義翻譯詞庫
python scripts/translate_quote.py quote.xlsx -l de -c my_translations.json

# 翻譯為阿拉伯語（自動 RTL 佈局）
python scripts/translate_quote.py quote.html -l ar

📁 支援的檔案格式

🔧 工作原理

Excel 檔案

1. 使用 openpyxl 載入工作簿，保留所有樣式和公式
2. 遍歷所有工作表和單元格
3. 識別需要翻譯的文本（跳過網址、郵箱、產品編號等）
4. 翻譯文本內容，保留單元格格式
5. 儲存為新檔案

HTML 檔案

1. 解析 HTML 結構（使用 BeautifulSoup）
2. 提取所有文本節點（跳過 <script>、<style> 標籤）
3. 翻譯文本內容
4. 保持原有 HTML 結構不變，僅替換文本
5. 阿拉伯語自動新增 dir="rtl" 屬性

Word 檔案

1. 解析 Word 文件（使用 python-docx）
2. 遍歷所有段落和表格

   7w4.net小蔥技能站收錄全網優質技能，值得收藏。

3. 翻譯文本內容
4. 保持原有樣式（字型、顏色、邊框等）

📦 依賴安裝

pip install openpyxl beautifulsoup4 lxml python-docx python-dotenv

🎨 定製翻譯詞庫

如果需要為特定產品/客戶定製翻譯，可以建立自定義詞庫：

建立 my_translations.json：

{
  "en": {
    "Charms": "吊墜",
    "Stainless steel Charms": "不鏽鋼吊墜",
    "Contact us for more Collection": "聯絡我們獲取更多系列"
  },
  "ja": {
    "Charms": "チャーム",
    "Stainless steel Charms": "ステンレススチールチャーム",
    "Contact us for more Collection": "その他のコレクションについてはお問い合わせください"
  }
}

使用自定義詞庫：

python scripts/translate_quote.py quote.xlsx -l ja -c my_translations.json

⚠️ 注意事項

✅ 適合的場景

• 報價單、產品目錄、價格表
• 包含產品描述、公司介紹的文件
• 需要保留原格式的正式檔案

⚠️ 限制

• 圖片中的文字不翻譯 - 僅翻譯文本內容，圖片內文字需手動處理
• 複雜表格建議校對 - 巢狀表格、合併單元格等複雜結構建議翻譯後人工檢查
• 專業術語建議定製詞庫 - 行業特定術語建議新增到自定義詞庫確保準確

📂 檔案結構

quote-translator/
├── SKILL.md                  # 技能說明（本檔案）
├── README.md                 # 詳細文件
├── .env.example              # API 配置示例（可選）
├── scripts/
│   ├── translate_quote.py    # 主指令碼
│   └── templates/            # 翻譯模板（可選）
│       ├── jewelry.json      # 珠寶行業模板
│       └── electronics.json  # 電子產品模板
└── examples/                 # 示例檔案（可選）

📝 使用案例

案例 1：珠寶報價單多語言版本

原始檔案：dg1688_template_quote.xlsx（英文）

需求：生成中文、日語、西班牙語版本

操作：

python scripts/translate_quote.py dg1688_template_quote.xlsx -l zh
python scripts/translate_quote.py dg1688_template_quote.xlsx -l ja
python scripts/translate_quote.py dg1688_template_quote.xlsx -l es

輸出： - dg1688_template_quote_zh.xlsx（中文） - dg1688_template_quote_ja.xlsx（日語） - dg1688_template_quote_es.xlsx（西班牙語）

案例 2：HTML 報價單阿拉伯語版本

原始檔案：quotation.html（英文）

需求：生成阿拉伯語版本（RTL 佈局）

操作：

python scripts/translate_quote.py quotation.html -l ar

輸出：quotation_ar.html（自動新增 dir="rtl" 屬性）

🔄 版本歷史

v2.0.0 (2026-03-31)

• ✅ 重構為直接翻譯模式，無需外部 API
• ✅ 支援 Excel 格式（.xlsx, .xlsm, .xls）
• ✅ 支援自定義翻譯詞庫
• ✅ 最佳化文本識別邏輯（跳過網址、郵箱、產品編號）
• ❌ 移除對外部翻譯 API 的依賴

v1.0.0 (2026-03-31)

• 初始版本
• 支援 HTML、Word、Markdown
• 依賴 DeepL/Google Translate API

📍 技能位置

C:\Users\caizheyu\.openclaw\workspace\skills\quote-translator\

💡 快速開始

最簡單的方式：

直接告訴我：

"把這份報價單翻譯成 [語言]"

我會自動處理，生成翻譯後的檔案！🍟

建立時間：2026-03-31
作者：薯條 🍟
版本：v2.0.0

這個翻譯工具的文件和使用說明寫得很好，介面清晰看得懂。但翻譯質量比較有限，只能處理詞庫裡預置的幾十個固定詞條，詞庫以外的文字會直接保留原文不翻譯。對於專業報價單中大量自定義產品名稱和描述，實際可用性不高。建議先用幾個真實報價單測試一下，看需要的詞彙是否都在詞庫裡。.