核心功能
Universal Translator是一款文档翻译框架Skill，提供标准化的文档解析流水线，支持Word(.docx)、Excel(.xlsx)、PowerPoint(.pptx)、PDF、HTML、Markdown、TXT共7种主流格式的批量翻译。该框架通过Python库（python-docx/openpyxl/python-pptx/pymupdf/BeautifulSoup）实现格式解析与排版保留，但本身不提供翻译能力——文本翻译完全依赖AI agent配置的LLM。
显著优点
- 格式覆盖全面：从办公文档到网页源码一网打尽，支持文件夹级批量处理
- 排版高度还原：直接操作DOM结构（段落/表格单元格/幻灯片形状），非文本提取方案
- 扩展性强：模块化设计，可自定义
translator_fn接入任意LLM - 轻量依赖：纯Python实现，MIT-0协议零限制
关键局限与风险
- 数据外发强制：文档内容需逐段发送至LLM，若配置远程API（如OpenAI/Claude）则存在敏感数据泄露风险；本地LLM可缓解但需自行部署
- 翻译质量不可控：框架仅做解析，翻译质量完全取决于底层LLM能力，无术语库集成或质量校验机制
- 格式兼容性限制：不支持旧版.xls/.doc，PDF复杂排版（图文混排/表格）可能错位
- 语言代码硬编码：示例代码中
target_lang参数存在多处硬编码为'en'的问题，需开发者修正 - 无回滚机制：直接覆写原文档，建议用户备份原文件
适用人群
- 需快速搭建文档翻译流水线的开发者
- 已拥有合规LLM接入能力的企业本地化团队
- 接受"解析框架+自研翻译逻辑"分工的技术用户
安全提示
- 敏感文档禁用：合同、病历、内部财报等涉密材料不建议接入远程LLM
- 依赖库审计：python-docx/openpyxl等库会解析XML，恶意构造的文档可能触发XXE（尽管概率较低）
- 输出校验必要：机器翻译后务必人工审校，尤其是数字、日期、专有名词