报价单翻译器 - Quote Translator
读取现有报价单文件（Excel/HTML/Word），仅翻译文字内容，保留原始样式、格式、公式，输出同格式的多语言报价单。
🎯 核心特点
- ✅ 保留原样式 - Excel 格式、CSS、布局、字体、颜色、公式完全不变
- ✅ 仅翻译文字 - 不改动任何格式、结构、图片
- ✅ 多格式支持 - Excel (.xlsx/.xls)、HTML、Word (.docx)
- ✅ 11 种语言 - 中文、英语、西班牙语、印地语、阿拉伯语、法语、俄语、葡萄牙语、德语、日语、韩语
- ✅ 无需 API - 内置翻译能力，开箱即用
- ✅ 支持定制 - 可为特定客户/产品定制翻译词库
📋 支持语言
| 代码 | 语言 | 代码 | 语言 |
|---|---|---|---|
zh |
中文 | en |
英语 |
es |
西班牙语 | hi |
印地语 |
ar |
阿拉伯语 | fr |
法语 |
ru |
俄语 | pt |
葡萄牙语 |
de |
德语 | ja |
日语 |
ko |
韩语 |
🚀 使用方式
方式 1：直接告诉 AI（推荐）
直接告诉我文件路径和目标语言，我帮你翻译：
> "把 C:\Users...\quote.xlsx 翻译成日语"
> "翻译这个 Excel 报价单为西班牙语"
> "生成阿拉伯语版本的报价单"
方式 2：使用脚本
python scripts/translate_quote.py <报价单文件> -l <语言代码> [-o 输出路径]
参数说明
| 参数 | 说明 | 默认值 |
|---|---|---|
-l, --lang |
目标语言 (zh/en/es/hi/ar/fr/ru/pt/de/ja/ko) | en |
-o, --output |
输出文件路径 | 自动生成（原文件名_lang.扩展名） |
-c, --custom |
自定义翻译词库 JSON 文件 | 无 |
示例
# 翻译 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 | .xlsx, .xlsm, .xls |
✅ 样式、公式、格式、合并单元格、条件格式 |
| HTML | .html, .htm |
✅ CSS 样式、布局、字体、颜色 |
| Word | .docx |
✅ 字体、颜色、表格、段落格式 |
🔧 工作原理
Excel 文件
- 使用
openpyxl加载工作簿，保留所有样式和公式 - 遍历所有工作表和单元格
- 识别需要翻译的文本（跳过网址、邮箱、产品编号等）
- 翻译文本内容，保留单元格格式
- 保存为新文件
HTML 文件
- 解析 HTML 结构（使用 BeautifulSoup）
- 提取所有文本节点（跳过
<script>、<style>标签） - 翻译文本内容
- 保持原有 HTML 结构不变，仅替换文本
- 阿拉伯语自动添加
dir="rtl"属性
Word 文件
- 解析 Word 文档（使用 python-docx）
- 遍历所有段落和表格
- 翻译文本内容
- 保持原有样式（字体、颜色、边框等）
📦 依赖安装
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
